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

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-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 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+(键盘拖动需要其 EditMode API)。

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 共用同一套代码,仅乐器固定为吉他(无乐器切换按钮)。