🎵 Auto Musician Mod

Tired of manually clicking to play instruments? Want to host a perfect in-game concert while your friends are looting? Auto Musician is here!

A fun and functional mod for R.E.P.O. that allows you to automatically play the Guitar, Piano, and Harp with perfect timing. It comes with a modern, fully interactive in-game UI where you can write, edit, and loop your own custom songs!

---

🌐 Language

• English Version
• 中文说明请向下滚动 (Chinese Version)

---

🇬🇧 English Version

⚙️ Core Features

Feature	Description
Multiplayer Synced	Both host and clients can use it! Perfectly synced over the network. Everyone in the lobby will hear your masterpiece.
Activation	Hold a Guitar, Piano, or Harp to enable the auto-playing features.
Smart UI Menu	Press F3 to open the custom interface. (Open the menu to configure and compose your songs freely!)
Quick Play/Stop	Press E while holding an instrument to start or stop playing the selected track.
Highly Customizable	5 song slots to save, edit, and rename your tracks. Adjust play speeds and loop delays on the fly!

⚠️ Important Note & Rant (Please Read!)

🚨 The In-Game Pitch Deviation: Please note that the game's native audio algorithm calculates note pitches incorrectly compared to real-life musical instruments. Because of this built-in limitation, complex or serious classical songs might sound completely out of tune. Don't take it too seriously—it's all about that chaotic energy for pure fun!

🙄 Rant: Honestly, it would be absolutely amazing if the R.E.P.O. dev team could fix and properly calibrate the instrument audio effects in a future update. Pretty please?

🎼 Pre-loaded Tracks & How to write your own

This Mod comes pre-loaded with 3 default tracks for you to try out instantly:

1. Jingle Bells
2. Little Star
3. Spooky Vibes (Funny)

You can also copy & paste your own music sheets into the text area! The mod uses a simple 3-octave syntax:

• Lower Octave: a b c d e f g
• Middle Octave: 1 2 3 4 5 6 7
• High Octave: A B C D E F G
• Rests / Pauses: 0

💡 Tip for formatting: Spaces, commas, and line breaks are completely ignored by the code. You can use them freely to format your sheet music beautifully and make it easier to read!

---

📦 Installation

1. Auto Installation (Recommended)

• Use Thunderstore Mod Manager or r2modman and click Install with Mod Manager.

2. Manual Installation

1. Make sure you have BepInEx installed.
2. Download the zip and extract it.
3. Place REPO_AutoMusician.dll into your BepInEx/plugins/ folder.
4. Launch the game and enjoy!

---

🔌 Dependencies

• BepInEx

🤝 Credits & Support

• Author: thOoOw13
• Discord Community: Join my Discord Server (Feel free to report bugs or share ideas here!)
• Disclaimer: This is a fan-made mod for entertainment purposes only.

---

---

🇨🇳 中文版说明 (Chinese Version)

🎵 自动演奏 (Auto Musician)

游戏R.E.P.O的趣味功能性 Mod。它可以让你极其精准地自动弹奏吉他、钢琴和竖琴。模组内置了现代化的独立交互面板，支持随时编写、编辑并循环播放你的专属歌单！

---

⚙️ 核心特性

特性	说明
全服联机同步	主机与客机均可使用！ 完美的网络同步，房间里的所有玩家都能听到你的演奏。
激活条件	只有当你抓取 吉他 (Guitar)、钢琴 (Piano) 或 竖琴 (Harp) 时，功能才会激活。
智能交互面板	按 F3 呼出自定义 UI。(打开面板可以随意配置与编曲！)
一键播放/停止	手持乐器时，按 E 键即可一键开始或停止当前曲目的弹奏。
极高自由度	提供 5 个独立的歌单槽位供你保存、重命名曲目。支持实时调整播放速度和循环间隔！

⚠️ 注意事项 & 个人吐槽

🚨 关于游戏内置音调偏差： 请注意，游戏本体自带的音频算法在计算音高时与现实中的真实乐器存在明显偏差。受限于游戏底层的这个 Bug，弹奏某些严谨的现实曲目时听起来会严重跑调。重在娱乐开心就好！

🙄 吐槽： 如果 REPO 制作组在未来的更新里能够纠正和还原真实的乐器音效那就太好了

🎼 内置歌单与乐谱编写指南

本模组默认内置了 3 首歌曲 供你开箱即用：

1. 铃儿响叮当 (Jingle Bells)
2. 小星星 (Little Star) 3. 很诡异啊 (Funny) 你可以直接在游戏内的文本框里粘贴你的自定义简谱！本模组采用极简的 3 八度音阶规则：

• 低音区 (小写字母): a b c d e f g (对应 Do 到 Ti)
• 中音区 (数字): 1 2 3 4 5 6 7 (对应 Do 到 Ti)
• 高音区 (大写字母): A B C D E F G (对应 Do 到 Ti)
• 休止符 (停顿): 0

💡 排版小贴士: 所有的空格、逗号以及回车换行符都会被代码自动忽略。你可以尽情使用它们来让你的乐谱看起来更整齐美观！

---

📦 安装方法

1. Auto Installation (推荐)

• 使用 Thunderstore Mod Manager 或 r2modman，点击 Install with Mod Manager 即可一键完成安装。

2. 手动安装

1. 确保你已经安装了 BepInEx 框架。
2. 下载此 Mod 的压缩包并解压。
3. 将解压出的 REPO_AutoMusician.dll 文件放入游戏根目录的 BepInEx/plugins/ 文件夹内。
4. 启动游戏即可生效！

---

🔌 依赖关系

• BepInEx

🤝 制作人员 & 交流反馈

• 模组作者: thOoOw13
• QQ 交流群: 1090845198 (欢迎加群反馈 Bug 或交流联机！)
• 免责声明: 自制 Mod。本模组仅供个人娱乐、非商业用途使用。