GUI调试模式

🔍 GUI 调试模式

一款为 NeoForge 开发者打造的轻量级游戏内 GUI 调试与检查工具。

无需再猜测坐标、添加临时调试文本，或为了弄清 GUI 元素的位置而反复重启游戏。

GUI 调试模式让你能直接、实时地在 Minecraft 中检查屏幕、槽位、组件、边界、坐标和重叠区域。

✨ 功能特性

📐 实时坐标覆盖层

在屏幕打开时查看重要的 GUI 定位信息：

• 屏幕 X / Y 坐标
• GUI 相对 X / Y 坐标
• GUI 原点
• 屏幕尺寸
• GUI 图像尺寸
• GUI 缩放
• 帧缓冲分辨率

📦 槽位检查器

直接在游戏中检查真实的容器槽位：

• 菜单槽位索引
• 容器槽位索引
• GUI 位置
• 屏幕位置
• 18×18 交互边界
• 当前物品堆
• 激活状态
• 高亮状态
• 容器信息

🧩 组件检查器

悬停支持的 GUI 组件以进行检查：

• Java 类
• 屏幕位置
• GUI 相对位置
• 宽度和高度
• 激活状态
• 可见状态
• 焦点状态
• 组件消息 / 标签

也支持检查屏幕内的嵌套组件，例如选项列表。

🟦 边界可视化

直接在 GUI 上可视化槽位和组件的实际交互边界。

这使得以下问题更容易被发现：

• 定位错误
• 非预期的命中区域
• 控件未对齐
• 组件尺寸过大
• 布局问题

⚠️ 重叠检测

GUI 调试模式能检测受支持元素间的真实交叉：

• 槽位 ↔ 槽位
• 槽位 ↔ 组件
• 组件 ↔ 组件

检测到的交叉区域可以高亮显示，并检查具体是哪些元素发生了重叠。

📌 冻结选择

发现想要更仔细检查的内容？

在悬停受支持的槽位或组件时按下 Shift 键即可冻结选择。

即使鼠标移开，所选元素仍会保持高亮状态。

📋 剪贴板导出

当元素被冻结时，按 Ctrl + C 可将详细的调试信息直接复制到剪贴板。

复制的内容可包含：

• 元素类型
• Java 类
• 坐标
• 边界
• 槽位信息
• 组件状态
• 物品堆信息
• 相关的重叠诊断信息

对于错误报告、开发笔记以及快速将坐标移回代码中非常有用。

🎛️ 调试视图

在多个重点检查模式间循环切换：

📐 坐标
📦 槽位
🧩 组件
⚠️ 重叠
🛠️ 全部

无需同时显示所有调试层。

⌨️ 默认控制

F8
切换 GUI 调试模式

F7
循环切换调试视图

Shift
冻结 / 解冻悬停的元素

Ctrl + C
复制冻结元素的信息

所有按键绑定都可以在 Minecraft 的控制菜单中更改。

⚡ 轻量设计

GUI 调试模式被设计为一款开发者实用工具，而非游戏性模组。

• 仅客户端运行
• 只读权限
• 不会移动或修改 GUI 元素
• 不会修改物品栏或机器数据
• 调试覆盖层默认禁用
• 高开销检查系统仅在需要时运行
• 禁用时，渲染开销被设计为实际上可以忽略不计

🛡️ 安全检查

该模组偏好使用 Minecraft 和 NeoForge 公开可访问的 GUI 结构，而非激进地检查私有实现细节。

不支持的模组自定义元素应简单地不被跟踪，而不会导致游戏崩溃。

⚠️ 当前限制

某些模组的界面会使用直接渲染调用手动绘制元素，而非标准的 Minecraft 组件。

因此，自定义元素如手动渲染的：

• 文本
• 纹理
• 动画精灵
• 自定义渲染区域

可能不总是能被检测为独立的组件。

这并不代表 GUI 已损坏 —— 只是说明该元素处于当前支持检查系统之外。

🚧 计划中的功能

未来版本可能会扩展 GUI 检查范围，包括：

• 纹理 / UV 检查
• 文本边界和基线调试
• 裁剪 / 裁剪区域可视化
• 目标渲染调用检查
• 可选的配方查看器兼容性
• 布局快照导出

💬 反馈与兼容性报告

发现了一个未能被正确检查的 GUI？

请留下评论并说明：

• 模组名称
• Minecraft 版本
• NeoForge 版本
• 尽可能附带截图
• GUI 调试模式检测错误的简短描述

来自自定义模组化屏幕的报告对提高兼容性尤其有帮助。

🧰 KIYOSHIBARA 开发者工具系列的一部分

GUI 调试模式完全独立。

使用它时，您无需安装任何其他 Kiyoshibara 开发工具。