翻译管理

翻译文件结构

翻译文件采用分层管理，按优先级从高到低：

1. 版本特定翻译 - data/translations/versions/{version}/{languageCode}.json
2. 通用翻译 - data/translations/common/{languageCode}.json
3. 官方翻译 - 自动下载的Mojang官方翻译

翻译继承机制

新版本会自动继承旧版本的翻译内容：

• 系统按时间顺序合并所有历史版本的翻译
• 只保留目标版本中存在的翻译键
• 避免了重复翻译工作

文件格式

翻译文件使用JSON格式：

{
  "gui.done": "完成",
  "gui.cancel": "取消",
  "menu.game": "游戏"
}

翻译工作流

1. 添加通用翻译

在 data/translations/common/ 目录创建语言文件：

echo '{}' > data/translations/common/my_lang.json

2. 添加版本特定翻译

为特定版本创建翻译：

mkdir -p data/translations/versions/1.21.6
echo '{}' > data/translations/versions/1.21.6/my_lang.json

3. 查看翻译进度

pnpm run cli progress

4. 验证翻译文件

pnpm run cli validate

多语言支持

• 每种语言独立管理
• 支持启用/禁用特定语言
• 支持RTL和双向文本
• 可配置基础语言