Skip to content

Release 2.9.0

Choose a tag to compare

View all tags
@tastybento tastybento released this 08 Jul 01:51
2.9.0
0467d1c
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Release Highlights

  • 🔒 Prerequisite generators — Gate a generator behind others, so tiers must be unlocked in a designed progression.
  • 🧱 OneBlock/AOneBlock gating — Require a specific AOneBlock phase or a number of blocks broken before a generator becomes available.
  • ⚙️ Re-lock level tiers on level loss — Optional lose-tiers-on-level-loss setting re-locks level-unlocked generators if an island's level drops.
  • ✨ Activate on unlock — Generators can now activate automatically the moment they are unlocked.
  • 💰 Purchase confirmation — Optionally ask players to confirm before money is taken for a generator.
  • 🛠️ Admin data reset — New admin command to reset a player's unlocked, purchased, and active generators.
  • 🔌 New cancellable API events — GeneratorPreBuyEvent and GeneratorTreasureDropEvent for other addons to hook into.
  • 🔺 Permission-gated generators are now revoked when an island's owner no longer holds the required permission.

Compatibility

✔️ BentoBox API 3.14.0
✔️ Minecraft 1.21.x
✔️ Java 21

Upgrading

  1. As always, take backups just in case. (Make a copy of everything!)
  2. Stop the server.
  3. Drop the new MagicCobblestoneGenerator jar into your addons folder and delete the old one.
  4. Restart the server.
  5. Review the new generator requirement options and the lose-tiers-on-level-loss config toggle if you want to use them.
  6. You should be good to go!

🔡 Locale note: New keys were added to en-US.yml for the prerequisite-generator selector, activate-on-unlock, purchase confirmation, the admin reset command, and OneBlock/AOneBlock requirement messages. Regenerate or update your locale files to pick up the new strings.

⚙️ Config note: A new lose-tiers-on-level-loss setting was added (default false). It will be written to config.yml automatically on first load after the update.

🔺 Behaviour change: Permission-gated generators that were previously a permanent grant are now revoked from an island's unlocked and active lists when the current (online) owner does not hold the required permission — for example after an ownership transfer. Purchased tiers are preserved, so access returns if the permission is regained.

Legend

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

New Features

🔒 Prerequisite Generators

[PR #158] Fixes #88

Generators can now require one or more other generators to be unlocked before they become available. This lets you build proper unlock trees and multi-step progressions instead of a flat list of tiers. Prerequisites are configured through a new admin GUI selector in the generator edit panel.

🧱 AOneBlock Phase Requirement

[PR #162] Fixes #121

On AOneBlock game modes, a generator can now be gated behind a specific island phase, so tiers only become available as the island advances through its phases.

🧱 OneBlock Block-Count Requirement

[PR #163] Fixes #117

Generators can also be gated behind the number of blocks broken on a OneBlock island, unlocking tiers based on player progress rather than island level or economy alone.

⚙️ Re-lock Level Tiers on Level Loss

[PR #161] Fixes #118

Restores the pre-2.0.0 behaviour where a generator unlocked by island level is re-locked if the island level later drops below its requirement. This is controlled by the new lose-tiers-on-level-loss setting and is off by default. Purchased tiers are always kept — only free, level-unlocked tiers are re-locked.

✨ Activate on Unlock

[PR #159] Fixes #106

A new per-generator option activates a generator automatically as soon as it is unlocked, saving players a trip to the GUI. It can be toggled from the generator edit panel.

💰 Purchase Confirmation

[PR #157] Fixes #109

Buying a generator can now require an explicit confirmation before any money is taken, helping to prevent accidental purchases.

🛠️ Admin Reset Command

[PR #160] Fixes #149

A new admin command resets a player's island generator data — unlocked, purchased, and active generators — after a confirmation prompt.

🔌 New Cancellable API Events

[PR #153] [PR #154]

Two new cancellable events give other addons more control:

  • GeneratorPreBuyEvent fires before a generator is purchased, allowing a buy to be cancelled or inspected.
  • GeneratorTreasureDropEvent fires when a treasure is about to drop from a generator, allowing the drop to be cancelled.

Both extend a shared GeneratorEvent base.

Bug Fixes

🔺 Revoke permission-gated generators when the owner loses permission

[PR #155] Fixes #133

Previously, a generator unlocked via permission stayed unlocked forever, even after the island changed hands to an owner without that permission. Unlock status is now re-checked and permission-gated tiers are revoked from the unlocked and active lists when the online owner no longer holds the permission. Purchased tiers are preserved so access returns if the permission is regained; offline owners are left untouched.

Stable generator ordering

[PR #156] Fixes #123

Generators are now ordered by their stable unique id rather than their friendly name, so the display order no longer shifts when generators are renamed.

Other Improvements

  • Extracted a shared GeneratorEvent base and a PlayerTargetCommand base to remove duplication across events and admin subcommands [PR #149]
  • Expanded the test suite (MagicGenerator, GeneratorEditPanel, CommonPanel, MultiGeneratorSelector, admin reset) and restored the JaCoCo agent in the Surefire config
  • Updated CLAUDE.md to match the current package structure

What's Changed

  • 🔒 Add prerequisite-generator requirement by @tastybento in #158
  • 🧱 Add AOneBlock phase requirement for generators by @tastybento in #162
  • 🧱 Add OneBlock block-count requirement for generators by @tastybento in #163
  • ⚙️ Add option to lose level-gated tiers when island level drops by @tastybento in #161
  • ✨ Add activate-on-unlock option for generators by @tastybento in #159
  • 💰 Add optional purchase confirmation before buying a generator by @tastybento in #157
  • 🛠️ Add admin command to reset a player's generator data by @tastybento in #160
  • 🔌 Add cancellable GeneratorPreBuyEvent by @tastybento in #153
  • 🔌 Add cancellable GeneratorTreasureDropEvent for treasure drops by @tastybento in #154
  • 🔺 Revoke permission-gated generators when island owner loses permission by @tastybento in #155
  • Stable generator ordering by unique id by @tastybento in #156

Full Changelog: 2.8.0...2.9.0

Contributors

tastybento
Assets 3
Loading