CustomLastSong

REPO_CustomLastSong

===================

一、簡介 / Introduction

簡體中文

REPO_CustomLastSong 是一個簡單的撤離階段背景音樂模組。

當本局所有提取點完成、進入“趕回卡車撤離”的階段時，本模組會：

• 停止遊戲原有的關卡背景音樂、常駐背景音樂、敵人靠近音樂
• 只播放你自己放在 BGM 文件夾中的音樂
• 保留所有遊戲音效（攻擊、交互、環境聲音等）

如果當前關卡沒有任何符合條件的自定義 BGM，本模組會自動使用該關卡原本的 BGM 作爲撤離階段的音樂。

English

REPO_CustomLastSong is a small mod that customizes the evacuation-phase background music.

When all extraction points are completed and the players are returning to the truck, the mod will:

• Stop the original level background music, constant music and “enemy near” music
• Play only your own tracks from the BGM folder
• Keep all gameplay sound effects (attacks, interactions, ambience, etc.)

If there is no valid custom BGM for the current level, the mod will fall back to the level’s original BGM for the evacuation phase.

二、安裝方式 / Installation

簡體中文

• 確保遊戲已安裝 BepInEx。
• 將 REPO_CustomLastSong 的 dll 放入以下路徑（建議單獨文件夾）：
• BepInEx\plugins\REPO_CustomLastSong\REPO_CustomLastSong.dll
• 啓動遊戲一次，自動生成：
• 配置文件：BepInEx\config\xiaohai.REPO_CustomLastSong.cfg
• BGM 子目錄：與 dll 同目錄下的 BGM 文件夾（不存在時會自動創建）

English

• Make sure BepInEx is installed for the game.
• Place the REPO_CustomLastSong dll in (a separate folder is recommended):
• BepInEx\plugins\REPO_CustomLastSong\REPO_CustomLastSong.dll
• Launch the game once. The mod will automatically create:
• Config file: BepInEx\config\xiaohai.REPO_CustomLastSong.cfg
• BGM subfolder: a BGM folder next to the dll (created if missing)

三、準備 BGM 文件 / Preparing BGM Files

簡體中文

• 找到 dll 所在目錄，例如：
• BepInEx\plugins\REPO_CustomLastSong\REPO_CustomLastSong.dll
• 確認同級目錄存在 BGM 文件夾（沒有會自動創建）：
• BepInEx\plugins\REPO_CustomLastSong\BGM
• 將你想在撤離階段播放的音樂文件放入該目錄。支持的常見格式：

-.wav,.ogg,.mp3,.aiff,.aif,.flac

-.xm,.mod,.it,.s3m

• 每個文件的“主文件名”（不含擴展名）會作爲配置文件中的段名。例如：
• BGM\LastRun_1.ogg → 段名 [LastRun_1]

English

• Locate the dll, for example:
• BepInEx\plugins\REPO_CustomLastSong\REPO_CustomLastSong.dll
• Ensure there is a BGM folder next to the dll (it is created automatically if missing):
• BepInEx\plugins\REPO_CustomLastSong\BGM
• Put the tracks you want to use during evacuation into this folder. Supported formats include:

-.wav,.ogg,.mp3,.aiff,.aif,.flac

-.xm,.mod,.it,.s3m

• The file’s base name (without extension) becomes the config section name. Example:
• BGM\LastRun_1.ogg → section [LastRun_1]

四、配置說明 / Configuration

簡體中文

配置文件路徑示例：

• BepInEx\config\xiaohai.REPO_CustomLastSong.cfg

首次運行遊戲時，模組會根據 BGM 目錄中的音頻文件自動生成配置項。

如果某個音頻文件被刪除，對應的配置項會在下次運行時自動移除。

• 通用設置

[通用]

撤離BGM音量 / Evac BGM volume (0-1)

Volume = 1

• Volume：撤離 BGM 的統一音量，範圍 0.0 ~ 1.0。

• 單個音頻文件設置

每一個放入 BGM 目錄的音頻文件都會生成一段配置，例如：

[LastRun_1]

最小使用關卡數 / Min level index (integer > 0)

MinLevel = 1

最大使用關卡數 / Max level index (integer > 0)

MaxLevel = 99

• 段名：音頻文件名（不含擴展名），例如 LastRun_1.ogg → [LastRun_1]
• MinLevel：最小使用關卡數，必須是大於 0 的整數。
• MaxLevel：最大使用關卡數，必須是大於 0 的整數，自動保證 MaxLevel >= MinLevel。
• 當前關卡序號在 [MinLevel, MaxLevel] 範圍內時，此曲目纔會進入隨機池。

當前關卡序號的簡化理解：

• 第 1 關：關卡序號爲 1
• 第 2 關：關卡序號爲 2
• 以此類推（等價於 levelsCompleted + 1，但不小於 1）

English

Example config file path:

• BepInEx\config\xiaohai.REPO_CustomLastSong.cfg

On first run, the mod scans the BGM folder and automatically creates config entries for each audio file.

If an audio file is removed later, its corresponding config entries will be removed on the next run.

• General settings

[通用]

撤離BGM音量 / Evac BGM volume (0-1)

Volume = 1

• Volume: global volume for evacuation BGM, range 0.0 ~ 1.0.

• Per-track settings

Each audio file in the BGM folder gets one section in the config, for example:

[LastRun_1]

最小使用關卡數 / Min level index (integer > 0)

MinLevel = 1

最大使用關卡數 / Max level index (integer > 0)

MaxLevel = 99

• Section name: file name without extension, e.g. LastRun_1.ogg → [LastRun_1]
• MinLevel: minimum level index where this track may be used, integer > 0.
• MaxLevel: maximum level index where this track may be used, integer > 0, automatically clamped so MaxLevel >= MinLevel.
• A track is considered