{"slug": "inspect-a-minecraft-mod-jar-from-the-terminal-with-jdx", "title": "Inspect a Minecraft mod jar from the terminal with jdx", "summary": "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.", "body_md": "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.\n\nThis 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.\n\n```\ncurl -fsSL https://raw.githubusercontent.com/MohammadMD1383/jdx/main/install-release.sh | bash\njdx version\n```\n\nOn 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.\n\n`./mods/YourMod.jar`.\n`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:\n\n```\njdx resources --jars ./mods/YourMod.jar --no-jdk\njdx resources fabric.mod.json --jars ./mods/YourMod.jar --no-jdk\njdx resources mixin --jars ./mods/YourMod.jar --no-jdk\n```\n\nThe 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.\n\nTo 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:\n\n```\njdx resources --cat fabric.mod.json --jars ./mods/YourMod.jar --no-jdk\n```\n\nBinary resources are not dumped as bytes; you get a size instead. Details: [jdx resources](https://mohammadmd1383.github.io/jdx/docs/reference/resources/).\n\n```\njdx search 'com.example.*' --jars ./mods/YourMod.jar --no-jdk\njdx outline com.example.YourMod --jars ./mods/YourMod.jar --no-jdk\njdx body 'com.example.YourMod#onInitialize()' --jars ./mods/YourMod.jar --no-jdk\n```\n\nReplace 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`.\n\njdx 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.\n\njdx does **not** remap. Names come out in whatever namespace the jar already uses. An obfuscated or Intermediary-only jar will answer in those names.\n\nIf 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.\n\n```\njdx members net.minecraft.world.item.ItemStack \\\n  --jars \"$HOME/.gradle/caches/fabric-loom/<ver>/minecraft-common.jar\" \\\n  --jars ./mods/YourMod.jar\n```\n\nClasspath options are in the [classpath guide](https://mohammadmd1383.github.io/jdx/docs/classpath/).\n\nv1.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)", "url": "https://wpnews.pro/news/inspect-a-minecraft-mod-jar-from-the-terminal-with-jdx", "canonical_source": "https://dev.to/mohammadmd1383/inspect-a-minecraft-mod-jar-from-the-terminal-with-jdx-2epk", "published_at": "2026-11-20 08:38:33+00:00", "updated_at": "2026-11-20 08:42:32.721929+00:00", "lang": "en", "topics": ["developer-tools", "ai-tools"], "entities": ["jdx", "Minecraft", "ASM", "Vineflower", "Fabric", "NeoForge", "MohammadMD1383"], "also_reported_by": [], "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.", "recommendation": null, "alternates": {"html": "https://wpnews.pro/news/inspect-a-minecraft-mod-jar-from-the-terminal-with-jdx", "markdown": "https://wpnews.pro/news/inspect-a-minecraft-mod-jar-from-the-terminal-with-jdx.md", "text": "https://wpnews.pro/news/inspect-a-minecraft-mod-jar-from-the-terminal-with-jdx.txt", "jsonld": "https://wpnews.pro/news/inspect-a-minecraft-mod-jar-from-the-terminal-with-jdx.jsonld"}}