# Inspect a Minecraft mod jar from the terminal with jdx

> Source: <https://dev.to/mohammadmd1383/inspect-a-minecraft-mod-jar-from-the-terminal-with-jdx-2epk>
> Published: 2026-11-20 08:38:33+00:00

**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.

I built [jdx](https://mohammadmd1383.github.io/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](https://mohammadmd1383.github.io/jdx/docs/installation/). 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](https://mohammadmd1383.github.io/jdx/docs/reference/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](https://mohammadmd1383.github.io/jdx/docs/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](https://mohammadmd1383.github.io/jdx/docs/classpath/).

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