Skip to content

InvSwitcher#

InvSwitcher separates player inventories and other aspects between the various worlds.

Created and maintained by tastybento.

Useful links

The following are switched per-world:

  • Inventory & armor
  • Advancements
  • Food level
  • Experience
  • Health
  • Game mode (creative, survival, etc.)

How to use#

  1. Place the addon jar in the addons folder of the BentoBox plugin
  2. Restart the server
  3. Done!

Config.yml#

InvSwitcher has a config.yml with two main sections.

Worlds#

Lists the gamemode worlds that InvSwitcher operates in. Nether and End worlds are included automatically.

worlds:
- bskyblock_world
- acidisland_world
- oneblock_world
# ... etc.

Options#

Controls which player aspects are switched per-world and, optionally, per-island.

options:
  inventory: true
  health: true
  food: true
  advancements: true
  gamemode: true       # game mode (Survival/Creative/etc.)
  experience: true
  ender-chest: true
  statistics: true
  # Per-island inventory switching (added in 1.17.0)
  # The world-level option must also be true for the island option to take effect.
  islands:
    active: true       # Enable per-island switching overall
    inventory: true    # Give players a different inventory on each island they own
    health: false
    food: false
    advancements: false
    gamemode: false
    experience: false
    ender-chest: true
    statistics: false

Set islands.active: true to allow players who own more than one island to maintain separate inventories (and other aspects) per island, not just per gamemode world.

Commands#

There are no commands.

What it does#

This addon will give players a separate inventory, health, food level, advancements and experience for each gamemode installed and their corresponding worlds. It enables players to play each gamemode independently of each other.

An example#

BSkyBlock's Inventory, Health, Food level, Advancements and Experience are shared only between its corresponding worlds: - BSkyBlock_world - BSkyBlock_world_nether - BSkyBlock_world_the_end

Please note: - It is not limited to just BentoBox worlds. It applies to all worlds on the server (right now).

Changelog#

What's new in v1.17.0

Released: 2026-03-31

  • Per-island inventory switching. Players who own more than one island can now maintain separate inventories (and optionally health, food, experience, ender-chest, statistics) per island within the same gamemode. Enable with options.islands.active: true and configure each sub-option. The world-level option must also be true for its island counterpart to take effect.
  • ⚙️ New options.islands section in config.yml.
  • Bug fix: inventory was lost when returning to the original island.

Release v1.17.0

What's new in v1.17.1

Released: 2026-05-09

  • 🐛 Fixed inventory cleared when teleporting from a BentoBox world to a non-BentoBox world. When a player left a BentoBox game world (e.g. BSkyBlock) for a non-BentoBox world (e.g. the default overworld or a third-party plugin world), their "outside" inventory could be lost because each non-BentoBox world stored data under its own key. All non-BentoBox worlds now share a single storage key, so the player's inventory is always restored correctly. Includes automatic migration for data saved under the old per-world keys.

Release v1.17.1

Translations#

Help us keep translations accurate

Most BentoBox and addon translations are now generated with the help of AI, so the bulk of the work is already done — but AI is not perfect. What we really need from the community is error reports and corrections.

  • Spotted a mistake or awkward phrasing? Open an issue or a PR on the relevant repository at bentobox.world (a short link to our GitHub org), or tell us on Discord.
  • Want to add a brand-new language? Open a PR adding a new locale file to src/main/resources/locales/ in the relevant repo, or ask on Discord and we'll get you started.
Language Language code Progress
English (United States) en-US 100% (Default)

This project does not yet have any translatable locale files. Only English is shipped at the moment.

Last update: May 9, 2026 23:13:40