R.E.P.O.
Install with App

Details

Latest version
0.1.3
Last Updated
First Uploaded
Downloads
89
Likes
1
Size
61KB
Dependants

⚠️ 测试版本:功能随时变动(机制、键位、配置项都可能在下个版本调整,请谨慎使用)

Simple Piano(简单钢琴)

随时随地在 REPO 里弹钢琴:按 [ 打开面板,用键盘演奏;支持自动演奏 MIDI/TXT。

⚠️ 版权声明:本项目由 cn_xc 独立开发,闭源授权,仅允许在《R.E.P.O.》游戏内以未修改形式运行。 禁止反编译、二次分发、商用,并包含针对 AI 训练/再现的明确限制。 完整条款(中文 + English,含出处署名要求、AI 条款、法律依据)见同目录 LICENSE。

依赖

  • MoreUIPanel 0.3.0+(必需,面板渲染与拖动由它负责)
  • BepInEx 5.4.2100

快速上手

  1. 进游戏(单人/多人均可),按 P 打开钢琴面板(再按 P 关闭)。
  2. 演奏键位(网页钢琴风格,三个八度自下而上):
行 键 音
低八度 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)

拿到结果后:

  1. 存成 .txt(UTF-8 编码),文件名就是曲目名;
  2. 放进 BepInEx\config\SimplePiano\Songs\;
  3. 回游戏按面板上的 ↻ 重扫,选中后点 ▶。

提示:只有 .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。

Thunderstore development is made possible with ads. Please consider making an exception to your adblock.