What is MultiInv

MultiInv is a plugin that gives players a separate inventory for every different world running on the server. You can share inventories over chosen worlds and some players can be ignored entirely. With this power it is possible to have multiple worlds running on one server, but keeping them totally segregated from one another.

MultiInv can also separate health over certain worlds allowing for total separations of a world on a server.

If MultiInv refuses to work and you can't change inventories, it's because you have the wrong version of the TuxTwoLib!

Update for UUIDs and 1.7.9 (there will be no support for 1.7.8 or below due to game breaking bugs) are here! Download will be available as soon as Bukkit Dev approves it.

MultiInv and MobArena are currently not compatible! Make sure users can only join a mob arena from the same world group!

Starting with MultiInv 3.2.1 we now require the library TuxTwoLib to maintain compatibility across various minecraft versions


  • Separate world inventories
  • Create groups of worlds where the inventory is shared between them
  • Separates XP, food, health, potion effects, and EnderChest inventory per world/group of worlds.
  • Option to ignore certain players completely (permissions based)
  • Can import Multiverse-Inventories/WorldInventories saved inventories.
  • Option to use mySQL instead of flat files.


The forums for this plugin (at the top of the page) are the best place to go if you have any questions that aren't just general comments (such as "I hat you" or "I love you"). There I can see which problems have been replied too and who still needs help.


  • /multiinv reload - Reloads config files.
  • /multiinv import - Imports flat files into a mysql database.
  • /multiinv mvimport - Imports Multiverse-Inventories into MultiInv, with the database that you have selected. (You will need to have the Multiverse-Inventories plugin installed when doing the import, just make sure to remove it afterwards)
  • /multiinv miimport - Imports WorldInventories into MultiInv.


  • multiinv.reload - Permission to use the reload command
  • multiinv.import - Permission to use the import command
  • multiinv.mvimport - Permission to use the mvimport command
  • multiinv.exempt - Exempts player from inventory switch (If your inventory is not changing, deny yourself this permission in your permissions manager!!!!)


^That's a link up there

Updating from MultiInv 2.x to 3.x

  1. Delete your old config.yml file in the plugins/MultiInv directory
  2. Start the server with the new plugin
  3. Rename the Worlds folder to Groups under the plugins/MultiInv directory.
  4. Rename shares.yml to groups.yml
  5. Cut the creativeGroups section out of groups.yml and paste it at the end of config.yml
  6. Edit the config.yml to your prefrences
  7. do: /multiinv reload
  8. If you are moving to the mysql database do: /multiinv import
  9. You're done, enjoy!

When, Where, and How are the Inventories Saved?
Old forum page (Includes old version links)
Development builds of this project can be acquired at the provided continuous integration server. These builds have not been approved by the BukkitDev staff. Use them at your own risk.
Jenkins Dev Builds
Source Code

Please note, that while I (Tux2) am maintaining this plugin you must file bug reports under the tickets section. If you're having a problem, try replicating it in the latest version of MultiInv as it could already be fixed! Also, if you want your problem to be addressed please make sure to include the MultiInv version, the TuxTwoLib version, your config.yml and groups.yml files contents as well, (even if it is a comment asking for help) If you do not follow these guidelines your comment may be deleted without warning!

MC Stats for MultiInv
Stats provided by Plugin Metrics

