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.
SimplePiano
按 P 打开钢琴面板,用键盘随时演奏原版钢琴音色;支持 MIDI/TXT 自动演奏与可点击选曲,演奏光效,多人时房主可让所有人听到。A Play-anywhere piano using the game's own piano samples, with auto-play (MIDI/TXT) and multiplayer support.
By cn_xc
| Last updated | an hour ago |
| Total downloads | 11 |
| Total rating | 1 |
| Categories | Mods Audio Client-side Server-side AI Generated |
| Dependency string | cn_xc-SimplePiano-0.1.0 |
| Dependants | 0 other packages depend on this package |
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 里弹钢琴:按 P 打开面板,用键盘演奏;支持自动演奏 MIDI/TXT。
⚠️ 版权声明:本项目由 cn_xc 独立开发,闭源授权,仅允许在《R.E.P.O.》游戏内以未修改形式运行。 禁止反编译、二次分发、商用,并包含针对 AI 训练/再现的明确限制。 完整条款(中文 + English,含出处署名要求、AI 条款、法律依据)见同目录 LICENSE。
版权声明(完整条款 / 中文 + English)
以下为本项目完整授权条款;同目录
LICENSE为同一文本的独立文件。
SimplePiano(简单钢琴)—— 版权声明与使用条款
本文件为完整条款(中文 + English)。
📜 版权声明与使用条款(完整版)
Copyright (C) 2026 cn_xc. All rights reserved. / 版权所有,保留一切权利。 本声明同时适用于本项目的源代码、二进制文件、文档、字符串资源与美术资源。
一、作品来源
本项目并非衍生作品,与其它模组没有任何代码或授权关系:
- 本作品:SimplePiano(简单钢琴),由 cn_xc 独立开发与维护。
- 所使用的第三方组件仅为运行所需的基础库(BepInEx、Harmony、Photon 相关库、 以及本作者自己的 MoreUIPanel),均按其各自的许可证使用,不改变本作品自身的著作权归属。
- 钢琴音色来自游戏《R.E.P.O.》自身的资源,本项目不附带、不分发任何游戏原始音频文件; 本声明不主张对游戏原资源本身的任何权利。
- 本声明的范围覆盖本项目的全部成果(代码、二进制、文档、字符串、图标等)。
二、授权范围
| 版本 | 许可证 | 授权内容 |
|---|---|---|
| 0.1.0 及之后(全部版本) | 闭源(不提供源代码) | 仅授权在 R.E.P.O.(REPO)游戏内以未经修改的形式运行 |
Licence granted: a limited, non-exclusive, non-transferable licence to run this work, unmodified, inside the game "R.E.P.O." only.
三、注明出处
⚠️ 分发、整合、引用、介绍时必须在显著位置注明作者与出处:
- 必须保留 作者署名(cn_xc);
- 必须写明出处(Thunderstore 页面地址);
- 移除、遮盖、篡改版权标识或作者信息,均视为违反本授权。
四、未经许可明确禁止
- 反编译、反汇编、逆向工程、脱壳、内存转储,或以任何方式提取实现逻辑;
- 复制、改编、翻译、演绎,或基于本作品创作衍生作品(含"换皮改名"后发布);
- 二次打包、重新分发、上架第三方平台,或用于任何商业用途(含付费整合、付费代装);
- 移除或篡改版权标识、作者署名与本条款;
- 通过反射、钩子、补丁等方式调用本作品内部实现,用于构建替代品或商业产品。
五、人工智能(AI)相关限制 —— 重要
未经作者书面许可,明确禁止下列人工智能相关行为:
- 训练用途:禁止将本项目的源代码、字符串、文档、注释或任何部分, 用于训练、微调、蒸馏、评测任何机器学习模型(含大语言模型、代码生成模型, 以及以此构建的数据集),无论该行为发生在本地、私有集群还是云端服务。
- 生成式还原:禁止将本项目的内容输入 AI 工具(对话模型、代码助手、Agent 等), 用以生成功能等价的实现,再以"原创"名义发布、分发或用于任何产品。
- AI 批量"换皮":禁止借助 AI 改写、重命名、重构本项目的实现后发布, 该行为本质上仍是对本作品的复制与改编。
- 规避授权:禁止通过"让 AI 代为阅读/提取/改写"的方式, 绕过本条款对反编译与复制改编的限制。
- 声明:AI 生成物不改变本作品的著作权归属,不构成独立创作; 由 AI 辅助产生的、与本作品实质相似的成果,同样受本条款约束。
说明:使用 AI 工具阅读公开文档、撰写评测、翻译说明文字不受限制; 上述限制针对的是代码与实现层面的提取、再现与再发布。
六、反规避与身份保护
- 禁止绕过、破坏或规避本作品的任何授权校验、标识或技术措施 (依 WCT 第 11 条及各缔约国国内法,规避有效技术措施本身即可被追究);
- 禁止以他人名义发布本作品,或伪称获得作者授权、官方合作、官方发行;
- 禁止发布经修改的版本却沿用本项目名称、图标或作者署名,造成来源混淆。
七、需要另行申请授权的情形
- 查看本模组的代码细节或进行代码审查;
- 将本模组加入整合包(modpack),或以任何非"原样运行"的方式使用;
- 任何形式的商业用途(含直播平台付费内容、代装服务、付费整合)。
如需以上授权,请联系作者申请;获准后仍须标明出处。
八、条款变更、可分性与准据法
- 作者保留随时更新本条款的权利;更新后的条款自发布之日起适用于新版本, 已发布版本的授权不因条款更新而回溯改变。
- 本条款任一条款被认定无效或不可执行,不影响其余条款的效力。
- 本条款的解释与争议适用中华人民共和国法律与伯尔尼保护文学和艺术作品公约。
九、免责声明
本模组按"现状"提供,不附带任何明示或暗示的担保(含适销性、特定用途适用性)。 因使用或无法使用本模组导致的任何损失(含存档损坏、联机异常、游戏崩溃、数据丢失等), 作者不承担责任。请在了解风险的前提下自行决定是否使用。
十、法律依据与后果
(一)自动保护与保护期限
本作品自创作完成之日起自动受版权保护,无需登记或任何手续;作为计算机程序, 保护期不少于作者终生加死后 50 年(多数成员国为 70 年)。
(二)国际条约(对所有成员国有效)
-
《伯尔尼保护文学和艺术作品公约》(Berne Convention)
- 国民待遇:作为成员国国民,本作品在所有其他成员国享有与当地国民同等的保护。
- 保护客体:计算机程序(无论源代码或目标代码形式)作为"文字作品"受保护。
- 专有权利:复制权、发行权、公开传播权等;未经许可复制或分发即构成侵权。
- 保护期限:计算机程序不少于 50 年。
-
《与贸易有关的知识产权协定》(TRIPS,WTO 框架)
- 对全部 WTO 成员具约束力,设定最低保护标准,并与国际贸易挂钩。
- 再次确认计算机程序按《伯尔尼公约》作为文字作品保护。
- 表达与思想的界限(第 9 条第 2 款):版权保护的是代码的表达, 不保护思想、程序、操作方法或数学概念本身。
- 要求成员建立有效的执法程序。
-
《世界知识产权组织版权条约》(WCT)
- 明确计算机程序(含 DLL 等目标代码形态)作为文字作品受保护, 不论其表达方式或形式。
- 发行权:授权通过销售或转让方式向公众提供作品复制品。
- 向公众传播权:授权以有线或无线方式向公众传播作品。
- 技术措施保护(第 11 条):缔约国须立法禁止规避有效技术措施。
-
欧盟《计算机程序保护指令》(2009/24/EC)
- 在欧盟境内将软件作为文学作品保护;其第 6 条允许"为互操作性"的有限反编译, 本条款不排除该法定情形。
(三)国内法
《中华人民共和国著作权法》《计算机软件保护条例》, 以及《中华人民共和国刑法》第二百一十七条(侵犯著作权罪)。
(四)后果
对上述禁止行为的实施者,作者 cn_xc 有权依据 《中华人民共和国著作权法》第五十二条、第五十三条及《计算机软件保护条例》 要求停止侵害、消除影响、赔偿损失;情节严重、以营利为目的的, 可能承担刑事责任。
说明:本条款旨在明确作者的授权边界,不排除法律强制赋予的权利。 例如:《计算机软件保护条例》第十七条允许"为了学习和研究软件内含的设计思想和原理" 而进行必要的复制;欧盟 2009/24/EC 第 6 条允许"为互操作性"的有限反编译。
📜 English Version (full)
Copyright (C) 2026 cn_xc. All rights reserved.
1. Origin
This project is NOT a derivative work and has no code or licensing relationship with LateJoinNow, PianoSimple or other mods. It is independently developed and maintained by cn_xc. Third-party components are only runtime base libraries (BepInEx, Harmony, Photon libraries, and the author's own MoreUIPanel), each under its own licence. Piano sound is produced by the game's own resources; this project ships no game audio. This notice claims no rights over the game's original assets.
2. Licence granted
Closed source. A limited, non-exclusive, non-transferable licence to run this work, unmodified, inside "R.E.P.O." only.
3. Attribution
You must credit the author (cn_xc) and the source wherever the work is distributed, integrated or referenced. Removing, obscuring or altering copyright notices or author information is a licence violation.
4. Prohibited without prior written permission
Decompiling / disassembling / reverse engineering / unpacking / memory dumping or extracting the implementation; copying, adapting, translating or creating derivative works (including renamed "reskins"); repacking, redistributing, publishing on third-party platforms or any commercial use; removing or altering this notice; calling internal implementations via reflection/hooks/patching to build substitutes or commercial products.
5. Artificial intelligence restrictions — important
Without prior written permission you may NOT:
- use any part of this project (source, strings, docs, comments) to train, fine-tune, distil or benchmark any machine-learning model, including LLMs and code-generation models, or to build datasets for that purpose;
- feed this project into AI tools to generate functionally equivalent implementations and then publish or distribute them as "original" work;
- use AI to rewrite, rename or restructure this project's implementation and publish the result — this remains copying and adaptation;
- circumvent these terms by having an AI read, extract or rewrite the work.
AI-generated output does not change the authorship of this work and does not constitute independent creation. Using AI to read public documentation, write reviews or translate descriptions is not restricted.
6. Anti-circumvention
No bypassing licence checks or technical measures; no publishing under another name or falsely claiming authorisation, partnership or official release; no releasing modified versions under this project's name, icon or author credit.
7. Separate permission required
Reviewing this mod's code details; including this mod in a modpack; any commercial use. Contact the author; if granted, credit the source, and the permission covers only what was granted in writing.
8. Changes, severability, governing law
The author may update these terms at any time; updates apply to new versions only. Invalidity of one clause does not affect the others. These terms are governed by the laws of the People's Republic of China.
9. Disclaimer
Provided "as is" without warranty of any kind. The author is not liable for any loss arising from use of, or inability to use, this mod.
10. Legal basis and consequences
(a) Automatic protection and term — protected automatically from creation, with no registration required; as a computer program the term is at least the life of the author plus 50 years (70 in many member states).
(b) International treaties
- Berne Convention — national treatment in all member states; computer programs (source or object code) are protected as literary works.
- TRIPS Agreement (WTO) — minimum standards; Article 9(2): copyright protects expression, not ideas; effective enforcement required.
- WIPO Copyright Treaty (WCT) — programs, including DLL/object-code form, are literary works; right of distribution and communication to the public; Article 11 requires prohibiting circumvention of effective technological measures.
- EU Directive 2009/24/EC — software protected as a literary work; Article 6 permits limited decompilation for interoperability, which this notice does not exclude.
(c) Domestic law — the Copyright Law of the PRC, the Regulations on Computer Software Protection, and Article 217 of the Criminal Law of the PRC.
(d) Consequences — the rights holder may seek injunctive relief, removal of infringing copies and damages; wilful infringement for commercial advantage may carry criminal liability.
Note: this notice does not exclude rights granted by mandatory law — e.g. Article 17 of the Regulations on Computer Software Protection of the PRC and EU Directive 2009/24/EC, Article 6.
依赖
- 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 的配置与曲目会在首次启动时自动迁移过来)
面板上的按钮:
| 按钮 | 作用 |
|---|---|
↻ |
重新扫描曲目目录 |
◀ / ▶(左右小箭头) |
上一首 / 下一首 |
▶ / ■ |
播放 / 停止 |
| 曲目名 | 直接点选(当前项高亮) |
支持的格式:
.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\; - 回游戏按面板上的
↻重扫,选中后点▶。
5. 常见问题
| 现象 | 原因 | 解决 |
|---|---|---|
| 曲目列表里没有 | 目录不对 / 扩展名不是 .mid 或 .txt | 确认路径后按 ↻ 重扫 |
| 只播放部分音符 | 有些音超出 48~121 | 整体移调(所有 MIDI 同时 ±12) |
| 节奏不对 | 时间写乱(顺序或空隙) | 时间必须单调递增,按累加计算 |
| 中文曲名乱码 | 文件不是 UTF-8 | 另存为 UTF-8 |
多人
- 钢琴是网络生成的真实物体,你装了本模组、房主也装了时,所有玩家都能听到和看到。
- 房主未安装本模组时:客机演奏只有自己听得到(原版 RPC 只接受房主发起)。
- 钢琴默认生成在演奏者下方 1.2m(配置
跟随深度(米)可调大以减少被看见)。
配置(BepInEx\config\cn_xc.SimplePiano.cfg)
| 项 | 默认 | 说明 |
|---|---|---|
| 开关键 | P | 开关面板 |
| 使用原版RPC(全员可听) | 开 | 关掉则只本地发声 |
| 同时本地播放(2D) | 关 | 听不到时可开来排查音源 |
| 音量 | 0.8 | 本地播放音量 |
| 基音MIDI_0号键 | 48 | 0 号键音高(C3) |
| 钢琴位置跟随演奏者 | 开 | 钢琴移到演奏者脚下 |
| 跟随深度(米) | 1.2 | 藏在楼板下的深度 |
限制
- 音色来自原版钢琴采样,音域固定 48~121;超出范围的音符会被忽略。
- MIDI 解析不支持 SMF 时间码、弯音与力度映射(力度会被忽略)。
- 演奏会触发原版引怪逻辑(
EnemyInvestigate),这是原版钢琴行为。
回退
把 BepInEx\plugins\cn_xc-SimplePiano 目录改名加 .off 即可完全禁用。