You are viewing a potentially older version of this package. View all versions.
cn_xc-SimplePiano-0.1.3 icon

SimplePiano

按 [ 打开钢琴面板,用键盘演奏原版钢琴音色;支持 MIDI/TXT 自动演奏、光效、卡车固定;多人同步(未充分测试)。

By cn_xc
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-5.4.2100 icon
BepInEx-BepInExPack

BepInEx pack for Mono Unity games. Preconfigured and ready to use.

Preferred version: 5.4.2100
cn_xc-MoreUIPanel-0.3.0 icon
cn_xc-MoreUIPanel

轻量信息面板,提供 API 让其他模组注册自定义显示行;支持按语言切换字体(中文/繁中/英/日/俄/法/泰/西/世界语/印地/阿/孟/葡/德/乌尔都)。

Preferred version: 0.3.0

README

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

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。

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 M C3~B3
    中 A S D F G H J K L C4~D5
    高 Q W E R T Y U I O P C5~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),未装模组的玩家会看到它;可在配置里调 跟随深度(米)。