iDos Games 项目是一个基于 @idosgames npm 包、由宿主外壳和功能模块组成的 TypeScript 应用。 外壳提供登录和大厅；每个模块是一个系统（商店、任务……）或一个游戏；客户端与 iDos Games 游戏 API 通信，所以不需要你自己的服务器。
包
| 包 | 用途 |
|---|---|
@idosgames/core | 游戏 API 客户端：登录、玩家数据、经济和所有系统 |
@idosgames/app-shell | 宿主外壳：登录界面、大厅、导航和共享界面 |
@idosgames/module-sdk | 模块接入外壳时实现的约定 |
@idosgames/react | 共享 React 组件和 UI kit |
@idosgames/wallet | 代币充值和提取的钱包签名 |
@idosgames/mcp | 为 AI 智能体提供模块和技能的本地 MCP 服务器 |
项目结构
- 基础：来自
@idosgames/app-shell的登录和大厅，在src/app.config.ts中配置（起始界面、标签页顺序）。 - 系统：
src/modules/{id}/，每个系统一个文件夹。每个系统注册自己的大厅标签页，在应用中尚未为它做任何配置时会隐藏该标签页。 - 游戏：也是模块；大厅根据项目中的游戏生成“开始”列表。
- 外观：一个文件
src/ui.config.ts，控制主题、动画和声音。
使用代码
- 在后台的 AI 编程助手中：聊天、实时预览和版本历史。
- 用你自己的智能体：连接 MCP 服务器，让智能体使用模块和技能。
- 通过 GitHub：在后台为项目连接一个代码仓库。
常见问题
有 Unity 的 SDK 吗？
有，有一个调用同一游戏 API 的 Unity C# SDK。平台的新系统会单独接入它，所以请确认你需要的系统在那里已经可用。
我需要自己的后端吗？
不需要。账号、背包、经济、排行榜和其他系统都运行在 iDos Games 游戏 API 上。