LocketteX - 简易箱子保护插件

有些服务器并不需要复杂的箱子保护插件，这款插件以轻量化的方式提供了最常用的功能。

只需放置一个箱子或双联箱，并在其任意一面贴上告示牌，第一行写上 [Protect]（可配置），箱子便会立即受到保护。告示牌上的文字会变得色彩鲜艳、美观易读，其中一行还会显示你的名字。此后，在任何环境下，只有你可以访问这个箱子。

本插件专为 Towny 和 Factions 这类环境设计，这些环境本身已具备按地块或按权限的箱子保护系统。因此，在这些场景下，一个用于私人存储的简易保护功能就完全足够了。

💡核心特性

• 可保护任何容器或门/栅栏门/活板门。
• 所有提示信息均可翻译。
• 支持分世界启用。
• 权限可配置。
• 告示牌标签和文本可配置。
• 告示牌所有者行可配置，以便与已安装的告示牌保护插件兼容。请注意，在创建部分告示牌后请勿更改所有者行编号，否则旧的告示牌将失效。

✨新增功能

• 添加了 /protect add 和 /protect remove 命令，用于授予或撤销对受保护方块的访问权限。
• 新增选项：仅当所有者在线时，白名单玩家才能访问。
• 新增选项：限制仅在玩家拥有建造权限的方块上设置保护。

🔧可选功能

• 爆炸与漏斗保护。
• UUID 支持（默认启用）。创建保护告示牌时，会同时保存玩家的 UUID 和名称。这样即使玩家更改游戏名，保护依然有效。如果你是离线模式服务器或不需要此功能，只需将所有者行格式设置为 %owner%，插件将仅使用告示牌上的玩家名。
• 保护在指定天数后过期。
• 按住 Shift 键点击箱子以快速保护。
• Vault 兼容性，支持为创建保护告示牌设置可配置的价格。
• 兼容 Towny、FactionsX、Lands、Feudal 和 FactionsUUID（及其分支）。提供选项允许市长/领袖绕过破坏和/或打开保护，并可在未认领的土地（如 Wilderness）上禁用保护。（MassiveCore Factions 理论上也可工作，但不受官方支持）
• GriefPrevention 兼容性（默认启用），在玩家无建造权限的位置禁止设置保护。

还有更多功能……（请阅读配置文件以了解全部特性！）

❓常见问题

• 如何报告问题或提出建议？

请前往讨论区页面提交，评论区并非用于反馈问题。

• 如何修改权限？

所有权限均在 config.yml 中可配置，你可以按需编辑，然后重载插件以使更改生效。

🎮API 接口

插件提供以下 API 供开发者使用

LocketteXAPI#isProtected(BlockState) // 返回布尔值
LocketteXAPI#hasAccess(Player,BlockState) // 返回布尔值
LocketteXAPI#getOwner(BlockState) // 返回 SignUser
LocketteXAPI#getSignOwner(Sign, signBlock, attachedBlock) // 返回 SignUser

从 SignUser 中可以获取玩家名称 (getName()) 和 UUID (getUniqueId())。

事件

• PlayerProtectBlockEvent：可取消，在成功保护方块前调用。可通过其方法获取涉及的玩家和方块。