关卡编辑器工具

这篇记我为什么开始写 Unity 编辑器工具、第一版踩了什么、以及最后做成一个 EditorWindow 的过程。它和玩法代码是两条不同的线:玩法是给玩家做的功能,工具是方便我开发的功能。

动机

动机一: 关卡里有一段需要沿 X 轴每隔 0.5 摆一个墙,为了不卡角还得每个在 Y 轴上有极小的偏移量。一共 30 多个。手动 Ctrl+D 复制、拖位置、改坐标。不仅慢,还容易摆歪、漏摆。

动机二 有一次墙滑/墙跳突然全部失效,查了很久才发现是搭墙的时候忘了把墙设成 WallJumpPlats 层

工具的价值不只是”快”,更是消除人为错误。

第一版:MenuItem + 写死参数

最省事的做法是给 Unity 菜单栏加一条命令:

public static class WallArrayTool
{
    [MenuItem("Tools/Wall Array/沿X阵列复制")]
    static void ArrayAlongX()
    {
        GameObject src = Selection.activeGameObject;   // 当前选中的对象
        int count = 30;  float dx = 0.5f, dy = -0.001f; // ← 参数写死在代码里

        for (int i = 1; i < count; i++)
        {
            GameObject clone = Object.Instantiate(src, src.transform.parent);
            clone.transform.position = src.transform.position + new Vector3(i * dx, i * dy, 0f);
            Undo.RegisterCreatedObjectUndo(clone, "Array");   // 让 Ctrl+Z 能撤销
        }
    }
}

能用。但换一段墙要改数量、改步进 就得回去改代码、等重编译。

第二版:EditorWindow

于是把它重做成一个带面板的编辑器窗口:

public class LevelToolsWindow : EditorWindow
{
    private float gridSize = 0.5f;
    private int arrayCount = 10;
    private float arrayDx = 0.5f, arrayDy = 0f;
    private int targetLayer = 0;

    [MenuItem("Tools/关卡工具")]
    private static void Open() => GetWindow<LevelToolsWindow>("关卡工具");

    private void OnGUI()
    {
        gridSize = EditorGUILayout.FloatField("网格大小", gridSize);
        if (GUILayout.Button("把选中对象吸附到网格")) SnapToGrid();

        arrayCount = EditorGUILayout.IntField("数量", arrayCount);
        arrayDx = EditorGUILayout.FloatField("X 步进", arrayDx);
        if (GUILayout.Button("生成阵列")) ArrayAlongX();

        targetLayer = EditorGUILayout.LayerField("目标层", targetLayer);
        if (GUILayout.Button("批量设置 Layer")) ApplyLayer();

        EditorGUILayout.LabelField($"当前选中:{Selection.gameObjects.Length} 个对象");
    }
}

现在参数在面板上直接调,不用改代码。

四个功能

批量设层是这么写的:

foreach (var go in Selection.gameObjects)
    foreach (var t in go.GetComponentsInChildren<Transform>(true))   // true = 含未激活的子物体
    {
        Undo.RecordObject(t.gameObject, "Set Layer");
        t.gameObject.layer = targetLayer;
    }

一个必须接的东西:Undo

编辑器工具不接 Undo,就等于不能用——用户按 Ctrl+Z 撤销不掉,那万一调错了就更痛苦了。两种场景分别用两个 API:

Undo.RecordObject(go.transform, "操作名");            // 修改已有对象前先记录
Undo.RegisterCreatedObjectUndo(newObject, "操作名");  // 新建对象后登记

对齐、吸附、批次设层属于前者;阵列复制的新对象属于后者。

收获

1. 不靠硬编码，可撤销(Undo)可太好用了。
2. 加速之前最好先解决防错。
3. MenuItem / EditorWindow / Selection / Undo / SerializedObject