LinkedChest
下载
最新版 LinkedChest 1.4.1(支持 DevBuild 1.6.4-R0.1)可在此处获取。
在 Bukkit 论坛 讨论此插件。
在 GitHub 上查看 LinkedChest 的源代码。
描述
- 此插件允许将箱子链接在一起。
- 你可以链接普通箱子和陷阱箱子。
- 主陷阱箱子会生成电流,但已链接的陷阱箱子不会。
- 这不是一个“末影箱”插件,因为链接箱是公共箱。
- 使用命令创建主箱,然后使用链接命令将另一个箱子链接到主箱。
- 除非使用 REMOVE 命令移除,否则你无法破坏主箱。
- 主箱受爆炸保护。链接箱则完全不受保护。
- 你无法在主箱附近放置箱子。请在添加主箱之前放置它。
- 在 Craftbukkit 1.2.3 之前的版本中,双主箱似乎无法正常工作。
- 主箱和链接箱可以放置在不同的世界中。
- 你无法在主箱附近放置箱子。请在添加主箱之前放置它。
- 在 Craftbukkit 1.2.3 之前的版本中,双主箱似乎无法正常工作。
- 如果手中持有方块,你将无法打开链接箱或主箱,以避免与Shift点击发生冲突。
- 你可以轻松移动主箱而保留所有链接箱。你甚至可以将单个主箱变为双主箱,反之亦然。
安装方法
- 只需将“LinkedChest-x.x.x.jar”文件放入 minecraft 服务器目录内的 plugins 文件夹中。
- 首次运行时,将创建“LinkedChest”目录,其中包含默认配置文件“configuration.properties”。你也可以使用提供的示例文件。
- 将对应于配置文件中配置的语言的“message_xx.properties”文件放入“LinkedChest”目录中。
- 如果没有消息文件或使用默认消息配置,游戏内将使用内部默认的英文消息。
- 插件数据存储在“masterchest.properties”和“linkedchest.properties”文件中。
- 第一个文件包含箱子名称、它们的位置和选项。
- 第二个文件包含链接箱的位置和主箱的名称。
你会找到一个名为“resources.zip”的归档文件,其中包含一些示例文件,如配置文件和消息文件。
消息文件示例:messages_en.properties
默认配置文件示例:configuration.properties
配置方法
根据需要填写配置文件 configuration.properties,使用以下参数:
- debug:值(true|false)-> 启用/禁用调试模式。(目前几乎没有调试消息)
- language:值(语言代码)-> 选择与此配置对应的消息文件。
- usepermissions:值(true|false)-> 启用权限(支持 PermissionsBukkit、PermissionsEx 和本地 Bukkit 权限系统)。
- saveallperiod:值(两次重载之间的分钟数或“disabled”)-> 当链接/主箱关闭或插件 /reload 时强制保存-all 命令。如果玩家抱怨物品消失,可能需要此配置。由于这是一个旧 bug,通常不应发生,但卡顿的玩家可能会遇到此 bug。
多语言消息
- 你可以选择游戏中显示消息的语言。
- 只需在语言配置中输入语言代码,并获取或制作相应的消息文件。
- 例如,配置为“language=en”,你需要使用名为“messages_en.properties”的文件。
- 必须保留花括号“{}”内的消息变量,以便插件将其替换为动态参数,如箱子名称。
- 消息变量名称无关紧要。它是基于变量顺序的。
- 你还可以使用 UTF-8 编码的消息文件。只需在配置中启用它:useutf8=true。
权限节点
支持的权限管理器:BukkitPermissions、PermissionEX 和本地 Bukkit Permissions。如果启用了权限(在配置文件中)且缺少两个支持的权限插件,则将默认使用本地 Bukkit 权限管理器。如果找到一个权限插件,LinkedChest 插件将尝试加载它们(如果尚未加载)。然后它将用于管理权限。
命令权限:
- 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
操作权限:
- linkedchest.openadminchest
- linkedchest.openmasterchest
- linkedchest.openlinkedchest
使用方法
此插件使用主命令 /linkedchest。可用的别名:/lc, /lchest, /linkchest。所有配置和数据更新都会自动保存。
以下命令需要参数。<c> = 命令, <n> = 箱子名称, <o> = 选项, <p> = 配置参数, <v> = 配置值, <r> = 已研究的字母
默认管理员可用:
- /lc add <n> <o> :使用目标箱子添加一个主控箱。仅提供“a”选项,用于创建仅限管理员使用的箱子
- /lc admin <n> :切换指定箱子是否具备管理员状态
- /lc config <p> <v> :显示当前配置或更新配置参数。如果未输入值,布尔类型参数可以进行切换。
- /lc link <n> :将目标箱子链接到主控箱
- /lc move <n> :将指定的主控箱移动到目标箱子。目标箱子必须为空,且必须能够容纳所选主控箱中的所有物品。如果主控箱之前已链接,移动操作不会取消链接。移动到主控箱的链接箱子保持链接状态。
- /lc open :远程打开一个箱子
- /lc positions <n> :列出所选主控箱的所有链接箱子的位置。双击箱子(双格箱子)的每个部分会分别显示一次。
- /lc remove <n> :移除一个主控箱
- /lc unlink (<n>) :取消目标箱子或所有属于给定主控箱的箱子的链接
默认用户可用:
- /lc alias <c> :显示给定命令的别名
- /lc details <n> :显示给定箱子的详细信息
- /lc help <c> :显示不带参数的通用帮助以及给定命令的帮助信息
- /lc list <r>:显示箱子列表,或仅显示以 <r> 中字母开头的箱子(使用空参数或 * 来显示所有箱子)
- /lc version :显示插件版本
计划功能
更新日志
请参阅 更新日志页面。
已知问题
- 如果您无法对周围有雪(或其他透明方块)的箱子执行命令,请尝试站在箱子上方并从上方瞄准它来使用命令。
- 如果您使用的是低于 1.2 版本的 Bukkit,双击箱子将无法与我的插件正常工作。您将只能创建单个主控箱。
- NEW:此问题应在 LinkedChest 1.2.4 版本中得到修复。OLD:当您在一个新区域(新区块)创建主控箱并链接一个箱子到该主控箱时,会出现一个非常奇怪的问题。然后通过链接箱子添加一些物品。接着执行 /reload 重新加载插件。在链接箱子上进行的操作不会被记录,添加或移除的物品也不会被保存。为避免此问题,请使用 /save-all 命令强制保存库存。然后,如果您 /reload 重新加载插件,链接箱子上的操作应该会被正确保存。
文件保存问题
- 如果在保存文件时遇到问题,例如数据文件(masterchest.properties 或 linkedchest.properties)或配置文件(linkedchest.config)。
- 如果您知道如何更改这些文件的权限(使用 chmod),请将其设置为 777 以避免问题。
- 如果您不知道如何修改文件权限,只需将文件内容复制到某处,或将文件从插件目录(LinkedChest)中移出。重新加载插件,这将使其以完全“权限”重新创建这些文件。然后,将之前复制的内容粘贴到这些新文件中。
- 示例文件是在 Windows 上创建的,因此它们可能具有受限权限,从而阻止插件修改它们。
紧急情况处理
打破玻璃!并在 此处 提交工单。请通过启用 debug 配置或使用游戏内相应命令来启用调试日志,并提供调试日志。
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.
评论 0
登录后参与评分
还没有评论,来抢沙发吧