InvSwitcher#

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

Created and maintained by tastybento.

The following are switched per-world:

• Inventory & armor
• Advancements
• Food level
• Experience
• Health
• Game mode (creative, survival, etc.)
• Money (per-world economy, added in 1.18.0)

How to use#

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

Compatibility with other inventory plugins#

The usual symptom is disappearing items: pick up an item on your island, go to the lobby, come back, and the island inventory is empty. Nothing appears in the console, because neither plugin is failing — each is faithfully saving a player state the other has already rewritten. In testing, the island inventory ended up filed under the lobby's storage key, and an empty inventory under the island's.

The InvSwitcher version makes no difference. If you are seeing this, check for a second inventory plugin before anything else.

Multiverse-Inventories#

Two things commonly mislead admins here:

• Leaving the BentoBox worlds out of every inventory group does not help. Groups control which worlds share an inventory, not which worlds Multiverse-Inventories handles. It still writes a per-world profile for a world that is in no group.
• /mv remove <world> does not help either. Multiverse-Core re-registers BentoBox worlds as they are created, so the removal is silently undone on the next restart. Setting auto-import-3rd-party-worlds: false does not prevent this — it only suppresses the import sweep that runs when Multiverse-Core starts, which is before BentoBox has created its worlds.

Multiverse-Inventories has no config option to ignore a world, but it does have a bypass permission. First enable it in the Multiverse-Inventories config.yml (it ships as false):

share-handling:
  enable-bypass-permissions: true

Then grant mvinv.bypass.world.<world> for each BentoBox world — including its nether and end — to every player. With LuckPerms:

lp group default permission set mvinv.bypass.world.bskyblock_world true
lp group default permission set mvinv.bypass.world.bskyblock_world_nether true
lp group default permission set mvinv.bypass.world.bskyblock_world_the_end true

Setting the nodes on a group that every player inherits (such as default) covers new players automatically. Repeat for each game mode world you run.

Use one node per world. Avoid mvinv.bypass.world.*, which switches Multiverse-Inventories off for every world, including the ones you still want it to manage.

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
  money: true          # Per-world money (added in 1.18.0). Requires Vault.
  # 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
    money: false       # Per-island wallets (added in 1.18.0). False = per-world money only.

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.

Economy#

Added in 1.18.0. When options.money is enabled, InvSwitcher registers itself as the Vault economy provider and keeps a separate balance for each switched world. Transactions (shop sales, /pay, jobs, etc.) are routed to the balance of the world they belong to — even when the target player is offline or in a different world. Worlds InvSwitcher does not manage are passed through to your existing economy plugin (e.g. EssentialsX); if no other economy is present, InvSwitcher handles every world itself.

The economy: block is only used when options.money is true:

economy:
  starting-balance: 0.0              # Balance given on first entry to a managed world (unless imported)
  currency-name-singular: Dollar
  currency-name-plural: Dollars
  fractional-digits: 2               # Digits after the decimal point
  import-existing-balances: true     # Import each player's existing balance once, on first entry
  delegate-unmanaged-worlds: true    # Pass unmanaged worlds through to the previous economy plugin
  debug: false                       # Log every transaction to the console (verbose)

Commands#

Added in 1.18.0. Each managed game mode gains its own economy commands, scoped to that game mode's world, so /bsb balance shows your BSkyBlock balance and /ai balance your AcidIsland balance regardless of where you are standing.

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#

Placeholders#

Translations#