Release 1.24.0

What's new

• 🔺 CraftEngine custom block support. Phases can now spawn CraftEngine blocks alongside the existing ItemsAdder and Nexo integrations. Refactored to delegate to BentoBox's new CraftEngineHook, so AOneBlock no longer tracks CraftEngine's API directly — this requires BentoBox 3.15.0 or later.
• ⚙️ Configurable chest particles per rarity. The particle type and color shown above UNCOMMON/RARE/EPIC chests are now fully configurable in config.yml under world.chest-particles. Set a particle to NONE to disable that rarity.
• CHEST_WITH_X fixed-block notation. Phase YAML fixedBlocks now accept entries like CHEST_WITH_WATER_BUCKET, which place a chest pre-filled with that item. Used to give Plains players a guaranteed water bucket as the last block before the Underground transition.
• Plains phase starter sequence updated. The first six blocks are now a deterministic grass + oak log sequence so new players always get logs before stone, and the test sponge entry has been replaced with the water-bucket chest above.
• ⚙️ OBSIDIAN_SCOOPING now off by default. Holding a bucket no longer instantly scoops obsidian magic blocks on fresh installs. Existing servers with the flag explicitly set are unaffected.
• 🔡 Placeholder defaults for islandless players. %aoneblock_my_island_phase%, %aoneblock_my_island_count%, and %aoneblock_my_island_percent_done% now return sensible defaults (Unknown, 0, 0%) instead of empty strings when the player has no island. New locale key aoneblock.placeholders.my-island-phase-default.
• 🔡 Missing actionbar/placeholder translations added across all locales.
• Documentation overhaul for MythicMobs, ItemsAdder, and Nexo custom block configuration in the README, including a start-commands workaround for MythicMobs skill issues.
• Code-quality sweep: 36 SonarCloud MEDIUM issues addressed, S2637 nullability warnings resolved, JaCoCo coverage now reports to SonarCloud, modrinth-publish action pinned to commit SHA.

Compatibility

✔️ BentoBox API 3.15.0+
✔️ Minecraft 1.21.5 or later
✔️ Java 21

Changelog

Legend

• 🔡 locale files may need to be regenerated or updated.
• ⚙️ config options have been removed, renamed, or added.
• 🔺 special attention needed.

Upgrading

1. Stop the server. Make a backup just in case.
2. Update BentoBox to 3.15.0 or later first — this release will not load against older BentoBox versions.
3. Copy this jar over the old one.
4. Restart the server.
5. (Optional) Review config.yml for the new world.chest-particles block if you want to customise chest particle effects.
6. (Optional) If you relied on the previous OBSIDIAN_SCOOPING: true default, re-add it explicitly.
7. You should be good to go!

🔺 BentoBox 3.15.0 required. The CraftEngine refactor depends on CraftEngineHook introduced in BentoBox 3.15.0. Older BentoBox versions will fail to load this addon.

⚙️ Config note: Fresh installs get six new keys under world.chest-particles and OBSIDIAN_SCOOPING: false. Existing config files keep their current values — copy the new section in if you want to use the configurable particles.

What's Changed

• Add CraftEngine custom block support by @tastybento in #496
• docs: strengthen README documentation for MythicMobs, ItemsAdder, and Nexo custom blocks by @tastybento in #498
• 🔡 Return defaults for empty placeholders when player has no island by @tastybento in #501
• 🔺 refactor: use BentoBox CraftEngineHook instead of direct API calls by @tastybento in #503
• ⚙️ Disable OBSIDIAN_SCOOPING by default by @tastybento in #505
• Add CHEST_WITH_X fixed-block shorthand and set Plains phase starter sequence by @tastybento in #506
• ⚙️ feat: make chest particle type and color configurable per rarity by @tastybento in #507

Full Changelog: 1.23.0...1.24.0

Release 1.23.0

New in this release

• Nexo custom block support! AOneBlock now supports Nexo custom blocks in phase definitions, alongside the existing ItemsAdder support.
• HEX / MiniMessage color support in the action bar. The /ob actionbar text now correctly renders HEX colors and full MiniMessage formatting.
• Russian locale updated to MiniMessage format with grammar corrections.
• Several action bar locale/translation bug fixes.

Compatibility

✔️ BentoBox API 3.10.0+
✔️ Minecraft 1.21.5 or later
✔️ Java 21

Changelog

Legend

