ichni 编辑器指南
前言
ichni Editor 是一款功能强大的 3D 谱面编辑器(被戏称为“建模软件”),相比 arcade/RPE 等工具更复杂。
新手建议:在编辑器中实操体验,结合本指南学习。
反馈渠道:教程问题请向 sls 反馈(更新速度存疑)。
一、新建项目
| 配置项 |
说明 |
| Project Name |
谱面名称,建议格式:曲名 + 空格 + 难度名(例:SongName Hard) |
| Creator |
谱师名称/马甲 |
| BPM |
固定节拍值(因 ichni 按秒存储谱面,且变 BPM 场景极少) |
| Delay |
谱面整体时间偏移:负数=提前开始,正数=延后开始(推荐优先裁剪音频) |
| Song Location |
音频文件路径(导入后与原文件无关) |
| Theme Bundle |
主题包选择(后续详解) |
BPM 工具参考:
二、快捷键速查
场景操作
| 按键 |
功能 |
| 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秒)才能明显体现缓动差异
- 参考工具:缓动函数可视化
6. Trail 拖尾效果
- 生成限制:需依附于
TrackPercentPoint
- 高级技巧:复制 Trail 粘贴到 Folder 下可通过事件自由控制
- ⚠️ 已知问题:编辑模式下暂停时 Trail 会消失(游戏本体无此问题)
7. Note 系统
基础配置
- 设置判定时间
exactJudgeTime
- 创建 Note Visual:
- 保存为 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)
- 配置:输入特效代码(需配合主题包文档)
五、工作流指南
标准流程