Release 1.25.0

What's new

• Populated bee nest in Plenty. The Plenty phase already drops honey blocks, honeycomb blocks, and honey bottles, but never a hive to farm them from. Plenty now spawns a bee_nest (3 bees inside, honey_level=0) at the same density as the other honey items, closing the honey-farming gap.
• Magic block client-side resync after mob rolls. When the magic block rolled a mob, the server cancelled the break event but never told the client — leaving the block looking transparent until the next chunk resync (typically on relog). The block state is now resent to the mining player immediately after the cancel.
• CraftEngine startup-order fix. AOneBlock's onEnable runs before CraftEngine has populated its block registry, which previously caused a flood of false Bad custom block errors for every valid type: craftengine entry. CraftEngineCustomBlock.fromMap() no longer consults the registry when the YAML explicitly declares type: craftengine; runtime placement still validates the ID gracefully.
• Stricter CraftEngine block-ID validation at config load. Blank IDs and IDs missing the namespace:key form are now rejected at config-load time instead of silently accepted and failing at placement.
• Configurable chest particles no longer crash on non-DUST types. Particle types whose data type is non-Void (e.g. ITEM, BLOCK, ENTITY_EFFECT) used to throw IllegalArgumentException because no particle data was being constructed. They are now detected, logged as a warning, and skipped. DUST and void-data particles (e.g. FLAME) work unchanged.

Compatibility

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

Upgrading

1. Stop the server. Make a backup just in case.
2. Copy this jar over the old one.
3. (Optional) Remove the phases folder so it can be regenerated. If you have customized your phases, don't do this. Just see the new entry and add it if you want.
4. Restart the server.
5. You should be good to go!

What's Changed

• Fix false "Bad custom block" errors for CraftEngine blocks on startup by @Copilot in #511
• feat: drop populated bee nest in Plenty phase by @tastybento in #513
• fix: resync magic block to client after entity-spawn cancel by @tastybento in #514
• fix: skip chest particles that require typed data instead of crashing by @tastybento in #516
• fix: validate CraftEngine block ID format in fromMap at config-load time by @Copilot in #517

Full Changelog: 1.24.0...1.25.0

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