Minecraft Deobfuscator

v1.0.0Developer Toolsstable

Powerful and universal deobfuscator for Minecraft mods and java decompiler!

deobfuscate-minecraftdeobfuscationdeobfuscatorforge-tooljar-decompiler
Share:
239
Stars
0
Downloads
0
Weekly
0/5

What is Minecraft Deobfuscator?

Minecraft Deobfuscator is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to powerful and universal deobfuscator for minecraft mods and java decompiler!

Powerful and universal deobfuscator for Minecraft mods and java decompiler!

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Powerful and universal deobfuscator for Minecraft mods and j

Use Cases

Deobfuscate Minecraft mods and Java code automatically.
Decompile JAR files for reverse engineering purposes.
Analyze and modify Minecraft forge mods.
LicenseMIT
Languagetypescript
Versionv1.0.0
UpdatedMay 11, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx minecraft-deobfuscator3000

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Minecraft Deobfuscator

Minecraft Deobfuscator3000 is a universal GUI tool for deobfuscating and decompiling Minecraft mod JAR files using MCP (Mod Coder Pack) mapping files. It accepts obfuscated mod JARs alongside CSV mapping files for fields, methods, and parameters, then produces readable Java source code — making it indispensable for mod authors who need to analyse third-party mods, port mods to new Minecraft versions, or understand how Forge mods interact with the game internals. Version 1.2.0 and later include an integrated Procyon decompiler so decompilation and deobfuscation happen in a single step.

Prerequisites

  • Java Runtime Environment (JRE 8 or later) installed and on your PATH
  • Deobfuscation mapping files — either the built-in mappings for Minecraft 1.7.10 or 1.12.x, or a custom MCP conf folder extracted from the Mod Coder Pack
  • The obfuscated mod JAR file you want to deobfuscate
  • Windows OS (the installer is a Windows .exe; macOS/Linux users need to run the JAR directly)
  • Sufficient disk space for decompiled sources (plan for 2–5x the size of the input JAR)
1

Download and install Deobfuscator3000

Download the official Windows installer from the project's download page and run it. The installer places the Deobfuscator3000 JAR and bundled mappings in the chosen installation directory.

# Download the installer:
# https://download-deobfuscator3000.netlify.app/files/Deobfuscator3000%20setup.exe
# Run the .exe and follow the setup wizard.
2

Obtain deobfuscation mappings

For Minecraft 1.7.10 and 1.12.x, built-in mappings are included. For other versions, download the Mod Coder Pack from http://www.modcoderpack.com/ and extract the 'conf' folder which contains the fields.csv, methods.csv, and params.csv mapping files.

3

Launch the application

Start Deobfuscator3000 by double-clicking the desktop shortcut or running the JAR from the command line. Java must be installed and accessible from your PATH.

java -jar Deobfuscator3000.jar
4

Configure the mappings path

In the first text field of the GUI, enter the full path to your mappings folder (the conf folder containing fields.csv, methods.csv, and params.csv). You can also point it at a single CSV file if you only need field or method mappings.

5

Select the obfuscated mod JAR

In the second text field, enter the path to the mod JAR file you want to deobfuscate. The tool accepts individual JAR files or ZIP archives containing Java class files.

6

Run deobfuscation

Click the Deobfuscate button. The integrated Procyon decompiler will process the JAR and apply your mapping file simultaneously. A log console shows progress. Output is written to your desktop as a ZIP containing the decompiled, readable Java source files.

Minecraft Deobfuscator Examples

Client configuration

Deobfuscator3000 is a standalone GUI tool, not an MCP server. If you want to invoke it programmatically from an MCP context, you can wrap the JAR call. This example shows a basic Claude Desktop config that invokes the tool via the java command.

{
  "mcpServers": {
    "minecraft-deobfuscator3000": {
      "command": "npx",
      "args": ["minecraft-deobfuscator3000"],
      "env": {}
    }
  }
}

Prompts to try

Example prompts you can use when working with deobfuscated Minecraft mod sources.

- "Deobfuscate this Minecraft 1.12.2 mod JAR using the MCP 1.12.2 mappings"
- "Show me the readable source of the main mod class after deobfuscation"
- "What methods does the obfuscated class 'aab' map to using the MCP field mappings?"
- "Decompile and deobfuscate this Forge mod so I can understand how it hooks into the player tick event"

Troubleshooting Minecraft Deobfuscator

Application fails to start with 'java is not recognized' error

Install the Java Runtime Environment from https://adoptium.net/ and ensure JAVA_HOME is set correctly. Run 'java -version' in your terminal to confirm Java is on your PATH before launching Deobfuscator3000.

Mapping file is rejected as invalid

Mapping CSV files must have the key in the first column (containing an underscore or starting with #) and the mapped name in the second column. The two values must differ. Ensure your CSV is not comma-quoted in a way that breaks column parsing, and check that it is UTF-8 encoded.

Output Java source still contains obfuscated names

Verify you are pointing at the correct mappings version for your Minecraft version. Mappings for 1.7.10 will not correctly deobfuscate a 1.12.x mod. Download the matching MCP conf folder from modcoderpack.com and re-run with the version-matched mappings.

Frequently Asked Questions about Minecraft Deobfuscator

What is Minecraft Deobfuscator?

Minecraft Deobfuscator is a Model Context Protocol (MCP) server that powerful and universal deobfuscator for minecraft mods and java decompiler! It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Minecraft Deobfuscator?

Follow the installation instructions on the Minecraft Deobfuscator GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Minecraft Deobfuscator?

Minecraft Deobfuscator works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Minecraft Deobfuscator free to use?

Yes, Minecraft Deobfuscator is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "minecraft-deobfuscator3000": { "command": "npx", "args": ["-y", "minecraft-deobfuscator3000"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Minecraft Deobfuscator?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides