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