SimplePiano
按 [ 打开钢琴面板,用键盘演奏原版钢琴音色;支持 MIDI/TXT 自动演奏、光效、卡车固定;多人同步(未充分测试)。⚠️ 测试版本:功能随时变动(机制、键位、配置项都可能在下个版本调整,请谨慎使用)
Simple Piano(简单钢琴)
随时随地在 REPO 里弹钢琴:按 [ 打开面板,用键盘演奏;支持自动演奏 MIDI/TXT。
⚠️ 版权声明:本项目由 cn_xc 独立开发,闭源授权,仅允许在《R.E.P.O.》游戏内以未修改形式运行。 禁止反编译、二次分发、商用,并包含针对 AI 训练/再现的明确限制。 完整条款(中文 + English,含出处署名要求、AI 条款、法律依据)见同目录 LICENSE。
依赖
- MoreUIPanel 0.3.0+(必需,面板渲染与拖动由它负责)
- BepInEx 5.4.2100
快速上手
- 进游戏(单人/多人均可),按 P 打开钢琴面板(再按 P 关闭)。
- 演奏键位(网页钢琴风格,三个八度自下而上):
| 行 | 键 | 音 |
|---|---|---|
| 低八度 | Z X C V B N M |
C3 D3 E3 F3 G3 A3 B3 |
| 中八度 | A S D F G H J K L |
C4 D4 E4 F4 G4 A4 B4 C5 D5 |
| 高八度 | Q W E R T Y U I O P |
C5 D5 E5 F5 G5 A5 B5 C6 D6 E6 |
| 半音(黑键) | 1 2 3 4 5 6 7 8 |
C#5 D#5 F#5 G#5 A#5 C#6 D#6 F#6 |
,/.:降低 / 升高八度(可用范围 MIDI 48~121,约 6 个八度)- 打开面板时会屏蔽玩家操作并解锁鼠标,方便点击 UI;关闭后恢复
- 面板可拖动:按 F2(MoreUIPanel 拖动模式)整体移动,位置自动保存
自动演奏
把曲目放进:
BepInEx\config\SimplePiano\Songs\
(旧版 PianoSimple 的配置与曲目会在首次启动时自动迁移过来)
面板上的按钮:
| 按钮 | 作用 |
|---|---|
↻ |
重新扫描曲目目录 |
◀ / ▶(左右小箭头) |
上一首 / 下一首 |
▶ / ■ |
播放 / 停止 |
| 曲目名 | 直接点选(当前项高亮) |
| 页码 | 一次显示 4 首,切到第 5 首会自动翻到第 2 页(显示 第 2/3 页) |
支持的格式:
.mid/.midi:标准 MIDI(格式 0/1),自动解析 tempo 与多轨.txt:简易文本格式,见下节
自己制作曲目(.txt 格式)
1. 文件格式
一行一个音,空格分隔三个数:
开始时间(毫秒) MIDI音高 时长(毫秒)
以 # 开头的行是注释,会被忽略。例:
# 一闪一闪亮晶晶(前两句)
0 60 400
400 60 400
800 67 400
1200 67 400
1600 69 400
2000 69 400
2400 67 800
- 开始时间:从曲子开头算起,单位毫秒(1000 = 1 秒)
- MIDI 音高:见下面的对照表
- 时长:该音持续多久(毫秒);当前为触发式发声,时长主要影响你排时间的习惯
2. 音高对照表
| 音名 | MIDI | 音名 | MIDI | 音名 | MIDI |
|---|---|---|---|---|---|
| C3 | 48 | C4 | 60 | C5 | 72 |
| C#3 | 49 | C#4 | 61 | C#5 | 73 |
| D3 | 50 | D4 | 62 | D5 | 74 |
| D#3 | 51 | D#4 | 63 | D#5 | 75 |
| E3 | 52 | E4 | 64 | E5 | 76 |
| F3 | 53 | F4 | 65 | F5 | 77 |
| F#3 | 54 | F#4 | 66 | F#5 | 78 |
| G3 | 55 | G4 | 67 | G5 | 79 |
| G#3 | 56 | G#4 | 68 | G#5 | 80 |
| A3 | 57 | A4 | 69 | A5 | 81 |
| A#3 | 58 | A#4 | 70 | A#5 | 82 |
| B3 | 59 | B4 | 71 | B5 | 83 |
- 每升高一个八度 = MIDI +12(如 C6 = 84、C7 = 96)
- 可用范围:48(C3)~ 121(C#9),超出会被忽略(日志有提示)
- 简易公式:
MIDI = 12 × (八度数 + 1) + 半音序号(C=0, C#=1, D=2 … B=11),例:A4 = 12×5+9 = 69
3. 节奏换算
| 速度 | 一拍时长 | 四分音符写多少 |
|---|---|---|
| 60 BPM | 1000ms | 1000 |
| 80 BPM | 750ms | 750 |
| 100 BPM | 600ms | 600 |
| 120 BPM | 500ms | 500 |
八分音符 = 一半,二分音符 = 两倍。整首按 时间 = 之前所有音符时值之和 顺排(像上面小星星那样累加)。
4. 省事做法:让 AI 帮你生成
把下面这段直接发给 AI(把曲名换成你要的):
请把《(曲名)》的主旋律写成 SimplePiano 模组可用的曲谱 txt,严格遵守:
1. 每行格式:开始时间(毫秒) 空格 MIDI音高 空格 时长(毫秒)
2. 从头开始按顺序累加时间,不要有空隙或倒序
3. 只用单声部主旋律,不要和弦、不要伴奏
4. MIDI 音高范围必须限制在 48~121 之间(C3~C#9),超出请整体移调
5. 以 # 开头的注释行可以写曲名和速度
6. 速度用 100 BPM(四分音符 = 600ms)
7. 直接给出完整 txt 内容
音高对照:C3=48 C#3=49 D3=50 D#3=51 E3=52 F3=53 F#3=54 G3=55 G#3=56 A3=57 A#3=58 B3=59
C4=60 C#4=61 D4=62 D#4=63 E4=64 F4=65 F#4=66 G4=67 G#4=68 A4=69 A#4=70 B4=71
C5=72 D5=74 E5=76 F5=77 G5=79 A5=81 B5=83(每加一个八度 +12)
拿到结果后:
- 存成
.txt(UTF-8 编码),文件名就是曲目名; - 放进
BepInEx\config\SimplePiano\Songs\; - 回游戏按面板上的
↻重扫,选中后点▶。
提示:只有
.mid/.midi/.txt会被当作曲目加载;笔记、核对表之类的文件请存成.md(不会被当作曲目)。
5. 常见问题
| 现象 | 原因 | 解决 |
|---|---|---|
| 曲目列表里没有 | 目录不对 / 扩展名不是 .mid 或 .txt | 确认路径后按 ↻ 重扫 |
| 只播放部分音符 | 有些音超出 48~121 | 整体移调(所有 MIDI 同时 ±12) |
| 节奏不对 | 时间写乱(顺序或空隙) | 时间必须单调递增,按累加计算 |
| 中文曲名乱码 | 文件不是 UTF-8 | 另存为 UTF-8 |
多人
机制
| 角色 | 行为 |
|---|---|
| 房主 | 全房只由房主生成一架钢琴(其他客户端不再各自生成,避免 ViewID 不一致导致 RPC 失效)。弹奏时同时做两件事:原版 RPC 广播(让未装模组的人听到)+ 自定义事件 178 广播(让装了模组的客户端本地发声)。 |
| 装模组的客机 | 弹奏 → 本地发声 + 事件 173 发给房主 → 房主再广播给所有人。收到房主事件 178 时直接本地发声。 |
| 未装模组的客机 | 只能听到房主那一侧的原版 RPC 声音;看不到/听不到客机弹的(协议限制)。 |
| 中途加入的玩家 | 收不到已生成的网络物体,但装了模组就能听到事件 178,并会在 6 秒后本地生成一架隐形「幽灵琴」用于发声。 |
已知限制
- 房主未安装本模组:客机弹奏只有自己听得到(原版 RPC 只接受房主发起,无法绕过)。
- 房主离开(主机迁移):中继会停止,需要重进房间。
- 钢琴位置不同步(各客户端按本地卡车位置摆放),听感方位可能略有差异。
防双声
客机本地发声后 0.35 秒内收到同一个键的原版 RPC 会被自动跳过(Harmony 前缀),不会出现"一个音响两遍"。
配置(BepInEx\config\cn_xc.SimplePiano.cfg)
| 项 | 默认 | 说明 |
|---|---|---|
| 开关键 | [ |
开关面板(可在配置里改) |
| 使用原版RPC(全员可听) | 开 | 关掉则只本地发声 |
| 同时本地播放(2D) | 关 | 听不到时可开来排查音源 |
| 音量 | 0.8 | 本地播放音量 |
| 基音MIDI_0号键 | 48 | 0 号键音高(C3) |
| 钢琴位置跟随演奏者 | 开 | 钢琴移到演奏者脚下 |
| 跟随深度(米) | 1.2 | 藏在楼板下的深度(关闭「固定在卡车」时生效) |
| 固定在卡车 | 开 | 钢琴固定生成在卡车里,不再跟着演奏者跑 |
| 显示钢琴模型 | 开 | 卡车里显示钢琴本体(有模型但不能碰、不能搬) |
| 钢琴面板X / Y | -1 | 钢琴 UI 的屏幕坐标(-1 = 自动居中下方),不随 MoreUIPanel 面板移动 |
限制
-
只在关卡场景可用:商店、卡车、主菜单按 P 无反应(避免在那些场景加载钢琴造成卡顿);离开关卡时面板会自动关闭。
-
音色来自原版钢琴采样,音域固定 48~121;超出范围的音符会被忽略。
-
MIDI 解析不支持 SMF 时间码、弯音与力度映射(力度会被忽略)。
-
演奏会触发原版引怪逻辑(
EnemyInvestigate),这是原版钢琴行为。
回退
把 BepInEx\plugins\cn_xc-SimplePiano 目录改名加 .off 即可完全禁用。
版权
Copyright (C) 2026 cn_xc. All rights reserved. / 版权所有,保留一切权利。
本作品闭源,仅授权在《R.E.P.O.》内以未经修改的形式运行;分发/整合/引用时必须保留作者署名 cn_xc 并注明出处;禁止反编译、二次分发、商用,以及任何 AI 训练/等价再现。
完整条款(中文 + English,含法律依据)见同目录
LICENSE。
