开发者工具

DevTools，世界检视器

DevTools 是一个客户端 Fabric 模组，支持 26.x-1.14.x 版本，为游戏添加了强大的检视模式。通过冻结移动并解锁光标，你可以指向方块、流体、掉落物和实体，直接在屏幕上查看丰富的调试风格数据。

它提供可自定义的布局、深度 NBT 风格数据转储和剪贴板复制功能。

---

要求和版本支持

要求	版本/约束	备注
Minecraft	26.x-1.14.x	兼容 26.x/1.21.x/1.20.x/1.19.x/1.18.x/1.17.x/1.16.x/1.15.x/1.14.x 版本。
Mod 加载器	Fabric >=0.18.6	仅客户端。加入服务器时留在 mods 文件夹中也无影响。
Fabric API	* （任意版本，但建议使用最新版）	核心模组功能必需。

---

快速开始

1. 安装 Fabric，然后将 DevTools 和 Fabric API 模组放入你的 mods 文件夹。
2. 启动游戏并进入一个世界。
3. 按 F6（默认）切换检视模式。
4. 将鼠标移动到方块或生物上，然后左键单击以选择它们。
5. 按 M 展开所选目标的详细信息。
6. 前往选项 → DevTools… 调整颜色、切换数据行或更改布局。

---

检视模式的工作原理

当你开启检视模式时，游戏会调整交互方式，以便你专注于环境数据。

特性	行为
移动	你会完全静止。移动被抑制，因此你不会意外离开检视点。
鼠标自由	你的光标被解锁。原版左键单击不会破坏方块或攻击；它仅用于选择目标。
智能射线投射	模组根据摄像头+光标选择目标。你可以指向方块、流动的流体、地面上的物品实体、经验球和生物。
世界轮廓线	细轮廓线显示当前悬停的目标。更粗、更亮的轮廓线显示已选中的目标。
滚动	在信息面板上使用鼠标滚轮滚动长文本。

---

快捷键

所有按键可在控制 → DevTools 下重新映射。信息面板始终显示当前绑定的按键的实际名称。

操作	默认按键	描述
切换检视	F6	开启或关闭检视模式。
选择目标	左键	将 HUD 锁定到悬停的方块/实体上。
更多信息	M	切换详细的 NBT/数据转储。
自由移动	按住左 Alt	恢复移动和摄像头，同时保持检视模式开启。
复制值	按住左 Ctrl	单击 HUD 中的任意行，将其值复制到剪贴板。

自由摄像头（Alt 模式）

按住左 Alt 时，你将暂时恢复移动和摄像头控制。射线投射更新被冻结，因此轮廓线会固定在你最后的目标上，同时 HUD 变为透明，以便你观察世界。

菜单暂停

打开任何全屏菜单（例如暂停或物品栏屏幕）会暂停并冻结射线投射及其更新，这样你不会搞乱你的选择。

---

信息面板（HUD）

HUD 旨在提供即时摘要数据，并可选择展开为详细类别。

• 标题： 显示你是处于悬停状态，还是有选中的目标。包括选中方块/实体的图标、显示名称和注册 ID。稀有度颜色自动匹配原版 Minecraft 层级（常见、少见、稀有、史诗）。
• 摘要： 快速信息，如坐标、生物的生命值或物品的掉落信息。
• 详细信息（"更多信息"）： 按下 M 键会打开一个分类的文本转储。默认类别顺序：来源、物品形式、状态属性、方块数据、方块实体、环境、类型、标识、状态、生命、装备、效果、生物、原始 NBT。
• 布尔值样式： true / false 行用不同颜色标识，以便快速查看。
• 复制反馈： 成功复制一行时会快速闪烁 "已复制" 消息。

---

设置菜单

选项 → DevTools… 打开设置菜单。该按钮位于 FOV 滑块下方，中央位置。

按钮	打开内容
HUD	颜色和偏好的子菜单
快捷键	原版按键绑定屏幕
布局	面板角落定位和类别排序

技术详情

配置文件 (devtools.properties)

