mcntools - Minecraft 模组 JAR 文件硬编码翻译工具

一个用于提取和替换 Minecraft 模组 JAR 文件中字符串的 Python 工具。

项目地址

• github mcntools

界面展示

此处用深色主题展示，主题配色均来自ttkbootstrap

字符串常量预览界面

原文译文映射表

功能特性

• 字符串提取- 从 class 文件常量池中提取可翻译字符串
• 智能翻译- 支持 DeepSeek（推荐）和 Google 翻译引擎
• 批量操作- 提取、翻译、保存整个文件夹的字符串

安装指南

开发环境

# 克隆项目gitclone https://github.com/empyrealtear/mcntools.gitcdmcntools# 创建虚拟环境python-mvenv .venv# 激活虚拟环境## Windows.venv\Scripts\activate.bat## Linux/MacOSsource.venv/bin/activate# 安装依赖pipinstall-rrequirements.txt

运行应用

python src/main.py

打包发布

python build.py

打包后的可执行文件位于dist/mcntools.exe。

使用说明

基本流程

1. 打开 JAR 文件- 点击菜单栏或工具栏的打开按钮
2. 选择文件- 在左侧文件树中选择 Class 文件或文件夹
3. 提取字符串- 右键文件夹名"提取字符串"到 JSON 文件
4. 翻译字符串- 在表格中选择条目，点击"翻译原文"
5. 保存修改- 点击"保存 JAR"覆盖原文件（建议备份原文件）

翻译配置

在编辑栏底部配置翻译引擎：

• DeepSeek- 需要 API Key，支持更精准的翻译
• Google- 无需 API Key，自动检测源语言

配置文件

应用会自动创建config.json配置文件，保存用户的偏好设置：

• 目标语言
• 翻译引擎
• 主题设置
• DeepSeek API Key（可选）

许可证

本项目采用 MIT 许可证 - 详情请参阅 LICENSE 文件。

贡献

欢迎提交 Issue 和 Pull Request！

鸣谢

• 本项目受 mod 汉化工具 mcntools 的启发，特此感谢其作者 comeheres。
• 本项目使用 Trae IDE 进行开发。