294 lines
6.3 KiB
Markdown
294 lines
6.3 KiB
Markdown
# Editor Console 方法文档
|
||
|
||
## 概述
|
||
Editor Console 是游戏编辑器中的命令行系统，用于执行各种便捷操作。按 **`~`** 键（Esc下方）打开控制台，支持历史记录和参数自动补全。
|
||
|
||
## 基础操作
|
||
|
||
### `tp(Vector3 pos)`
|
||
将场景相机移动到指定坐标
|
||
|
||
**示例**:
|
||
```csharp
|
||
tp [10,5,0] // 移动到坐标(10,5,0)
|
||
tp [0,2,-3] // 移动到坐标(0,2,-3)
|
||
tp(0, 0, 15) // 使用括号格式
|
||
```
|
||
|
||
### `tp()`
|
||
将场景相机移动到当前选中对象的位置
|
||
|
||
**示例**:
|
||
```csharp
|
||
tp // 直接传送到选中对象位置
|
||
```
|
||
> **要求**: Inspector中必须选中对象
|
||
|
||
### `ReName(string message)`
|
||
重命名当前选中对象
|
||
|
||
**示例**:
|
||
```csharp
|
||
ReName "NewTrackName"
|
||
ReName "PlayerSpawnPoint"
|
||
ReName("EnemyPath_01") // 括号格式
|
||
```
|
||
|
||
## 路径生成
|
||
|
||
### `Lgp(int loop, Vector3 start, Vector3 end, bool Clear = false, bool offsetOrigin = false)`
|
||
在选中的Track上生成线性路径节点
|
||
|
||
**参数**:
|
||
- `loop`: 节点数量（必须大于1）
|
||
- `start`: 起始坐标
|
||
- `end`: 结束坐标
|
||
- `Clear`: 是否清除现有节点
|
||
- `offsetOrigin`: 是否基于原节点变换偏移
|
||
|
||
**示例**:
|
||
```csharp
|
||
Lgp 10 [0,0,0] [5,0,5] // 生成10个节点的直线
|
||
Lgp 5 [1,2,3] [10,2,3] true // 清除旧节点后生成新路径
|
||
Lgp 8 [0,0,0] [0,10,0] false true // 保留并偏移原有节点
|
||
```
|
||
|
||
### `Spiral` 螺旋路径生成
|
||
|
||
#### 主轴方向螺旋
|
||
```csharp
|
||
Spiral(int loop, Vector3 center, float r, float h, int pointsPerTurn, string axis = "y")
|
||
```
|
||
|
||
#### 自定义方向螺旋
|
||
```csharp
|
||
Spiral(int loop, Vector3 center, float r, float h, int pointsPerTurn, Vector3 dir)
|
||
```
|
||
|
||
**示例**:
|
||
```csharp
|
||
// Y轴螺旋（默认）
|
||
Spiral 20 [0,0,0] 3 10 8
|
||
|
||
// Z轴螺旋
|
||
Spiral 20 [0,0,0] 3 10 8 "z"
|
||
|
||
// 自定义方向螺旋
|
||
Spiral 15 [1,2,3] 2 5 6 [1,1,0]
|
||
|
||
// 复杂螺旋路径
|
||
Spiral(30, [5,0,5], 4.0, 15.0, 10, [0,1,1])
|
||
```
|
||
|
||
## 数据处理
|
||
|
||
### `SamplerImport(string inputData)`
|
||
导入采样器格式的音符数据
|
||
|
||
**数据格式**: `(动作类型, 轨道ID, 时间戳, X值, [Hold持续时间])`
|
||
|
||
**支持的动作类型**:
|
||
- `Tap`: 点击音符
|
||
- `Stay`: 停留音符
|
||
- `Hold`: 长按音符（需要持续时间）
|
||
- `Flick`: 滑动音符
|
||
|
||
**示例**:
|
||
```csharp
|
||
// 单个音符导入
|
||
SamplerImport "(Tap, Track1, 12.5, 3.2)"
|
||
|
||
// 多个音符批量导入
|
||
SamplerImport "(Tap, MainTrack, 10.0, 1.5)\n(Hold, SideTrack, 15.0, -2.1, 3.5)"
|
||
|
||
// 复杂序列
|
||
SamplerImport "
|
||
(Tap, RedTrack, 5.2, 0.0)
|
||
(Stay, BlueTrack, 7.8, 2.5)
|
||
(Hold, GreenTrack, 12.3, -1.0, 4.2)
|
||
(Flick, YellowTrack, 18.6, 3.0)
|
||
"
|
||
```
|
||
|
||
### `ExportNotesFromTrack()`
|
||
导出当前Track下所有音符为正则格式文本
|
||
|
||
**示例**:
|
||
```csharp
|
||
ExportNotesFromTrack // 自动复制到剪贴板
|
||
```
|
||
> **输出示例**:
|
||
> ```
|
||
> (Tap, MainTrack, 5.200, 0.000)
|
||
> (Stay, MainTrack, 7.800, 2.500)
|
||
> (Hold, MainTrack, 12.300, -1.000, 4.200)
|
||
> ```
|
||
|
||
## 音符操作
|
||
|
||
### `SetNoteHLInGame(bool forceSetOff = false, bool SameTheme = false)`
|
||
全局高亮重复时间点的音符
|
||
|
||
**示例**:
|
||
```csharp
|
||
SetNoteHLInGame // 高亮所有重复时间点音符
|
||
SetNoteHLInGame true // 先关闭所有高亮再重新高亮
|
||
SetNoteHLInGame false true // 只高亮同类型重复音符
|
||
```
|
||
|
||
### `SetNoteHLInElement(bool forceSetOff = false, bool SameTheme = false)`
|
||
在当前元素内高亮重复时间点的音符
|
||
|
||
**示例**:
|
||
```csharp
|
||
SetNoteHLInElement // 在当前选中的Track内高亮
|
||
SetNoteHLInElement true // 重置后高亮
|
||
```
|
||
|
||
### `AttachNoteInNearestTrail()`
|
||
将轨道上的音符吸附到最近的轨迹线
|
||
|
||
**示例**:
|
||
```csharp
|
||
AttachNoteInNearestTrail // 自动吸附所有音符到最近轨迹
|
||
```
|
||
> **要求**: 必须选中Track对象
|
||
|
||
## 动画操作
|
||
|
||
### `swapDisplacement()`
|
||
反转位移动画方向（正负值互换）
|
||
|
||
**示例**:
|
||
```csharp
|
||
swapDisplacement // 将选中的位移动画反向
|
||
```
|
||
> **要求**: 选中Displacement元素
|
||
|
||
### `swapSwirl()`
|
||
反转旋转动画方向
|
||
|
||
**示例**:
|
||
```csharp
|
||
swapSwirl // 反转旋转动画
|
||
```
|
||
> **要求**: 选中Swirl元素
|
||
|
||
### `swapScale()`
|
||
反转缩放动画方向
|
||
|
||
**示例**:
|
||
```csharp
|
||
swapScale // 反转缩放动画
|
||
```
|
||
> **要求**: 选中Scale元素
|
||
|
||
### `FloorAnim()`
|
||
为动画属性添加0时刻关键帧
|
||
|
||
**示例**:
|
||
```csharp
|
||
FloorAnim // 确保所有动画从时间0开始
|
||
```
|
||
|
||
## 对象管理
|
||
|
||
### `DelSameInParent()`
|
||
删除父对象中所有同类型的兄弟元素（包括自身）
|
||
|
||
**示例**:
|
||
```csharp
|
||
DelSameInParent // 删除当前选中类型的所有同级对象
|
||
```
|
||
|
||
### `AdjustPathnodeZ(float OriginZpoint, float scale)`
|
||
调整PathNode的Z坐标缩放
|
||
|
||
**示例**:
|
||
```csharp
|
||
AdjustPathnodeZ 0 2.0 // 以Z=0为原点，2倍缩放
|
||
AdjustPathnodeZ 5 0.5 // 以Z=5为原点，缩小一半
|
||
```
|
||
|
||
## 高级功能
|
||
|
||
### `SplitHoldToTrack(int PathnodesCount)`
|
||
将选中的Hold音符分割为带路径的新Track
|
||
|
||
**示例**:
|
||
```csharp
|
||
SplitHoldToTrack 5 // 分割为5个路径节点的Track
|
||
SplitHoldToTrack 10 // 更精细的分割
|
||
```
|
||
> **要求**: 选中Hold对象，父Track为Movable类型
|
||
|
||
### `SplitAllHoldToTrack(int PathnodesCount)`
|
||
将Track下所有Hold音符分割
|
||
|
||
**示例**:
|
||
```csharp
|
||
SplitAllHoldToTrack 5 // 分割当前Track下所有Hold音符
|
||
```
|
||
> **要求**: 选中Track对象
|
||
|
||
### `Rebuild()`
|
||
强制刷新所有游戏元素和轨道路径
|
||
|
||
**示例**:
|
||
```csharp
|
||
Rebuild // 完全重建场景，解决显示问题
|
||
```
|
||
|
||
## 使用技巧
|
||
|
||
### 参数格式
|
||
```csharp
|
||
// 空格分隔格式
|
||
func "abc" 1 2 [0,1,2]
|
||
|
||
// 括号分隔格式
|
||
func("abc", 1, 2, [0,1,2])
|
||
|
||
// 混合使用
|
||
Lgp 10 [0,0,0] [5,5,5] true
|
||
```
|
||
|
||
### 常用工作流示例
|
||
|
||
**快速创建路径**:
|
||
```csharp
|
||
// 1. 选择Track
|
||
// 2. 生成直线路径
|
||
Lgp 8 [0,0,0] [10,0,5]
|
||
|
||
// 3. 生成螺旋补充
|
||
Spiral 12 [5,2,2] 2 6 4
|
||
```
|
||
|
||
**批量处理音符**:
|
||
```csharp
|
||
// 1. 导入数据
|
||
SamplerImport "(Tap, Track1, 5.0, 1.0)"
|
||
|
||
// 2. 检查重复音符
|
||
SetNoteHLInGame
|
||
|
||
// 3. 吸附到轨迹
|
||
AttachNoteInNearestTrail
|
||
|
||
// 4. 导出验证
|
||
ExportNotesFromTrack
|
||
```
|
||
|
||
## 故障排除
|
||
|
||
- **对象未选中**: "Please select a Track first!"
|
||
- **参数错误**: "Loop must be greater than 1!"
|
||
- **类型不匹配**: "Please select a Displacement first!"
|
||
- **功能未启用**: "Please enable 'Note Prefab' in EditorManager"
|
||
|
||
使用前请确认：
|
||
1. 正确选中目标对象
|
||
2. 参数类型和数量匹配
|
||
3. 相关功能已启用（如Note Prefab）
|
||
4. 操作前建议保存工程 |