Bukkit

InventoryHelperExtened

Current version: InventoryHelperExtended-0.0.30
Supports actually: 1.7.2-R0.3 and 1.7.9-R0.1
Depends: BKCommonLib
Softdepend: MyWorlds, Multiverse-Core

The lost Inventory!

For three weeks I and many other players inventory was deleted without some reason. Now we wanted to recreate it back over the plugin Inventory Helper but ... Oh NO! It only saves inventories issued by the command /isave and als it dosn't save the contents from the enderchest. And so I have had many days to recreate over 30 Inventories and Endechests over NBTExplorer.

After it was done, I decided to contact the owner from Inventory Helper but doesn't got any answere to my questions and now I've created the Extended version as Inventory Helper Extended with some new features and how thougt it withdifferent source :).

Here is a samll overview between Inventory Helper and Inventory Helper Extended:

So finaly thougt this was a good idea and know here it is ... my first Plugin!

Before You install this Plugin ...

Well, know you think: "Wow, how can I install it?" My answere: "If youhave installed the depended Plugins!"

Here is the list of (soft)depended Plugins marked bold if it's requiered, otherwise it's optional:

• BKCommanLib
• MyWorlds or Multiverse-Core

BKCommonLib is required if you are useing MyWorlds or another Plugin which manges multiple worlds to create the needed folder structure.

MyWorlds or Multiverse-Core not needed but marked as softdepend because my Plugin uses as storagelocation the world on which you logout or issued the save command.

Here are afolder structure if you are using MyWorld:

save/ (location: save; default see **Configuration** for more details)
    playername/
        worldsname/
            playersUUID.yml (containig the inventory and the enderchest contents)

Otherwise it will save all files under save/playerUID.yml !

NEW since v0.0.30

Now it will save the MD5 from each savefile under md5_save/MD5Storage.yml! Content looks like this:

plugins/InventoryHelperExtended/save/Chaoschaot234/world/xxxxx6f1d9ef-inv:
  yml: bdd1d1fa7adc8412bb2e3072ee3b1319
plugins/InventoryHelperExtended/save/FabianIXB/world/xxxxx96c84-inv:
  yml: 03f1354d33fc4f17d7653d0def6b5cd9

Installation

Simply download the InventoryHelperExtended-X.X.X.jar and put them into the servers plugin dir!
Please look at the supported Serverversion because support is only granted if the Plugin fits the supported Serverversions.

In addition here is a table with the Plugins version and supported Serverversions:

Configuration

The configuration is very simpl asthere actually exists only to values:

• locationInv: save (by default)
• locationMD5: md5_save (by default) NEW
• useSign: fals (by default)

First one declares the main save folder under the plugins homedir to store the YAML-Files. You can change this if you want. Secound one declares the main save folder under the MD5Storage.yml will be stored. You can change this if you want. Third one declares if you want to save/load the inventories over a special written sign which can also be locked/unlocked over command.

Releay simple, isn't it?

Permissions

Well, this plugin also has a few permissions which can be granted (actually not included!):

permissions:
    inventoryhelperextended.*:
        description: Allows access to all (sub)permissions.
        children:
            inventoryhelperextended.sign.*: true
            inventoryhelperextended.cmd.*: true
            inventoryhelperextended.admin.*: true
    
    inventoryhelperextended.sign.*:
        default: op
        description: Allows to save and load the inventory over a sign and also lock/unlock these signs.
        children:
            inventoryhelperextended.sign.save: true
            inventoryhelperextended.sign.load: true
            inventoryhelperextended.sign.unlock: true
    
    inventoryhelperextended.cmd.*:
        default: op
        dscription: Allows you to use a command to save/load your or a players inventory.
        children:
            inventoryhelperextended.cmd.save: true
            inventoryhelperextended.cmd.load: true
    
    inventoryhelperextended.admin.*:
        default: op
        description: Allows to make a full backup from the saved inventorys as tgz file or import one.
        children:
            inventoryhelperextended.admin.backup: true
            inventoryhelperextended.admin.import: true

Commands

Because the first release only supports automated save on the PlayerQuitEvent there are no commands to describe (but they are exists in the source ;) ).

Planned fetaures

• Save/Load over Signs (under construction)
• Load over PlayerJoinEvent (under construction)
• Backup/Import stored saves
• Commands to save/load inventories and enderchests and also backup/import stored savefiles.

Credits

At this point I'll give some credits to useres which helpe me by problems or other things:

• SpaceManiac - for the codesnipet to store the Items in a configuration file (Source))
• timtower and tobiyas - solving getted errors
• Saladoc - helping me to get the code shrinked down and make the final jar shaded

Now enjoy the hole World of Minceraft (Bukkit), lost your inventory and enderchest contents and get them back over this Plugin! Feel also free to report bugs (full stractrace is required found in the servers logfile) and report feature wishes.

At last ... sorry if some sentence doesn't met the englisch grammer because my main language is german :).