LockSecurity - 锁箱钥匙

使用钥匙锁定容器，只有你和你的朋友才能访问它们！

Bukkit / Spigot 作者 2008Choco 支持版本 1.16 - 1.16

访问 Spigot 下载插件

服务器使用量

服务玩家数

下载量

57,956

插件详细介绍

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 版本上无需更新即可运行。

命令列表

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

/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 或插件本体贡献代码，提出或自行实现您希望看到的新功能。

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

测试支持版本

1.16

版本分布

基本信息

插件名称 LockSecurity

作者 2008Choco

平台 Bukkit / Spigot

支持版本 1.16 - 1.16

点赞数 1