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!

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#