面向玩家的 Minecraft 模组 / Addon 翻译工作区工具 A player-first translation workspace for Minecraft mods and addons.
模组灵译（Mod Lingo） 是一款面向 Minecraft 玩家与汉化维护者的跨平台桌面工具。
它的目标不是做一个“只能翻译单个文件”的小脚本，而是提供一个更接近 VS Code 工作区 的翻译体验： 用户打开一个项目，就是打开一个独立工作区； 如果需要同时处理多个项目，就分别使用多个窗口。
项目初期将聚焦于最常见、最稳定、最容易形成闭环的翻译场景：
langjsonjs
当前阶段主要处理这些文件中的键值型文本翻译，优先把“导入 → 浏览 → 翻译 → 导出”这条流程打通。
Mod Lingo 希望成为一个真正面向玩家的 Minecraft 翻译工具，而不是只给少数开发者使用的命令行脚本。
它优先解决的是这些问题：
- 英文模组 / Addon 游玩门槛高
- 语言文件分散，维护成本高
- 多文件翻译过程缺少统一工作区
- 玩家想批量处理文本，而不是手工改文件
- 汉化维护者需要一个更清晰的项目视图和编辑流程
项目初期先专注做好以下能力：
- 工作区管理
- 多窗口项目打开
lang/json/js文件导入- 键值文本识别
- 键值翻译与编辑
- 翻译结果导出
当前不会过度承诺复杂能力，例如：
- 通用硬编码文本扫描
- 字节码级文本提取
- 任意脚本语义分析
- 所有 Mod / Addon 格式的全自动兼容
这些方向未来可以继续扩展，但不是第一阶段重点。
Mod Lingo 的核心交互模型参考 VS Code：
- 一个窗口 = 一个工作区
- 一个工作区 = 一个独立项目上下文
- 多个工作区 = 多个独立窗口
这样设计的原因是：
- 更适合管理不同模组 / Addon 项目
- 降低多项目之间的状态污染
- 更清晰地维护项目缓存、翻译记录与导出结果
- 更符合桌面端重度工具的使用习惯
- 项目基础信息
- 文件树
- 待翻译键值列表
- 已翻译 / 未翻译状态
- 搜索与过滤
- 导出配置
- 项目缓存与翻译记录（后续）
.lang.json.js
- 键值对文本提取
- 翻译项浏览与编辑
- 批量翻译
- 保留原始键结构
- 导出可继续使用的结果文件
- 翻译模组语言文件
- 翻译 Addon 配置文本
- 翻译脚本中的键值型文案结构
- 对已有语言内容做整理、补全与批量维护
当前项目计划采用以下技术栈：
- Vue.js
- Vite
- Node.js 24
- pnpm
- 跨平台桌面应用
- 多窗口工作区架构
- 想汉化 Minecraft 模组的普通玩家
- 想维护整合包汉化内容的玩家
- 需要整理 Addon 文本的创作者
- 想用图形界面管理翻译项目的维护者
因为很多玩家真正需要的，不只是“一个会翻译的脚本”，而是一个：
- 能打开项目
- 能查看文件
- 能管理翻译项
- 能批量编辑
- 能导出结果
- 能长期维护
的图形化翻译工作区工具。
Mod Lingo 想做的，就是把 Minecraft 模组 / Addon 翻译这件事，从零散文件处理，变成一个更清晰、更稳定、更接近日常开发工具体验的流程。
- 基础应用框架
- 工作区创建与打开
- 多窗口支持
- 文件树展示
-
lang文件解析 -
json文件解析 -
js键值结构解析 - 翻译项列表
- 基础搜索与过滤
- 翻译编辑
- 导出结果
- 项目缓存
- 翻译记忆
- 术语表
- 批量任务
- 差异更新
- 更细粒度的文本识别规则
- 更多 Minecraft 文件格式支持
- 更复杂文本来源支持
- 更强的自动识别能力
- 更完整的项目级本地化流程
- 更深层的半自动翻译能力
本项目计划开源到 GitHub，欢迎参与：
- Issue 反馈
- 功能建议
- PR 贡献
- 测试样本提供
- 文件格式与规则补充
当前仍处于早期设计与实现阶段。 README 会随着架构与功能推进持续更新。
AGPL-3.0
模组灵译 Mod Lingo 让 Minecraft 模组 / Addon 翻译，从零散文件处理变成真正可用的工作区体验。