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.

What you need

  • jdx v1.7.0 and a Java 21+ runtime (Linux, macOS or Windows). Install:
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.

  • A mod jar, for example ./mods/YourMod.jar.

1. List the non-class files

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.

2. Find a class, then read one method

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.

3. If you also want Minecraft names, pass the remapped game jar

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.

That's it

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