项目初始化
中文 | English
在仓库根目录运行以下命令,用本机 Unity MCP 回放本页示例。
python Docs/Manual/manual/tools/tutorials.py run get-started
点击展开 MCP 操作点击收起 MCP 操作
准备教学样例。${变量} 由配方提供。
{
"variables": {
"sdkCheckout": "../../../Panzer-War-Mod-SDK"
},
"calls": []
}
1. 下载并解压 SDK
- 打开 装甲纷争模组 SDK 发行页,展开 Assets。
- 下载名称为
Panzer-War-Mod-SDK-sdk-*.zip的发行包(公开版sdk-2026.11.04.1约 600 MB)。它内含 DLL 和本地依赖,不需要 Git;自动生成的 Source code (zip) 可能只包含 Git LFS 指针。 - 按下载校验步骤对照发行版的
SHA256SUMS.txt检查 ZIP。点击全部解压到新建目录,保留下方的目录结构。
<任意解压目录>/
├─ Packages/ # SDK 依赖包,与 UnityProject 同级
└─ UnityProject/
├─ Assets/
├─ Packages/
│ └─ manifest.json
└─ ProjectSettings/
└─ ProjectVersion.txt
外层 Packages 提供工程引用的本地依赖,UnityProject 内部的 Packages/manifest.json 声明工程自身依赖。两者都要保留原位。使用 Git 的读者可改走克隆与 LFS 流程。
2. 确认工程根目录和版本
- 打开
UnityProject,确认包含Assets/、Packages/manifest.json和ProjectSettings/ProjectVersion.txt。 - 打开
ProjectVersion.txt,记录m_EditorVersion。已核验的公开发行版sdk-2026.11.04.1声明 Unity 2022.3.62f1。 - 若下载的是更新版,读取该包的
m_EditorVersion,按版本要求安装同一版本。
点击展开 MCP 操作点击收起 MCP 操作
针对并排存放的公开 SDK 验证工程版本、同级资源依赖和首个载具模板。SDK 在其他位置时,调整 sdkCheckout 指向它的外层目录。
[
{
"tool": "invoke",
"arguments": {
"path": "static:System.IO.Directory/Exists",
"args": [
"${sdkCheckout}/UnityProject/Assets"
]
},
"expect": {
"contains": "(Boolean) True"
}
},
{
"tool": "invoke",
"arguments": {
"path": "static:System.IO.File/ReadAllText",
"args": [
"${sdkCheckout}/UnityProject/ProjectSettings/ProjectVersion.txt"
]
},
"expect": {
"contains": "m_EditorVersion: 2022.3.62f1"
}
},
{
"tool": "invoke",
"arguments": {
"path": "static:System.IO.File/ReadAllText",
"args": [
"${sdkCheckout}/UnityProject/Packages/manifest.json"
]
},
"expect": {
"contains": "file:../../Packages/Sdk/com.shanghaiwindy.middlelayer"
}
},
{
"tool": "invoke",
"arguments": {
"path": "static:System.IO.File/Exists",
"args": [
"${sdkCheckout}/UnityProject/Assets/ModManager/BuildPipline-Template-Vehicle.asset"
]
},
"expect": {
"contains": "(Boolean) True"
}
},
{
"tool": "invoke",
"arguments": {
"path": "static:System.IO.File/Exists",
"args": [
"${sdkCheckout}/UnityProject/Assets/ModManager/Template-Blank-Vehicle.asset"
]
},
"expect": {
"contains": "(Boolean) True"
}
},
{
"tool": "invoke",
"arguments": {
"path": "static:System.IO.File/Exists",
"args": [
"${sdkCheckout}/Packages/Sdk/com.shanghaiwindy.middlelayer/package.json"
]
},
"expect": {
"contains": "(Boolean) True"
}
}
]
3. 在 Unity Hub 打开工程
- 在 Unity Hub 的 Projects → Add → Add project from disk 中选择解压目录内的
UnityProject,不要选外层解压目录,也不要选Assets或Packages。选到正确目录时,应能看到本教程第 2 节列出的三个位置。 - 在项目列表打开刚添加的工程,并用
ProjectVersion.txt声明的同一版本打开。首次打开会下载包、导入资源并编译脚本,耗时明显长于后续启动;请等到 Hub 和编辑器进度结束。 - 编译完成后查看 Console,确认没有编译错误;通过时顶部会出现 Framework - 框架 菜单。找不到菜单时,依次检查:是否选的是内层
UnityProject、相邻Packages是否完整、解压是否中断、编辑器版本是否与声明一致。 - 若 Hub 提示缺少版本,先安装该编辑器再重新打开。典型故障:打开外层目录会提示不是 Unity 工程;解压不完整会报缺失包或 DLL;
Packages被移走会导致本地包无法解析。
4. 先用随包模板验收项目
- 在 File → Build Settings 选择目标平台。Windows 选 PC, Mac & Linux Standalone → Windows → x86_64,Android 选 Android,再点击 Switch Platform。
- 在 Project 选中
Assets/ModManager/BuildPipline-Template-Vehicle.asset,点击 Build Linked Objects to AssetBundle,等待资源构建结束。 - 选
Assets/ModManager/Template-Blank-Vehicle.asset,点击 Package Mod Now。Windows 示例输出在UnityProject/Build/Mod-Package/StandaloneWindows64/Template-Blank-Vehicle/下。切平台或改资源后,先重新构建链接资源再打包。 - 按安装模组导入与游戏平台一致的
.modpack。地图模板在同一目录下,改选BuildPipline-Template-Blank.asset与Template-Blank-Scene.asset。
第 3、4 步能生成模板包并在游戏中加载,说明工程与编辑器环境可用。接着按需设置 Steam 游戏目录,或开始从零制作第一辆坦克。如果使用能创建项目的 GameHub 版本,可参照环境配置打开它生成的工程。