cd /news/developer-tools/inspect-a-minecraft-mod-jar-from-the… · home › topics › developer-tools › article
[ARTICLE · art-173137] src=dev.to ↗ pub= topic=developer-tools verified=true sentiment=↑ positive

Inspect a Minecraft mod jar from the terminal with jdx

A developer released jdx, an open-source command-line tool that inspects Minecraft mod jars without unzipping or executing them. Built on ASM bytecode parsing, jdx lists resources, searches classes, outlines members and decompiles method bodies with Vineflower, labeling reconstructed code so users know it is not original source. Version 1.7.0 requires Java 21+ and is licensed Apache-2.0.

key takeaway

jdx parses mod jars with ASM without loading or executing their classes, and flags Vineflower-decompiled method bodies as reconstructed so you don't mistake them for original source.

by read2 min views1 publishedNov 20, 2026

I built jdx mainly because I was writing Minecraft mods and wanted IDE answers about a jar I did not author — metadata, mixin configs, a class body — without unzipping it or running it.

This is a short walkthrough for a Fabric, Quilt, Forge or NeoForge mod jar you already have on disk. It is not a remapper, and it is a different tutorial from my earlier one about giving an AI agent an IDE for ordinary Java libraries.

curl -fsSL https://raw.githubusercontent.com/MohammadMD1383/jdx/main/install-release.sh | bash
jdx version

On Windows, use the PowerShell installer in the installation guide. Releases are unsigned, so Gatekeeper or SmartScreen may warn on first run.

./mods/YourMod.jar. jdx resources lists resource paths (anything that is not a .class). Pass the jar with --jars. --no-jdk keeps the running JDK off the classpath so you only see that jar:

jdx resources --jars ./mods/YourMod.jar --no-jdk
jdx resources fabric.mod.json --jars ./mods/YourMod.jar --no-jdk
jdx resources mixin --jars ./mods/YourMod.jar --no-jdk

The same command works for quilt.mod.json, mods.toml or neoforge.mods.toml — those are just path substrings. Mixin JSON is listed as an ordinary resource; jdx does not parse mixin configs.

To print the text of one unique path, use --cat. If more than one path matches, jdx exits 2 and lists the candidates instead of guessing:

jdx resources --cat fabric.mod.json --jars ./mods/YourMod.jar --no-jdk

Binary resources are not dumped as bytes; you get a size instead. Details: jdx resources.

jdx search 'com.example.*' --jars ./mods/YourMod.jar --no-jdk
jdx outline com.example.YourMod --jars ./mods/YourMod.jar --no-jdk
jdx body 'com.example.YourMod#onInitialize()' --jars ./mods/YourMod.jar --no-jdk

Replace the package and member with whatever search and outline actually printed for that jar. If there is no sources jar, body decompiles with Vineflower and labels the result ⚠ reconstructed, so you know it is not original source. The reading code guide covers show, members, outline and body.

jdx parses bytecode with ASM. It never loads or executes the classes it inspects, which is the point when the jar is someone else's mod.

jdx does not remap. Names come out in whatever namespace the jar already uses. An obfuscated or Intermediary-only jar will answer in those names.

If you want Mojmap or Yarn names for the game API, pass the remapped jar your toolchain already produced, for example Loom's minecraft-common.jar, with --jars. Auto-discovery can find Maven-style dependency jars from the Gradle or Maven caches; it will not find that remapped game jar for you.

jdx members net.minecraft.world.item.ItemStack \
  --jars "$HOME/.gradle/caches/fabric-loom/<ver>/minecraft-common.jar" \
  --jars ./mods/YourMod.jar

Classpath options are in the classpath guide.

v1.7.0, Apache-2.0, Java 21+. Docs: https://mohammadmd1383.github.io/jdx/ · source: https://github.com/MohammadMD1383/jdx

── more in #developer-tools 4 stories · sorted by recency
── more on @jdx 3 stories trending now
sponsored brought to you by zahid.host 4,200+ EU-deployed projects
reading about agents? ship yours in a single git push.

Run your AI side-project on zahid.host

EU-based hosting, git-push deploys, automatic HTTPS, no cold starts. Free tier with a custom domain — perfect for shipping the agent you just read about.

$git push zahid main
→ Live at https://your-agent.zahid.host ✓
Get free account → Pricing
from €0/mo · no card required
LIVE [news/inspect-a-minecraft-…] indexed:0 read:2min 2026-11-20 · —