多语言支持

语言配置

在 template.config.json 中配置多种语言：

{
  "languages": {
    "custom_zh_cn": {
      "name": "自定义中文",
      "region": "中国",
      "displayName": "Custom Chinese",
      "baseLanguage": "zh_cn",
      "bidirectional": false,
      "rtl": false,
      "enabled": true
    },
    "custom_en_us": {
      "name": "Custom English",
      "region": "United States",
      "displayName": "Custom English",
      "baseLanguage": "en_us",
      "bidirectional": false,
      "rtl": false,
      "enabled": false
    }
  }
}

语言属性说明

基础属性

• name - 语言的本地化名称
• region - 语言所属地区
• displayName - 在Minecraft中显示的名称
• baseLanguage - 基础官方语言代码

文本方向

• rtl - 是否为从右到左书写（如阿拉伯语、希伯来语）
• bidirectional - 是否支持双向文本

状态控制

• enabled - 是否启用该语言

翻译文件管理

每种语言都有独立的翻译文件：

data/translations/
├── common/
│   ├── custom_zh_cn.json
│   └── custom_en_us.json
└── versions/
    └── 1.21.6/
        ├── custom_zh_cn.json
        └── custom_en_us.json

构建行为

单语言构建

只构建启用的语言到资源包中

多语言构建

可选择包含多种语言在同一资源包中

语言代码映射

系统自动处理语言代码映射：

• 自定义语言代码 → Minecraft语言代码
• 支持自定义语言名称和显示文本

基础语言

每种自定义语言都基于一种官方语言：

• 用于下载官方翻译作为基础
• 确保翻译的完整性
• 提供回退翻译内容

管理命令

查看启用的语言：

pnpm run cli progress

为特定语言构建：

pnpm run cli pack -v 1.21.6 --language custom_zh_cn