game-translator-mcp

Ein ein universelles MCP-Werkzeug für KI-Übersetzung von Spielen ins Chines – es scannt das Spieverzeichnis, ruft die KI-Übersetzung auf und scheicht den chinesischen Text zurück.

Positionierung: eine „Lokalisierungsfähigkeit", die von einem KI-Agenten aufgerufen werden kann, stätt einer eigenständigen SpieLokalisierungssoftware. Es kann mit Werkzeugen wie mc-translater-mcp, mc-pack-builder-mcp uszusammenarbeiten.

Anwendungsbereich

Dieses Werkzeug ist für Spiele/Mods, deren Texte als Klartextdatein gespeichert sind, gedacht – es handet sich um „Textokalisierung" und ncht um „Resscenpaket-Einfügung".

Nicht hinlnge/hinnende / Bekannte Schränkungen:

• Rie Ressourcen (#.-pakt / .vpk / catalog.json) in Unity müssen erstren entpackt werden.

• Unreal-Piele mit .locres wie Pal-word auf .locres-oe n.-.)" locial activ. Ausgabe ver.

• Von Servern "gefert" verteidte oder verschlüsselungerte Textt us wie among Among War Thunder / PUBG; zusätzliche Entpackt wird nicht unterstützt.

• Textdatein über 10 MB werden beimenn ausfallgelassen, um binärdatein zuern.

Hinweis: Unity-Iere haben zwar viele .json / .xml-Formate, aber meistens "giche oder "gleiche Konfigurung; der Scanner liefert so- or so all etxe zurü; ob es über die Übersetzung entsched, ist er Anwender.

Related MCP server: translator-ai

Voraussetzung

Der KI-Anbieterver wird vollständig vom Anwender ko nfiguriert (der deekannte Schlüß wird verwendet; Priorität custom- > agnes > heesh > deseks):

• eiger OpenAI-kompatibler Anbieter (ump fohlen, am vielfäligsten): TRANSLATOR_API_KEY + TRANSLATOR_BASE_URL + TRANSLATOR_MODEL, kompatibel mit Celigen Anbieterplattformen.

• agnes ai: AGNES_API_KEY + AGNES_BASE_URL + AGNES_MODEL

• Qwen (通义千问): Use DASHSCOPE_API_KEY

Need revert? Wait I wrote Chinese "Qwen (通义千问)"? Actually final draft has Qwen and DASHSCOPE? Source " DASHSCOPE". I'll ensure final not wrong.

Let's check: Should be DASHSCOPE_API_KEY (D A S H S C O P E). Good.

• DeepSeek (optional fallback): DEEPSEEK_API_KEY

安装

cd game-translator-mcp
pip install -e ".[dev]"

安装

No, "## 安装" not good. Use "## Install":

Wait, earlier I wrote "for 安装" is "Anstall". Actually we need "Install" or "安装"? "Installation" in German. I'd use "## Installation".

Ok.

Need revisit final plan in continuous text. I will now produce final output, careful with code names.

Let's craft fully.

Need maybe "MCP tool" table.

Let's finish using German.

Let's make final answer now in German, with no code# game-translator-mcp

Allgemeines MCP-Tool zur Spiel-Lokalisierung ins Chinesische – scannt Spielverzeichnisse, ruft KI-Übersetzungen auf und schreibt chinesischen Text zurück.

Positionierung: eine „Lokalisierungsfähigkeit“, die von einem KI-Agenten aufgerufen werden kann, statt einer eigenständigen Lokalisierungssoftware. Es kann mit Werkzeugen wie mc-translator-mcp, mc-pack-builder-mcpc usw. zusammenarbeiten.

Anwendungsbereich

Dieses Werkzeug eignet sich für die Übersetzung von Spiele/Mods, deren Text als Klartextdatei gespeichert ist. Es handelt sich also um „Textlokalisierung“ und nicht um „Resource-Injection“ .

Nicht temperament / bekannte Schränkungen:

• Unity-efüre Binärkategorien (t.tom / .vpq / catalog.json) müssen zuerst entpacken werden.

• Unreal-Spiele mit .locres (z. B. Palword) müssen mit UnrealPak entpackt werden.

