RestockIt
RestockIt
Note about Permissions
If Restockit has suddenly broken for you with 1.9.1, check the permissions and release notes below - OLD deprecated permissions (not used for 1.5 years) have been removed!
The restockit.chest.* permission has now been deprecated - see below! It still works, but will likely eventually cause issues (such as what I just mentioned)
About
RestockIt allows you to fill chests, trapped chests, hoppers, droppers and dispensers (plus whatever other containers you want to add) with infinite items, or with gradually refilling items.
It supports PermissionsEX and SuperPerms, with separate permissions for creating RestockIt chests and RestockIt dispensers.
If you don't use PEX or SuperPerms, RestockIt will automatically detect this and only allow ops to create RestockIt chests or dispensers.
RestockIt also has a blacklist, so you can prevent the use of dangerous or expensive items.
There is a major update in the works, which is an almost full rewrite; this will include things like enchantments, different items in one chest and more. I don't have an ETA for it, so the best I can give is "eventually" - I don't want to give a date to avoid disappointment.
How to use
To create a RestockIt container, create a sign above or below the chest/dispenser/whatever with the following syntax:
line 1: Anything
line 2: RestockIt
line 3: Item number or name
line 4: Delayed Restocking Information OR Anything
One sign is required per ccontainer, double chests only require one sign. However, if you place a sign above each half of the double chest, with different items on each, the double chest will be filled half-and-half with each item.
Additional Features
- As well as item ID numbers, internal Minecraft names can also be used, for example: stone or trapped_chest
- Items with damage values are fully supported, for example Lime Green Wool would be written as WOOL:5 or 35:5
- You can also use RestockIt as an Incinerator - just put Incinerator on line 3.
- Dispensers will automatically re-stock themselves whenever they are triggered - you don't need to open them.
- RestockIt supports Full Chest syntax as well as its own, so you don't have to re-sign all of your chests if you used to use Full Chest.
- To use delayed restocking, set the 4th line to:
- x Items, ys - this will restock one item every y seconds, until there are x items in the chest. (Alternate: xi,ys)
- x Stacks, ys - this will restock one item every y seconds, until there are x stacks in the chest. (Alternate: xs,ys)
- Rather than specifying time in seconds, you can specify it in ticks (20ths of a second), by not typing an s after the time.
- Remember to put a comma between the number of items and the delay, or it won't work.
- If you don't want to use delayed restocking, leave line 4 blank, or put anything you want in it.
- To use the blacklist, simply add items (number or capitalised name, just like on a sign) to the config.yml file in the RestockIt folder.
- Bedrock and TNT are blacklisted by default - you can remove these if you want.
- To add additional containers to fill, add items to the "singleContainers", "doubleContainers" or "dispensers" list in config.yml - they should be fairly self-explanatory.
- Unless there's a container you specifically want to use, I'd recommend leaving these alone.
Permissions
Permissions for PEX and SuperPerms are:
- restockit.container.create
- restockit.container.open
- restockit.container.destroy
- restockit.dispenser.create
- restockit.dispenser.open
- restockit.dispenser.destroy
- restockit.incinerator.create
- restockit.incinerator.open
- restockit.incinerator.destroy
- restockit.blacklist.bypass
Remember, you don't need PEX or SuperPerms to use RestockIt - It will automatically use op status if you don't have PEX.
Without a permissions plugin, *.open defaults to everyone, *.create and *.destroy default to ops, and restockit.blacklist.bypass defaults to nobody.
Also, you can use the opsOverrideBlacklist setting (set it to true) in the config.yml to allow ops to bypass the blacklist. (This is only really useful if you're not using a permissions system)
Planned Features
- A way to control how many items a chest can accept being put into it
- Ability to save current chest inventory, and restock that
- A system of accessing a main chest from multiple other "slave" chests
New to 1.9.2/3
- Fixed issue with deprecated permission detection for the blacklist
- RestockIt (hopefully) now works with Java 1.6
- Fixed exception when checking permissions under certain circumstances
Sorry for the rapid updates!
New to 1.9.1:
- [Bugfix] Permissions now work properly with new containers
- OLD deprecated permissions have been REMOVED
- New permission restockit.container.(create|destroy|open)
- Permission restockit.chest.* has been DEPRECATED (still works, but please change it...)
New to 1.9:
- Any container can now be used (set in config.yml)
- Trapped chests, droppers and hoppers now supported out of the box
- Items on signs no longer have to be all upper case
- General code cleanup (see GitHub if interested)
You can download Restockit from the button at the top right of this page.
The latest build is available at a wget-friendly link: http://dev.bukkit.org/media/files/768/478/RestockIt.jar
Source is available at https://github.com/xCP23x/RestockIt
RestockIt is open source, and uses the GNU GPL v2 license.
Special thanks go to Scott Marshall for code contributions and debug help.
@ixionforte
Does it still work on modern servers?
Unfortunately RestockIt is somewhat discontinued now - I may update it if it's broken (please let me know!), but I don't really have the time for new features any more.
I really hope this gets an update soon. You have no idea how important this plugin is to some servers.
Do you know if this breaks in spigot 1.8?
@maxx0107
yee :)
i need a plugin which fills what is in there already like not the whole chest filled.
Can you put multiple items on one sign? I would like to create an inventory chest for my pvp arena with complete armor....
@Xikage
Restockit should work with any permission system that uses SuperPerms.
@xCP23x Hey, nice plugin, but in the next update, could you possibly add custom item & firework restocking? Like, for example, if you had a stick with a custom name and enchantments, you could make a feature where you do something like "/restockit export" where it saves the customised item to a file or SQl db maybe, then gives you like a #<n> at the end, for example, let's say I had a stick with sharpness I called bob, and I wanted to restockit. I would do /restockit export, then it would say something along the lines of "'bob' exported! Use STICK#1 to restock!"
and the config would look something like:
customitems: &6bob: enchantments=sharpness:1 id:1
@Xikage
Hi, sorry for the slow response, been REALLY busy recently.
I've got a few months off in 2 or 3 weeks, so will put a lot of time into rewriting RestockIt from the ground up to add lots of new features. I'll certainly consider other permissions systems, and will look into it closer to the time.
Thanks
Could we get support for other permission plugins, like YAPP?
@SuperClift1
the dev build works :P
Please update to 1.4.7 !
@RyuKazuki
Ok, that seems to be the same problem that andrewabosh was getting, I'll take a look into that.
Thanks for reporting it.
Every time I type in the item name, regardless of case, I get the 6th error telling me it's not a valid item name. When I type in the number it works fine.
@jag3498
If possible, do you know the situation in which this was happening, as it looks like it occurs when a player tries to open a chest. Eg, chest layout, text on sign, etc. I'll try to take a look into the code to see what could cause this, but more information would make things much easier, if you can.
Thanks.
@deleted_10267026 Hmm... Can you type in exactly what you put on the sign? Remember that DIAMOND has to be in capitals. It should be something like this:
RestockIt DIAMOND 27s,90s
That should fill a single chest (replace 27 with 54 for a double) with diamonds If it doesn't work, reply and I'll look further into it
I am getting strange restock it related errors. Any one have any ideas why? Paste Bin Link
I get diamond is not a valid item... Please help i want it to restock every 90 seconds with 1 diamond. and it dosent add to 2 diamonds just stays at one...
@MysticGohan33
Aah, I should have been more explicit. The effects placed on fireworks use the same system as enchantments, so without enchantment support, RestockIt won't work with fireworks yet.
Oh, and the thing about making a RestockIt container based on what's inside it is also planned for RI2.
@xCP23x
I said Fireworks not enchantments you silly goose. Maybe make it so the item in the dispenser is the invincible one then you just do a command while looking at it to make it that item then it would work