MC Language Template

一个功能完整的 Minecraft 语言包开发模板，支持多语言、多版本管理、官方翻译自动合并和统一打包发布。

✨ 特性

• 🌍 多语言支持 - 同时管理多种语言，灵活配置启用状态
• 📦 多版本管理 - 支持不同 Minecraft 版本，自动处理版本间差异
• 🔄 智能合并 - 自动下载官方翻译并与自定义翻译合并
• 🚀 一键打包 - 生成符合 Minecraft 标准的资源包
• ⚡ 版本继承 - 支持翻译在版本间的继承，避免重复工作
• 🛡️ 黑名单过滤 - 自动过滤调试信息、法律条款等不需要的翻译
• 📊 进度跟踪 - 可视化翻译完成度和缺失内容
• 🎨 高度可配置 - 通过配置文件轻松定制所有行为

🚀 快速上手

作为模板使用

1. 点击 "Use this template" 创建新仓库
2. 克隆你的新仓库
3. 初始化项目: pnpm run init (交互式配置)
4. 或手动配置: cp template.config.example.json template.config.json
5. 安装依赖: pnpm install
6. 开始翻译: 在 data/translations/common/ 添加你的翻译文件

详细步骤请查看 使用指南

本项目示例（LolCat 语言包）

本仓库同时也是一个 LolCat 语言包的实现示例，使用以下配置：

# 查看当前配置
cat template.config.json

# 查看翻译进度
pnpm run cli progress

# 构建资源包
pnpm run pack:latest

🛠️ 开发命令

# 开发模式
pnpm run dev

# 构建项目
pnpm run build

# 代码检查
pnpm run lint

# 查看翻译进度
pnpm run cli progress

# 构建资源包
pnpm run cli pack --all

📁 项目结构

mc-language-template/
├── template.config.json          # 模板配置文件
├── template.config.example.json  # 配置示例
├── TEMPLATE_USAGE.md             # 详细使用指南
├── src/                          # 源代码
│   ├── cli/                      # CLI 命令实现
│   ├── core/                     # 核心功能模块
│   ├── types/                    # TypeScript 类型定义
│   └── utils/                    # 工具函数
├── data/                         # 翻译数据
│   ├── translations/
│   │   ├── common/               # 通用翻译（所有版本共享）
│   │   └── versions/             # 版本特定翻译
│   ├── official/                 # 官方翻译缓存
│   └── blacklist.json           # 黑名单配置
├── config/
│   └── versions.json             # Minecraft 版本配置
├── public/
│   └── pack.png                  # 资源包图标
└── dist/packs/                   # 生成的资源包文件

🤝 贡献

欢迎贡献代码、报告问题或提出改进建议！

1. Fork 本仓库
2. 创建功能分支: git checkout -b feature/amazing-feature
3. 提交更改: git commit -m 'Add amazing feature'
4. 推送分支: git push origin feature/amazing-feature
5. 提交 Pull Request

📄 许可证

MIT License