位置：.minecraft/config/devtools.properties

键	类型	用途
tutorialSeen	true / false	教程已显示 / 永久跳过
hud.color.<名称>	8 位十六进制 AARRGGBB	HUD 颜色覆盖（见下表）
pref.<键>	true / false	每行/每节的 HUD 偏好
layout.position	TOP_LEFT、TOP_RIGHT、BOTTOM_LEFT、BOTTOM_RIGHT	检查器面板角落
layout.categoryOrder	逗号分隔的名称	自定义更多信息类别顺序

---

HUD 颜色屏幕

每行都有一个颜色方块、一个十六进制代码字段、一个复制按钮和一个重置按钮。单击方块会打开一个带有色相、饱和度和亮度滑块的颜色选择器。

HUD 颜色键 (hud.color.*)

配置后缀	UI 标签	作用
bg	背景	面板填充
borderTop	边框（顶部）	顶部强调线
headerBg	标题背景	标题栏
header	标题标签	"悬停"/"已选中" 文本
category	类别标签	转储中的章节标题
key	属性键	: 前的文本
value	属性值	: 后的文本
dim	暗淡文本	提示/次要行
scrollbar	滚动条轨道	滚动槽
scrollThumb	滚动条滑块	滚动手柄
boolTrue	True 值	布尔值徽章/样式
boolFalse	False 值	布尔值徽章/样式

（注意：物品稀有度颜色严格与原版绑定，在此不可配置。）

---

HUD 偏好屏幕

你可以精确切换哪些行显示。顶部的全部偏好选项会同时开启或关闭其他所有复选框。

通用偏好

键	标签
pref.showIcon	显示图标
pref.showId	显示标识

方块相关偏好

键	标签
pref.block.source	来源模组
pref.block.destroyTime	破坏时间
pref.block.resistance	抗性
pref.block.lightEmit	发光等级
pref.block.lightDamp	遮光等级
pref.block.friction	摩擦力
pref.block.speedFactor	速度因子
pref.block.jumpFactor	跳跃因子
pref.block.isSolid	是固体
pref.block.isAir	是空气
pref.block.liquid	液体
pref.block.blocksMotion	阻挡运动
pref.block.canOcclude	可遮挡
pref.block.redstone	红石
pref.block.randomTick	随机刻
pref.block.ignitedByLava	可被岩浆点燃
pref.block.stateProps	状态属性
pref.block.blockEntity	方块实体 NBT
pref.block.environment	环境（生物群系/光照）

实体相关偏好

键	标签
pref.entity.source	来源模组
pref.entity.category	类别
pref.entity.dimensions	尺寸
pref.entity.fireImmune	火焰免疫
pref.entity.uuid	UUID
pref.entity.customName	自定义名称
pref.entity.tags	标签
pref.entity.onGround	在地面
pref.entity.invulnerable	无敌
pref.entity.silent	安静
pref.entity.glowing	发光
pref.entity.noGravity	无重力
pref.entity.frozen	冻结
pref.entity.inWater	在水中
pref.entity.onFire	着火
pref.entity.HP	生命值
pref.entity.armor	盔甲
pref.entity.isBaby	是幼年
pref.entity.effects	活跃效果
pref.entity.equipment	装备
pref.entity.noAI	无 AI
pref.entity.persistent	持久存在
pref.entity.leftHanded	左撇子
pref.entity.target	目标
pref.entity.owner	所有者
pref.entity.rawNbt	原始 NBT

---

布局屏幕

控制项	循环选项
窗口位置	左上 → 右上 → 左下 → 右下
排序	默认，然后每个已知类别对应 "<类别> 优先"。

记得在颜色、偏好和布局屏幕上按保存以保留更改。

---

又是技术详情，抱歉

项目元数据和链接

Mod ID	devtools
作者	Beef and Capybarabeef Studios under Miljö AB
源代码	GitHub 仓库
问题追踪器	GitHub Issues

许可证

DevTools 基于 MIT 许可证发布。完整法律文本可在仓库根目录下的 LICENSE 文件中找到。