Please disclose if any significant portion of your mod was created using AI tools by adding the 'AI Generated' category. Failing to do so may result in the mod being removed from Thunderstore.
| Date uploaded | 16 hours ago |
| Version | 0.1.3 |
| Download link | cn_xc-SimplePiano-0.1.3.zip |
| Downloads | 37 |
| Dependency string | cn_xc-SimplePiano-0.1.3 |
This mod requires the following mods to function
BepInEx-BepInExPack
BepInEx pack for Mono Unity games. Preconfigured and ready to use.
Preferred version: 5.4.2100cn_xc-MoreUIPanel
轻量信息面板,提供 API 让其他模组注册自定义显示行;支持按语言切换字体(中文/繁中/英/日/俄/法/泰/西/世界语/印地/阿/孟/葡/德/乌尔都)。
Preferred version: 0.3.0README
⚠️ 测试版本:功能随时变动(机制、键位、配置项都可能在下个版本调整,请谨慎使用)
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。
CHANGELOG
[0.1.3]
界面
- 面板改为「四行统一布局」:标题(乐器名/音域/键位数/开关键)、操作提示、曲目状态、按钮行,不再互相遮挡。
- 页数并入状态行(
当前曲目 2/7: 小星星 | 第 1/2 页),删除原来单独悬浮的页数标签。 - 按钮行上移贴近键位区,键位区不再被按钮压住。
- 标题/提示文案按乐器动态生成(钢琴版显示
[ 关闭)。
配置
- 配置分区按乐器命名:
[钢琴]/[钢琴界面]/[钢琴调试](吉他/竖琴版本对应[吉他]/[竖琴])。 - ⚠️ 分区改名后,旧
[钢琴]段的自定义值不会被读取,需要重新设置一次(默认开关键已改为[)。
其它
- 开关键由
P改为[;上一首/下一首由[]改为;/'([]让给乐器开关键)。 - README 的版权声明改为 4 行摘要,完整条款只保留在
LICENSE(READMe 体积 21.6 KB → 8.7 KB)。 - 只由房主生成钢琴:之前每个客户端都会
PhotonNetwork.Instantiate,导致房间里有多架钢琴、ViewID 不一致,房主的 RPC 打不到客机的对象(客机听不到)。 - 客机改为查找房主已生成的钢琴;中途加入找不到时,6 秒后本地生成一架隐形「幽灵琴」仅用于本地发声。
- 新增自定义事件 178:房主每次弹奏/中继时广播给其他玩家,装了模组的客户端直接本地发声,不再依赖 RPC 命中对象(中途加入者也能听到)。
- 新增 Harmony 前缀去重:客机刚本地播过同一个键(0.35 秒内)就跳过原版 RPC,消除双声。
[0.1.2]
网络同步修复
修复
- 光效消失:改为「两遍绘制」——先画完所有白键/黑键/标签,再统一绘制光柱,避免被后画的元素覆盖。
- 特效偶发整块不画:修复曲目索引越界(
_songIndex超出_songs.Count)导致绘制异常被静默吞掉的问题;画前统一夹紧索引。 _fx字典新增过期清理(>0.9 秒移除),避免长期运行积累陈旧条目。
变更
- 关闭面板不再停止自动演奏(按用户要求,可当 BGM 继续听);离开关卡仍会自动停曲。
- 中继事件改用
SendReliable,降低自动演奏时对方漏音。 - 切换曲目(
[]/◀▶|/ 点曲名)会自动停止当前播放。 - 快捷键拦载重试:最多 6 次(每 10 秒),找到目标模组即停。
新增
- 自动八度归一:曲目加载时自动整体平移若干八度,保证所有音符落在钢琴可弹范围 48~121 内(整首统一平移,不在曲中跳八度)。
- 客机演奏中继:客机按键 → 本机发声 + Photon 事件(173) 发给房主 → 房主用原版 RPC 广播;广播用
RpcTarget.Others,避免发送者重复发声。 - 钢琴固定在卡车(默认开):生成后只定位一次到卡车安全点,正常摆放在车内地面,不跟随玩家。
- 显示钢琴模型(默认开):能看到钢琴本体,但碰撞/抓取/物理全部禁用。
- 曲目列表分页:一次显示 4 首,切到第 5 首自动翻页并显示「第 2/3 页」。
- F2 拖动钢琴键盘:编辑模式下可直接拖动键盘,位置保存到
[界面] 钢琴面板X/Y。 - 场景门禁:只在关卡场景可用(商店/卡车无反应),离开关卡自动关闭面板。
Changelog
[0.1.1]
修复
- 只在关卡场景可用:商店/卡车/主菜单按 P 无反应;离开关卡时面板自动关闭,避免在非关卡场景加载钢琴导致卡顿。
新增 / 修复
-
钢琴固定在卡车(默认开):生成后只定位一次到卡车安全点,不再跟随玩家。
-
显示钢琴模型(默认开):卡车里能看到钢琴本体,但碰撞/抓取/物理全部禁用,无法触碰或搬动。
-
客机演奏中继:客机按键 → 本地发声 + Photon 事件 173 发给房主 → 房主用原版 RPC 广播,其他人也能听到。
-
曲目列表分页:一次显示 4 首,切到第 5 首自动翻页并显示"第 2/3 页"。
-
曲目行新增状态文字:
当前曲目 3/7: 小星星(播放中)。
[0.1.0]
新增
-
按
P打开/关闭钢琴面板(关闭面板后玩家操作恢复正常)。 -
使用原版钢琴的 18 段采样 + 变调发声,音域 MIDI 48~121(约 6 个八度),无需额外音频文件。
-
键位(网页钢琴风格,自下而上三个八度):
行 键 音 低 Z X C V B N MC3~B3 中 A S D F G H J K LC4~D5 高 Q W E R T Y U I O PC5~E6 半音 1 2 3 4 5 6 7 8配合高八度 ,/.切换八度。 -
自动演奏:把
.mid/.midi/.txt放进BepInEx\config\SimplePiano\Songs\,面板上↻重扫、点曲目名选曲、▶播放、■停止。.txt格式:每行开始毫秒 MIDI音高 时长毫秒(例:0 60 400)。
-
演奏光效:每个音在对应琴键上射出随机颜色的上滑光柱。
-
多名支持:钢琴是网络生成的真实物体,房主安装本模组时,未安装模组的玩家也能听到琴声(走原版 RPC)。
-
面板拖动:集成 MoreUIPanel 的
F2拖动模式(可整体拖动,位置自动保存)。 -
打开面板时用游戏官方接口
PlayerController.InputDisable屏蔽玩家操作,并解锁鼠标以点击 UI。
说明
- 需要 MoreUIPanel 0.3.0+(用于面板渲染与拖动)。
- 多人时若房主没有安装本模组,客机演奏只有自己听得到(原版 RPC 仅接受房主发起)。
- 钢琴生成在演奏者脚下(默认 1.2m),未装模组的玩家会看到它;可在配置里调
跟随深度(米)。