Use it with AI

On this website

1. Find your pack

   In Minecraft, click Singleplayer, click your world once, then Edit, then Open World Folder. Open the datapacks folder. Your pack is in there.

   If your pack is a folder and not a .zip, make it a .zip first. On Windows: right-click the folder, choose Send to, then Compressed (zipped) folder. On a Mac: right-click it and choose Compress.

2. Open MCDDD

   Click the green check in the hotbar at the top (at the bottom on a phone), or press 1. Or go to elkonia.com/mcddd.

3. Drop the pack in

   Drag your .zip onto the box that says Drop your pack's .zip here. On a phone, tap the box and pick the file.

   If your pack is on Modrinth, you can paste its link instead.

4. Read what it found

   Error means Minecraft will skip that file or the whole pack, so fix these first. Warning means it will probably cause trouble. Note is useful to know. Every line says which file, which line, and what to change.

   When nothing is left to fix and every check ran (tick JSON schemas in step 2 for that), you earn a badge you can show on your pack's page.

In an AI chat (ChatGPT, Gemini, Claude)

1. Is your pack on Modrinth?

   If it is on Modrinth, put your pack's link after the = and open this link yourself: the page checks the pack on its own. You can also give the link to an AI that can browse web pages, but most cannot run a page like this one, so opening it yourself is the sure way.

   https://elkonia.com/mcddd/?pack=PASTE-YOUR-PACK-LINK-HERE

   Copy

   If it is not on Modrinth, keep going.

2. Download the checker

   Download mcddd.zip

   Also find your pack's .zip (the first step of the website tab shows where).

3. Give both files to the AI

   Open a new chat. Click the paperclip or + button and attach mcddd.zip and your pack's .zip.

   The AI must be able to run Python code. ChatGPT, Claude and Gemini can on most plans. If it says it can't run code, use the website instead.

4. Paste this message

   Change my_pack.zip to your pack's file name, then send it:

   Please run this Python code using the two files I attached, and explain each problem it finds in simple words:
   
   import sys
   sys.path.insert(0, "mcddd.zip")
   from mcddd.validator import validate
   from mcddd.report import render_text
   print(render_text(validate("my_pack.zip")))

   Copy

   If the AI says it can't find a file, tell it: "Use the folder where you saved my attachments."

5. Know the difference

   The AI runs the same checks as the website, except the two deepest ones (command grammar and JSON fields), which need extra data the website loads for you. For the most thorough check, use the website.

Claude Desktop (MCP)

MCP is how AI apps plug in tools. Once you set this up, you can just say "check my pack" and Claude runs MCDDD itself. Ask a grown-up first if you are not allowed to install programs.

1. Install Python

   Go to python.org/downloads and click the big yellow Download Python button. Open the file you downloaded.

   On Windows, on the very first screen, tick the box that says Add python.exe to PATH. Then click Install Now.

   On a Mac, open the downloaded file and click Continue until it finishes.

2. Check that Python works

   Windows: press the Windows key, type cmd, press Enter. Mac: open Terminal. Type this and press Enter:

   python --version

   Copy

   You should see Python 3 and some numbers. On a Mac, type python3 --version instead.

3. Make a folder for the tool

   Windows: make a folder called MCTools right on your C: drive, so it is C:\MCTools. Mac: make a folder called MCTools in your home folder.

4. Download the checker

   Download mcddd.zip

   Move mcddd.zip into the MCTools folder. Do not unzip it.

5. Open Claude's settings file

   Open Claude Desktop. Open Settings, click Developer, then click Edit Config. A folder opens with a file called claude_desktop_config.json. Open that file in Notepad (Windows) or TextEdit (Mac).

6. Paste this in

   If the file is empty or only has {}, delete everything and paste this. On a Mac, change python to python3, and the path to /Users/YOUR-NAME/MCTools/mcddd.zip.

   {
     "mcpServers": {
       "mcddd": {
         "command": "python",
         "args": ["-m", "mcddd", "mcp"],
         "env": { "PYTHONPATH": "C:\\MCTools\\mcddd.zip" }
       }
     }
   }

   Copy

   If the file already has "mcpServers" in it, ask an adult or an AI to help you add the "mcddd" part. One missing comma breaks the whole file.

7. Save, quit, and reopen Claude

   Save the file. Then quit Claude fully. Windows: right-click the Claude icon by the clock and choose Quit. Mac: open the Claude menu and choose Quit. Then open Claude again.

8. Ask Claude to check your pack

   Start a new chat and type something like:

   Use mcddd to check my datapack at C:\Users\YOUR-NAME\AppData\Roaming\.minecraft\saves\My World\datapacks\my_pack.zip

   Copy

   Claude asks permission the first time it uses the tool. Say yes.

Claude Code

1. Download the checker

   Download mcddd.zip

   Save it somewhere, for example C:\MCTools\mcddd.zip. Do not unzip it. You need Python 3 installed.

2. Add it to Claude Code

   claude mcp add mcddd --env PYTHONPATH=C:\MCTools\mcddd.zip -- python -m mcddd mcp

   Copy

3. Ask

   "Check the datapack in ./datapacks/my_pack with mcddd." Claude Code gets every finding with its file, line and fix.