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.
SimpleGuitar
按 ] 用游戏内自带吉他(Valuable Arctic Guitar)演奏;独立指板界面(6 弦 × 8 品)、自动演奏、光效;单人已测,多人未充分测试。
By cn_xc
| Date uploaded | 16 hours ago |
| Version | 0.1.1 |
| Download link | cn_xc-SimpleGuitar-0.1.1.zip |
| Downloads | 51 |
| Dependency string | cn_xc-SimpleGuitar-0.1.1 |
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 Guitar(简单吉他)
按 ] 打开面板,用键盘演奏游戏内自带的吉他(采样直接取自游戏本体,不额外附带音频)。
⚠️ 先看这条:目前只测过单人
| 场景 | 状态 |
|---|---|
| 单人 | ✅ 已测试(作者本地验证) |
| 多人联机 | ⚠️ 未测试(代码里保留了同步逻辑,但没有实际联机验证,可能出现听不到/双声/位置不同步) |
如果你只玩单人,可以放心用;要联机请自行评估风险,出问题请把日志发我。
乐器参数(来自游戏实测)
| 项 | 值 |
|---|---|
| 音源 | 游戏内 Valuable Arctic Guitar(Arctic 吉他) |
| prefab | Valuables/04 Big/Valuable Arctic Guitar |
| 键数 | 12 采样 × 4 八度 = 48 键 |
| 基音 | 0 号键 = C3(MIDI 48),可在配置里改 |
键位
| 行 | 键 | 音 |
|---|---|---|
| 低 | Z X C V B N M |
低八度白键 |
| 中 | A S D F G H J K L |
中八度白键 |
| 高 | Q W E R T Y U I O P |
高八度白键 |
| 半音 | 1 2 3 4 5 6 7 8 |
黑键 |
, / . 切换八度。
自动演奏
把 .mid / .midi / .txt 放进 BepInEx\config\SimpleGuitar\Songs\,面板上:
| 按钮 | 作用 |
|---|---|
↻ |
重扫曲目 |
◀ / `▶ |
` |
▶ / ■ |
播放 / 停止 |
| 曲目名 | 点选 |
.txt 格式:每行 开始毫秒 MIDI音高 时长毫秒。
提示:曲目目录与其他 Simple 系列乐器共用(
config\SimplePiano\Songs也会被扫描),同一首曲子换乐器就能听不同音色。
界面
面板会根据乐器换皮:吉他版本使用木色/金色底与琴弦装饰(非钢琴键盘样式)。
配置
BepInEx\config\cn_xc.SimpleGuitar.cfg:
| 项 | 默认 | 说明 |
|---|---|---|
| 开关键 | ] |
开关面板(可在配置里改) |
| 使用原版RPC(全员可听) | 开 | 多人相关(未测试) |
| 同时本地播放(2D) | 关 | 听不到时打开排查 |
| 音量 | 0.8 | 本地音量 |
| 基音MIDI_0号键 | 48 | 0 号键音高 |
| 固定在卡车 | 开 | 乐器固定生成在卡车里 |
| 显示乐器模型 | 开 | 能看到乐器本体(不能碰/不能搬) |
限制
- 只在关卡场景可用(商店/卡车按 Y 无反应);离开关卡自动关闭面板。
- 多人同步未测试。
- 音域固定为乐器自身采样范围,超出的音符会被忽略。
回退
把 BepInEx\plugins\cn_xc-SimpleGuitar 目录改名加 .off 即可禁用。
版权
Copyright (C) 2026 cn_xc. All rights reserved. / 版权所有,保留一切权利。 本作品闭源,仅授权在《R.E.P.O.》内以未经修改形式运行; 分发/整合/引用时必须保留作者署名 cn_xc 并注明出处; 禁止反编译、二次分发、商用,以及任何 AI 训练/等价再现。 完整条款见 LICENSE(中文 + English)。
CHANGELOG
[0.1.1]
界面
- 独立吉他界面:木色指板 + 6 根琴弦 + 琴枕/品丝/弦名/音名标签(不再复用钢琴键盘样式)。
- 面板改为四行布局:标题(乐器/音域/键数/开关键)、操作提示、曲目状态(含页数)、按钮行。
- 专属图标(木色吉他剪影)。
变更
- 开关键:
P→];选曲键:[]→;'。 - 配置分区按乐器命名:
[吉他]/[吉他界面]/[吉他调试]。 - 依赖更新为 MoreUIPanel 0.3.1+(键盘拖动需要其
EditModeAPI)。
Changelog
[0.1.0]
新增
- 按
P用游戏内自带吉他演奏(采样与音域来自游戏本体)。 - 键位三行三个八度:
Z X C V B N M/A S D F G H J K L/Q W E R T Y U I O P,黑键1~8;,.换八度。 - 自动演奏:把
.mid/.txt放进BepInEx\config\SimpleGuitar\Songs\,面板↻重扫、点曲目名选择、▶播放。 - 演奏光效(随机色上滑光柱)。
- 多人:房主生成乐器,客机弹奏经房主中继;装了同模组的客户端都能听到。
- 与 SimplePiano 共用同一套代码,仅乐器固定为吉他(无乐器切换按钮)。