InspectMC v1

InspectMC

A modern in-game inspection and diagnostic toolkit for Minecraft modpack creators, datapack authors and mod developers.

Public v1 target

InspectMC 1.0.0 targets Minecraft 1.21.1, Java 21, Fabric and NeoForge. The 26.2 and 26.3 trees in the repository are experimental forward-port work and are not part of the public 1.0.0 release.

What does InspectMC do?

InspectMC exposes useful game, registry, world and datapack information directly in-game. It is designed to reduce the time spent jumping between logs, commands, source files and external utilities while building or debugging a modpack.

Main toolsets

Inspect held items, blocks, block entities, entities, players and biomes.
Search runtime registries by partial ID or namespace.
Locate nearby blocks, entities and block entities.
Inspect loaded chunks, dimensions, entity types and block entities.
Collect block and biome statistics around the player.
List mods, datapacks, namespaces and runtime registries.
Export registries, tags, recipes, biomes and complete diagnostic reports.
Optionally audit Cobblemon spawn data and expose Cobblemon-specific diagnostics.

Interactive chat output

Click useful IDs and values to copy them.
Hover registry IDs for registry and namespace context.
Use [TP] actions to prefill teleport commands for returned positions.
Use clickable previous and next actions for long result lists.
Keep raw entity NBT out of chat while retaining a dedicated [Copy NBT] action.
Open local dump files and folders directly when the client has access to the generated path.

Permissions

Safe local inspection such as the held item, current biome, self inspection and registry search is available to regular players. World searches, other-player inspection, sensitive NBT, loaded-state diagnostics, pack information, statistics and exports require the configured vanilla permission level.

Getting started

Installation

Use the loader build that matches your Minecraft 1.21.1 installation.

Requirements

Component	Requirement
Minecraft	1.21.1
Java	21 or newer compatible Java 21 runtime
Fabric	Fabric Loader 0.19.3+ and Fabric API
NeoForge	NeoForge 21.1+

Install the mod

Download the regular InspectMC JAR for your loader.
Place it in the relevant mods folder.
Start the game or dedicated server.
Run /inspectmc hand or /inspectmc inspect biome as a first test.

Use the normal release JAR

Files containing sources or dev-shadow are development artifacts and are not the normal runtime build.

Optional client configuration UI

Cloth Config is optional. When present, InspectMC exposes the same settings through /inspectmc-config, Mod Menu on Fabric, or the NeoForge mod configuration button.

On a dedicated server, the client-side screen cannot edit the remote server filesystem. The server administrator must edit the server's config/inspectmc.json.

Optional Cobblemon integration

Cobblemon is not required. Additional runtime diagnostics become available when Cobblemon 1.8.1 to 1.8.x and OS Cobblemon Library 1.1.x are both installed.

In-game toolkit

Commands

InspectMC groups inspection, search, runtime diagnostics, world queries and exports under /inspectmc.

Item and world inspection

/inspectmc hand

Compact main-hand summary. Use /inspectmc hand full for tags, components and additional copy actions.

/inspectmc inspect held [details]

Inspect the held item. The optional detailed view exposes additional technical data.

/inspectmc inspect block [distance|target [distance]|id <block_id> [distance]]

Inspect the block you are looking at or target a specific block ID.

/inspectmc inspect blockentity [distance]

Inspect a targeted block entity, including inventory and copyable NBT where available.

/inspectmc inspect entity [distance|look [distance]|target <selector>|id <entity_type> [distance]]

Inspect a targeted entity or select one through a selector or entity type.

/inspectmc inspect biome [details]

Inspect the current biome. details adds ambient, spawn and world-generation information.

/inspectmc inspect player [player]

Inspect yourself or, with the required permission, another player.

Registry search and locate

/inspectmc search <name or namespace>

Search partial IDs across items, blocks, block entities, fluids, particles, sounds, entity types and runtime biomes.

/inspectmc search page <page> <name or namespace>

Open a specific result page for a registry search.

/inspectmc locate block <block_id> [radius]

Locate nearby blocks of a specific ID.

/inspectmc locate entity <entity_type> [radius] [limit]

Locate nearby entities and return the nearest matching positions.

/inspectmc locate blockentity <block_entity_type> [radius] [limit]

Locate nearby block entities and return compact position and chunk information.

Loaded state and statistics

/inspectmc loaded chunks [map_radius_chunks]

Display loaded chunk information with a compact chunk map.

/inspectmc loaded entities [page]

List loaded entity types with pagination.

/inspectmc loaded blockentities

Summarize loaded block entities.

/inspectmc loaded dimensions

Summarize loaded dimensions, players, entities and forced chunks.

/inspectmc stats blocks [radius]

Collect block statistics around the executing player.

/inspectmc stats biomes [radius] [step]

Sample biome distribution around the executing player.

Pack information

/inspectmc pack <mods|datapacks|namespaces|registries> [page]

Browse loaded mods, active datapacks, namespaces or runtime registries.

Exports

/inspectmc dump biomes [excel|csv|json]

Export biome and biome-tag data. Excel is the default.

/inspectmc dump registries [json|csv|excel]

Export all runtime registries.

/inspectmc dump registry <registry_id> [json|csv|excel]

Export one registry.

/inspectmc dump tags <registry_id> [json|csv|excel]

Export tags for one registry.

/inspectmc dump recipes [json|csv|excel]

Export normalized recipe information.

/inspectmc dump spawns [json|csv|excel]

