LinkedChest
LinkedChest
Download
Latest LinkedChest Version 1.4.1 (Support DevBuild 1.6.4-R0.1) is available here.
Talk about this plugin on Bukkit Forums
Watch the source code of LinkedChest on GitHub.
Description
- This plugin allows to link chests together.
- You can link normal and trapped chests.
- Master trapped chests will generate current, but not Linked trapped chests.
- This is NOT an "Ender-chest" plugin, as the Linked Chests are community chests.
- A command is used to create a master chest, then, use a the link command to link another chest to a master chest.
- You wont be able to destroy a master chest, unless you remove it with the REMOVE command.
- Master chests are protected against explosions. Linked chests are not protected at all.
- You wont be able to place a chest near a simple master chest. Place it before adding the master chest.
- Double master chests seems to not work in versions older than 1.2.3 of Craftbukkit.
- Master chests and linked chests can be placed in separate worlds.
- You wont be able to place a chest near a simple master chest. Place it before adding the master chest.
- Double master chests seems to not work in versions older than 1.2.3 of Craftbukkit.
- You cannot open linked or master chests if a block is in hand, to avoid a conflict with the shift-click.
- You can easily move a master chest while keeping all linked chests. You can even move a single master chest to a double master chest and vice versa.
How to install
- Only put the "LinkedChest-x.x.x.jar" file in your plugins directory, inside the minecraft server directory.
- At the first run, the directory "LinkedChest" will be created, with the default configuration file "configuration.properties". You can also used provided sample files.
- Place in the "LinkedChest" directory the "message_xx.properties" file corresponding to the language configured in the configuration file.
- Without any messages files, or with a default messages configuration, there will be internal default English messages which will be used ingame.
- Plugin data is stored in the files "masterchest.properties" and "linkedchest.properties".
- The first file contains chest names, their locations and options.
- The second file contains the linked chest locations, and master chests names.
You will find an archive file named "resources.zip" with some sample files, like configuration file and messages files.
Sample of messages file : messages_en.properties
Sample of default configuration file : configuration.properties
How to configure
Fill the configuration file configuration.properties as you want, using these parameters:
- debug: Values (true|false) -> Enable/Disable the debug mode. (There is barely no debug messages for now)
- language: Values (language code) -> Select the messages file corresponding to this configuration.
- usepermissions: Values (true|false) -> Enable permissions (PermissionsBukkit, PermissionsEx and Native Bukkit's Permissions system are supported).
- saveallperiod: Values (number of minutes between 2 reload or "disabled") -> Enabled forcing save-all command when a linked/master chest is closed, or when there is a plugins /reload. This configuration can be necessary if players are complaining about stuff which disappear. It should not occur as it was an old bug but laggy players may encounter this bug.
Multilanguage messages
- You can choose the language of displayed messages ingame.
- Only put a language code in the language configuration and get or make the corresponding messages file.
- For example, with a configuration "language=en", you have to use a file named "messages_en.properties".
- You must let the messages variables inside braces "{}" to let the plugin replace them by dynamic parameters, as chest names.
- Messages variables names does not matter. It is based on variables order.
- You can also use messages file in UTF-8 encoding. Just enable it in the configuration: useutf8=true.
Permissions Nodes
Supported permissions managers: BukkitPermissions, PermissionEX and native Bukkit Permissions. Native Bukkit permissions manager will be used by default if permissions are enabled (in the configuration file) and if both supported Permissions plugins are missing. If one of Permissions plugins is found, the LinkedChest plugin will try to load them, if it is not already the case. Then it will be used to manage permissions.
Commands permissions:
- linkedchest.add
- linkedchest.adminchest
- linkedchest.aliases
- linkedchest.config
- linkedchest.details
- linkedchest.help
- linkedchest.link
- linkedchest.list
- linkedchest.move
- linkedchest.openremote
- linkedchest.positions
- linkedchest.remove
- linkedchest.unlink
- linkedchest.version
Actions permissions:
- linkedchest.openadminchest
- linkedchest.openmasterchest
- linkedchest.openlinkedchest
How to use
This plugin use the main command /linkedchest. Available aliases: /lc, /lchest, /linkchest. All configuration and data updates are automatically saved.
Following commands use parameters. <c> = command, <n> = chest name, <o> = options, <p> = config param, <v> = config value, <r> = researched letters
For admins by default:
- /lc add <n> <o> : add a master chest using the chest targeted. Only "a" option is available, to make an admin-only chest
- /lc admin <n> : toggle the admin status of the given chest
- /lc config <p> <v> : display the current config or update a configuration parameter. Boolean parameters can be toggle if no value is typed.
- /lc link <n> : link the targeted chest to a master chest
- /lc move <n> : move the given master chest to the targeted chest. The target chest must be empty and must be able to contain all items from the chosen master chest. Does not unlink the master chest if it was previously linked.master chest if it was previously linked. Linked chests to the moved master chest remain linked.
- /lc open : remotely open a chest
- /lc positions <n> : list all linked chests positions of the chosen master chest. Double linked chests will appear twice for each part of the double chest.
- /lc remove <n> : remove a master chest
- /lc unlink (<n>) : unlink the targeted chest or all chests of the given master chests
For users by default:
- /lc alias <c> : display the aliases of the given command
- /lc details <n> : display the details of the given chest
- /lc help <c> : display general help without parameter and the help message of the given command
- /lc list <r>: display chests list or only chests which start with letters in <r> (use empty parameter or * to display all chests)
- /lc version : display plugin version
Planned features
- Add a command to teleport to master (maybe)
- Requests ?
Changelogs
See the Changelogs page.
Known bugs
- If you cannot use commands on a chest surrounded by snow (or other transparent block) try to use commands by being on top of the chest and by targeting it from above.
- If you play with a Bukkit version less than 1.2, double chests won't work properly with my plugin. You will be able to make single master chests only.
- NEW: This problem should be fixed since the version 1.2.4 of LinkedChest. OLD: A very strange problem appears when you create a master chest in a new area (new chunks) and link a chest to this master chest. Then add some items trough the linked chest. Then /reload the plugins. The actions done on the linked chest are not taken into account and items added or removed are not saved. To avoid this problem, use /save-all command to force the inventory to be saved. Then, if you /reload the plugins, actions on linked chests should be correctly saved.
Problem with saving files
- If you encounter some problems with saving file, for instance the data file (masterchest.properties or linkedchest.properties) or the configuration file (linkedchest.config).
- If you know how to change the rights of these files (using chmod) do it and make to 777 to avoid problems.
- If you don't know of to modify files rights, just copy the file content somewhere, or move the files from the plugin directory (LinkedChest). Reload the plugin which make it recreate these files with full "rights" on these files. Then, paste the content previously copied in these new files.
- The sample files have been created on windows so they could have restricted rights which could prevent the plugin to modify them.
In case of Emergency
Break the glass ! And open a ticket here. Please provide debug logs by enabling it with the debug configuration or enabling it ingame with the right command.
My custom version for 1.13.1
getTargetPlayer was throwing exception when using /lc link or add ...
http://funwithfriends.fr/LinkedChest1.5.jar
Just the plugin I needed on my server! Guess what! It works on 1.8.7!
Thank you for this plugin!
Is there a way you can turn off the unlimited items in chest and just refill them
Thanks Ghomerr
@trickyrockslayer
I've checked it very fast recently and it seemed to work except that my masterchest files may have been reseted (but it could be a mistake I've made previously).
So, if you upgrade to bukkit 1.7.x, may sure you have made a backup of the plugin files to restore them if it's needed.
Otherwise, the plugin seems to work fine. I will see if I can find the time (and the motivation) to make a proper update soon.
Can you update this to 1.7.2? or if it works for 1.7.2 then say so.
@CommodoreAlpha
"Supported permissions managers: BukkitPermissions, PermissionEX and native Bukkit Permissions."
I don't think bPermissions is supported. If you can, just try and see if it worked.
Does the plugin support "bPermissions"?
@TfT_02
It's done in the version 1.3.6! The message which says that you cannot open a linked chest with a block in hand is also managed by this new configuration.
@TfT_02
Yes, sure. I will try to add it to the next version.
@jmartin657
Hi. I was working on it but there are so many problems to manage that this is very long to do. I don't know if I could make it work at the end.
Just an example, it is hardly impossible to make a linked chest sends items through a hopper, because the inventory of a linked chest is the inventory of its master chest and not its own inventory. So, the hopper does not receive items events from a source linked chest.
This is also very hard to manage "permissions" through hoppers because events are done in several sequences (items from the source chest to the hopper inventory, then from the hopper inventory to the destination chest: it means, I have to keep the track of who placed the hopper and where the items go.... This is even harder with hoppers in minecarts...)
So, I don't know if I will manage to make hoppers work with this plugin. Moreover, I have no more internet at my home... Very hard to work so.
However, I will keep on trying to make it work !
I realize this will probably never happen but... if you could make hoppers work with linked chests you would be a freaking hero :P
Great work on this plugin, one of the most useful plugins on our server
@KoottaHigure
Hello. Absolutely not. Please provide sever logs in debug mode enabled, it will help. Thanks.
I'm having an issue where Linked Chest won't open. They say they're opening but they never do. Any idea what's going on?
Someone on my server experienced an old issue regarding rollback of some chest inventories. However, he is the only one who get this problem.
Does anybody else has encountered this kind of problem since the latest version ?
I may add a chest inventory logging to track this bug in the next versions.
@Phonix420
Since the version 1.1, signs are not more used to link chests together. You can place signs near linked chests but this does not affect the plugin anymore.
However, the plugin does not permit to directly place signs on chests. So, it is not possible to do. You may try to use WorldEdit to place signs on chests (using copy paste to put a sign on a chest)
Anyways, thank you for using my plugin :)
Great plugin, absolutely love it!
Is it still possible to place a sign on a master chest? I'm having trouble doing so.
@proEndreeper
Someone had already suggested it but I thought I had done the modification on my side to allow other plugins to cancel the open event of a chest which is not permitted by the plugin. When my plugin checks if the player can open a master chest, it checks if the event has been cancelled before.
So if the lockette plugin works, it should cancel the event when the permissions is verified and not given to the current player.
However, I don't know these plugins and how they work. I don't have much time to make heavy developments this time, but I will check how it could be possible. But I think I would not have to do something in my plugin if these chest plugins cancelled correctly the event when the permissions is denied.
I think there should be support for lockette, lwc and other chest lock plugins, as if you open it when a lockette sign is attached it says that you don't have permission while allowing you to see the master chest's contents
@Intangir
Hi. You should try on the request plugin topic on the bukkit forums: http://forums.bukkit.org/forums/plugin-requests.13/
Regarding your request, what you need is a regular single chest, with the texture and the durability on the ender chest with the ability to place them next to other chests, am I right ? In this case, I think it could be done with a plugin. The local inventory will be the hardest thing to manage but this is realizable.