ModLens

🔍 ModLens

ModLens 是一款面向 NeoForge 开发者的轻量级运行时检查工具。

无需在每次检查时临时添加日志语句或附加调试器，ModLens 可让您在游戏内直接检查方块、方块实体、物品、实体、标签、数据组件、附加数据和 NeoForge 能力（Capabilities）。

ModLens 被设计为只读的开发者工具。它不会修改被检查对象或世界数据。

✨ 功能特性

• 在游戏内直接检查方块、方块实体、物品堆（ItemStacks）和实体
• 查看注册表 ID、命名空间、Java 类、坐标和运行时信息
• 检查 BlockState 属性，例如朝向（facing）、激活（active）、点亮（lit）和含水（waterlogged）
• 浏览方块、物品、实体类型和方块实体类型的标签（Tags）
• 检查物品堆（ItemStack）和方块实体的数据组件
• 查看客户端可见的 NeoForge 附加数据
• 检查物品、流体和能量能力（Capabilities）
• 可单独检查各个方向的能力：
  上（UP）、下（DOWN）、北（NORTH）、南（SOUTH）、东（EAST）、西（WEST）以及无方向（UNSIDED）
• 查看物品槽位使用情况、流体量/容量以及存储能量
• 支持冻结/恢复的实时运行时刷新
• 可复制单个值或完整快照到剪贴板
• 将完整检查结果导出为可读的 JSON 文件
• 清晰区分无（NONE）、未知（UNKNOWN）和不可用（UNAVAILABLE）数据
• 设计上确保检查器关闭时保持轻量

🖥️ 运行时检查器

注视方块或实体时，按下 ModLens 检查键即可打开检查器。

也可以直接从物品栏和容器界面中检查物品。

检查器包含以下专属部分：

概览（Overview）
状态/数据（State / Data）
标签（Tags）
组件（Components）
能力（Capabilities）
复制/导出（Copy / Export）

⚡ 能力检查器

ModLens 可以检查 NeoForge 物品、流体和能量能力，而无需在后台持续轮询它们。

方块能力可以针对每个方向分别检查，这对于调试机器、物品栏、储罐、管道和自动化系统非常有用。

能力数据仅在使用能力检查器时才会刷新。

❄️ 实时与冻结

检查器打开时，运行时值可以实时更新。

使用冻结（Freeze）功能捕获当前状态并在值不变的情况下进行检查，当您需要再次获取实时数据时，点击恢复（Resume）即可。

📋 复制与 JSON 导出

检查器中的行可以被选中并直接复制到剪贴板。

完整的快照也可以导出为 JSON 文件。

导出的文件存储在：

logs/modlens/

您可以通过 ModLens 命令在 Minecraft 内直接打开该文件夹。

⌨️ 命令

/modlens
/modlens inspect
/modlens export
/modlens files
/modlens exports
/modlens status
/modlens help

🌐 多人游戏

ModLens 可以作为客户端侧检查工具使用。

当无法从客户端可靠获取某些信息时，ModLens 会将其报告为未知（UNKNOWN）或需要服务器访问（SERVER ACCESS REQUIRED），而不是错误地声称数据不存在。

🪶 设计轻量

ModLens 专注于运行时检查。

它不会：
• 编辑 NBT 或运行时数据
• 修改方块、实体或能力
• 作为常规游戏信息 HUD
• 嗅探网络数据包
• 需要其他 Kiyoshibara 开发者工具

 

🔧 平台

• Minecraft 26.2
• NeoForge
• Java 25
• 客户端侧

ModLens 完全独立，不需要其他 Kiyoshibara 开发者工具。

作者：Kiyoshibara