• Server-el ezte oder verschulüsele Texte wie in War Thunder / PUBG werden nicht unterstützt – keine Cracks.

• Textdateein über 10 MB werden beim Scanneen übersprungen, um Binärdateien zu vermeiden.

Hinweis: Unity-Spiele haben zwar viele .json/.xml-Dateien, aber die meisten sind Engine-Konfigurationen statt Spieletexten. Der Scanner liefert sie wie sie sind; ob es das Übersetzen wirt, entscheided der Anwender.

Voraussetzungen

Der KI-Anbieter wird vollständig vom Anwender konfiguriert (der konfigurierte Schlüssel wird erkannt; Priorität custom > agnes > dashscope > deepseek):

• Eigerer OpenAI-kompatibler Anbieter (empfohfen, am allgemeinsten): TRANSLATOR_API_KEY + TRANSLATOR_BASE_URL + TRANSLATOR_MODEL, funktioniert mit jeder kompatiblen Plattform.

• agnes ai: AGNES_API_KEY + AGNES_BASE_URL + AGNES_MODEL

• Qwen (通义千问): DASHSCOPE_API_KEY

• DeepSeek (optionaler Fallback): DEEPSEEK_API_KEY

Installation

cd game-translator-mcp
pip install -e ".[dev]"

Konfiguration

Kopiere .env.example zu .env und fülle den gewünschten Anbieter aus:

cp .env.example .env

Wähle eine der Methoden (welcher Key erkannt wird, wird auch verwendet; Priorität custom > agnes > dashscope > deepseek):

# 方式 A（推荐，最通用）：自定义 OpenAI 兼容供应商 —— 填你自己的 key / 网关地址 / 模型名
TRANSLATOR_API_KEY=sk-xxx
TRANSLATOR_BASE_URL=https://your-gateway.example.com/v1
TRANSLATOR_MODEL=your-model

# 方式 B：agnes ai（也可展开为 OpenAi 兼容平台）
# AGNES_API_KEY=sk-xxx
# AGNES_BASE_URL=https://apihub.agnes-ai.com/v1
# AGNES_MODEL=agnes-2.5-flash

# 方式 C：通义千问
# DASHSCOPE_API_KEY=sk-your-qwen-key-here

# 方式 D：DeepSeek（可选，主供应商失败时 fallback）
# DEEPSEEK_API_KEY=

BATCH_SIZE=15                # 每批翻译条数，越高越省 token
OUTPUT_DIR=translated_output # 汉化输出目录

Priorität der Konfiguration: zuerst die Umgebungsvariablen, dann die .env-Datei im Projekroot, zuletzt die Standardwerte. Der API-Key muss selbst beschafft werden; wende dich an die jeweiligen Plattformen (z. B. agnes / Qwen / DeepSeek oder andere OpenAI-kompatible Gateways).

By / usability: Dieses Werkzeug ist an keinen Cloud-Anbieter gebunden; sobald auf der Zielmaschine ein beliebiges der oben genannten API-Key-Sets eingerichtet ist, läuft it or CI, in Docker oder zu allen Plattformen.

Starten

Als MCP-Server (zur Nutzung durch KI-Agenten)

python -m game_translator_mcp

Beispielkonfiguration für Trae / Claude Desktop:

{
  "mcpServers": {
    "game-translator-mcp": {
      "command": "python",
      "args": ["-m", "game_translator_mcp"]
    }
  }
}

LangChain-Agent-Integration (für PYTHONPATH auf src/):

{
  "mcpServers": {
    "game-translator-mcp": {
      "command": "python",
      "args": ["-m", "game_translator_mcp"],
      "env": {
        "PYTHONPATH": "/path/to/game-translator-mcp/src"
      }
    }
  }
}

CLI-Modus

# 扫描游戏目录，列出可翻译文件
python -m game_translator_mcp check <游戏目录路径>

# 执行完整汉化
python -m game_translator_mcp translate <游戏目录路径> --modid mygame

# 预览翻译效果（不写入文件）
python -m game_translator_mcp translate <游戏目录路径> --modid mygame --dry-run

# 列出 Steam 库中的可翻译游戏
python -m game_translator_mcp steam

MCP-Werkzeuge

