Search Results for

    Show / Hide Table of Contents

    用 Unity 地图向导制作模组地图

    中文 | English

    在仓库根目录运行以下命令,用本机 Unity MCP 回放本页示例。 命令也会重拍两种语言的配图。

    python Docs/Manual/manual/tools/tutorials.py run map-wizard-tutorial --capture
    
    点击展开 MCP 操作点击收起 MCP 操作

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

    {
      "variables": {
        "map": "${fixture}/TutorialMapData.asset",
        "thumbnail": "Packages/com.shanghaiwindy.urpresources/Main/Maps/DefaultMap/DefaultMap_Thumbnail.png"
      },
      "calls": [
        {
          "tool": "invoke",
          "arguments": {
            "path": "static:UnityEditor.AssetDatabase/CreateFolder",
            "args": [
              "${fixtureParent}",
              "${folder}"
            ]
          },
          "expect": {
            "contains": "(String)"
          }
        }
      ]
    }
    
    1. 保存其他已打开的场景。在 SDK 的 GM 编辑器 → 地图与场景 → 地图创建 中输入一个未使用的地图名称,点新建地图并确认。向导会把名称转成小写,并打开新场景。
    点击展开 MCP 操作点击收起 MCP 操作
    [
      {
        "tool": "gm_describe",
        "arguments": {
          "id": "MapCreation"
        },
        "expect": {
          "contains": "CreateMap"
        }
      }
    ]
    
    点击展开 MCP 操作点击收起 MCP 操作

    在已保存的 SDK 工程中执行。执行前把 tutorialmap 改为未使用的名称,工具会切换当前场景。

    [
      {
        "tool": "gm_run",
        "arguments": {
          "id": "MapCreation",
          "action": "CreateMap",
          "params": "{\"mapName\":\"tutorialmap\"}",
          "confirm": true
        }
      }
    ]
    
    1. 用自己的内容替换默认地形和方块。把地形设到 Terrain 层,建筑物设到 Building 层。检查 TeamAStartPoint、TeamBStartPoint 和 PatorlPoint。在地图向导中可添加各类点。修改后点 Rebuild Path,如需重烘走路面则启用 Rebuild Navmesh,并保存场景。
    点击展开 MCP 操作点击收起 MCP 操作

    先打开自己的地图场景。添加点位后调整布局,再重建并保存。

    [
      {
        "tool": "gm_run",
        "arguments": {
          "id": "MapCreation",
          "action": "AddTeamAStartPoint"
        }
      },
      {
        "tool": "gm_run",
        "arguments": {
          "id": "MapCreation",
          "action": "AddTeamBStartPoint"
        }
      },
      {
        "tool": "gm_run",
        "arguments": {
          "id": "MapCreation",
          "action": "AddPatrolPoint"
        }
      },
      {
        "tool": "gm_run",
        "arguments": {
          "id": "MapCreation",
          "action": "RebuildPath",
          "params": "{\"rebuildNavmesh\":true}"
        }
      },
      {
        "tool": "invoke",
        "arguments": {
          "path": "static:UnityEditor.SceneManagement.EditorSceneManager/SaveOpenScenes",
          "args": []
        }
      }
    ]
    
    1. 打开生成的 MapData,填写地图显示名、支持模式和 700 × 200 流式缩略图。为需要测试的模式添加一项。流式缩略图使用已导入的图片资源。

    地图数据中的支持模式和流式缩略图

    点击展开 MCP 操作点击收起 MCP 操作
    [
      {
        "tool": "invoke",
        "arguments": {
          "path": "static:UnityEditor.AssetDatabase/CreateAsset",
          "args": [
            "@static:UnityEngine.ScriptableObject/CreateInstance(ShanghaiWindy.Core.MapData)",
            "${map}"
          ]
        },
        "expect": {
          "contains": "OK:"
        }
      },
      {
        "tool": "inspect_set",
        "arguments": {
          "path": "asset:${map}/guid",
          "value": "a9be4c0a-31a4-44e3-ac12-cf19312d60ec"
        },
        "expect": {
          "contains": "OK:"
        }
      },
      {
        "tool": "invoke",
        "arguments": {
          "path": "static:UnityEditor.AssetDatabase/AssetPathToGUID",
          "args": [
            "${thumbnail}"
          ]
        },
        "expect": {
          "contains": "(String)"
        },
        "capture": {
          "thumbnailGuid": {
            "regex": "\\(String\\) ([a-f0-9]{32})"
          }
        }
      },
      {
        "tool": "invoke",
        "arguments": {
          "path": "static:UnityEngine.JsonUtility/FromJsonOverwrite",
          "args": [
            "{\"supportModes\":[5]}",
            "@asset:${map}"
          ]
        },
        "expect": {
          "contains": "OK:"
        }
      },
      {
        "tool": "inspect_set",
        "arguments": {
          "path": "asset:${map}/localizedMapName/defaultName",
          "value": "Tutorial Map"
        },
        "expect": {
          "contains": "OK:"
        }
      },
      {
        "tool": "inspect_set",
        "arguments": {
          "path": "asset:${map}/streamingThumbnail/assetGUID",
          "value": "${thumbnailGuid}"
        },
        "expect": {
          "contains": "OK:"
        }
      },
      {
        "tool": "inspect_set",
        "arguments": {
          "path": "asset:${map}/streamingThumbnail/extra",
          "value": "${thumbnail}"
        },
        "expect": {
          "contains": "OK:"
        }
      },
      {
        "tool": "invoke",
        "arguments": {
          "path": "static:UnityEditor.EditorUtility/SetDirty",
          "args": [
            "@asset:${map}"
          ]
        },
        "expect": {
          "contains": "OK:"
        }
      },
      {
        "tool": "invoke",
        "arguments": {
          "path": "static:UnityEditor.AssetDatabase/SaveAssets",
          "args": []
        },
        "expect": {
          "contains": "OK:"
        }
      },
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${map}/supportModes/0"
        },
        "expect": {
          "contains": "(Mode) PlayField"
        }
      }
    ]
    
    1. 检查 MapBuildGroup 中关联的是你的场景与 MapData。打开 Assets/ModManager 中对应的构建管线和 ModPackageData,填写包信息。按目标平台构建资产与 .modpack 后安装测试。
    点击展开 MCP 操作点击收起 MCP 操作

    用你的地图名替换 tutorialmap。构建前填写 ModPackageData 的名称、说明、作者和支持链接。

    [
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:Assets/MapBuildGroup-tutorialmap.asset/mapDatas/0"
        }
      },
      {
        "tool": "modpack_plan",
        "arguments": {
          "pipeline": "Assets/ModManager/BuildPipline-Map-tutorialmap.asset"
        }
      },
      {
        "tool": "modpack_build",
        "arguments": {
          "pipeline": "Assets/ModManager/BuildPipline-Map-tutorialmap.asset"
        }
      }
    ]
    
    In this article
    Back to top Panzer War Document