LockSecurity - 锁箱钥匙

LockSecurity 是一款为 Minecraft 服务器设计的容器保护插件，它通过可合成的钥匙来锁定方块，为服务器增添 RPG 沉浸感。插件操作直观，功能丰富，并提供了完善的管理命令、权限与配置选项。

💡重要须知

版本与支持状态

• 自 2020 年 7 月 9 日起，LockSecurity 发布了最后一个免费更新版本。此后的新版本将转为付费插件。
• 付费版本链接：https://www.spigotmc.org/resources/locksecurity.81282/
• 此最终免费版与付费版的初始发布版本功能一致，适用于未更新至 1.12.2 以上版本的服务器。

运行环境要求

• 必须运行 Spigot 1.16.1 或更高版本。
• 不支持任何低于 1.16.1 的版本，也不支持 CraftBukkit 服务器。
• 请勿在不符合要求的服务器版本上下载使用。

🎮核心功能

LockSecurity 旨在提供最简便、直观的容器保护体验。

主要特性

• 可配置锁定：使用可合成的钥匙来锁定一系列可配置的方块。
• 私有访问：锁定的方块只能由对应的钥匙打开。
• 多方块支持：自动支持双箱、双门等多方块结构。
• 钥匙管理：支持钥匙的合并、复制与重置，方便管理多个锁。
• 钥匙属性：可更改钥匙的多种属性（称为“标志”），例如“使用后销毁”、“禁止合并”等。
• 管理功能：提供全面的命令、权限节点和配置选项，拥有强大的管理能力。
• 未来兼容：代码经过精心设计，可保证在 1.16.1 之后的 Spigot 版本上无需更新即可运行。

更多信息

• 如需查看完整的功能列表与详细说明，请访问插件的 GitHub Wiki 官方页面。
• 欢迎社区成员为 Wiki 贡献内容，补充缺失或过时的信息。

🔧命令列表

所有命令均配有智能补全和独立的权限节点，方便管理员控制玩家可见的命令。

/locksecurity (别名 /ls)

查看插件基本信息、作者、版本及管理功能。

• /locksecurity reload - 重载插件配置文件并应用所有更改。

/editkey (别名 /editkeys, /keyedit, /ek)

编辑玩家手中已锻造钥匙的属性标志。

• /editkey get - 列出手中钥匙的所有标志。
• /editkey get <flag> - 获取手中钥匙指定标志的值。
• /editkey set <flag> <true|false> - 设置手中钥匙指定标志的值。

/givekey (别名 /givekeys)

给予自己或其他玩家未锻造的钥匙。

• /givekey [player] [amount] - 给予指定玩家指定数量的未锻造钥匙。两个参数均为可选。

/ignorelocks (别名 /ignorelock, /il)

启用“忽略锁”模式。详情请参阅 Wiki。

/locklist (别名 /lockslist, /ll)

获取自己或他人拥有的所有锁的列表。

• /locklist [player] - 获取指定玩家拥有的锁列表。

/locknotify (别名 /locknotifications, /ln)

启用“锁通知”模式。详情请参阅 Wiki。

/refreshkeys (别名 /refreshkey, /keyrefresh, /updatekey, /updatekeys, /keyupdate)

刷新玩家物品栏中的所有钥匙。此操作将

• 移除世界中已不存在的方块对应的钥匙。
• 将不再关联任何锁定方块的钥匙转换回未锻造状态。
• 更新钥匙的 Lore 信息，以反映新增或移除的标志。

⭐权限节点

LockSecurity 提供了详尽的权限节点，以便精确控制玩家能力。

命令权限

• locksecurity.command.* - 授予所有 LockSecurity 命令的访问权限。
• locksecurity.command.editkey - 允许使用 /editkey 命令。
• locksecurity.command.givekey - 允许使用 /givekey 命令。
• locksecurity.command.ignorelocks - 允许使用 /ignorelocks 命令。
• locksecurity.command.locklist - 允许使用 /locklist 命令。
• locksecurity.command.locklist.other - 允许使用 /locklist [player] 子命令。
• locksecurity.command.locknotify - 允许使用 /locknotify 命令。
• locksecurity.command.refreshkeys - 允许使用 /refreshkeys 命令。
• locksecurity.command.reload - 允许使用 /locksecurity reload 子命令。

