SimplePiano
按 [ 打开钢琴面板,用键盘演奏原版钢琴音色;支持 MIDI/TXT 自动演奏、光效、卡车固定;多人同步(未充分测试)。[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),未装模组的玩家会看到它;可在配置里调
跟随深度(米)。