Verwendungsbeispiele

Natürliche Sprachaufrufe (über Trae)

„Scanne meine Steam-Spiele daraufhin, welche übersetzbaren Texte haben.“

„Übersetze den englischen Text des Spiels 'RimWorld'.”

„Zeige mir eine Vorschau der Lokalisierung von 'Factorio', ohne Es tatsächlich zu schreiben.“

Direkte Terminal-Aufrufe

# 汉化一个模组目录
python -m game_translator_mcp translate "path/to/my-mod" --modid mymod

# 输出目录默认为 translated_output/
# 汉化报告自动生成到 translated_output/report.txt

Ausgabestruktur

translated_output/
├── my-mod/
│   ├── assets/my-mod/lang/zh_cn.json
│   └── ...（保持原目录结构）
├── rimworld/
│   ├── Assets/StreamingAssets/Localization/zh-cn.json
│   └── ...
└── report.txt           # 汉化报告

Kernmodule

Design-Prinzips

1. Write through caches: For {modid}::key::value wird SHA-256-Hash erzeugt; derselbe Originaltext wird nur einmal übersetzt und Ergebnisse bleiben translator_cache.json erhalten.

2. Lokalisierungs überspringen: Existiert bereits eine Übersetzung gleicher Formate im Ausgabeverzeichnis, wird sie automatisch übersprungen – Community-Übersetzungen bleiben zu überschreiben.

3. Batch-Übersetzung: In each request können bis zu BATCH_SIZE Einträge, ein API-Anruf liefert alle Ergebnisse; Tokenakosten und Verzögerung sinken deutlich.

4. Anbieter-Erkennung: Erkennt, welcher Key konfiguriert ist (Priorität custom > agnes > dashscope > deepseek), mit optionaler DeepSeek-Fallback; an keinem Anbieter gebunden.

5. Non-invasive output: Im Standardmodus copy erzeugt es ein separates Ausgabeverzeichnis ohne die Originaldateien zu verändern.

Tests

python -m pytest tests/ -v
# 或
pytest tests/ -v

Alle Tests in Windows + Python 3.14 bestanden (77 tests passed, incl. neuer VDF-UTF-16-Testfälle).

Reale Lokalisierungs Tests

Mit echten Spieldateien wurden Ende-zu-Tests (via agnes ai) durchgeführt; Ergebnisse unter demo/.test/reorts/README.md.

• ✅ REPO (Monster-Runner): Menu/HUD/Game.tsv insgesamt 603 Einträge, alle tatsächlich übersetzt und als TSV zurückgeschrieben, 602 erfolgreich

• ✅ Portal 2: Source-Engine-VDF (UTF-16) Ende-zu-Ende lokalisiert, basemodui_english.txt mit 2231 Klar-Text- übersetzungen, Rückgabe unter Beibehaltung der UTF-16-BOM

• ✅ Biped 2: localization_en.txt als Klartext key=value mit 928 Einträgen direkt übersetzbar

• 🔍 Andere Spiele (Isaac / Palworld / CSGO usw.): Texte in internen Ressourcen-Paketen gebunden oder nur Engine-Konfiguration, Details siehe Testreport

Mitwirken zur Spielebibliothek

Dieses Werkzeug unterstützt jedes Spiel/Modism, dessen Text in Klartextdateien gespeichert ist. Wenn deine Spielions als Klartextdatein (.json / .tsv / .lang / .sii / .vdf etc.) vorliegen, erweitert / die Kol zurück / Konfigurationen existieren. gen über Issue/PR die Bibliothek, um die vorhandenen Parsers erweitern genauer Anleitung siehe tests/reports/.

Verhältnis zur bestehenden Toolchain

Contribution Guide

Um Unterstützung für ein neues Spielformat hinzuzufügen:

1. Füge in parser.py eine neue Funktion hinzu (z. B. _parse_locres)

2. Registriere sie im _PARSERS-Wörterbuch

3. Füge die Erweiterung in scanner.py im SUPPORTED_EXTENSIONS-List hinzu

4. Füge TestFälle in tests/test_parser.py hinzu

Lizenz

MIT-Lizenz – zur freien Verwendung, Modifikation, Verteilung.