Andmed Studio
一个专为游戏开发设计的资源管理 VS Code 扩展，提供完整的游戏资源创建、编辑、导出和多语言翻译功能。
✨ 特性
🎮 游戏资源管理
- 可视化资源管理器：直观的侧边栏界面，快速浏览和管理所有游戏资源
- 资源类型支持：支持 champion、skin、effect、reward、battlepass 等多种游戏资源类型
- 智能资源创建：通过模板快速创建新资源，自动生成标准目录结构
- 资源验证：自动检查资源完整性，确保数据格式正确
📦 双重导出系统
- 客户端资源包：生成适合 CDN 部署的客户端资源包，包含所有图片、音频等静态资源
- 服务端数据包：生成轻量级的服务端数据包，只包含游戏逻辑所需的核心信息
🌐 多语言翻译
- DeepL 集成：支持使用 DeepL API 进行自动翻译
- 批量翻译：一键翻译所有上下文文件
- 多语言支持：支持英语、日语、韩语等多种目标语言
🔧 开发工具
- 智能代码补全：为 JSON 配置文件提供智能提示
- 实时预览：支持资源的实时预览和编辑
- 错误检查：实时检查配置文件的语法和格式错误
📁 项目结构
your-game-project/
├── resource/ # 游戏资源目录
│ ├── champion/ # 英雄资源
│ │ ├── hero1/
│ │ │ ├── data.json # 英雄数据
│ │ │ ├── icon.png # 英雄图标
│ │ │ └── skills/ # 技能数据
│ │ └── hero2/
│ ├── skin/ # 皮肤资源
│ ├── effect/ # 特效资源
│ └── ...
├── output/ # 导出目录
│ ├── client/ # 客户端资源包
│ └── edge/ # 服务端数据包
└── translations/ # 翻译文件
🚀 快速开始
1. 安装扩展
从 VS Code 扩展市场安装 "Andmed Studio"
2. 打开项目
打开包含 resource 目录的游戏项目
3. 开始使用
- 在资源管理器中查看 "游戏资源管理器" 面板
- 右键点击文件夹创建新资源
- 使用命令面板 (Ctrl+Shift+P) 访问所有功能
📝 使用指南
创建新资源
- 在资源管理器中右键点击
resource 目录
- 选择 "创建新资源"
- 选择资源类型（champion、skin、effect 等）
- 输入资源名称
- 系统自动生成标准目录结构和配置文件
导出资源
- 在游戏资源管理器面板中点击导出按钮
- 选择导出类型：
- 客户端资源包：包含所有静态资源，用于上传到 CDN
- 服务端数据包：只包含游戏逻辑数据，用于游戏服务器
翻译资源
- 在设置中配置 DeepL API Key
- 右键点击 JSON 文件选择 "翻译此文件"
- 或使用命令面板执行 "翻译所有上下文文件"
⚙️ 配置选项
在 VS Code 设置中可以配置以下选项：
{
"andmed-studio.export.clientPath": "output/client",
"andmed-studio.export.edgePath": "output/edge",
"andmed-studio.translation.apiKey": "your-deepl-api-key",
"andmed-studio.translation.targetLanguages": ["en", "ja", "ko"]
}
🔥 新功能预览
v1.0.0 的主要改进：
- 全新 UI 界面：使用 React 构建的现代化用户界面
- 服务化架构：重构为基于服务的架构，提高可维护性
- 自动化 CI/CD：集成 GitLab CI/CD，自动构建和发布
- 性能优化：优化文件读写性能，支持大型项目
- 错误处理：改进错误处理和用户反馈机制
🛠️ 开发
环境要求
- Node.js 18+
- npm 或 yarn
- VS Code 1.86.0+
本地开发
# 克隆项目
git clone https://gitlab.com/your-username/andmed-studio
cd andmed-studio
# 安装依赖
npm install
# 启动开发模式
npm run watch
# 在 VS Code 中按 F5 启动调试
构建和发布
# 构建生产版本
npm run package
# 发布到 VS Code 市场
npm run deploy
🤝 贡献
欢迎提交 Issue 和 Pull Request！
📄 许可证
MIT License - 查看 LICENSE 文件了解详情
📞 支持
如果你在使用过程中遇到问题：
- 查看 GitHub Issues
- 提交新的 Issue 描述问题
- 查看项目 Wiki 了解更多使用技巧
享受游戏开发的乐趣！ 🎮✨
