原创 付费 🔒 WarZBagLock —— 现代化背包锁定插件 | 1.7–1.21+ | 支持 Folia | WarZ / RPG / 硬核生存必备 2.1.5

[MD] # WarZBagLock 插件文档 WarZBagLock 是一个现代化的 Minecraft 背包锁定插件，专为限制玩家背包空间而设计。经过现代化升级，现在完美兼容 1.7 - 1.21+ 所有版本，并支持 Folia 服务器。 非常适合末日生存（WarZ风格）、硬核生存或 RPG 服务器，用于模拟背包容量限制或负重系统。 ## ✨ 主要功能 * **🔒 灵活的锁定机制**：可以锁定玩家背包中的任意槽位。 * **🛠️ 高度自定义**： * **跨版本支持**：兼容 1.7.10 至 1.21+ 以及 Folia。 * **材质支持**：支持所有版本的物品材质名称。 * **CustomModelData**：支持 1.14+ 自定义模型数据，配合材质包实现精美UI。 * **Lore支持**：支持自定义锁定物品的描述（Lore）。 * **⚡ 智能防刷机制**： * **隐形标签**：自动为锁定物品添加不可见标识符，防止玩家通过改名等方式伪造。 * **死亡防掉落**：增强的死亡掉落检测逻辑，确保锁定物品在死亡时直接消失，不会掉落在地或残留。 * **生成拦截**：防止锁定物品以实体形式生成。 * **禁止丢弃**：禁止玩家丢弃（Q键）锁定物品。 * **🔑 权限解锁系统**：玩家可以通过获得特定权限节点来解锁对应的背包区域。 * **🎮 快捷栏锁定行为控制**：支持配置当玩家尝试切换到被锁定的快捷栏槽位时的行为（允许手持或禁止切换）。 * **⚡ 高性能与兼容性**： * 自动识别 Folia/Paper/Spigot 环境并优化调度。 * 防止物品卡BUG，安全可靠。 * **🔧 便捷指令**：支持游戏内快速设置锁定样式和重载配置。 ## 📦 安装说明 1. 下载插件 jar 文件。 2. 将文件放入服务器的 `plugins` 目录中。 3. 启动或重启服务器。 4. 配置文件将自动生成在 `plugins/WarZBagLock/config.yml`。 ## 💻 指令与权限 主命令别名：`/warzbaglock`, `/baglock`, `/wbl` | 指令 | 描述 | 权限 | | :--- | :--- | :--- | | `/baglock reload` | 重载插件配置文件 | `warzbaglock.admin` | | `/baglock set [组名]` | 将手中物品设置为指定组的锁定样式（自动保存材质、名称、Lore、ModelData） | `warzbaglock.admin` | ## ⚙️ 配置文件详解 配置文件 `config.yml` 允许您完全控制锁定的行为。 ```yaml # 全局设置 settings: # 检查更新间隔 (ticks), 默认 20 (1秒) update-interval: 20 # 是否启用调试模式 debug: false # 启用的世界列表 (留空代表所有世界启用) enabled-worlds: [] # 消息配置 (支持颜色代码 &) messages: prefix: "§f[§6WarZBagLock§f] " reload-success: "§a配置文件已成功重载！" # ... 其他消息 # 默认锁定物品类型 (当组内未指定具体物品时使用) default-type: BARRIER # 快捷栏锁定行为设置 (v2.1.3+) # ALLOW_HOLD: 允许玩家切换到被锁定的快捷栏槽位（但禁止丢弃） # PREVENT_SWITCH: 禁止玩家切换到被锁定的快捷栏槽位（会自动切回） hotbar-lock-behavior: ALLOW_HOLD # 锁定组配置 # 您可以配置无限个锁定组 locks: 1: name: "§c已锁" permission: "baglock.1" # 物品材质 (支持新旧名) material: BARRIER # 自定义模型数据 (仅 1.14+) custom-model-data: 0 # 物品 Lore (描述) lore: - "§7此槽位已被锁定" - "§7请升级背包以解锁" # 锁定的槽位列表 slots: [9, 10] 2: name: "§cVIP 专属槽位" permission: "baglock.vip" material: RED_STAINED_GLASS_PANE slots: [11, 12, 13] ``` ### 🔢 槽位 ID 参考表 * **快捷栏 (Hotbar)**: `0` - `8` * **背包第一行**: `9` - `17` * **背包第二行**: `18` - `26` * **背包第三行**: `27` - `35` ## 🛡️ 权限解锁机制 * **机制**: 如果玩家**拥有**该权限，对应的槽位将**解锁**（变为空）。如果玩家**没有**该权限，对应的槽位将显示为**锁定物品**。 * **示例**: * 给玩家 `baglock.1` 权限 -> 解锁组 `1` 定义的槽位。 ## 📞 联系与支持 * **开发者**: Crazy_Jky * **联系QQ**: 1285988665 * **插件技术交流群**: 398893720 * **末日类服务器交流群**: 1063544727 * **插件定制开发**: 承接各类 Bukkit/BungeeCord/Folia 插件定制 ## 📜 更新日志 ### v2.1.3 * **新增**：新增 `hotbar-lock-behavior` 配置项，允许自定义快捷栏锁定行为。 * `ALLOW_HOLD` (默认): 允许玩家切换并手持锁定物品，但禁止丢弃。 * `PREVENT_SWITCH`: 强制禁止玩家切换到被锁定的快捷栏槽位（自动切回原位）。 * **修复**：修复了玩家可以按 Q 键丢弃锁定物品的问题。现在任何方式的丢弃操作都会被拦截。 ### v2.1.2 * **修复**：修复了玩家死亡后锁定物品可能掉落在地上的问题。 * **优化**：引入隐形颜色代码标识符机制，提高锁定物品识别的准确性（不再仅依赖材质和名称）。 * **优化**：增强了死亡事件处理逻辑（优先级提升至 HIGHEST），并额外扫描玩家背包以清除残留锁定物品。 * **新增**：添加了 `ItemSpawnEvent` 监听器，作为最后一道防线拦截并移除任何尝试生成的锁定物品实体。 * **兼容性**：自动将旧版本的锁定物品无缝替换为带有新标识符的版本。 [/MD]​