ModLens

🔍 ModLens

ModLens is a lightweight runtime inspection tool for NeoForge developers.

Instead of adding temporary log statements or attaching a debugger every time you need to inspect something, ModLens lets you examine blocks, block entities, items, entities, tags, data components, attachments, and NeoForge capabilities directly in-game.

ModLens is designed as a read-only developer tool. It does not modify inspected objects or world data.

✨ Features

• Inspect blocks, block entities, ItemStacks, and entities directly in-game
• View registry IDs, namespaces, Java classes, positions, and runtime information
• Inspect BlockState properties such as facing, active, lit, and waterlogged
• Browse Block, Item, Entity Type, and Block Entity Type tags
• Inspect ItemStack and Block Entity data components
• View client-visible NeoForge attachments
• Inspect Item, Fluid, and Energy capabilities
• Check sided capabilities individually:
  UP, DOWN, NORTH, SOUTH, EAST, WEST, and UNSIDED
• View item slot usage, fluid amounts/capacity, and stored energy
• Live runtime refresh with Freeze / Resume support
• Copy individual values or complete snapshots to the clipboard
• Export complete inspections as readable JSON
• Clearly distinguishes NONE, UNKNOWN, and UNAVAILABLE data
• Designed to remain lightweight when the inspector is closed

🖥️ Runtime Inspector

Press the ModLens inspect key while looking at a block or entity to open the inspector.

Items can also be inspected directly from inventory and container screens.

The inspector contains dedicated sections for:

Overview
State / Data
Tags
Components
Capabilities
Copy / Export

⚡ Capability Inspector

ModLens can inspect NeoForge Item, Fluid, and Energy capabilities without constantly polling them in the background.

Block capabilities can be inspected separately for every direction, making it useful for debugging machines, inventories, tanks, pipes, and automation systems.

Capability data refreshes only while the capability inspector is being used.

❄️ Live & Freeze

Runtime values can update while the inspector is open.

Use Freeze to capture the current state and inspect it without values changing, then Resume when you want live data again.

📋 Copy & JSON Export

Inspector rows can be selected and copied directly to the clipboard.

Complete snapshots can also be exported as JSON.

Exported files are stored in:

logs/modlens/

You can open the folder directly from inside Minecraft with the ModLens commands.

⌨️ Commands

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

🌐 Multiplayer

ModLens can work as a client-side inspection tool.

When information cannot be reliably known from the client, ModLens reports it as UNKNOWN or SERVER ACCESS REQUIRED instead of incorrectly claiming that the data does not exist.

🪶 Lightweight by Design

ModLens is focused on runtime inspection only.

It does not:
• edit NBT or runtime data
• modify blocks, entities, or capabilities
• act as a normal gameplay information HUD
• sniff network packets
• require the other Kiyoshibara developer tools

🔧 Platform

• Minecraft 26.2
• NeoForge
• Java 25
• Client-side

ModLens is completely standalone and does not require the other Kiyoshibara developer tools.

Created by Kiyoshibara