559 lines
29 KiB
Markdown
559 lines
29 KiB
Markdown
# 09 · 编辑器扩展
|
||
|
||
> **命名空间** `BaseGames.Editor`
|
||
> **所属文档集** [← 返回索引](./README.md) · [总览](./00_Overview.md)
|
||
> **程序集** `BaseGames.Editor.asmdef`（Editor-only，不打包进 Runtime）
|
||
|
||
---
|
||
|
||
## 目录
|
||
|
||
1. [设计原则](#1-设计原则)
|
||
2. [自定义 Inspector 列表](#2-自定义-inspector-列表)
|
||
3. [EditorWindow 工具列表](#3-editorwindow-工具列表)
|
||
4. [Scene 视图 Gizmos 汇总](#4-scene-视图-gizmos-汇总)
|
||
5. [Play Mode 调试叠加层](#5-play-mode-调试叠加层)
|
||
6. [ContextMenu 工具](#6-contextmenu-工具)
|
||
7. [编辑器菜单结构](#7-编辑器菜单结构)
|
||
8. [自动化检查工具](#8-自动化检查工具)
|
||
9. [高级工具集（补充）](#9-高级工具集补充)
|
||
|
||
---
|
||
|
||
## 1. 设计原则
|
||
|
||
- **编辑器扩展与运行时代码完全分离**：所有编辑器扩展代码置于 `Editor/` 文件夹，使用独立 `.asmdef`
|
||
- **工具服务于制作流程**：每个工具针对具体的制作痛点，不做泛用性过度设计
|
||
- **视觉化优先**：Gizmos 和自定义 Inspector 的目标是"**看一眼就知道配置是否正确**"
|
||
- **不破坏运行时行为**：所有 Inspector 修改通过 `SerializedObject.ApplyModifiedProperties()` 标准流程，支持撤销（Undo）
|
||
- **UI 技术选型**：所有编辑器扩展统一使用 **Unity UI Toolkit（UIElements）**，不使用 IMGUI（`OnGUI` / `EditorGUILayout`）
|
||
|
||
### UI Toolkit 统一规范
|
||
|
||
**自定义 Inspector** — 使用 `CreateInspectorGUI()` + `BindProperty()`：
|
||
|
||
```csharp
|
||
[CustomEditor(typeof(PlayerController))]
|
||
public class PlayerControllerEditor : Editor
|
||
{
|
||
public override VisualElement CreateInspectorGUI()
|
||
{
|
||
var root = new VisualElement();
|
||
|
||
// 默认字段绑定（替代 DrawDefaultInspector）
|
||
InspectorElement.FillDefaultInspector(root, serializedObject, this);
|
||
|
||
// 自定义运行时状态区
|
||
var statusFoldout = new Foldout { text = "运行时状态（Play Mode）" };
|
||
var stateLabel = new Label();
|
||
stateLabel.schedule.Execute(() =>
|
||
{
|
||
if (!EditorApplication.isPlaying) return;
|
||
var t = target as PlayerController;
|
||
stateLabel.text = $"State: {t.CurrentStateName} HP: {t.HP}/{t.MaxHP}";
|
||
}).Every(100); // 100ms 轮询
|
||
statusFoldout.Add(stateLabel);
|
||
|
||
// 调试按钮（Play Mode only）
|
||
var debugGroup = new VisualElement();
|
||
debugGroup.SetEnabled(false);
|
||
EditorApplication.playModeStateChanged += state =>
|
||
debugGroup.SetEnabled(state == PlayModeStateChange.EnteredPlayMode);
|
||
var hurtBtn = new Button(() => (target as PlayerController)?.TakeDamage(2)) { text = "Hurt 2" };
|
||
debugGroup.Add(hurtBtn);
|
||
|
||
root.Add(statusFoldout);
|
||
root.Add(debugGroup);
|
||
return root;
|
||
}
|
||
}
|
||
```
|
||
|
||
**EditorWindow** — 使用 `CreateGUI()` + 内置控件：
|
||
|
||
```csharp
|
||
public class MyTool : EditorWindow
|
||
{
|
||
[MenuItem("BaseGames/My Tool")]
|
||
public static void Open() => GetWindow<MyTool>("My Tool");
|
||
|
||
public void CreateGUI()
|
||
{
|
||
var splitView = new TwoPaneSplitView(0, 260f, TwoPaneSplitViewOrientation.Horizontal);
|
||
var left = new ScrollView();
|
||
var right = new VisualElement();
|
||
splitView.Add(left);
|
||
splitView.Add(right);
|
||
rootVisualElement.Add(splitView);
|
||
}
|
||
}
|
||
```
|
||
|
||
**§2–§9 各工具使用的关键 UI Toolkit 控件**：
|
||
|
||
| 工具 | 关键控件 | 说明 |
|
||
|------|---------|------|
|
||
| §2.x 自定义 Inspector | `ProgressBar`、`Foldout`、`Button`、`Label` | `CreateInspectorGUI()` 替代 `OnInspectorGUI()` |
|
||
| §2.3 ParrySystem（时间轴）| 自绘 `VisualElement`（`generateVisualContent` + `Painter2D`）| 替代 `GUI.Box` 手绘条 |
|
||
| §3.1–3.4 简单 EditorWindow | `ListView`、`Button`、`TextField` | `CreateGUI()` 替代 `OnGUI()` |
|
||
| §9.1 BT 验证器 | `TreeView` | 原生树形控件 |
|
||
| §9.2 进程流程图 | `GraphView`（`UnityEditor.Experimental.GraphView`）| 节点图；见注意事项 |
|
||
| §9.3 GameState 分析器 | `MultiColumnListView` | 矩阵视图 |
|
||
| §9.4 伤害模拟器 | `TwoPaneSplitView` + 自绘直方图（`Painter2D`）| 参数面板 + 分布图 |
|
||
| §9.7 装备预览 | `TwoPaneSplitView` + `DropdownField` | 响应式分栏 |
|
||
| §9.8 构建验证器 | `MultiColumnListView` + 可点击 `Label` | 多列结果 + 跳转 |
|
||
|
||
> **GraphView 注意**：`UnityEditor.Experimental.GraphView` 标注为 Experimental，API 可能在 Unity 版本间变动。如遇稳定性问题，9.2 进程流程图可改为 `VisualElement` 手绘节点（`generateVisualContent` + `Painter2D.DrawBezierCurve`），无需依赖 Experimental API。
|
||
|
||
**USS 样式文件存放**：`Assets/Editor/UI/USS/` — 统一样式变量（颜色、间距、字体大小），通过 `styleSheets.Add()` 挂载。
|
||
|
||
---
|
||
|
||
## 2. 自定义 Inspector 列表
|
||
|
||
### 2.1 PlayerController Inspector
|
||
|
||
**目标**：Play Mode 下直观监控玩家状态，快速触发测试。
|
||
|
||
**布局规划**：
|
||
|
||
```
|
||
┌─ PlayerController ─────────────────────────────────┐
|
||
│ ◈ 状态信息 │
|
||
│ ┌──────────────────────────────────────────────┐ │
|
||
│ │ Current State RunState │ │
|
||
│ │ HP ████████████░░ 8 / 10 │ │
|
||
│ │ Soul ███████░░░░░░░ 66 / 99 │ │
|
||
│ │ Geo 340 │ │
|
||
│ │ IsGrounded ✓ FacingDir → (+1) │ │
|
||
│ │ Invincible ░░░░░░░░░░ (0.00s remaining) │ │
|
||
│ └──────────────────────────────────────────────┘ │
|
||
│ ◈ 已解锁能力 │
|
||
│ ┌──────────────────────────────────────────────┐ │
|
||
│ │ [✓ Parry] [✓ DoubleJump] [✗ WallJump] │ │
|
||
│ │ [✗ AerialDash] [✗ Swim] │ │
|
||
│ └──────────────────────────────────────────────┘ │
|
||
│ ◈ 调试工具（Play Mode Only） │
|
||
│ [Force Idle] [Force Run] [Force Air] │
|
||
│ [Deal Damage: 2] [Deal Damage: 10] [Instant Kill] │
|
||
│ [Add Soul: 33] [Add Geo: 100] │
|
||
│ [Unlock All Abilities] [Lock All Abilities] │
|
||
└────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
**实现方式**：继承 `Editor`，重写 `CreateInspectorGUI()` 返回 `VisualElement` 树。进度条使用 UI Toolkit `ProgressBar` 控件；Play Mode 限定区域通过 `debugGroup.SetEnabled(EditorApplication.isPlaying)` + `EditorApplication.playModeStateChanged` 回调控制显隐。
|
||
|
||
---
|
||
|
||
### 2.2 EnemyBase Inspector
|
||
|
||
**目标**：快速查看敌人 AI 状态，测试战斗参数。
|
||
|
||
```
|
||
┌─ EnemyBase ──────────────────────────────────────┐
|
||
│ ◈ 运行时状态（Play Mode） │
|
||
│ State: Controlled HP: █████████░ 90/100 │
|
||
│ BD Node: BD_MoveToPlayer (Running) │
|
||
│ Nav Status: Moving → (12.5, -3.0) [0.8m left] │
|
||
│ ◈ 属性配置 │
|
||
│ Stats SO: [ES_GruntWarrior ▼] │
|
||
│ AnimCfg : [EA_GruntWarrior ▼] │
|
||
│ ◈ 调试工具（Play Mode Only） │
|
||
│ [Force Stagger] [Force Death] [Reset HP] │
|
||
│ [Disable BD] [Enable BD] [Reload BD Tree] │
|
||
└──────────────────────────────────────────────────┘
|
||
```
|
||
|
||
---
|
||
|
||
### 2.3 ParrySystem Inspector
|
||
|
||
**目标**：可视化弹反时间轴，测试弹反参数。
|
||
|
||
```
|
||
┌─ ParrySystem ────────────────────────────────────┐
|
||
│ ◈ 时间轴预览 │
|
||
│ [▌ Startup ▌▌▌▌▌▌▌ Active Window ▌▌ Endlag ▌] │
|
||
│ 0.05s 0.28s 0.10s │
|
||
│ ◈ 运行时状态（Play Mode） │
|
||
│ State: Active Timer: 0.19s / 0.28s │
|
||
│ Window: ████████████░░░ 68% │
|
||
│ CounterW: ────────────── (Inactive) │
|
||
│ ◈ 调试工具 │
|
||
│ [Trigger Parry Success] [Trigger Parry Fail] │
|
||
│ [Open Counter Window] [Reset] │
|
||
└──────────────────────────────────────────────────┘
|
||
```
|
||
|
||
**时间轴预览** 在 Edit Mode 下也可显示（根据 `ParryConfigSO` 参数计算比例），方便策划调整数值时直观预览窗口比例。
|
||
|
||
---
|
||
|
||
### 2.4 RoomCameraBounds Inspector
|
||
|
||
**目标**：防止镜头边界配置错误。
|
||
|
||
```
|
||
┌─ RoomCameraBounds ───────────────────────────────┐
|
||
│ ◈ 边界检查 │
|
||
│ Bounds Size: (32.0, 18.0) │
|
||
│ Camera View (4.22 OrthoSize): (29.9, 16.8) │
|
||
│ Status: ✓ 边界大于镜头视野 │
|
||
│ ─────────────────────────────────────────────── │
|
||
│ [Preview Camera View in Scene] │
|
||
│ [自动调整 PolygonCollider2D 至最小安全尺寸] │
|
||
└──────────────────────────────────────────────────┘
|
||
```
|
||
|
||
---
|
||
|
||
### 2.5 DamageSourceSO Inspector
|
||
|
||
**目标**：策划配置攻击参数时，即时预览伤害计算和属性。
|
||
|
||
```
|
||
┌─ DamageSourceSO ─────────────────────────────────┐
|
||
│ ◈ 伤害预览 │
|
||
│ BaseDamage × Multiplier = Final │
|
||
│ 5 × 1.0 = 5 │
|
||
│ ◈ 击退预览 │
|
||
│ KnockbackForce: 8.0 Direction: → │
|
||
│ HitStun: 0.30s │
|
||
│ ◈ 属性标记 │
|
||
│ [CanBeParried ✓] [Unblockable ✗] [IgnoreIFrame ✗]│
|
||
│ ◈ 伤害类型 │
|
||
│ Type: Normal (物理) │
|
||
│ HitFxType: Slash │
|
||
└──────────────────────────────────────────────────┘
|
||
```
|
||
|
||
---
|
||
|
||
## 3. EditorWindow 工具列表
|
||
|
||
### 3.1 房间连接验证工具
|
||
|
||
**菜单路径**：`BaseGames > World > Room Connection Validator`
|
||
|
||
**功能**：
|
||
|
||
```
|
||
┌─ Room Connection Validator ──────────────────────────────────────┐
|
||
│ 扫描所有 Room_*.unity 场景中的 RoomTransition 组件 │
|
||
│ │
|
||
│ 房间 出口ID 目标场景 │
|
||
│ ────────────────────────────────────────────────────────────── │
|
||
│ Room_Forest_01 Door_To_Forest_02 ✓ Room_Forest_02 存在 │
|
||
│ Room_Forest_02 Door_To_Cave_01 ✓ Room_Cave_01 存在 │
|
||
│ Room_Cave_01 Door_To_Boss ✗ Boss_Cave 不存在 ⚠ │
|
||
│ │
|
||
│ SpawnPoint 检查: │
|
||
│ Room_Forest_02 缺少 SpawnPoint "SP_From_Forest_01_Door" ⚠ │
|
||
│ │
|
||
│ [重新扫描] [选中有错误的场景] [导出验证报告.md] │
|
||
└──────────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
---
|
||
|
||
### 3.2 SO 事件频道监视器
|
||
|
||
**菜单路径**：`BaseGames > Core > Event Channel Monitor`
|
||
|
||
**功能**：Play Mode 下实时监听所有 SO 事件频道的触发情况。
|
||
|
||
```
|
||
┌─ Event Channel Monitor ──────────────────────────────────────────┐
|
||
│ [▶ Play Mode Only] [清除日志] [暂停记录] │
|
||
│ │
|
||
│ 时间 事件频道 数据 │
|
||
│ ────────────────────────────────────────────────────────────── │
|
||
│ 0.012s OnPlayerHPChanged value: 8 │
|
||
│ 0.013s OnHitConfirmed DMG:5, Knockback:8.0 │
|
||
│ 1.245s OnParrySuccess DMG:5, Flags: CanBeParried │
|
||
│ 1.248s OnPlayerHPChanged value: 8 (no change) │
|
||
│ 2.001s OnRoomEntered Transform: Room_Forest_01 │
|
||
│ │
|
||
│ [筛选频道: ___________] [仅显示Player] [仅显示Combat] │
|
||
└──────────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
---
|
||
|
||
### 3.3 NavSurface 快速烘焙工具
|
||
|
||
**菜单路径**：`BaseGames > Navigation > Quick Bake All Rooms`
|
||
|
||
一键遍历所有场景中的 `NavSurface`，按顺序烘焙 PathBerserker2d 导航网格并保存场景：
|
||
|
||
```
|
||
┌─ NavSurface Bake Tool ──────────────────────────────────────────┐
|
||
│ 扫描到 NavSurface 数量: 12 │
|
||
│ │
|
||
│ Room_Forest_01: ✓ 已烘焙 (2024-01-01 12:00) │
|
||
│ Room_Forest_02: ⚠ 需要重新烘焙（场景已修改） │
|
||
│ Room_Cave_01: ✓ 已烘焙 │
|
||
│ │
|
||
│ [烘焙全部] [仅烘焙已修改] [验证所有路径连通性] │
|
||
└─────────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
---
|
||
|
||
### 3.4 SaveData 查看器
|
||
|
||
**菜单路径**：`BaseGames > World > SaveData Viewer`
|
||
|
||
```
|
||
┌─ SaveData Viewer ───────────────────────────────────────────────┐
|
||
│ Slot 0 | Slot 1 | Slot 2 │
|
||
│ ───────────────────────────────────────────────────────────── │
|
||
│ Player: HP 5/5 | Geo 340 | Soul 66/99 │
|
||
│ Scene: Room_Forest_01 @ SP_Forest_01_Entry │
|
||
│ Abilities: Parry✓ DoubleJump✓ WallJump✗ Dash✗ Swim✗ │
|
||
│ Discovered: 3 rooms | Cleared: 1 | Bosses Defeated: 0 │
|
||
│ ───────────────────────────────────────────────────────────── │
|
||
│ [JSON 原始视图] [编辑并保存] [删除此存档] │
|
||
└─────────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
---
|
||
|
||
## 4. Scene 视图 Gizmos 汇总
|
||
|
||
| 组件 | Gizmo 形状 | 颜色 | 说明 |
|
||
|------|-----------|------|------|
|
||
| `HitBox` | BoxWire | 橙色（激活：实心50%透明）| 攻击判定区域 |
|
||
| `HurtBox` | BoxWire | 绿色（受击中：红色闪烁）| 受击区域 |
|
||
| `SpawnPoint` | 旗帜Icon + 文字 | 绿色 | 玩家出生点标识 |
|
||
| `RoomTransition` | 箭头 → 目标场景文字 | 蓝色 | 房间出口方向 |
|
||
| `RoomCameraBounds` | Polygon + 内层相机视野矩形 | 青色 | 镜头约束范围 |
|
||
| `EnemyBase` 检测范围 | 圆圈 | 黄色 | 玩家检测半径 |
|
||
| `EnemyBase` 攻击范围 | 圆圈 | 红色（实线）| 攻击触发范围 |
|
||
| `EnemyBase` 巡逻路径 | 线段 + 端点 | 蓝色虚线 | 巡逻 A~B 路径 |
|
||
| `EnemyBase` 寻路目标 | 箭头 | 绿色 | 当前导航目标 |
|
||
| `EnemyBase` 视线检测 | 射线 | 青色（遮挡：红色）| Raycast 视线 |
|
||
| `NavLink` | 弧形箭头 | 紫色 | 导航跳跃链接 |
|
||
| `HazardZone` | BoxWire | 红色（实心30%透明）| 危险区域范围 |
|
||
| `AbilityUnlock` | 星形Icon | 金色 | 能力解锁物件标识 |
|
||
| `SavePoint` | 旗帜Icon（已激活/未激活）| 蓝色/灰色 | 存档点状态 |
|
||
| `ParrySystem`（窗口中）| 圆圈动画 | 黄色 | 弹反窗口激活指示 |
|
||
|
||
---
|
||
|
||
## 5. Play Mode 调试叠加层
|
||
|
||
`DebugOverlayWindow`：按 F1 键（仅 Development Build 和 Editor 中）显示调试叠加层。
|
||
|
||
### 叠加层布局
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────────────┐
|
||
│ [F1 关闭] FPS: 144 │
|
||
│ │
|
||
│ Player State: RunState HP: 8/10 Soul: 66 Geo: 340 │
|
||
│ IsGrounded: ✓ Facing: → Invincible: ✗ │
|
||
│ │
|
||
│ Active Camera: VCam_Explore Blend: Complete │
|
||
│ Current Room: Room_Forest_01 │
|
||
│ │
|
||
│ Enemies in Scene: 2 Alive: 1 Dead: 1 │
|
||
│ │
|
||
│ ─────────── 快捷键 ─────────────────────────────────────── │
|
||
│ F2 切换无敌 F3 加满 Soul F4 下一检查点 F5 重新加载场景 │
|
||
│ F6 切换 Gizmos F7 切换碰撞体显示 F8 切换 AI 暂停 │
|
||
└─────────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
---
|
||
|
||
## 6. ContextMenu 工具
|
||
|
||
通过 Inspector 右键菜单（`[ContextMenu]`）调用，无需进入 Play Mode：
|
||
|
||
| 组件 | 右键菜单项 | 说明 |
|
||
|------|----------|------|
|
||
| `EnemyStatsSO` | `Print Stats Summary` | Console 打印该敌人完整属性表 |
|
||
| `DamageSourceSO` | `Calculate DPS` | Console 打印理论 DPS（BaseDamage / AttackCooldown）|
|
||
| `RoomCameraBounds` | `Fit to Room Tilemap` | 自动调整 PolygonCollider2D 以包裹 Tilemap 边界 |
|
||
| `NavSurface` | `Bake NavMesh` | 立即烘焙此 NavSurface |
|
||
| `SavePoint` | `Mark As Activated` | 设置 SavePoint 为已激活状态（用于测试继续游戏场景）|
|
||
| `RoomTransition` | `Validate Target Scene` | 检查目标场景是否存在于 BuildSettings |
|
||
|
||
---
|
||
|
||
## 7. 编辑器菜单结构
|
||
|
||
Unity 菜单栏 `BaseGames/` 下的所有工具入口：
|
||
|
||
```
|
||
BaseGames/
|
||
├── Core/
|
||
│ └── Event Channel Monitor → EventChannelMonitorWindow
|
||
│
|
||
├── World/
|
||
│ ├── Room Connection Validator → RoomConnectionValidatorWindow
|
||
│ ├── SaveData Viewer → SaveDataViewerWindow
|
||
│ └── Rebuild All Spawn Points → 扫描并重新生成 SpawnPoint ID 索引
|
||
│
|
||
├── Navigation/
|
||
│ ├── Quick Bake All Rooms → NavSurfaceBakeTool
|
||
│ └── Validate Path Connectivity → 检查所有房间 NavLink 连通性
|
||
│
|
||
├── Combat/
|
||
│ └── DPS Calculator → 输入 DamageSourceSO + AttackCooldown，输出 DPS 表格
|
||
│
|
||
└── Settings/
|
||
├── Open Project Layer Matrix → 快速跳转到 ProjectSettings > Physics2D Layer Matrix
|
||
└── Validate Assembly Definitions → 检查 .asmdef 依赖关系是否符合零耦合原则
|
||
```
|
||
|
||
---
|
||
|
||
## 8. 自动化检查工具
|
||
|
||
### 场景验证检查（保存场景时自动运行）
|
||
|
||
`SceneValidationProcessor`（继承 `AssetModificationProcessor`），在保存场景时自动检查：
|
||
|
||
| 检查项 | 错误级别 | 说明 |
|
||
|--------|---------|------|
|
||
| 场景是否有 `RoomCameraBounds` | Warning | 遗漏镜头约束 |
|
||
| 场景是否有 `NavSurface` | Warning | 有敌人的场景必须有 NavSurface |
|
||
| 所有 `RoomTransition` 目标场景是否在 BuildSettings | Error | 目标场景不存在 |
|
||
| 所有 `HitBox` 是否有对应 `DamageSourceSO` | Error | 攻击参数未配置 |
|
||
| 所有 `EnemyBase` 是否有 `EnemyStatsSO` | Error | 敌人属性未配置 |
|
||
|
||
检查结果在 Console 窗口输出，并在 `Scene Validation` 浮窗中汇总。
|
||
|
||
### Assembly Definition 依赖校验
|
||
|
||
`BaseGames > Settings > Validate Assembly Definitions` 检查 `.asmdef` 是否遵循零耦合原则（如 `BaseGames.Player` 不应直接依赖 `BaseGames.Enemies`），输出依赖图 Mermaid 格式并在 Console 报警。
|
||
|
||
---
|
||
|
||
## 9. 高级工具集（补充）
|
||
|
||
### 9.1 Behavior Tree 验证器
|
||
|
||
`Tools > Zeling > BT Validator`（`BaseGames.Editor.BehaviorTreeValidator`）：
|
||
|
||
扫描 `Assets/` 下所有 Behavior Designer `.asset` 文件，检测：
|
||
|
||
| 检查项 | 级别 | 说明 |
|
||
|--------|------|------|
|
||
| 孤立节点（无父节点且非根）| Warning | 表示悬空的设计草稿节点 |
|
||
| 缺失 TaskName 的 Action/Condition | Error | 会导致 BD 无法编译 |
|
||
| SharedVariable 引用为空 | Warning | 运行时会 NullRef |
|
||
| Action 节点最大深度 > 12 | Warning | 过深 BT 建议拆分子树 |
|
||
| 同一 Agent 上同时存在多个 BehaviorTree 组件 | Error | 会互相覆盖 |
|
||
|
||
输出到 Console，双击跳转到对应 BD 资产。
|
||
|
||
### 9.2 进程流程图（Progression Flow Graph）
|
||
|
||
`Tools > Zeling > Progression Flow Graph`（EditorWindow）：
|
||
|
||
```
|
||
┌─ Progression Flow Graph ─────────────────────────────────────┐
|
||
│ [刷新] [导出为 PNG] [高亮未实现节点] │
|
||
│ │
|
||
│ ┌Forest──────┐ ─击败SpiderGuard→ ┌Cave───────────────┐ │
|
||
│ │SP_Forest_01│ │SP_Cave_01 │ │
|
||
│ │HP+2 Heart │ │WallJump Unlock │ │
|
||
│ └────────────┘ └───────────────────┘ │
|
||
│ │ │ │
|
||
│ └──────── 需要 Dash ─────────────────┘ │
|
||
└──────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
- 自动读取所有 `ProgressLock`/`AbilityGate` SO 及 `BossProgressTracker` 配置
|
||
- 用 Bezier 曲线绘制依赖关系（红色=未解锁，绿色=已解锁）
|
||
- 右键节点 → "模拟解锁" → 在 Editor 中测试后续节点是否变绿
|
||
|
||
### 9.3 GameState 转换分析器
|
||
|
||
`Tools > Zeling > GameState Analyzer`（EditorWindow）：
|
||
|
||
- 列出 `GameManager` 中所有 `GameState` 枚举值
|
||
- 显示每个状态下：允许的输入 Action Map、哪些 SO 频道被监听
|
||
- 矩阵视图：行 = 事件频道，列 = 当前状态；标注"会触发"/"被忽略"
|
||
- 辅助排查"暂停状态下攻击事件仍被响应"等逻辑漏洞
|
||
|
||
### 9.4 伤害模拟器（Damage Simulator）
|
||
|
||
`DamageSourceSO` 右键菜单 → `Simulate Damage`，弹出快速面板：
|
||
|
||
```
|
||
┌─ Damage Simulator: DamageSource_PlayerAttack1 ──┐
|
||
│ 目标防御: 0 [ ] 格 受伤类型: Normal │
|
||
│ CharmBonus: × 1.5 + 12（剑尖魅力） │
|
||
│ 弱点: × 1.0 [✓] 骑士弱点（十字架） │
|
||
│ ───────────────────────────────────────────── │
|
||
│ 最终伤害: 14（基础 9 × 1.5 + 1 向上取整） │
|
||
│ [运行 1000 次随机伤害分布图] │
|
||
└─────────────────────────────────────────────────┘
|
||
```
|
||
|
||
不需要进入 Play Mode 即可快速验证伤害数值设计。
|
||
|
||
### 9.5 地图贴图验证器（Map Texture Validator）
|
||
|
||
`Tools > Zeling > Map Texture Validator`：
|
||
|
||
- 读取 `MapRoomDataSO.roomOutlineTexture` 与对应场景的实际 Tilemap 边界
|
||
- 对比边界框是否对齐（允许 ± 1 tile 误差）
|
||
- 检测 Texture 是否以 `Read/Write` 导入（SetPixels 需要）
|
||
- 批量输出不匹配的房间列表 + 截图预览
|
||
|
||
### 9.6 音频导入预处理器（Audio Import Preprocessor）
|
||
|
||
`BaseGames.Editor.AudioImportPreprocessor`（继承 `AssetPostprocessor`）：
|
||
|
||
规则表（`AudioImportRulesSO`，可在 Inspector 配置）：
|
||
|
||
| 文件名前缀 | 平台 | 采样率 | 压缩格式 | Load Type |
|
||
|-----------|------|--------|---------|-----------|
|
||
| `BGM_` | All | 44100 | Vorbis（q=0.4）| Streaming |
|
||
| `SFX_` | All | 22050 | ADPCM | CompressedInMemory |
|
||
| `AMB_` | All | 22050 | Vorbis（q=0.3）| Streaming |
|
||
| `Voice_` | All | 22050 | Vorbis（q=0.6）| CompressedInMemory |
|
||
|
||
导入音频时自动按文件名前缀应用对应设置，Console 输出 `[AudioPreprocessor] Applied: SFX rule → SFX_Player_Hurt.wav`。
|
||
|
||
### 9.7 装备预览工具（Equip Preview）
|
||
|
||
`Tools > Zeling > Equip Preview`（EditorWindow）：
|
||
|
||
```
|
||
┌─ Equip Preview ──────────────────────────────────────────────┐
|
||
│ 选择魅力组合（最多 4 个槽位）: │
|
||
│ 槽1: [剑之力量魅力 ▼] 槽2: [灵魂强化魅力 ▼] │
|
||
│ 槽3: [无 ] 槽4: [无 ] │
|
||
│ ───────────────────────────────────────────────────────── │
|
||
│ 最终属性: │
|
||
│ 攻击力: 9 × 1.5 = 13 法术消耗: 33 × 0.67 = 22 │
|
||
│ 弹反 Soul: 10 → 10 法术弹数: 3 → 3 │
|
||
│ 路径成本: 4 个通知（EquipmentManager.Apply × 4） │
|
||
│ [复制配置 JSON] [应用到 Player（Play Mode）] │
|
||
└──────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
### 9.8 构建验证器（Build Validator）
|
||
|
||
`Tools > Zeling > Validate Build`，在正式打包前执行完整检测：
|
||
|
||
| 检测项 | 级别 |
|
||
|--------|------|
|
||
| 所有场景已加入 Build Settings | Error |
|
||
| 所有 `AudioImportRulesSO` 规则已应用 | Warning |
|
||
| 所有 `AnimationEventConfigSO` 无超出范围的事件时间 | Error |
|
||
| 所有 `AbilityGate` 引用的能力 ID 存在于 `AbilityType` 枚举 | Error |
|
||
| 所有 `LocalizationKeys` 常量在 zh-CN StringTable 中有对应条目 | Warning |
|
||
| Player Prefab 已注册为 Addressable（address = `"Player"`，不使用 `Resources/`）| Error |
|
||
| 所有 Addressable Group 无缺失引用（Missing Reference）| Error |
|
||
| `SaveData` JSON Schema 与当前字段一致（版本检查）| Warning |
|
||
| 构建目标平台 Build Target 与发布目标匹配 | Warning |
|
||
|
||
输出结果为 Build Validation Report（Text + 每项跳转链接），只有零 Error 才允许继续打包。
|