io.github.dcd887由 GitHub 帳號 dcd887 發布v0.1.1更新於 Oct 29, 2026
Minecraft 模组语言文件翻译：扫描 jar、生成资源包
掃描 Minecraft 模組 jar 內的語言檔，呼叫 AI 翻譯介面產生中文資源包。
Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。
參照 儲存庫 中的啟動說明。
mcp-name: io.github.dcd887/mc-translator
Minecraft 模组中文翻译 MCP 工具
自动从模组 jar 包提取语言文件，调用通义千问批量翻译，生成中文资源包。
不绑定任何特定 AI 供应商。复制 .env.example 为 .env，填任一家的 key 即可（优先级 custom > agnes > dashscope，可选 DeepSeek 兜底）：
任选一种方式（检测到哪个 key 就用哪个）：
所有配置都从环境变量 /
.env读取，任何环境本地都能跑通、可移植。填好任一家的 key 即可开始翻译；改成别的供应商只需改.env，不用动代码。
先确认程序能跑（不联网）：
能看到命令帮助说明安装正常。若报 No module named mc_translator_mcp，说明没装好或没在项目目录下运行。
再确认 API Key 被正确加载：
.env 没生效或 key 填错，回查 .env 文件名（不要叫 .env.example）与变量名；
dry-run会抽样翻译少量条目（默认 20 条），消耗极少 token，是验证配置最直接的方式。
在 Trae/Claude Desktop 中配置 MCP server：
💡 先 preview 再翻译：翻译会消耗 token。正式翻译前先跑
preview看工作量和预估消耗，或dry-run抽样体验翻译质量，再决定是否执行。
直接对 Trae 说：
"帮我翻译这个模组：/path/to/mymod.jar"
Trae 会自动调用 MCP 工具的 translate_mod 或 translate_all_mods_in_directory。
所有
<jar_path>/<directory>都请替换成你的实际绝对路径，例如C:/Users/你的用户名/Desktop/mods/myzombie.jar。路径中含空格时记得加英文双引号。
默认输出到 output/ 目录，每个模组生成独立资源包：
加载方式：将 output/<modid>-zh-cn/ 文件夹复制到 Minecraft 的 resourcepacks/ 目录。
调用翻译时，会把「这是一个 Minecraft 1.20.1 整合包的模组语言文件」作为上下文注入提示词，并按以下规则约束翻译：
Block→方块、Item→物品、Inventory→背包、Health→生命、Craft→合成、Enchant→附魔、Tool→工具、Armor→盔甲、Chunk→区块Sodium→钠、Copper→铜{0}、%s、$variable$、§颜色码、<modid:item> 物品标签、\n 等原样保留<key>:<中文翻译> 返回，不做额外解释不同模组有自己的社区通认译名（如 Powah 的等级：Niotic→钻石、Spirited→富生、Nitro→下界），通用提示词无法提前知道。为此支持模组定制术语表：
translator_glossary.json（或通过 GLOSSARY_FILE 环境变量指定其它路径），格式为 { "terms": { "英文术语": "强制中文译名" } }：
你也可以直接在
translator.py的SYSTEM_PROMPT中补充通用规则，改完即生效。
.json（现代）、.lang（传统）与 .properties（部分老模组/Java 习惯）三种语言文件格式；.properties 源会自动转为 Minecraft 可加载的 zh_cn.json 输出來源：README.md，提交 6eb30c9
翻译单个 Minecraft 模组 jar 包，生成中文资源包。 Args: jar_path: 模组 jar 文件的绝对路径（如 C:\...\mymod-1.2.0.jar） batch_size: 每批翻译的词条数（默认 15，越大越快但单次请求更长） force_retranslate: 强制重新翻译（忽略缓存，慎用） Returns: 翻译结果摘要（包含每个模组的输出路径）
jar_path必填batch_sizeforce_retranslate（零成本）预览单个模组的汉化范围：列出每个语言文件、条目数与预估 token。 只做 jar 扫描与文本解析，**不调用任何 AI 翻译 API、不消耗 token、不写任何文件**， 用于在真正翻译前评估工作量与费用。 Args: jar_path: 模组 jar 文件的绝对路径 Returns: 预览摘要 JSON（含每个 modid 的格式、条目数、是否已有 zh_cn、社区估算 token）
jar_path必填预览翻译效果：解析单个模组并抽样翻译一小部分，**不写入任何文件**。 注意：本工具**会调用 AI 翻译 API 并消耗少量 token**（最多 `limit` 条样例）， 只用来快速感受翻译质量，不会生成资源包、不改动原 jar。 Args: jar_path: 模组 jar 文件的绝对路径 limit: 最多预览（抽样翻译）的条目总数（默认 20） batch_size: 每批翻译的词条数（默认 15） Returns: 预览 JSON，含原文-译文对照样例
limitjar_path必填batch_size批量翻译目录下所有模组 jar 包。 Args: directory: 包含模组 jar 的目录路径 glob_pattern: jar 文件匹配模式（默认 *.jar） batch_size: 每批翻译的词条数 force_retranslate: 强制重新翻译 Returns: 批量翻译汇总
directory必填batch_sizeglob_patternforce_retranslate已滿足適用檢查項的 90%
該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。
請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。
cd mc-translator-mcppip install -e .cp .env.example .env# 方式 A（推荐，最通用）：任意 OpenAI 兼容供应商 —— 自已填 key / 网关 / 模型名TRANSLATOR_API_KEY=sk-xxxTRANSLATOR_BASE_URL=https://your-gateway.example.com/v1TRANSLATOR_MODEL=your-model
# 方式 B：agnes ai# AGNES_API_KEY=sk-xxx# AGNES_BASE_URL=https://apihub.agnes-ai.com/v1# AGNES_MODEL=agnes-2.5-flash
# 方式 C：通义千问（阿里云百炼）—— https://bailian.console.aliyun.com/# DASHSCOPE_API_KEY=sk-xxx# QWEN_MODEL=qwen-plus
# 方式 D：DeepSeek（可选，主供应商失败时 fallback）# DEEPSEEK_API_KEY=# DEEPSEEK_MODEL=deepseek-chatpython -m mc_translator_mcp --helppython -m mc_translator_mcp dry-run "C:/path/to/某个模组.jar"python -m mc_translator_mcp{ "mcpServers": { "mc-translator-mcp": { "command": "python", "args": ["-m", "mc_translator_mcp"] } }}# 检查 jar 语言文件python -m mc_translator_mcp check <jar_path>
# 零成本预览：看会翻译哪些模组、多少条文本、预估 token（不调 AI、不写文件）python -m mc_translator_mcp preview <jar_path>
# 抽样翻译预览质量（会消耗少量 token，不写文件）python -m mc_translator_mcp dry-run <jar_path> [--limit 20]
# 翻译单个 jarpython -m mc_translator_mcp mod <jar_path> [--batch-size 15] [--force-retranslate]
# 批量翻译目录下所有 jarpython -m mc_translator_mcp dir <directory> [--glob "*.jar"] [--batch-size 15]# 翻译单个模组（把 <jar_path> 替换成你电脑上的实际路径，下同）python -m mc_translator_mcp mod "C:/path/to/mods/myzombie.jar" --batch-size 20
# 批量翻译整个 mods 目录python -m mc_translator_mcp dir "C:/path/to/.minecraft/mods" --glob "*.jar"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└── ...{ "terms": { "Niotic": "钻石", "Spirited": "富生", "Nitro": "下界", "Blazing": "烈焰" }}python -m pytest tests/ -v