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.
@rwmtiger
Sorry, I don't understand what you're asking - could you try rephrasing it?
@MysticGohan33
Sorry, that would require support for enchantments, which will be in RestockIt 2. Unfortunately I don't have an ETA for that yet.
Can you make it so we can use our own custom fireworks in the dispenser? That would be really nice for a fireworks show!
can you add restock item that just in the chest only. i want to have power to give handbook out to player. as far what the plugin go. it seem to work really well!
@Kitten_Tails
It should work with 1.4.6, I'll probably test that today if I get a chance, but I see no reason why it wouldn't. As for fireworks, I'm not sure how they differentiate themselves - if they use damage values, they'll work, if they use enchantments, they won't (although enchantments are on the list of things to add to the next version of RestockIt).
I'll edit this post when I've tested it.
EDIT: Ok, there seem to be some isses with Restockit 1.8.3 in MC 1.4.6 relating to delayed chests, I'll look into them and release an update when it's fixed. Regular full chests appear to work fine though.
Edit 2: I've (hopefully) fixed the bug to do with delayed chests, I'll upload this fix as a beta version of RestockIt now. Once I've got confirmation that it works, I'll set it as the stable version.
I've looked into fireworks, and they don't use damage values, so won't work in the current version of RestockIt. RestockIt 2 will most likely support these though, but I don't have an ETA for that yet.
Looks great! Will it work with 1.4.6? I want to make an infinite firework display!
Meow. :3
this plugin is excellent, thanks man!
thank you for this plugin, seems to work fine with 1.4.2 :)
Lou
Amazing plugin, used it since the start of my server and the creator just lost the game.
Awesome plugin! :D
@mamemame187
Yes, RestockIt supports any permissions plugin that works with Bukkit's SuperPerms, this includes bPermissions.
Hi xCP its mame. May I ask if it supprts other plugins for perms like bPermissions? Thanks, mame
@lol768:
Yeah, I don't see why not... I'm currently on holiday, so will look into it when I get back. I'm working on a massive update for RestockIt, hence the lack of recent updates, so I'll probably add ender chest support too that once I think of something to do with them.
-xCP23x
EDIT: Fixed formatting issue.
Ender chest support?
@xCP23x kk ty ill try that nao :)
@graner18
Minecraft uses the network ID of the mob as the damage value for the mob egg - You can get these from the Minecraft Wiki. For example, a creeper has network ID 50, so a creeper egg would be 383:50. AFAIK, there's no mob with ID 3.
Hope this helps.
Hey, It doesn't work when i try to spawn mobs :s i put 1: Anything 2: RestockIt 3: 383:3 or 4 idk 4: nothing here
What do i put?
@xCP23x
Thank you! It is working now!
@KyleBoyer
By the looks of things, you're using an older version of Java than I compiled RestockIt for. I usually compile for JRE6, but it seems that the latest version has been compiled for JRE7. I'll re-compile and upload it now, thanks for reporting this.
EDIT: Done, Restockit 1.8.2-JRE6 is now available