文档，给那些工具挪窝

2025-06-07 00:01:54 +08:00
parent 4497c3b3da
commit 26e5d302be
38 changed files with 408 additions and 1821 deletions
--- a/Document/编辑器指南
+++ b/Document/编辑器指南
@@ -0,0 +1,158 @@
+# ichni 编辑器指南
+
+## 前言
+ichni Editor 是一款功能强大的 3D 谱面编辑器（被戏称为“建模软件”），相比 arcade/RPE 等工具更复杂。  
+**新手建议**：在编辑器中实操体验，结合本指南学习。  
+**反馈渠道**：教程问题请向 sls 反馈（更新速度存疑）。
+
+---
+
+## 一、新建项目
+| 配置项               | 说明                                                                 |
+|----------------------|----------------------------------------------------------------------|
+| **Project Name**     | 谱面名称，建议格式：`曲名 + 空格 + 难度名`（例：`SongName Hard`）    |
+| **Creator**          | 谱师名称/马甲                                                        |
+| **BPM**              | 固定节拍值（因 ichni 按秒存储谱面，且变 BPM 场景极少）               |
+| **Delay**            | 谱面整体时间偏移：负数=提前开始，正数=延后开始（推荐优先裁剪音频）   |
+| **Song Location**    | 音频文件路径（导入后与原文件无关）                                   |
+| **Theme Bundle**     | 主题包选择（后续详解）                                               |
+
+> **BPM 工具参考**：  
+> - [BPM 概念解释](https://cn.bing.com/search?q=歌曲bpm是什么&FORM=QSRE1)  
+> - [BPM 检测工具](https://vocalremover.org/zh/key-bpm-finder)
+
+---
+
+## 二、快捷键速查
+### 场景操作
+| 按键          | 功能                 |
+|---------------|----------------------|
+| **W/A/S/D**   | 前后左右移动相机     |
+| **E/Q**       | 上/下移动相机        |
+| **鼠标右键**  | 按住旋转相机         |
+
+### 轨道操作
+| 快捷键       | 功能                     |
+|--------------|--------------------------|
+| `Alt + P`    | 显示/隐藏路径节点        |
+| `Alt + D`    | 启用/禁用轨道路径显示    |
+
+### 工作流
+| 快捷键       | 功能                     |
+|--------------|--------------------------|
+| `Ctrl + S`   | 保存项目                 |
+| `Ctrl + E`   | 导出项目                 |
+| `Ctrl + C/V` | 复制/粘贴选中元素        |
+| `Ctrl + D`   | 删除选中元素             |
+
+### 显示控制
+| 快捷键         | 功能                         |
+|----------------|------------------------------|
+| `Ctrl + 1/2/3` | 切换手机/平板/安全区域提示   |
+| `Ctrl + U`     | 切换静态窗口显示             |
+| `Ctrl + ↑/↓`   | 放大/缩小 UI                |
+| `Ctrl + M`     | 切换摄像机                  |
+
+> **注意**：多数快捷键需鼠标聚焦对应 UI 区域生效。
+
+---
+
+## 三、核心界面功能
+### Logger 窗口
+- **位置**：播放控制器上方
+- **日志颜色含义**：
+  - 🟢 绿色：操作正常
+  - ⚪ 白色：提示信息
+  - 🟡 黄色：非致命警告（通常可忽略）
+  - 🔴 红色：严重错误（需截图保存并联系开发者）
+
+### EditorManager
+- **功能**：  
+  显示谱面元数据、开关网格/判定模式、创建特殊元素。
+
+---
+
+## 四、谱面结构详解
+### 1. Element Folder
+- **本质**：空容器节点（可嵌套）
+- **作用**：管理子元素的位置属性
+
+### 2. Camera
+- **关键规则**：单谱面仅允许 **1 个 Camera**
+- **位置**：
+  - 简单场景：直接放在 Folder 下
+  - 多机位场景：置于 Cross Track Point 内
+- **运动逻辑**：随父节点（Folder/Track）移动而移动
+
+### 3. Track 轨道系统
+#### 类型对比
+| 属性         | Movable Track                     | Static Track                     |
+|--------------|-----------------------------------|----------------------------------|
+| **运动逻辑** | Note 在轨道上固定位置生成         | Note 从轨道尾部运动到头部        |
+| **核心参数** | 开始/结束时间、可视长度、缓动     | 下落时间、下落缓动               |
+| **Note 放置**| 判定时间需在轨道启停时间范围内    | 无时间限制                      |
+
+#### 显示模式
+| 模式                  | 适用场景                          | 特点                          |
+|-----------------------|-----------------------------------|-------------------------------|
+| **AutoOrient**        | 3D 空间轨道（如螺旋线）          | 轨道面始终朝向摄像机          |
+| **TrackPath**         | 平面内规则轨道                   | 随 PathNode 方向改变朝向      |
+| **TrackRenderSurface**| 闭合轨道区域渲染                | 需手动调整法向量避免扭曲      |
+
+#### PathNode 节点
+- **作用**：控制轨道的形状、旋转、缩放、颜色
+- **操作建议**：通过实操理解参数影响
+
+### 4. 事件系统 (Events)
+- **功能**：驱动位移(Displacement)/旋转(Swirl)/缩放(Scale)动画
+- **最佳实践**：在 0-1 位置放置基础事件避免编辑器异常
+- **特殊事件**：
+  - `TrackPercentPoint`：用 0-1 值控制轨道进程（配合 Trail 实现精细动画）
+  - `TrackHeadPoint`：简化版进程控制器
+
+### 5. 缓动系统 (Easing)
+- **作用**：控制数值变化速率（默认匀速 `Linear`）
+- **选型建议**：
+  - 加速/减速 → `InQuad`/`OutQuad`
+  - 平滑过渡 → `Sine` 系列
+  - 长动画（>1秒）才能明显体现缓动差异
+- **参考工具**：[缓动函数可视化](https://easings.net/zh-cn)
+
+### 6. Trail 拖尾效果
+- **生成限制**：需依附于 `TrackPercentPoint`
+- **高级技巧**：复制 Trail 粘贴到 Folder 下可通过事件自由控制
+- **⚠️ 已知问题**：编辑模式下暂停时 Trail 会消失（游戏本体无此问题）
+
+### 7. Note 系统
+#### 基础配置
+1. 设置判定时间 `exactJudgeTime`
+2. 创建 Note Visual：
+   - 选择主题包
+   - 调整位置/大小（小屏设备需增大尺寸）
+3. 保存为 Prefab：  
+   通过 `Save Note Prefab` + `Use Note Prefab` 实现批量复用
+
+#### 设计规范
+- **下落时间**：直轨 ≤1秒，斜轨需实测设备显示效果
+- **安全区域**：用 `Ctrl+1/2/3` 确保 Note 在安全范围内
+- **材质规范**：
+  - ✅ Stay 可用 Tap 材质
+  - ❌ Tap 不可用 Stay/Hold 材质
+
+### 8. 特效系统 (Effect)
+- **触发方式**：
+  - Note 判定事件（Perfect/Good/Bad/Miss）
+  - 时间轴事件 (Time Effects Collection)
+- **配置**：输入特效代码（需配合主题包文档）
+
+---
+
+## 五、工作流指南
+### 标准流程
+```mermaid
+graph TD
+    A[准备音源与主题包] --> B[创建摄像机轨道]
+    B --> C[设计轨道系统]
+    C --> D[放置Note]
+    D --> E[添加事件/特效]
+    E --> F[测试与优化]