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 natallyk natallyk Jan 26, 2015 at 16:31 UTC - 0 likes

    @Tux2: Go

    Thank you for this! BTW - I am not sure what code you use for the conversion, just in case. There is an example of a UUIDFetcher that works. You would have to change one parameter though, to prevent response "429" from Mojang - change Thread.sleep(100L); to some larger delay, like 1000,

  • Avatar of Tux2 Tux2 Jan 26, 2015 at 15:34 UTC - 1 like

    @natallyk: Go

    I can see what's going on there. I'll see about getting a fix out for that.

    @_Mahagon: Go

    @natallyk: Go

    That is quite slow. I'll see about speeding up import in the next build. 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 natallyk natallyk Jan 26, 2015 at 09:13 UTC - 0 likes

    @_Mahagon: Go

    I agree, this is too slow. We gave up on the test server, we have more then 100k inventories. I wonder why is it so slow? As far as I understand, Mojang takes 600 requests per 10 minutes, 100 UUIDs per request. This is 60000 UUIDs per 10 minutes, not that slow.

  • Avatar of _Mahagon _Mahagon Jan 26, 2015 at 08:18 UTC - 0 likes

    @Tux2: Go


    Multiverse import seems to work now But its pretty slow :O it would take a view days to import. I tried it on a testserver It took 8 Hours to import 9000 players

    But there are still 15000 left Thats kind of a problem for me D:

    Brauhaus der Hoffnung

  • Avatar of natallyk natallyk Jan 25, 2015 at 21:50 UTC - 0 likes

    @Tux2: Go

    Thank you! There are no banners, as we are converting from 1.7.10 I am currently running the conversion using the latest Multiverse-inventories and build 45. It will take a while, but it certainly does something this time. It creates somehow 2 files for each player, I think. and just UUID.yml The is empty. Is it the idea? There also still errors in console for each player - what do they mean?

    EDIT: Judging by the number of files in Multiinv folder, approximately half of the inventories is converted (cannot yet test if it is done correctly), and half gives the error. So, again, what do those errors mean?

    Last edited Jan 25, 2015 by natallyk
  • Avatar of Tux2 Tux2 Jan 25, 2015 at 15:20 UTC - 0 likes

    @Grant1204: Go

    Thanks for the feedback. Please try the newest version and see if that fixes the issues.

    @natallyk: Go

    How many of those had banners? Try the newest build as there are more bug fixes. Also, make sure you are using the latest version of Multiverse-Inventories from their Jenkins.

    Last edited Jan 25, 2015 by Tux2
  • Avatar of natallyk natallyk Jan 25, 2015 at 09:03 UTC - 0 likes

    @Grant1204: Go Could you elaborate a bit on which inventories you had to delete? Thanks!

    EDIT: tried to run build 44. On import from multiverse I am getting a bunch of errors and nothing gets converted. Errors are like this - only for all 100k+ players

    Spigot 1.8, online mode, Multiverse-inventories 2.5

    What am I doing wrong?

    Last edited Jan 25, 2015 by natallyk
  • Avatar of Grant1204 Grant1204 Jan 24, 2015 at 20:27 UTC - 0 likes

    @drumming102: Go

    I've never gotten that far with all of my inventory files. I've maybe tried to convert files about 10 times over the past month. The entire system is extremely buggy, and takes hours when you have 14,145 players. I ran countless test runs on our beta server to try and get it to complete.

    EDIT: After deleting a bunch of inventories that were not neccessary, we finally got them all synced :D
    Everything seems to work now, but when it converted the files, all the world names were lowercased (breaking the groups). This was easily fixed by changing the groups.yml to include proper capitalization.

    Last edited Jan 25, 2015 by Grant1204 Main/

  • Avatar of drumming102 drumming102 Jan 24, 2015 at 20:20 UTC - 0 likes

    @Grant1204: Go

    Does it ever even say complete?

  • Avatar of Grant1204 Grant1204 Jan 24, 2015 at 20:01 UTC - 0 likes

    @drumming102: Go

    There's never any output. I get something like "No groups.yml, creating one." (Even if there is a groups.yml) when it starts then I just assume it's working. Until it says complete or throws an error. I refresh the directory to see how many files have been added also to see if it is done.


Date created
Aug 26, 2011
Last update
Jan 08, 2015
Development stage
  • enUS
GNU General Public License version 3 (GPLv3)
Curse link
Recent files
  • 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
  • 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