---

前置要求 / Requirements​

1. MDL3（3.0.0-dev.33 或更新版本）
   MDL3 下载 / Download
2. HD2 Data Hub（0.3.0 或更新版本）
   如果使用包含 HD2 Data Hub 的 MDL3 整合包，则无需单独安装。
   
   If you're using an MDL3 package that already includes HD2 Data Hub, you don't need to install it separately.

巨爽巨解压版 / TL;DR Version​

首次通过 Mod Manager 加载 Mod 时，会自动创建音乐目录及配置文件。
Game modding tutorials

The first time you load the mod through Mod Manager, it automatically creates the music folder and configuration file.


将音乐文件（.wav）放入此目录即可。

Simply place your music files (.wav) in this folder.

注意：请勿使用体积过大的音频文件，以免占用过多内存并影响游戏性能。

Note: Avoid excessively large audio files, as they may consume too much memory and affect game performance.

游戏内设置 / In-game Settings​

按下 ESC 打开设置菜单，进入：

Press ESC to open the settings menu, then navigate to:

音乐文件 / Music Setup​

音乐目录 / Music Directory


将 .wav 音频文件放入该目录即可。首次加载 Mod 时会自动创建目录和脚本。

Place your .wav audio files in this folder. The directory and script are automatically created when the mod is loaded for the first time.

音频格式要求 / Audio Format Requirements

• 
  []格式 / Format：16-bit PCM WAV
  []采样率 / Sample Rate：推荐 22050Hz 或 44100Hz / Recommended: 22050Hz or 44100Hz
• 声道 / Channels：单声道或立体声 / Mono or Stereo

音频转换 / Audio Conversion

你可以使用随 Mod 附带的 convert_track.cmd，也可以使用 Audacity 或 FFmpeg 转换音频。

You can use the included convert_track.cmd, or convert your audio using Audacity or FFmpeg.

将 MP3、FLAC、OGG 或 M4S 文件拖放到 convert_track.cmd 上，即可转换为同名 WAV 文件。

Drag and drop MP3, FLAC, OGG, or M4S files onto convert_track.cmd to convert them into WAV files with the same filename.

请尽量控制 WAV 文件大小。几十 MB 甚至更大的音频文件可能会占用过多内存，影响游戏性能。

Keep WAV files reasonably small. Audio files tens of MB or larger may consume excessive memory and affect game performance.

安装方法 / Installation​

方法一：Arsenal Mod Manager

1. 将 StimMusic-x.x.x.zip 拖入 Mod Manager。
2. 启用 Mod。
3. 点击 Deploy 完成安装。

Method 1: Arsenal Mod Manager

1. Drag StimMusic-x.x.x.zip into Mod Manager.
2. Enable the mod.
3. Click Deploy to install.

方法二：手动安装 / Manual Installation

将压缩包中的以下文件解压到：

Extract the following files from the archive into:


需要复制：

Required files:

• 
  []Addon/9ba626afa44a3aa2.patch_0
  []对应的 .gpu_resources 文件
• 对应的 .stream 文件

如果目标目录中已经存在相同编号的 Patch，请使用下一个可用编号，例如 patch_1、patch_2 等。

If a patch with the same index already exists, use the next available index, such as patch_1, patch_2, and so on.

常见问题 / FAQ​

Q1：打针没有播放音乐？

• 
  []确认已经安装 MDL3 和 HD2 Data Hub。
  []在游戏内 ESC 菜单中确认 Stim Music 已启用。
  []确认音乐目录中存在有效的 WAV 文件。
  []不要直接将 MP3 文件重命名为 WAV，必须使用音频转换工具。
• 检查 STIM_MUSIC_STATUS.txt 获取状态信息。

Q1: No music plays when using a stim?

• 
  []Make sure MDL3 and HD2 Data Hub are installed.
  []Make sure Stim Music is enabled in the in-game ESC menu.
  []Check that valid WAV files exist in the music folder.
  []Do not simply rename MP3 files to WAV. Use an audio converter.
• Check STIM_MUSIC_STATUS.txt for status information.

---

Q2：为什么连续打针时音乐不会重新开始？

这是预期行为。音乐会在多次打针之间持续播放，直到整首歌曲播放完毕，然后循环播放。

Q2: Why doesn't the music restart when using multiple stims?

This is intended behavior. Music continues across multiple stims until the entire song finishes, then it loops.

---

Q3：配置文件在哪里？


语言设置支持以下选项：

The language setting supports the following values:

• 
  []auto：自动 / Automatic
  []en：英文 / English
• zh：中文 / Chinese

---