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

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 CountChaos CountChaos Sep 05, 2015 at 00:40 UTC - 0 likes

    I'm getting a problem where I change worlds but my inventory stays the same. I disabled multiinv.exempt, so that's not the problem. Checked a bunch of people for help, but no one knew what to do. Using Version 3.3.5 of Multiinv and Version 1.8.4-b6 of TuxTwoLib. here are the files.

    Last edited Sep 05, 2015 by CountChaos
    Name Size MD5
    Config.yml.txt 337 B b0cf3347f3b5...
    Groups.yml.txt 287 B e17c7994f93a...
  • Avatar of Bfitzy Bfitzy Sep 04, 2015 at 01:24 UTC - 0 likes

    For those of you having issues with 1.8.8: make sure you don't have the multiinv.exempt permission for yourself if you are testing it. For previous versions, that permission didn't affect me but now seems to be the reason why it was not working for me. I'm running git-spigot-0359393-9a17f01 (MC: 1.8.8). Hopefully this helps!

  • Avatar of _Mahagon _Mahagon Sep 02, 2015 at 15:53 UTC - 0 likes

    @Ethon6: Go

    TuxTwoLib needs to update not multiinv

    Brauhaus der Hoffnung

  • Avatar of Ethon6 Ethon6 Aug 28, 2015 at 05:05 UTC - 0 likes

    Please update to 1.8.8 bukkit/spigot!

  • Avatar of Ethon6 Ethon6 Aug 21, 2015 at 05:28 UTC - 0 likes

    you can put in plugin a seperate money?

  • Avatar of dmncpham dmncpham Jul 30, 2015 at 00:11 UTC - 0 likes

    Can you explain in detail how inventories are stored? When I check most of the inventories, they show all air, but in the game, they have different items.

  • Avatar of greeves12 greeves12 Jul 26, 2015 at 22:32 UTC - 0 likes

    @Telbaru: Go

    You should do it yourself

    Every donation keeps me motivated!

  • Avatar of Telbaru Telbaru Jul 11, 2015 at 20:56 UTC - 0 likes

    Can you compile your Plugin for Java 1.8 pls? - Der Bauserver für Groß und Klein

  • Avatar of kbalor kbalor Jul 11, 2015 at 09:58 UTC - 0 likes

    BUG?? So after disconnecting while a player is ingame in skywars then rejoins the server. Im using Skywars reloaded plugin.


    Last edited Jul 11, 2015 by kbalor
  • Avatar of HalestormXV HalestormXV Jul 03, 2015 at 16:22 UTC - 0 likes

    This plugin looks to be what I am looking for however I have not installed it just yet. I do have one question. Does this plugin have the capability to erase the inventory of a player when they are entering a world? For example a minigame world uses this plugin to store a separate inventory and everytime a player enters that minigame world their inventory is reset again so it is always empty.

    Does this plugin also remove equipped armor?


Date created
Aug 26, 2011
Last update
May 18, 2015
Development stage
  • enUS
GNU General Public License version 3 (GPLv3)
Curse link
Recent files
  • R: v3.3.5 for 1.8.1 May 18, 2015
  • R: v3.3.4 for 1.8.1 May 12, 2015
  • R: v3.3.3 for 1.8.1 May 04, 2015
  • A: v3.3.2-dev for 1.8.1 Jan 08, 2015
  • R: v3.3.1 for CB 1.7.9-R0.2 Dec 03, 2014