MCP-Resource-Downloader

mcp
Security Audit
Warn
Health Warn
  • No license — Repository has no license file
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 6 GitHub stars
Code Warn
  • Code scan incomplete — No supported source files were scanned during light audit
Permissions Pass
  • Permissions — No dangerous permissions requested
Purpose
This tool is a Minecraft MCP resource downloader. It automates fetching specific resource files for Minecraft modding or development.

Security Assessment
A light code scan was unable to examine the Java source files directly. The project requests no dangerous system permissions. However, given its purpose, it inherently makes external network requests to download Minecraft resources. It does not appear to execute shell commands or leak hardcoded secrets. Because the underlying code could not be automatically verified, the overall risk is rated as Medium. You should manually verify what data the application transmits over the network.

Quality Assessment
The repository is highly active, with its latest push occurring today. Despite recent maintenance, the project suffers from extremely low community visibility, evidenced by only 6 GitHub stars. Furthermore, the tool lacks both a README file and an open-source license. The missing license means there are no clear legal terms regarding usage, modification, or distribution.

Verdict
Use with caution: the project is actively maintained but lacks a license, a README, and verifiable code transparency.
SUMMARY

Minecraft MCP Resource Downloader

README.md

MCP-Resource-Downloader

An alternative to downloading resource files for older versions of Minecraft for MCP (Minecraft-Coder-Pack).

Downloads directly from Minecraft servers. No middleman, no sketchy website.

CMD

Usage:

Normal: gradlew -p CMD run --args="{insert arguments here}"

Print out all Minecraft versions: gradlew -p CMD run

Arguments:

  • --mcp [MCP directory]
    • The directory of where MCP is (REQUIRED)
  • --mcVersion [Minecraft version]
    • The version of Minecraft to download resources (REQUIRED)
  • --jars
    • If jar files should be downloaded (OPTIONAL)
  • --client
    • If the client jar should be downloaded (REQUIRED if --jars used)
  • --server
    • If the server jar should be downloaded (REQUIRED if --jars used)
  • --libraries
    • If library jars should be downloaded (OPTIONAL)
  • --natives
    • If natives should be downloaded and extracted (OPTIONAL)
  • --linux
    • If Linux natives should be downloaded and extracted (NOT required even if --natives used)
  • --windows
    • If Windows natives should be downloaded and extracted (NOT required even if --natives used)
  • --w32
    • If Windows 32-bit natives should be downloaded and extracted (NOT required even if --windows used)
  • --w64
    • If Windows 64-bit natives should be downloaded and extracted (NOT required even if --windows used)
  • --osx
    • If OSX natives should be downloaded and extracted (NOT required even if --natives used)
  • --resources
    • If resources (sound, music) should be downloaded (OPTIONAL)
  • --local-assets
    • If local assets from the .minecraft should be used instead of downloading from the servers.
    • This will download the assets anyway, if it is missing from the .minecraft folder or fails the file hash check.
  • --forge
    • Does extra things for Forge, specifically.
    • Versions 1.2.3, 1.2.5, 1.3.2, 1.4.7, 1.5.2, 1.6.4 are the only compatible versions at this time.
    • You are free to try other versions, but do not expect it to work.
  • --overwrite
    • If downloaded files should be overwritten should one already exist (OPTIONAL)

Examples:

gradlew -p CMD run --args="--mcp mcp62 --mcVersion 1.2.5 --jars --client --libraries --natives --resources --overwrite"

gradlew -p CMD run --args="--mcp forge-1.4.7-6.6.2.534-src/forge/mcp --mcVersion 1.4.7 --jars --client --server --libraries --natives --linux --windows --osx --resources --forge --overwrite"

gradlew -p CMD run --args="--mcp mcp811 --mcVersion 1.6.4 --jars --client --libraries --natives --resources --overwrite"

Troubleshooting:

  • I keep getting error FileNotFoundException MCP directory "XXXXXX" does not exist!!
    • Make sure when inputting the --mcp argument you're using either a relative location to the CMD folder
      (if MCP folder is in root directory -where build.gradle is-, use ../<MCP directory>),
      or an exact location of where the MCP folder is (ex: C:\Users\<User>\Downloads\<MCP directory>).

GUI

Easier to use, however more limited than CMD.

Usage:

gradlew -p GUI run

Supported versions:

  • 1.19.2
    • Vanilla
  • 1.12
    • Vanilla
  • 1.8
    • Vanilla
  • 1.7.10
    • Vanilla
  • 1.6.2
    • Forge
      • Doesn't work due to MCP-RD not patching files - do NOT expect resolved issues on GitHub
  • 1.6.4
    • Vanilla
    • Forge
  • 1.5.2
    • Vanilla
    • Forge
  • 1.4.7
    • Vanilla
    • Forge
  • 1.3.2
    • Vanilla
    • Forge
  • 1.2.5
    • Vanilla
    • Forge
  • 1.2.3
    • Vanilla
    • Forge
  • Older
    • Maybe?

Known Issues:

  • Certain versions aren't working
    • Create a new GitHub issue with the specific version (both Minecraft and MCP) you're having troubles with.
  • Mac OS (OSX) users may not have natives extracted
    • Create a new issue.

Found an issue? Create a new issue on GitHub.

Workarounds:

  • 1.8+
    • Starting the client throws error Can't find the resource index file: assets/indexes/1.8.json
      • Another MCP problem. In directory <MCP Dir>/jars/assets/indexes, rename file <version>.json (ex: 1.12) to 1.8.json
  • 1.6+
    • MCP can't decompile because it tries copying launcher files
      • Manually run the decompile script with
        runtime/bin/python/python_mcp runtime/decompile.py --nocopy --client (Windows: runtime\bin\python\python_mcp.exe runtime\decompile.py --nocopy --client)
        (in MCP directory) after running MCP-RD in client mode.
  • 1.6
    • MCP can't decompile
      • Manually run install.cmd in command prompt or terminal
        • install.cmd --no-assets (Windows)
  • Mac OS (OSX) users may not have natives extracted
    • Manually extract jars files

Dependencies:

Moshi 1.15.1

Lombok 1.18.44

JavaFX 21 (controls, fxml)

Built with:

JetBrains IntelliJ Community Edition 2026.1

Eclipse Temurin JDK 21.0.4.7 (LTS)

Gradle 9.4.1

Lombok Gradle Plugin 9.2.0

JavaFX Plugin 0.1.0

License

Do not steal or claim this code as yours.

No derivative versions without releasing the source code.


Copyright Master801 2022-2024

Reviews (0)

No results found