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 or forgot to deny yourself the permission multiinv.exempt!

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

Video Tutorial


  • 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.

Using MultiInv with BungeeCord

Since BungeeCord requires servers to be in offline mode it's sometimes hard to acquire a reliable UUID if Spigot/BungeeCord isn't configured correctly. Here are the settings you will need to change:
In the BungeeCord config.yml make sure ip_forward is set to true
On the server in the spigot.yml make sure bungeecord is set to true
By setting these two options BungeeCord will be able to pass the correct UUID to the servers. Please note that if you are sharing inventories across multiple servers that this feature is still in beta and may not always work.


  • /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 mcimport - Import Minecraft player files into MultiInv. (Only useful when you've got existing player data and you are enabling the SaveInventoryOnQuit option)
  • /multiinv mcexport - Exports MultiInv player data for the default world into the default world in Minecraft format.


  • 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.mcimport - Permission to use the mcimport command
  • multiinv.mcexport - Permission to use the mcexport 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 EvlCreeperReaper EvlCreeperReaper Jun 05, 2016 at 13:16 UTC - 0 likes

    I know everyone below's already said this, just trying to emphasize the necessity. :P I get the same issue with changing worlds as wrecktify80 below, and it completely breaks my server. I can't upgrade without this plugin, so...yeah! 1.9.4 support please!

    >>> The Medius Network <<<

    Coming soon, to a server list near you.

  • Avatar of FabTheZen FabTheZen May 25, 2016 at 00:53 UTC - 1 like

    @wrecktify80: Go

    Can confirm, 1.9.4 basically "breaks" the plugin. :(

  • Avatar of wrecktify80 wrecktify80 May 18, 2016 at 04:17 UTC - 3 likes

    Error on 1.9.4. when changing worlds

    Also when switching to /gm 1 and /gm 0 the inventory doesnt change even though I have that setting on

    Last edited May 18, 2016 by wrecktify80
  • Avatar of reezhu reezhu May 18, 2016 at 02:27 UTC - 0 likes

    Hello, I'm a developer and try to make use of your plugin to serialize the itemstack, but when I enable the sql, I can't get the "writen_book" from the string. And the table of "multiinv_bools" is empty. May I know where did the "book_hash.yml" go when using sql?

  • Avatar of Azfaloth Azfaloth May 09, 2016 at 04:11 UTC - 1 like

    can we please have an update for the Shield pattern saving and tipped arrows? That would really be perfect. Thanks for the plugin and keeping it updated to 1.9. :)

  • Avatar of Androkai Androkai Apr 06, 2016 at 13:46 UTC - 0 likes

    With Jenkins-build #74 potions loses there effect at reconnect. - Minecraft in familiärer Atmosphäre genießen

  • Avatar of spetznack spetznack Apr 05, 2016 at 22:56 UTC - 0 likes

    @Bobdanielt6: Go

    Take a backup of your server to test with and just try different things. I have never done it so I can't say I know how to, but it makes sense that you only need to have Multiverse-Inventories installed so that it has a database somewhere in for example /plugins/Multiverse-Inventory folder. Perhaps you need both plugins running at the time you do /multiinv mvimport - in that case you should remove Multiverse-Inventory.jar file after you have finished the /multiinv mvimport

    Good luck ^^

    Last edited Apr 05, 2016 by spetznack
  • Avatar of Bobdanielt6 Bobdanielt6 Mar 31, 2016 at 17:22 UTC - 0 likes

    If I want to convert my server from Multiverse-Inventories to MultiInv does anyone have any suggestions? I understand there is /multiinv miimport but do I have both plugins on the server at the same time? Anything else I need to do to try to have a seamless transfer?

    Thanks in advance

  • Avatar of McPixel McPixel Mar 31, 2016 at 01:06 UTC - 0 likes

    Found bug on version 3.3.6 im using latest 1.9.2 spigot

  • Avatar of AdamTragedy AdamTragedy Mar 26, 2016 at 17:28 UTC - 0 likes

    Dupe glitch in 1.9


Date created
Aug 26, 2011
Last update
Mar 02, 2016
Development stage
  • enUS
GNU General Public License version 3 (GPLv3)
Curse link
Reverse relationships
Recent files