InvSwitcher

Release Highlights

• 🔺⚙️🔡 Per-world money — InvSwitcher can now give every game world its own separate economy, on top of the inventories, health, XP and stats it already switches.
• ⚙️ InvSwitcher is the economy — it registers itself as the Vault economy provider, so shop sales, /pay, jobs and other plugins all credit and debit the correct world's balance — even when the player is offline or in a different world.
• 🔡 New commands & placeholders — per-game-mode balance, pay, and admin eco give/take/set/balance, plus balance placeholders, translated into every language BentoBox ships.
• 🐛 Two inventory/XP fixes — advancements no longer inflate XP on world switch, and BentoBox island resets no longer wipe the wrong world's inventory.

Compatibility

✔️ BentoBox 3.17.0 ✔️ Paper Minecraft 1.21.5 – 26.1.2 ✔️ Java 21

Upgrading

1. As always, take backups just in case. (Make a copy of everything!)
2. Stop the server.
3. Update BentoBox to 3.17.0 — this release requires it.
4. Replace the InvSwitcher jar with this one.
5. If you want per-world money, install Vault (an economy plugin such as EssentialsX is optional) and leave options.money: true in config.yml.
6. Restart the server.
7. You should be good to go!

🔺 Requires BentoBox 3.17.0: InvSwitcher now listens to BentoBox's player-reset events (including the new money-reset event), which were introduced in 3.17.0. It will not load on older BentoBox versions.

🔺 Economy behaviour change: when options.money is enabled, InvSwitcher becomes the server's Vault economy provider. Worlds it does not manage are passed through to your existing economy (e.g. EssentialsX); managed worlds get their own per-world balance. If you run the Bank addon, island wallets become per-world too. On first entry to a managed world a player's existing balance is imported once (configurable via economy.import-existing-balances). Vault is required for money; an economy plugin is optional — InvSwitcher can be the only economy.

⚙️ New config: options.money, options.islands.money, and an economy: block (starting balance, currency names, fractional digits, import toggle, delegate toggle, debug). Existing configs keep working; the new keys are added with safe defaults.

🔡 Locale note: a new English reference locale and 22 translated locale files have been added for the economy commands.

Legend

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

New Features

🔺⚙️🔡 Per-world economy

InvSwitcher can now keep a separate money balance for each switched world, just as it does for inventories. With options.money enabled it registers itself as the Vault economy provider at the highest priority and routes every transaction to the balance of the world it belongs to. Because balances live in InvSwitcher's own data store, credits and debits land in the right world even when the target player is offline or standing somewhere else — fixing the classic "shop sale crosses worlds" problem. Worlds InvSwitcher does not manage are delegated to the previously-registered economy (e.g. EssentialsX), and if no other economy is present InvSwitcher handles everything itself.

Configuration lives under options.money / options.islands.money and a new economy: block (starting balance, currency name, fractional digits, one-time balance import, delegation toggle, and a debug switch). Per-world is the default; per-island wallets are opt-in.

🔡 Economy commands, tab completion and placeholders

Each managed game mode gains its own economy commands, scoped to that game mode's world: balance and pay for players, and eco give/take/set/balance for admins (with online-player tab completion on the player argument). /bsb balance shows your BSkyBlock balance and /ai balance your AcidIsland balance, regardless of where you are standing. Two PlaceholderAPI placeholders per game mode (<gamemode>_invswitcher_balance and ..._balance_formatted) expose the per-world balance. All strings are translated into every language BentoBox ships.

Bug Fixes

Advancements no longer inflate experience on world switch

[PR #47]

Some advancements reward XP when their criteria are restored. When switching worlds, re-awarding stored advancements could incorrectly increase the player's experience. InvSwitcher now saves and restores the exact XP around the advancement-restore step.

Island resets no longer clear the wrong world's inventory

[PR #49]

When BentoBox fired an inventory/ender-chest/health/hunger/XP reset for a player who was in a non-BentoBox world, the live player (in the wrong world) could be affected. InvSwitcher now intercepts these reset events and clears the stored data for the correct world instead. This release also handles the new money-reset event the same way.

Other Improvements

• Economy console output is gated behind economy.debug to keep logs clean.
• Admin economy commands refactored to remove duplicated code (no behaviour change).
• addon.yml API version updated to 3.17.0.

What's Changed

• 🔺⚙️🔡 Add per-world economy via a Vault provider, with commands, tab completion, placeholders and locales by @tastybento
• 🐛 Fix XP increase when restoring advancements on world switch by @Copilot in https://github.com/BentoBoxWorld/InvSwitcher/pull/47
• Intercept BentoBox player reset events to protect non-BentoBox world inventories by @Copilot in https://github.com/BentoBoxWorld/InvSwitcher/pull/49

Full Changelog: https://github.com/BentoBoxWorld/InvSwitcher/compare/1.17.1...1.18.0