主题
游戏项目结构与编译入口
用编辑器创建并打开游戏项目。业务代码写在该项目中;SDK 中的 api/ 是供查阅的声明,不是要复制进项目编译的框架源码。
按任务找到文件
| 位置 | 用途与修改方式 |
|---|---|
src/GameEntry.csproj | 游戏程序集与项目依赖;从这里编译游戏 |
src/ 下的业务 C# 文件 | 编写玩法和 UI,按实际 API 可用端使用 #if SERVER / #if CLIENT |
src/WasiCoreSDK.props | 编辑器生成的 SDK 路径配置;更换电脑后用编辑器打开项目刷新 |
editor/data/ | 数据编辑器保存的源数据;通过数据编辑器或对应 MCP 修改 |
DataGenerated 生成投影 | 检查数据生成结果;需要改变数据时回到源定义修改,不手改生成代码 |
ui/、res/ | 项目资源;二者的路径规则不同,见项目资源路径 |
docs/sdk/ | 项目引用的 SDK 文档入口,用来查 API 和指南 |
AGENTS.project.md | 项目自定义 AI 说明,编辑器刷新上下文时会合入生成入口 |
具体目录随模板不同而变化,以上按职责定位,不要求游戏采用固定的业务目录划分。项目根目录的 AGENTS.md、CLAUDE.md 和 .cursor/rules/project-context.mdc 会自动刷新,长期项目说明写入 AGENTS.project.md。
编译与依赖
在项目根目录分别执行:
powershell
dotnet build src/GameEntry.csproj -c Server-Debug
dotnet build src/GameEntry.csproj -c Client-Debug使用编辑器提供的 SDK 和模板依赖配置,不需要手动安排框架程序集的构建顺序。拆分业务程序集或引入自有 DLL 时,见自定义托管程序集。