Search Results for

    Show / Hide Table of Contents

    旧工程迁移到新模组工程

    中文 | English

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

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

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

    {
      "variables": {
        "sourceAssetDir": "${fixture}/.migration/legacy/Assets/MyMod",
        "backupAssetDir": "${fixture}/.migration/backup/Assets/MyMod",
        "targetAssetDir": "${fixture}/.migration/fresh/Assets/MyMod"
      },
      "calls": [
        {
          "tool": "invoke",
          "arguments": {
            "path": "static:UnityEditor.AssetDatabase/CreateFolder",
            "args": [
              "${fixtureParent}",
              "${folder}"
            ]
          },
          "expect": {
            "contains": "(String)"
          }
        },
        {
          "tool": "invoke",
          "arguments": {
            "path": "static:System.IO.Directory/CreateDirectory",
            "args": [
              "${fixture}/.migration/legacy/Assets/MyMod"
            ]
          },
          "expect": {
            "contains": "DirectoryInfo"
          }
        },
        {
          "tool": "invoke",
          "arguments": {
            "path": "static:System.IO.Directory/CreateDirectory",
            "args": [
              "${fixture}/.migration/backup/Assets"
            ]
          },
          "expect": {
            "contains": "DirectoryInfo"
          }
        },
        {
          "tool": "invoke",
          "arguments": {
            "path": "static:System.IO.Directory/CreateDirectory",
            "args": [
              "${fixture}/.migration/fresh/Assets"
            ]
          },
          "expect": {
            "contains": "DirectoryInfo"
          }
        },
        {
          "tool": "invoke",
          "arguments": {
            "path": "static:System.IO.File/WriteAllText",
            "args": [
              "${sourceAssetDir}/Example.lua",
              "return { name = \"Migration example\" }\n"
            ]
          },
          "expect": {
            "contains": "OK:"
          }
        },
        {
          "tool": "invoke",
          "arguments": {
            "path": "static:System.IO.File/WriteAllText",
            "args": [
              "${sourceAssetDir}/Example.lua.meta",
              "fileFormatVersion: 2\nguid: 8164f16a6ac0458b9dd5a79639ccb845\n"
            ]
          },
          "expect": {
            "contains": "OK:"
          }
        },
        {
          "tool": "invoke",
          "arguments": {
            "path": "static:System.IO.File/WriteAllText",
            "args": [
              "${sourceAssetDir}.meta",
              "fileFormatVersion: 2\nguid: 95f38d6822b44d6ab0dcacb51e81752e\nfolderAsset: yes\n"
            ]
          },
          "expect": {
            "contains": "OK:"
          }
        }
      ]
    }
    

    把完整 SDK 解压到新目录,再迁入自己的资源及其 .meta 文件。

    1. 备份旧工程并打开新工程

    复制旧工程的完整目录或保留版本库快照。从 GitHub 正式发行页下载名为 Panzer-War-Mod-SDK-sdk-*.zip 的资产并完整解压到新目录。保留同级的 UnityProject 和 Packages。按项目初始化在 Unity Hub 打开新 UnityProject,选择它声明的编辑器版本,等待首次导入和编译完成。

    2. 复制自己的资源

    把自己创建的 Assets 子目录复制到新工程的 UnityProject/Assets,保留相对路径,并带上文件和目录对应的 .meta。同时找出 Assets/ModManager 下属于自己的模组包与构建管线资产,带上它们的 .meta,核对关联对象和包 GUID。新 SDK 自带的 Packages 和样例留在新工程中。Steam 游戏目录等个人设置在新工程中重新填写。

    点击展开 MCP 操作点击收起 MCP 操作

    在独立目录演示复制和备份,并回读资源、文件 GUID 和目录 GUID。

    [
      {
        "tool": "invoke",
        "arguments": {
          "path": "static:UnityEditor.FileUtil/CopyFileOrDirectory",
          "args": [
            "${sourceAssetDir}",
            "${backupAssetDir}"
          ]
        },
        "expect": {
          "contains": "OK:"
        }
      },
      {
        "tool": "invoke",
        "arguments": {
          "path": "static:UnityEditor.FileUtil/CopyFileOrDirectory",
          "args": [
            "${sourceAssetDir}.meta",
            "${backupAssetDir}.meta"
          ]
        },
        "expect": {
          "contains": "OK:"
        }
      },
      {
        "tool": "invoke",
        "arguments": {
          "path": "static:UnityEditor.FileUtil/CopyFileOrDirectory",
          "args": [
            "${sourceAssetDir}",
            "${targetAssetDir}"
          ]
        },
        "expect": {
          "contains": "OK:"
        }
      },
      {
        "tool": "invoke",
        "arguments": {
          "path": "static:UnityEditor.FileUtil/CopyFileOrDirectory",
          "args": [
            "${sourceAssetDir}.meta",
            "${targetAssetDir}.meta"
          ]
        },
        "expect": {
          "contains": "OK:"
        }
      },
      {
        "tool": "invoke",
        "arguments": {
          "path": "static:System.IO.File/ReadAllText",
          "args": [
            "${targetAssetDir}/Example.lua"
          ]
        },
        "expect": {
          "contains": "return { name = \"Migration example\" }"
        }
      },
      {
        "tool": "invoke",
        "arguments": {
          "path": "static:System.IO.File/ReadAllText",
          "args": [
            "${targetAssetDir}/Example.lua.meta"
          ]
        },
        "expect": {
          "contains": "guid: 8164f16a6ac0458b9dd5a79639ccb845"
        }
      },
      {
        "tool": "invoke",
        "arguments": {
          "path": "static:System.IO.File/ReadAllText",
          "args": [
            "${targetAssetDir}.meta"
          ]
        },
        "expect": {
          "contains": "guid: 95f38d6822b44d6ab0dcacb51e81752e"
        }
      },
      {
        "tool": "invoke",
        "arguments": {
          "path": "static:System.IO.File/ReadAllText",
          "args": [
            "${sourceAssetDir}/Example.lua.meta"
          ]
        },
        "expect": {
          "contains": "guid: 8164f16a6ac0458b9dd5a79639ccb845"
        }
      },
      {
        "tool": "invoke",
        "arguments": {
          "path": "static:System.IO.File/ReadAllText",
          "args": [
            "${backupAssetDir}/Example.lua.meta"
          ]
        },
        "expect": {
          "contains": "guid: 8164f16a6ac0458b9dd5a79639ccb845"
        }
      }
    ]
    

    3. 检查引用并重新构建

    打开迁入的 prefab 和配置,检查缺失脚本、材质、着色器和依赖。按 多平台打包 逐个目标构建、测试,期间保留旧工程。

    点击展开 MCP 操作点击收起 MCP 操作

    检查当前连接的编辑器。真实新工程中的引用、编译和平台包需另行验证。

    [
      {
        "tool": "editor_status",
        "arguments": {},
        "expect": {
          "contains": "\"scriptCompilationFailed\": false"
        }
      },
      {
        "tool": "logs",
        "arguments": {
          "count": 10
        }
      }
    ]
    

    早期文档按 Runtime-Supports 识别旧工程,并使用原位替换 MiddleLibLayer 的方式升级。当时的安装布局见 模组工具更新记录。

    In this article
    Back to top Panzer War Document