Locked Items - 可合成的上锁箱子

LockedItems 是一款独特的插件，它允许玩家合成并放置一种全新的方块——上锁的箱子。只有箱子的主人或被授权的玩家才能打开它，为物品存储提供了安全且便捷的解决方案。

💡版本选择

• 对于 Minecraft 1.8 服务器，请使用 LockedItems 1.7.4。
• 对于 Minecraft 1.9+ 服务器，请使用最新版本（至少 1.8.0）。
• 点击插件页面上的“Version History”可以下载历史版本。

🎮核心特性

• 可合成的上锁箱子：合成并放置一个全新的方块，无需使用钥匙或告示牌。
• 安全访问：只有箱子的主人以及拥有 lockeditems.lockedchest.openall 权限的玩家才能打开。
• 安全破坏：只有箱子的主人以及拥有 lockeditems.lockedchest.mineall 权限的玩家才能挖掘。
• 防爆保护：默认情况下，上锁的箱子不会被爆炸摧毁（可在配置中修改）。如果启用相关选项，箱子被破坏时会掉落内部所有物品。
• 漏斗保护：无法使用漏斗从上锁箱子中取出或放入物品。
• 双箱支持：可以像普通双箱一样，将两个上锁箱子并排放置以形成“双锁箱”。
• 权限管理：允许主人使用简单的命令授权或取消其他玩家打开特定箱子的权限。

针对 PvP 服务器

如果您运行的是 PvP 服务器，插件 PickLockedItems 可能更适合您，它包含更多如分级箱子、钥匙、开锁器、陷阱等特性。

🔧命令列表

基础命令：/lockeditems

• /lockeditems help - 查看帮助。
• /lockeditems give [玩家] [数量] - 给予指定玩家（若不指定则给予命令执行者）一个上锁箱子。
• /lockeditems see [玩家] - 查看指定玩家（若不指定则查看自己）拥有的上锁箱子列表。
• /lockeditems permit <玩家> - 授权你正在看着的箱子的打开权限给指定玩家。
• /lockeditems unpermit <玩家> - 取消指定玩家对你正在看着的箱子的打开权限（仅对已授权的玩家有效）。
• /lockeditems viewPermitted - 查看你正在看着的箱子已授权的玩家列表。
• /lockeditems checkUpdates - 检查更新（不会自动更新）。此命令只能从服务器控制台运行。

⭐权限节点

所有权限默认均为关闭，您需要在权限插件中手动配置。

• lockeditems.lockedchest.open - 打开自己的上锁箱子。
• lockeditems.lockedchest.openall - 打开所有上锁箱子。
• lockeditems.lockedchest.craft - 合成上锁箱子。
• lockeditems.lockedchest.mine - 挖掘自己的上锁箱子。
• lockeditems.lockedchest.mineall - 挖掘所有上锁箱子。
• lockeditems.lockedchest.place - 放置上锁箱子。
• lockeditems.lockedchest.bypasslimit - 绕过箱子数量限制。
• lockeditems.lockedchest.give - 使用 /lockeditems give 命令。
• lockeditems.lockedchest.give.others - 使用 /lockeditems give [玩家] 命令。
• lockeditems.lockedchest.see - 使用 /lockeditems see 命令。
• lockeditems.lockedchest.see.others - 使用 /lockeditems see [玩家] 命令。
• lockeditems.lockedchest.permit - 使用 permit、unpermit 和 viewPermitted 命令。
• lockeditems.lockedchest.* - 所有与上锁箱子相关的权限。
• lockeditems.* - 本插件的所有权限。

✨安装与配置

安装步骤

• 将 LockedItems.jar 文件放入服务器的 plugins 目录。
• 重启服务器。
• （可选）根据需要编辑配置文件，然后再次重启服务器以使配置生效。

配置文件

主要配置文件位于 plugins/LockedItems/config.yml。

修改合成配方

您可以在配置中自定义上锁箱子的合成配方。

• 设置配方形状，例如：

   shape:
     - 'III'
     - 'ICI'
     - 'III'

• 定义材料，将字母映射到物品ID，例如：

   ingredients:
     I: 265 # 铁锭
     C: 54  # 箱子

其他重要选项

• chestLimit：定义单个玩家可拥有的上锁箱子最大数量。设置为 -1 表示无限制。拥有 lockeditems.lockedchest.bypasslimit 权限的玩家可绕过此限制。
• explodeChests: true/false：定义上锁箱子是否会被爆炸摧毁。
• checkForUpdates: true/false：定义是否在服务器启动时检查更新（不会自动更新）。

语言文件

语言文件位于 plugins/LockedItems/language.yml。您可以在此自定义所有操作提示和信息文本，支持使用 & 符号的颜色代码（例如 &4Hi）。

• 西班牙语翻译由 Ajneb97 提供：https://pastebin.com/9i7R1Jn7
• 捷克语翻译由 Wupin 提供：https://pastebin.com/0AdhH1EB

❓开发者支持

如果您是开发者，希望在其他插件中集成 LockedItems 的功能：

• 将本插件添加到您的构建路径和 plugin.yml 的依赖列表中。
• 您可以按如下方式使用 API：

import me.Sindybad.lockeditems.*;
LockedChest lc = LockedItemsMain.lc;

// 可用函数（IDE 的智能提示会显示 Javadoc）：
lc.save(); // 将所有上锁箱子保存至 chests.yml
lc.getChests(); // 返回 HashMap<Location, OwnerUUID>。注意：修改此副本无效。
lc.isOwner(UUID playerUUID, Location location); // 检查玩家是否拥有该位置的箱子
lc.isLockedChest(Location location); // 检查该位置的方块是否为上锁箱子
lc.isLockedChest(ItemStack item); // 检查物品堆是否为上锁箱子
lc.setLockedChest(Location location, UUID ownerUUID); // 将指定位置设置为上锁箱子
lc.removeLockedChest(Location location, boolean dropChest, boolean dropItems); // 移除该位置的上锁箱子
lc.getItemStack(); // 返回上锁箱子的 ItemStack

🔧数据存储与统计

• 上锁箱子的数据保存在 plugins/LockedItems/chest.yml 中。每个世界下列出了该世界中所有上锁箱子的坐标（格式为 X^Y^Z）及其所有者的 UUID。
• 本插件使用 MCStats 来收集匿名的使用统计，以帮助开发。您可以在此处查看数据。
• 如果您想退出统计，请在 plugins/PluginMetrics/config.yml 中将 opt-out 设置为 true。

💡注意事项与支持

• 离线服务器：请注意，LockedItems 的某些功能在离线模式（未正版验证）服务器上可能无法正常工作。
• 问题反馈：如果您遇到任何漏洞，请在讨论区发帖或私信我。请不要在评论/评分区发布漏洞报告！
• 支持我们：如果您喜欢这个插件，请留下评论或评分！您也可以通过捐赠来支持插件的持续开发。
• 社区服务器（示例）：

- New St. Hodenstate: `37.157.248.114:25565`

- 您可以在讨论区告诉我您的服务器地址，以便添加至此列表。

教程视频

• 英文教程 by LtJim007
• 西班牙语教程 by Ajneb97