Skip to main content
← All Guides
Plugin Config · 5 min read

Multiverse, Per-World Inventories

Set up multiverse per world inventories to give each world its own player inventory, health, XP, and game mode. Full config walkthrough with world groups and sharing rules.

Why Separate Inventories Per World?

On a server with multiple worlds, players can carry overpowered gear from survival into a minigame world, or transfer creative-mode items into survival. Multiverse per world inventories solves this by giving each world (or group of worlds) its own independent inventory, health, hunger, XP, and game mode. Players switching between worlds start fresh or load a separate saved state, keeping your game modes isolated and fair.

If you have not yet set up Multiverse itself, start with our Multiverse tutorial to get the core plugin running.

Installing Multiverse-Inventories

Multiverse per world inventories requires the Multiverse-Inventories addon. Download it from the Multiverse GitHub or your plugin marketplace and drop it into your plugins/ folder:

plugins/
  Multiverse-Core.jar
  Multiverse-Inventories.jar
  Multiverse-Portals.jar    # optional but recommended

Restart the server. Multiverse-Inventories generates its config in plugins/Multiverse-Inventories/.

Understanding World Groups

The key concept is world groups. Worlds in the same group share inventories. Worlds in different groups have completely separate inventories. By default, no groups exist, which means every world is isolated.

A typical setup groups the overworld, nether, and end together (since players naturally travel between them), while keeping creative, minigame, and event worlds separate:

# groups.yml
groups:
  survival:
    worlds:
      - world
      - world_nether
      - world_the_end
    shares:
      - all
  creative:
    worlds:
      - creative
    shares:
      - all
  minigames:
    worlds:
      - spleef
      - bedwars
    shares:
      - all

Configuring Shared Attributes

The shares list controls what is shared within a group. You can share everything or pick specific attributes:

shares:
  - inventory      # hotbar and main inventory
  - armor          # equipped armor
  - health         # current HP
  - hunger         # food level
  - experience     # XP level and progress
  - economy        # Vault economy balance (if supported)
  - bed_spawn      # bed respawn location
  - ender_chest    # ender chest contents

Using - all is shorthand for every attribute. For most setups, - all within survival groups and - all within creative groups is the right choice. The plugin gives you granular control when you need it, for example sharing economy balance across all worlds while keeping inventories separate.

Creating Groups In-Game

You can also create groups from the console or in-game:

/mvinv group create survival
/mvinv group addworld survival world
/mvinv group addworld survival world_nether
/mvinv group addworld survival world_the_end
/mvinv group addshare survival all

Repeat for each group. Changes take effect immediately without a restart.

Game Mode Per World

Multiverse-Core already lets you set a game mode per world with /mvm set mode creative creative. When combined with per-world inventories, players switching from survival to creative automatically get a separate inventory and switch to creative mode. This prevents the classic exploit of grabbing creative items and carrying them back to survival.

Handling Edge Cases

  • Ungrouped worlds: Any world not in a group gets its own isolated inventory by default. Players teleporting there start with an empty inventory and full health.
  • Adding a world to a group after players have used it: Existing inventory data for that world is preserved. The next time a player enters, they load the group's shared inventory instead of their world-specific one. Their old world-specific data stays in storage and can be recovered if you remove the world from the group.
  • Economy balance: If you use Vault, adding economy to shares keeps the balance consistent within a group. Omit it if you want separate economies per world.

Config File Reference

The main config at plugins/Multiverse-Inventories/config.yml controls global behavior:

# config.yml
first-spawn-override: true    # use MV-Inv inventory on first join
use-bypass: false              # allow bypass permission for staff
save-and-load-on-world-change: true

Keep save-and-load-on-world-change enabled. Disabling it is the most common cause of inventory duplication bugs. For staff who need to carry items between worlds (for testing or moderation), grant multiverse.inventories.bypass.* through LuckPerms.

Summary

Multiverse per world inventories keeps game modes honest by isolating player data across worlds. Install Multiverse-Inventories, define world groups, choose which attributes to share, and test by switching between worlds. Combined with Multiverse-Core's per-world game mode settings from the Multiverse tutorial, you get a clean multi-world server where survival, creative, and minigame modes coexist without contamination.

Full config access on every plan: Astroworld Hosting, NVMe SSDs, Pterodactyl panel.

Related Tools & Resources

🔧

Minecraft Tools

Calculators, generators & server tools

🧱

Item Database

Browse all Minecraft items, stats & recipes

⚒️

Crafting Recipes

Visual crafting guides for every recipe