Export the optional Cobblemon spawn audit.

/inspectmc dump report

Create the complete ZIP diagnostic report.

Server-local settings

Configuration

InspectMC stores its server-local configuration in config/inspectmc.json.

The file is created when a configuration-aware command is first used. Changes are read when the server starts. Values outside their documented bounds fall back to defaults.

Option	Default	Purpose
`operatorPermissionLevel`	2	Vanilla permission level required for world, runtime and export diagnostics.
`defaultBlockDistance`	20	Default block and block-entity inspection distance.
`defaultEntityDistance`	20	Default entity inspection distance.
`defaultLocateResults`	8	Exact positions shown by locate commands when no limit is supplied.
`searchPageSize`	30	Registry search results shown per page.
`listPageSize`	50	Mods, datapacks, namespaces and runtime registries shown per page.
`loadedEntityPageSize`	25	Loaded entity types shown per page.
`maxDumpArchives`	0	Maximum timestamped archives retained per export. Zero keeps all archives.

Dedicated servers

The client configuration screen cannot write to a remote dedicated server. Edit that server's own config/inspectmc.json and restart the server.

Permission model

The configured operator level is used for world searches, another player's data, loaded-state diagnostics, statistics, pack information and dumps. Lower-risk local queries remain available without operator privileges.

Diagnostics & automation

Exports

Generate human-readable workbooks and stable machine-readable files from the live game state.

Output directory

inspectmc/dumps

Dumps are written relative to the game or server working directory. Every export keeps a timestamped archive and atomically updates a stable *-latest.* alias for scripts and bots.

Excel

/inspectmc dump biomes defaults to a real .xlsx workbook. It opens on an explanatory Overview sheet, followed by a filterable Biomes summary and a normalized Biome Tags sheet with one biome/tag relationship per row.

CSV

CSV is the stable RFC 4180 machine format for integrations that prefer flat files.

JSON

JSON exports use schema version 2, UTC timestamps and common Minecraft, InspectMC and loader metadata. IDs, tags, relations and recipes are sorted deterministically.

Complete report

/inspectmc dump report creates a ZIP containing:

manifest.json
a complete report.xlsx
normalized CSV files for mods, registries, entries, tags, biomes and recipes
detailed recipe JSON
active datapacks, loaded dimensions, forced-chunk counts and per-dimension entity summaries

Local convenience actions

When the generated file exists on the local machine, chat output can expose [Open file] and [Open folder] actions in addition to copying the path.

Optional integration

Cobblemon

InspectMC can audit loaded Cobblemon spawn resources and expose deeper runtime diagnostics without making Cobblemon a required dependency.

Spawn audit

/inspectmc spawn validate

Check malformed entries, duplicate spawn IDs, missing presets and unresolved biome, dimension or block references.

/inspectmc spawn here [page]

Browse compatible and potentially compatible spawn entries for the current location.

/inspectmc spawn explain <pokemon> [page]

Evaluate biome, dimension, height, light, sky visibility, weather and moon-phase conditions at the current position.

Validation warnings are not always errors

Another loaded datapack or optional mod can intentionally provide a reference. InspectMC therefore keeps unresolved optional relationships as warnings where appropriate.

Runtime API diagnostics

When Cobblemon 1.8.1 to 1.8.x and OS Cobblemon Library 1.1.x are both available, InspectMC enables an additional read-only runtime integration.

/inspectmc cobblemon status

Report whether the optional integration is available.

/inspectmc cobblemon entity [look [distance]|target <selector>]

Inspect Pokémon identity, form, shiny/Alpha state, aspects, labels, marks, types, ability category, size, owner, battle state and IV diagnostics.

/inspectmc cobblemon player [player]

Summarize Party, PC and Pokédex progress.

/inspectmc cobblemon find <property_query>

Search your owned Pokémon using native Cobblemon property syntax.

/inspectmc cobblemon find player <player> <property_query>

Operator form for searching another player's owned Pokémon.

Spawn exports

/inspectmc dump spawns defaults to an Excel audit containing Overview, Problems, Spawn Entries, Conditions, Presets, Buckets, Dependencies and Source Packs sheets. CSV gives one stable row per spawn entry, while JSON preserves normalized metadata and original loaded definitions.

Common checks

Troubleshooting

Start with the command, permission level and runtime location before digging into logs.

A command is denied

Check operatorPermissionLevel in config/inspectmc.json. World searches, loaded-state diagnostics, another player's data, statistics, pack information and dumps are intentionally permission-gated.

I cannot open a generated file

The file is created on the machine running the game or server. On a remote dedicated server, the local client cannot directly open a path that only exists on the server host. Copy the path or retrieve the file from the server filesystem.

Cobblemon commands are unavailable

Base InspectMC features do not require Cobblemon. The deeper runtime integration requires both Cobblemon 1.8.1 to 1.8.x and OS Cobblemon Library 1.1.x. Run /inspectmc cobblemon status to inspect availability.

Spawn data looks stale

InspectMC reads the datapack resources currently loaded by the server. After changing datapacks, run /reload before validating or explaining spawn data.

Can I use the 26.2 or 26.3 code?

Those directories are experimental forward-port work in the repository. The public 1.0.0 release target documented here is Minecraft 1.21.1.

Bug reports

For export or runtime issues, include the exact InspectMC version, loader, Minecraft version, command used and relevant logs. A complete /inspectmc dump report can be useful when the problem concerns registries, recipes, packs or world state.