方块交互权限（默认授予）

• locksecurity.block.* - 授予各种与方块相关的功能权限。
• locksecurity.block.clonekey - 允许锁的所有者通过右键点击方块来创建对应的已锻造钥匙。
• locksecurity.block.inspect - 允许玩家潜行时用空手右键点击方块来查看其信息。
• locksecurity.block.lock - 允许玩家使用未锻造的钥匙锁定方块。
• locksecurity.block.ignorelimit - 在所有世界中忽略方块数量限制。
• locksecurity.block.nickname - 允许玩家使用命名牌为已锁定的方块设置昵称。

合成权限（默认授予）

• locksecurity.crafting.* - 授予各种与合成相关的功能权限。
• locksecurity.crafting.duplicate - 允许玩家在工作台中复制已锻造的钥匙。
• locksecurity.crafting.merge - 允许玩家在工作台中合并已锻造的钥匙。
• locksecurity.crafting.reset - 允许玩家在工作台中将已锻造的钥匙重置为未锻造状态。
• locksecurity.crafting.unsmithed - 允许玩家在工作台中合成未锻造的钥匙。

✨配置概述

LockSecurity 提供了详细且可扩展的配置选项。以下是默认配置文件的核心内容：

Metrics: true # 是否发送匿名统计信息
PerformUpdateChecks: true # 是否检查更新

# 钥匙相关配置
Keys:
  Unsmithed:
    ModelData: 1 # 未锻造钥匙的材质模型数据
    RecipeYield: 1 # 合成配方产出的钥匙数量
  Smithed:
    ModelData: 2 # 已锻造钥匙的材质模型数据
    AllowKeyDuplication: true # 是否允许钥匙复制
    AllowKeyMerging: true # 是否允许钥匙合并
    AllowKeyResetting: true # 是否允许钥匙重置

# 各世界最大锁数量限制（-1 表示无限制）
MaxLocks:
  world: -1
  world_nether: 0
  world_the_end: 0

# 玩家可使用钥匙锁定的方块列表
LockableBlocks:
  - 'minecraft:chest'
  - 'minecraft:trapped_chest'
  # ... 各种门、活板门、栅栏门等

• 关于配置文件的完整说明和所有可用选项，请参阅 官方 Wiki。

❓资源包与开源

资源包

• LockSecurity 附带一个可选的资源包，用于让钥匙看起来更逼真。
• 首次运行插件后，资源包压缩文件将生成于 plugins/LockSecurity/resourcePack 目录。
• 强烈建议使用此资源包，无论服务器是否已安装其他资源包。

开源与贡献

• LockSecurity 是开源项目，欢迎熟悉 Bukkit/Spigot API 的开发者贡献代码。
• 源代码位于 GitHub。插件不含任何恶意或隐藏代码，鼓励直接修改。
• 希望您能将有益的修改提交回上游项目，让其他用户也能受益。

🔧开发者 API

尽管 LockSecurity 已成为付费插件，但开发者可以免费使用其 API，无需购买 SpigotMC 上的资源。API 作为独立的构件提供，并托管在 Maven 仓库中。

Maven 依赖

<repositories>
  <repository>
    <id>jitpack</id>
    <url>https://jitpack.io</url>
  </repository>
</repositories>
<dependencies>
  <dependency>
    <groupId>com.github.2008Choco</groupId>
    <artifactId>LockSecurity</artifactId>
    <version>API-VERSION-HERE</version>
    <scope>provided</scope>
  </dependency>
</dependencies>

Gradle 依赖

repositories {
  maven { url "https://jitpack.io" }
}
dependencies {
  implementation 'com.github.2008Choco:LockSecurity:API-VERSION-HERE'
}

💡最后说明

• 下载并使用此插件，即表示您认可开发者在其中投入的时间与精力。
• 虽然插件开源且可自行编译，但如果您希望获得未来的更新与支持，购买付费版本将是极大的鼓励。
• 如有任何问题，请通过 官方支持 Discord 联系我。
• 欢迎为 API 或插件本体贡献代码，提出或自行实现您希望看到的新功能。

感谢使用，祝您游戏愉快！