AutoMusician

🎵 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:

• Jingle Bells
• Little Star
• 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

• Auto Installation (Recommended)
• Use Mod Manager or r2modman and click Install with Mod Manager.
• Manual Installation
• Make sure you have BepInEx installed.
• Download the zip and extract it.
• Place REPO_AutoMusician.dll into your BepInEx/plugins/ folder.
• 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 首歌曲 供你開箱即用：

• 鈴兒響叮噹 (Jingle Bells)
• 小星星 (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

💡 排版小貼士:

所有的空格、逗號以及回車換行符都會被代碼自動忽略。你可以盡情使用它們來讓你的樂譜看起來更整齊美觀！

📦 安裝方法

• Auto Installation (推薦)
• 使用 Mod Manager 或 r2modman，點擊 Install with Mod Manager 即可一鍵完成安裝。
• 手動安裝
• 確保你已經安裝了 BepInEx 框架。
• 下載此 Mod 的壓縮包並解壓。
• 將解壓出的 REPO_AutoMusician.dll 文件放入遊戲根目錄的 BepInEx/plugins/ 文件夾內。
• 啓動遊戲即可生效！

🔌 依賴關係

• BepInEx

🤝 製作人員 & 交流反饋

• 模組作者: thOoO