调试插件（Debug Plugin）

基本信息

属性 值
插件 uid debug（DebugPlugin.java:17，常量 Identifiers.NAMESPACE_DEBUG，Identifiers.java:62）
依赖 mod 无
配置分类 plugins_autogen.debug
注册调用 服务端 0 次 / 客户端 6 次
生效侧 仅客户端
默认状态 全部关闭（需手动启用 provider）

功能

面向开发者的诊断信息：方块硬度、爆炸抗性、注册表数据、坐标。四个 provider 中三个注册在方块侧、一个同时覆盖实体侧。

RegistryDataProvider 与 CoordinatesProvider 各有 getBlock() / getEntity() 两个工厂方法（与 通用插件 同样式），说明它们按方块侧/实体侧返回不同实现。

注册内容

客户端（DebugPlugin.registerClient）：

方法 目标类 provider
registerBlockComponent Block HardnessProvider.INSTANCE
registerBlockComponent Block BlastResistanceProvider.INSTANCE
registerBlockComponent Block RegistryDataProvider.getBlock()
registerBlockComponent Block CoordinatesProvider.getBlock()
registerEntityComponent Entity RegistryDataProvider.getEntity()
registerEntityComponent Entity CoordinatesProvider.getEntity()

数值

plugins.debug 分类只有两个字段（PluginsConfig.java:426-441）：

字段 默认值 语义
entityregistrydata false 实体上显示注册表数据（RegistryDataProvider）
displaymode SHORT 取值为 RegistryDataProvider.DisplayMode 枚举

entityRegistryData 是默认关闭的诊断开关（PluginsConfig.java:433-435）。方块侧的硬度/爆炸抗性/坐标没有独立的总开关——它们与其它 provider 一样受 plugins_autogen.debug 下每个 provider 自己的 enabled 与 priority 控制。

general 分类下的 forceLegacy 会使 WDMla 忽略所有现代特性，HarvestToolProvider 等 provider 都会走旧版 Waila 路径（读取点 HarvestToolProvider.java:61）。

交互

调试信息只在玩家按住对应的「显示详细信息」键时才会完整展开——这一行为由注册到 Block.class 的 BreakProgressTextProvider 与 核心插件 的组件共同决定，键位见 按键绑定。

相关条目