mc-translator-mcp

MCP-Tool für chinesische Übersetzungen von Minecraft-Mods

Extrahiert automatisch Sprachdateien aus Mod-JAR-Dateien, übersetzt sie in Batches über 通义千问 und erzeugt ein chinesisches Ressourcenpaket.

Installation

cd mc-translator-mcp
pip install -e .

Related MCP server: NetEase ModSDK MCP Server

Konfiguration

Kopiere .env.example in .env und trage deinen 通义千问-API-Key ein:

cp .env.example .env
# 编辑 .env，填入 DASHSCOPE_API_KEY

API Key anfordern: 阿里云百炼控制台

Startoptionen

Als MCP-Server (empfohlen)

python -m mc_translator_mcp

Konfiguriere den MCP-Server in Trae/Claude Desktop:

{
  "mcpServers": {
    "mc-translator-mcp": {
      "command": "python",
      "args": ["-m", "mc_translator_mcp"]
    }
  }
}

CLI-Modus

# 检查 jar 语言文件
python -m mc_translator_mcp check <jar_path>

# 翻译单个 jar
python -m mc_translator_mcp mod <jar_path> [--batch-size 15] [--force-retranslate]

# 批量翻译目录下所有 jar
python -m mc_translator_mcp dir <directory> [--glob "*.jar"] [--batch-size 15]

Anwendungsbeispiele

MCP-Tools im Trae-Chat verwenden

Sag direkt zu Trae:

„Hilf mir, dieses Mod zu übersetzen: /path/to/mymod.jar"

Trae ruft dann automatisch das MCP-Tool translate_mod oder translate_all_mods_in_directory auf.

Lokal ausführen

# 翻译单个模组
python -m mc_translator_mcp mod "C:/Users/kjds/Desktop/mods/myzombie.jar" --batch-size 20

# 批量翻译整个 mods 目录
python -m mc_translator_mcp dir "C:/Users/kjds/Desktop/.minecraft/mods" --glob "*.jar"

Ausgabe

Die Ausgabe erfolgt standardmäßig in das Verzeichnis output/ – für jeden Mod wird ein eigenes Ressourcenpaket erzeugt:

output/
├── mymod-zh-cn/
│   ├── pack.mcmeta
│   └── assets/mymod/lang/zh_cn.json
├── zombie_mod-zh-cn/
│   ├── pack.mcmeta
│   └── assets/zombie_mod/lang/zh_cn.json
└── ...

Einbinden: Kopiere den Ordner output/<modid>-zh-cn/ in das Verzeichnis resourcepacks/ von Minecraft.

Kernmodule

Tests

python -m pytest tests/ -v

Designprinzipien

1. Ressourcenpaket zuerst: Standardmäßig wird ein separates Ressourcenpaket erzeugt, die Original-JAR-Datei bleibt unangetastet

2. Intelligenter Cache: Einträge mit demselben Originaltext + modid werden nur einmal übersetzt, um unnötigen Tokenverbrauch zu vermeiden

3. Vorhandene chinesische Übersetzungen überspringen: Wird eine vorhandene zh\_cn.json erkannt, wird automatisch übersprungen, um Community-Übersetzungen nicht zu überschreiben

4. Batch-Übersetzung: Maximal BATCH_SIZE Einträge pro Stapel, eine API-Aufruf liefert alle Ergebnisse zurück

5. Formatkompatibilität: Unterstützt .json (modern) und .lang (traditionell) als Sprachdateiformate