Search Results for

    Show / Hide Table of Contents

    项目初始化

    中文 | English

    在仓库根目录运行以下命令,用本机 Unity MCP 回放本页示例。

    python Docs/Manual/manual/tools/tutorials.py run get-started
    
    点击展开 MCP 操作点击收起 MCP 操作

    准备教学样例。${变量} 由配方提供。

    {
      "variables": {
        "sdkCheckout": "../../../Panzer-War-Mod-SDK"
      },
      "calls": []
    }
    

    1. 下载并解压 SDK

    1. 打开 装甲纷争模组 SDK 发行页,展开 Assets。
    2. 下载名称为 Panzer-War-Mod-SDK-sdk-*.zip 的发行包(公开版 sdk-2026.11.04.1 约 600 MB)。它内含 DLL 和本地依赖,不需要 Git;自动生成的 Source code (zip) 可能只包含 Git LFS 指针。
    3. 按下载校验步骤对照发行版的 SHA256SUMS.txt 检查 ZIP。点击全部解压到新建目录,保留下方的目录结构。
    <任意解压目录>/
    ├─ Packages/                  # SDK 依赖包,与 UnityProject 同级
    └─ UnityProject/
       ├─ Assets/
       ├─ Packages/
       │  └─ manifest.json
       └─ ProjectSettings/
          └─ ProjectVersion.txt
    

    外层 Packages 提供工程引用的本地依赖,UnityProject 内部的 Packages/manifest.json 声明工程自身依赖。两者都要保留原位。使用 Git 的读者可改走克隆与 LFS 流程。

    2. 确认工程根目录和版本

    1. 打开 UnityProject,确认包含 Assets/、Packages/manifest.json 和 ProjectSettings/ProjectVersion.txt。
    2. 打开 ProjectVersion.txt,记录 m_EditorVersion。已核验的公开发行版 sdk-2026.11.04.1 声明 Unity 2022.3.62f1。
    3. 若下载的是更新版,读取该包的 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 打开工程

    1. 在 Unity Hub 的 Projects → Add → Add project from disk 中选择解压目录内的 UnityProject,不要选外层解压目录,也不要选 Assets 或 Packages。选到正确目录时,应能看到本教程第 2 节列出的三个位置。
    2. 在项目列表打开刚添加的工程,并用 ProjectVersion.txt 声明的同一版本打开。首次打开会下载包、导入资源并编译脚本,耗时明显长于后续启动;请等到 Hub 和编辑器进度结束。
    3. 编译完成后查看 Console,确认没有编译错误;通过时顶部会出现 Framework - 框架 菜单。找不到菜单时,依次检查:是否选的是内层 UnityProject、相邻 Packages 是否完整、解压是否中断、编辑器版本是否与声明一致。
    4. 若 Hub 提示缺少版本,先安装该编辑器再重新打开。典型故障:打开外层目录会提示不是 Unity 工程;解压不完整会报缺失包或 DLL;Packages 被移走会导致本地包无法解析。

    4. 先用随包模板验收项目

    1. 在 File → Build Settings 选择目标平台。Windows 选 PC, Mac & Linux Standalone → Windows → x86_64,Android 选 Android,再点击 Switch Platform。
    2. 在 Project 选中 Assets/ModManager/BuildPipline-Template-Vehicle.asset,点击 Build Linked Objects to AssetBundle,等待资源构建结束。
    3. 选 Assets/ModManager/Template-Blank-Vehicle.asset,点击 Package Mod Now。Windows 示例输出在 UnityProject/Build/Mod-Package/StandaloneWindows64/Template-Blank-Vehicle/ 下。切平台或改资源后,先重新构建链接资源再打包。
    4. 按安装模组导入与游戏平台一致的 .modpack。地图模板在同一目录下,改选 BuildPipline-Template-Blank.asset 与 Template-Blank-Scene.asset。

    第 3、4 步能生成模板包并在游戏中加载,说明工程与编辑器环境可用。接着按需设置 Steam 游戏目录,或开始从零制作第一辆坦克。如果使用能创建项目的 GameHub 版本,可参照环境配置打开它生成的工程。

    In this article
    Back to top Panzer War Document