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

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

    @Grant1204: Go

    Do you get any console output as it converts or does it just look like it's sitting there?

  • Avatar of Grant1204 Grant1204 Jan 24, 2015 at 19:25 UTC - 0 likes

    @Tux2: Go

    Build #44 is extremely slow at conversion. I left it running for 8 hours and it only converted 3,201 players' inventories. I wish there was a perm to bypass the whitelist as well; it doesn't use the current whitelist system.

    EDIT: Looking through the logs, I found out that it threw an error and stopped part of the way in...

    Last edited Jan 24, 2015 by Grant1204
  • Avatar of drumming102 drumming102 Jan 24, 2015 at 14:51 UTC - 0 likes

    Hey tux2 great work on the update.

    Having an issue. Our server "Unfortunately" auto restarted during our conversion. We have updated to 3-44 from your jenkins and attempted to change the UUIDGroups back to just Groups to force it to try to reconvert. It skips all those that converted just fine but when it gets to those still needing converted it throws this.

    I thought it was just us reaching our API limit but I waited 24 hrs and it's still doing it. Any ideas?

  • Avatar of Tux2 Tux2 Jan 24, 2015 at 02:30 UTC - 0 likes

    The newest development build of MultiInv on the Jenkins build server now has faster conversion of players to UUID from flatfile! It also fixes the server hangs by handling conversions in a separate thread. However please note that the plugin will not allow anyone to log into the server during the conversion process to prevent inventory loss. Please test this out and let me know if there is something I need to change.

    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: 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 Tux2 Tux2 Jan 24, 2015 at 01:10 UTC - 1 like

    @Gnat008: Go

    Make sure you have the latest version of MultiVerse-Inventories before importing.

    @_Mahagon: Go

    Spigot loves to do auto crash recovery. I'm investigating ways to do the import quickly, efficiently, and with no crashing in the future.

    @tilen1232: Go

    I understand what you're trying to do, but no, support for a world being in two groups will not be supported as it takes quite a bit of effort, although possible it is extremely hard to do. (Yes, I've done it before in a custom plugin)

    @Her_craving: Go

    Looking at your timings report and seeing the vast improvement in timings from Multiverse-Inventories to MultiInv you still have the audacity to call the plugin inefficient?!

    Yes, it seems it does have some lag when changing game modes in your timings report, however, when comparing it to Multiverse-Inventories using your timings reports it is still around 10x quicker than Multiverse-Inventories. I have poured quite a few hours into this plugin improving speed using methods such as data caching, prefetching, threads, and queued saving, which your report shows I have accomplished quite effectively as the timings reflect a much smaller footprint than the main competitor: Multiverse-Inventories.

    However, I have removed some debugging from the latest development build which may have been causing some lag in that event and you are more than welcome to try it to see if it improves the timings.

  • Avatar of Her_craving Her_craving Jan 24, 2015 at 00:21 UTC - 0 likes

    Yeah this plugin causes TPS lag. It's inefficient. Adam - Relentless CEO/Owner [IP:]


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