Debug Stick - 调试棒

DebugStick 是一款为 Minecraft 1.8 至 1.12.2 版本服务器设计的插件，它精准复刻了 1.13 版本中的调试棒功能。你可以用它来修改方块的属性状态，并自定义物品、消息和命令。插件还额外添加了如木头和原木类型等自定义方块状态，并与 WorldGuard、PlotSquared 等主流领地插件兼容。

💡核心功能

• 完美复刻原版调试棒功能，用于修改方块的属性状态。
• 支持自定义调试棒的物品材质、名称、附魔效果和描述。
• 添加了额外的自定义方块状态（如木头类型）。
• 完整的权限系统，可精细控制使用权限。
• 与 WorldGuard 和 PlotSquared 插件集成，提供区域和地皮保护支持。
• 提供详细的 API，方便开发者进行二次开发。
• 支持通过操作栏（ActionBar）显示状态变更信息。

🎮命令列表

• /debugstick give <玩家名> - 给予指定玩家一根调试棒。若不指定玩家，则给予自己。
• /debugstick reload - 重新加载插件配置和消息文件。
• /debugstick update - 检查插件是否有更新。

✨权限节点

权限可在配置文件中修改，默认如下

• debugstick.modify - 允许使用调试棒修改方块。
• debugstick.command.use - 允许使用 /debugstick 命令。
• debugstick.command.give - 允许使用 /debugstick give 命令。
• debugstick.command.give.others - 允许给予其他玩家调试棒。
• debugstick.command.reload - 允许使用重载命令。
• debugstick.command.update - 允许使用更新检查命令。
• debugstick.world.{世界名} - 绕过在特定世界中的使用限制。
• debugstick.modify.plots.roads - 允许修改 PlotSquared 的道路。
• debugstick.modify.plots.claimed - 允许修改其他玩家已认领的地皮。
• debugstick.modify.plots.friend - 允许修改你作为成员的地皮。
• debugstick.modify.plots.owned - 允许修改你自己认领的地皮。
• debugstick.worldguard.bypass - 绕过所有设置了 debugstick 标志为拒绝的区域。

🔧配置说明

主要配置选项包括

• enabled: 是否启用插件。
• custom-command: 自定义主命令（默认为 debugstick）。
• item: 自定义调试棒的物品名称、材质、数据值、描述和附魔效果。
• allowed-worlds: 设置允许或禁止使用调试棒的世界列表。
• allowed-gamemodes: 设置允许使用调试棒的玩家游戏模式。
• use-actionbar: 控制各类操作提示是否通过操作栏显示。
• permissions: 对应上述所有权限节点的字符串，可在此修改。

消息配置

消息文件支持高度自定义，所有提示文本均可修改。插件使用 %变量% 格式的占位符来动态生成消息，例如 %player% 代表玩家名，%state% 代表选中的方块状态。

⭐注意事项与已知问题

使用须知

• 请勿使用 PlugMan 等插件重载此插件，这会导致自定义命令注册异常，必须重启服务器才能修复。
• 若遇到 WorldGuard 相关的报错（如 No such method），请尝试以下版本搭配：

- 对于 1.8 - 1.11 服务器，使用 WorldGuard 6.2。

- 对于 1.12 服务器，使用 WorldGuard 6.2.1 或 6.2.2。

开发计划

• 添加更多（自定义）方块状态。
• 增加操作栏显示时长和淡出效果的配置。
• 为使用调试棒添加冷却时间。
• 改进 API 事件系统。

❓API 使用指南 (v1.0)

插件提供了完整的 API 供开发者调用。主要功能类位于 me.itstautvydas.debugstick.utils.DebugStickUtils。

实用方法

• public static DataChanged changeBlockData(Block block, String state, Object value) - 修改方块数据，返回 DataChanged 实例。
• public static Object getBlockData(Block block, String state) - 获取方块的指定状态值。
• public static Object dataReader(byte data, Material material, String state) - 读取原始数据值。
• public static String readDataError(Object data) - 读取数据错误信息。
• public static boolean hasDataErrors(Object data) - 检查获取的数据是否包含错误。

**错误代码说明**

• -1: 方块枚举缺失 (block missing)
• -2: 状态缺失 (state missing)
• -3: 版本不支持 (version not supported)
• -4: 无此状态 (no such state)

事件系统

插件提供了三个事件，均位于 me.itstautvydas.debugstick.events 包中：

• DebugStickClickEvent - 在修改方块数据前触发，可取消。
• DebugStickBlockDataChangedEvent - 当方块数据成功改变后触发。
• DebugStickClickedEvent - 在方块数据改变后触发。

🔧支持与帮助

如果你在使用中遇到任何问题或需要帮助，可以通过私信联系开发者。未来可能会创建 Discord 服务器以提供更好的支持。