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.
this is unrelated but i wonder if you might have the knowledge of wether something like this is possible:
I want to make it so that enderchests are no longer linked to only your own private stash, but instead treats it like any other regular chest, where it has local inventory. except i want them to be placable side by side without linking, and also as obsidian it is harder to break
do you think that is possible?
Awesome plugin thanks for making this! :D
@Sk8Sanctified
Actually, it should work. I've tried it between Overworld and Nether and it was fine. Never tested it between different worlds but it should be OK.
And you're right ! I've not written here that the plugin works for chests linked from different worlds. I'm gonna fix it !
Thank you for using my plugin ;) Have fun !
@Ghomerr
Oh no that's fine with me, I was just wondering if all players can see the linked chest.
That's perfect! I would like to remove enderchest from PvP on my server because it's to easy to keep valuables stashed in them and not be able to have them stolen. Since enderchest are personal.
This is an awesome alternative with the removal of enderchest. That way players are able to transfer items from a PvE world to a PvP world. Yet still risk the chance of their items being stolen... Wait, can you use the linked chest in a separate world from the master chest? I apologize if you stated this somewhere in the plugin description. I scanned through it rather quickly :/
looks cool :)
@Sk8Sanctified
Yes, they can open any linked chests (if the players have the right permissions and if the chest is not an "admin" chest, only "openable" by admins).
Then linked chests are not "private" chests, like the ender chests. The concept of the linked chests is to provide community chests accessible from everywhere on the map to offer the possibility to share materials and items from far locations.
Someone had suggested to add the ability to create a linked chest only accessible for the player who made it. But I think it would tend to be a "personal" chest instead of a real linked chest. There are already many plugins which offer this ability, so I think I won't add this feature in this plugin.
@RulingKyle1496 @Ghomerr
Can players take items out of a linked chest that isn't theirs? Would be a great alternative for the enderchest on a multiworld server with PvP and PvE worlds.
Players can stash goods in enderchest for PvP worlds because they have individual store data per player. Which makes enderchest lame for PvP and raiding sucks. However, I really like the idea of players from PvE using the chest to get a foothold in PvP if they started out in PvE.
@RulingKyle1496
And when that's full? You can have people buy these :D
@RulingKyle1496
Well, what ? Do you know what "a sentence" is ?
ender-chest
No worries was worth asking :) I have the master chest sat next to a multi-page chest and just transfer items manually, still a very useful plugin.
Ash.
@pugsx
Uh, I see. Actually, I think the "multi-pages chest" is a new block introduced by this mod. This won't work with a Bukkit plugin as this new block is unknown from the Bukkit side.
So it can't be detected as a chest when you want to open it. Sorry :(
Sorry for late reply, didnt notice your message, I have both installed but when I try i get target block is not a chest.
Ash
@pugsx
Did you try to use both ? Did it work ?
This plugin only allow "linked" chests to open the inventory of their master chest. I think if you set multi pages on a master chest, the linked chests will open the master chest multi-paged inventory !
Would it be possible to get this plugin to work with the multi page chest mod?
so we can have many chests linked to one master chest.
Ash
Ok... I haven't enabled the subscriptions (notifications) on my other plugins. I received only those of TravelGates !
It's fixed now and I won't do the same mistake for my future plugins.
The mod LinkedChest bypasses Secure Chests http://dev.bukkit.org/server-mods/secure-chests/ I have left a comment there stating the same. I am not sure how I can get these mods to play nice.
How can I make it so only people with permissions can open a certain chest.
Hi, can you add numbers of max links to config file?