Buglemusic

Buglemusic 喇叭換聲

功能

替換遊戲中喇叭的音效，避免喇叭聲音刺耳。支持自定義.ogg、.wav、.mp3、.aif、.m4a 音頻文件。

功能特點：

• 運行時自動平衡各音頻音量，確保聽起來大小一致
• 手持喇叭時使用按鍵切換曲目，支持自定義曲目
• 支持自定義切換按鍵和音量步進
• 音頻文件播放結束後自動循環
• 切換音效或調整音量時顯示字幕提示

使用方法

默認使用

安裝後默認使用內置的 1.ogg 和 2.ogg 音效文件，無需額外配置。

自定義音效

• 找到 Mod 安裝目錄：BepInEx/plugins/Buglemusic/
• 刪除或重命名現有的 1.ogg、2.ogg 文件
• 將您自己的.ogg、.wav、.mp3 或.aif 音頻文件放入該目錄
• 文件名可以任意，Mod 會自動加載所有音頻文件
• 重啓遊戲生效

控制按鍵

手持喇叭時：

| 按鍵 | 功能 |

|------|------|

| Left Arrow | 上一首 |

| Right Arrow | 下一首 |

| Up Arrow | 增大音量 |

| Down Arrow | 減小音量 |

• 音量調整範圍 0% - 500%
• 默認步進 10%，可在配置文件中調整

字幕提示（默認啓用）：

• 切換音效時，屏幕底部顯示當前播放的曲目名稱
• 調整音量時，顯示當前音量百分比
• 2 秒後自動消失

循環播放

默認啓用循環播放，音頻文件播放結束後會自動重新開始。可在配置文件中關閉。

配置文件

配置文件位於 BepInEx/config/Buglemusic.cfg：

| 配置項 | 默認值 | 說明 |

|--------|--------|------|

| Volume | 1.0 | 基礎音量 (0.0 - 5.0，即 0% - 500%) |

| VolumeStep | 0.1 | 音量調整步進 (0.01 - 0.5) |

| EnableLoop | true | 音頻循環播放 |

| EnableWheelSwitch | false | 滾輪切換音效 |

| EnableClipIndicator | true | 切換時顯示字幕提示 |

| ApplyToOthers | true | 對隊友的喇叭也生效 |

| SwitchUpKey | RightArrow | 切換下一個音效的按鍵 |

| SwitchDownKey | LeftArrow | 切換上一個音效的按鍵 |

| VolumeUpKey | UpArrow | 增大音量的按鍵 |

| VolumeDownKey | DownArrow | 減小音量的按鍵 |

| EnableAutoBalance | true | 啓用自動音量平衡 |

| RmsWeight | 0.6 | RMS 權重 (0.0-1.0，越高越偏向平均響度，越低越偏向峯值) |

| TargetLoudness | 0.25 | 目標響度 (0.01-1.0，越高整體越響) |

| MaxVolumeBoost | 2.5 | 最大增益倍數 (1.0-5.0) |

| SampleLimit | 100000 | 採樣分析上限 (1000-500000，越低越快但越不精確) |

安裝

使用 Mod Manager 或 gale 安裝。手動安裝則把 plugins/ 裏的文件放到 BepInEx/plugins/。

權限說明

只要你標註原作者“傑尼龜（Squirtle18）”，就可以任意借鑑、轉載我的所有mod、思路和代碼（不只是本mod），用來進行你需要的一切活動。

即使代碼有100%的相似度，你只是本地化配置文件，甚至只是更改了描述文件，讓描述更清晰，也允許。（我只是因爲我的github賬號另有他用，所以無法上傳源碼）

但希望你借鑑後的mod也同樣授權mod社區借鑑。

若A借鑑了我的思路或代碼，B又借鑑了A的思路或代碼，則最終致謝名單應爲：傑尼龜（Squirtle18）、A、B。（是的，包括致謝你自己，我也感謝你爲社區作出的貢獻）