旧工程迁移到新模组工程
中文 | 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 的方式升级。当时的安装布局见 模组工具更新记录。