Skip to content

游戏项目结构与编译入口 ​

用编辑器创建并打开游戏项目。业务代码写在该项目中;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 时,见自定义托管程序集。

首次设置见快速开始,运行验证见游戏项目验证。