• 🔡 locale files may need to be regenerated or updated.
• ⚙️ config options have been removed, renamed or added.
• 🔺 special attention needed.

Upgrading

1. Stop the server. Make a backup just in case.
2. Copy this jar over the old one.
3. Restart the server.
4. You should be good to go!

What's Changed

• Fix hex colors in the /ob actionbar command by @tastybento in #469
• 🔡⚙️🔺 Add Nexo custom block support by @tastybento in #474
• 🔡 Update Russian locale to MiniMessage format with grammar corrections by @tastybento in #479
• 🔡 Fix ONEBLOCK_ACTIONBAR translation not appearing in settings by @tastybento in #480
• Fix wrong locale keys in AdminSanityCheck by @tastybento in #481
• Fix action bar color codes stripped by getTranslationNoColor by @tastybento in #482

Full Changelog: 1.22.0...1.23.0

Release 1.22.0

New in this release

• Action Bar status! Use /ob actionbar to toggle the action bar status on or off. Working independently of the Boss Bar. Admins can customize the text in the locale file. (This didn't make it into the last release due to a version error!)
• Locales have been updated with this change too.

Compatibility

✔️ BentoBox API 3.0.0+
✔️ Minecraft 1.21.5 or later
✔️ Java 21

Changelog

Legend

• 🔡 locale files may need to be regenerated or updated.
• ⚙️ config options have been removed, renamed or added.
• 🔺 special attention needed.

Upgrading

1. Stop the server. Make a backup just in case.
2. Copy this jar over the old one
3. Restart the server
4. You should be good to go!

What's Changed

• 🔡⚙️ Provides Actionbar command and settings by @tastybento in #464
• Update tests to Mockito 5 and remove PowerMockito by @tastybento in #466
• Test additions by @tastybento in #467
• Version 1.22.0 by @tastybento in #465

Full Changelog: 1.21.1...1.22.0

Release 1.18.0

This release is for 1.21.3 and later and will not run on earlier versions, sorry!

Compatibility

✔️ BentoBox API 2.7.1 only
✔️ Minecraft 1.21.3 or later only
✔️ Java 17

Changelog

Legend

• 🔡 locale files may need to be regenerated or updated.
• ⚙️ config options have been removed, renamed or added.
• 🔺 special attention needed.

Upgrading

0. 🔺Make sure you are running 1.21.3 or later!
1. Stop the server. Make a backup just in case.
2. Copy this jar over the old one
3. Restart the server
4. You should be good to go!

What's Changed

• 🔺2.3.1 compatibility by @tastybento in #404
• Release 1.18.0 by @tastybento in #408
• Added text about the tipped arrow (commit: 2aef6a7)
• ⚙️Updated SNOWMAN to SNOW_GOLEM (commit: 252fe35)
• Remove holograms even if they are not cached (commit: 8ae0b83)

Full Changelog: 1.17.0...1.180

Release 1.21.1

New in this release

• Suspicious gravel and sand will now yield loot if brushed.
• Action Bar status! Use /ob actionbar to toggle the action bar status on or off. Working independently of the Boss Bar. Admins can customize the text in the locale file. (This didn't make it into this release due to a version error. It'll be in the next one)

Compatibility

✔️ BentoBox API 3.0.0+
✔️ Minecraft 1.21.5 or later
✔️ Java 21

Changelog

Legend

• 🔡 locale files may need to be regenerated or updated.
• ⚙️ config options have been removed, renamed or added.
• 🔺 special attention needed.

Upgrading

1. Stop the server. Make a backup just in case.
2. Copy this jar over the old one
3. Restart the server
4. You should be good to go!

What's Changed

• Add ActionBar support #450 by @tastybento in #455
• Release 1.21.0 by @tastybento in #456
• Fix for suspicious sand/gravle by @tastybento in #457
• Release 1.21.1 by @tastybento in #458

Full Changelog: 1.21.0...1.21.1

Release 1.21.0

New in this release

• Action Bar status! Use /ob actionbar to toggle the action bar status on or off. Working independently of the Boss Bar. Admins can customize the text in the locale file.

Compatibility

✔️ BentoBox API 3.0.0+
✔️ Minecraft 1.21.5 or later
✔️ Java 21

Changelog

Legend

• 🔡 locale files may need to be regenerated or updated.
• ⚙️ config options have been removed, renamed or added.
• 🔺 special attention needed.

Upgrading

1. Stop the server. Make a backup just in case.
2. Copy this jar over the old one
3. Restart the server
4. You should be good to go!

What's Changed

• Add ActionBar support #450 by @tastybento in #455
• Release 1.21.0 by @tastybento in #456

Full Changelog: 1.20.1...1.21.0

Release 1.20.1

New in this release

• Bug fix - with Minecraft 1.21.10 servers the blocks were not dropping on top.

Compatibility

✔️ BentoBox API 3.0.0+
✔️ Minecraft 1.21.5 or later
✔️ Java 21

Changelog

Legend

• 🔡 locale files may need to be regenerated or updated.
• ⚙️ config options have been removed, renamed or added.
• 🔺 special attention needed.

Upgrading

1. Stop the server. Make a backup just in case.
2. Copy this jar over the old one
3. Restart the server
4. You should be good to go!

Release 1.20.0

New in this release

• Bug fix - update tp latest ItemsAdder API

Compatibility

✔️ BentoBox API 3.0.0+
✔️ Minecraft 1.21.5 or later only
✔️ Java 21

Changelog

Legend

• 🔡 locale files may need to be regenerated or updated.
• ⚙️ config options have been removed, renamed or added.
• 🔺 special attention needed.

Upgrading

1. Stop the server. Make a backup just in case.
2. Copy this jar over the old one
3. Restart the server
4. You should be good to go!

What's Changed

• Update to latest ItemsAdder API by @tastybento in #444
• Version 1.20.0 and Java 21 by @tastybento in #442

Full Changelog: 1.19.0...1.20.0

Release 1.19.0

New in this release

• New Phases!
  • Lush Caves
  • Dripstone Caves
  • Mangrove Swamp
  • Meadow
  • Cherry Grove
  • Jagged Peaks
  • This extends the loop to 15,000 blocks!
  • If this is an update, nothing will be added or overwritten. See the install instructions below.
• Boss Bar - this shows how many blocks are left in a phase. Admins can customize what it shows. Users can enable or disable it via the Settings GUI (Settings tab - Dragon Head icon)
• Bug fixes - holograms now delete far more reliably

Compatibility

✔️ BentoBox API 3.0.0+
✔️ Minecraft 1.21.3 or later only
✔️ Java 21

Changelog

Legend

• 🔡 locale files may need to be regenerated or updated.
• ⚙️ config options have been removed, renamed or added.
• 🔺 special attention needed.

Upgrading

1. Stop the server. Make a backup just in case.
2. Copy this jar over the old one
3. (Optional) Delete or move the plugins/BentoBox/addons/AOneBlock/phases folder so that the new phases are added. If you have custom phases and just want the new ones, you can download them from here. Remember to change the goto file.
4. Restart the server
5. You should be good to go!

What's Changed

• 420 boss bar by @tastybento in #423
• 426 boss bar improvements by @tastybento in #427
• 437 new bossbar setting locale by @tastybento in #438
• New phases by @tastybento in #435
• 436 hologram fails to delete by @tastybento in #439
• Version 1.19.0 by @tastybento in #440

Full Changelog: 1.18.2...1.19.0

Release 1.18.2

This release fixes an issue in new world creation where water creatures were not spawning naturally because recently the FLAT type of world height of the world became -63, i.e., one block above -64. Unfortunately, this fix doesn't change existing worlds. It can only affect new worlds.

To fix current worlds

Use are your own risk! Take a backup copy of your world beforehand

You need to edit or replace the level.dat file in the aoneblock_world folder. The simple approach is to copy a level.dat file from a generic world and paste over it, e.g. the world folder's copy. Then restart the server, and it should work. Alternatively, if you have a NBT editor, then you can change the level.dat file of the world NBT tags to look like this:

Compatibility

✔️ BentoBox API 3.0.0+
✔️ Minecraft 1.21.3 or later only
✔️ Java 21

Changelog

Legend

• 🔡 locale files may need to be regenerated or updated.
• ⚙️ config options have been removed, renamed or added.
• 🔺 special attention needed.

Upgrading

0. 🔺Make sure you are running 1.21.3 or later!
1. Stop the server. Make a backup just in case.
2. Copy this jar over the old one
3. Restart the server
4. You should be good to go!

What's Changed

• Water animal sea fix by @tastybento in #414
• Release 1.18.2 by @tastybento in #416

Full Changelog: 1.18.1...1.18.2