You must login to post a comment. Don't have an account? Register to get one!

  • Avatar of Tux2 Tux2 Oct 20, 2014 at 20:22 UTC - 0 likes

    @eryk2000: Go

    Corrupting item names is based on the default character set of the computer you are running the server on. I have tried fixing this in the past, but it seems it is still doing it. I'll see what I can do to force the server to save and read in UTF-8 format.

    @RJbeley: Go

    It should, do you have TuxTwoLib for 1.7.10 installed?

    @GodsDead: Go

    I'll see if I can replicate the bug. Remember, if I can't get it to do it, then I can only guess as to how to fix it.

    @SuperEPF: Go

    Put the world name in single quotes:
    - 'name with spaces' Bitcoins?1Lr7prAnqYpZe2UizvPKV2Cg4KSuj2weXb
    If you didn't take the time to read how my plugins work, don't expect me to take the time to diagnose your stupidity.
    If updates to my plugins depended on donations, they would never update. Donate!

  • Avatar of eryk2000 eryk2000 Oct 14, 2014 at 13:16 UTC - 1 like

    Will there ever be a plugin like this one but without custom items name bug? I switched to that from Multiverse-Inventories and both are corrupting the names.

    I mean when Item is named &a&lMenu (green, bold), after relog its name is ?a?lMenu. This is so annoying because I'm using crackshot (guns) and this makes guns don't work. Please, repair it.

  • Avatar of RJbeley RJbeley Oct 07, 2014 at 11:01 UTC - 0 likes

    This plugin doesn't seem to work with 1.7.10 please have a update?

  • Avatar of GodsDead GodsDead Oct 02, 2014 at 10:01 UTC - 0 likes

    Please can you fix this inventory saving issue, This is the one thing holding my server back from using multiple worlds & letting me create some unique games. Get this fixed and Ill buy you a few beers!

  • Avatar of PocketMines PocketMines Sep 28, 2014 at 06:27 UTC - 0 likes

    Is there any way to link enderchests only?

    Edit- I looked in the source, and gave everyone the permission

    Last edited Oct 01, 2014 by PocketMines: Figured it out :D
  • Avatar of SuperEPF SuperEPF Sep 21, 2014 at 12:34 UTC - 0 likes

    I need help asap. I want players to have same inventories for some worlds,while separate for others. Help me please!

    P.S. Sorry for my english....

    Update: I tried connecting worlds in groups.yml but it wont work. The problem is my main world is called "randm world" with a space... Help me please..... I want to connect randm world, the end, the nether, wild and survival worlds Thanks ahead :)

    Last edited Sep 21, 2014 by SuperEPF: Update
  • Avatar of GodsDead GodsDead Sep 15, 2014 at 12:45 UTC - 0 likes

    @Tux2: Go

    Cool, what causes the inventory to load momentarily then get wiped? This is why I had to disable and wait for a fix before I can use on a live server.

    Shouldn't inventory get written to the players data every time a change is made!?

    All players on my survival map will play 90% of the time on the main map, so they wont change map, only 3 of us have OP to GM1, which leaves all logic up to when they log in. As its an existing server, It cant check the world group as its the first time they have logged in using multiinv.

    I only used the plugin for less than 5 hours, and we had duplication and inventory wipes, Im not sure what other information I can give you to try and get this fixed, Its not because im running Spigot 1.7.10 is it?

  • Avatar of Tux2 Tux2 Sep 13, 2014 at 19:47 UTC - 0 likes

    @GodsDead: Go

    Here's how MultiInv works:
    Player changes worlds-> Are the worlds in the same group?
    Yes: Save player's current inventory, load inventory of new group
    No: Does nothing

    Player logs in:
    Is player in the same world group he logged out in?
    Yes: Do nothing
    No: Save current inventory to group he logged out in, load inventory of new group

    Player changes game mode:
    Swap game mode inventories for this player?
    Yes: Saves current inventory to the previous game mode -> load last inventory for new game mode
    No: Do nothing

    Last edited Sep 13, 2014 by Tux2: formatting
  • Avatar of GodsDead GodsDead Sep 12, 2014 at 10:12 UTC - 0 likes

    @Tux2: Go

    I wouldn't be 100% sure on that, we have quite a few crashes due to a our mysql host going down a lot recently, but that's another problem and have never had inventory problems before. It was both unlucky that a crash happened while it was in the beta-test period, I actually trailed it on my dev server before hand with no issues, then again it never died on me! But it was a blessing as I only had to search through 17 UUID's to replace their inventory instead of resorting 10k+! So sadly this is an issue with Multiinv, Im itching to get this plugin working without issue.

    Save wise, That sounds a little dangerous, Im a little confused still on when saves happen for players inventory & Ender chests/Gm change. Is everything kept in temp until a world change? Because I never did a world change while I was trialing this plugin, my player that lost his inv did at one point to the End which is in the same group as my main world. Should saves not happen every 5 mins or so anyway? And there be an inventory history & restore function just in case? Most players keep all their valuable items on them.

  • Avatar of Tux2 Tux2 Sep 12, 2014 at 01:09 UTC - 1 like

    @GodsDead: Go

    Wow, talk about unfortunate... however that would have happened with or without my plugin, as I only save/restore the inventories when you change world groups, so the duplication and wipes was actually due to Minecraft not saving the inventory before the crash, which really isn't the fault of the plugin.


Date created
Aug 26, 2011
Last update
Jul 05, 2014
Development stage
  • enUS
GNU General Public License version 3 (GPLv3)
Curse link
Recent files
  • R: v3.3.0 for CB 1.7.9-R0.1 Jul 05, 2014
  • R: v3.2.9 for CB 1.7.9-R0.1 Jun 22, 2014
  • R: v3.2.8 for CB 1.7.9-R0.1 Jun 15, 2014
  • R: v3.2.7 for CB 1.6.4-R2.0 Dec 16, 2013
  • R: v3.2.6 for 1.6.2 Jul 05, 2013