# Editable Music Manager
## Features
- In-game music configuration UI
- Custom volume, weight, play time, seasons
- Support for battle/tense music
- Control vanilla music
- Does not affect other mods' music
## How to Use
### Add Music Files
- Place `.ogg` or `.wav` music files into the `Editable_music_manager` folder in the mod directory
- You can create subfolders to organize your music
### Launch Game
- Launch RimWorld
- Go to Options → Mod Settings
- Find "Editable Music Manager"
### Configure Music
- Click "Save Settings" to scan newly added music files
- Configure each song:
- **Enabled**: Enable/disable the song
- **Volume (%)**: 0-200%, default 100%
- **Weight**: 0.1-10, higher = more frequently played
- **Time of Day**: Any / Day / Night
- **Seasons**: Any / Spring / Summer / Fall / Winter
- **Tense**: Mark as battle/tense music
- **Play on Map**: Disable to only play on main menu
### Vanilla Music Control
- Check "Disable Vanilla Music" to completely disable game default music
- When not disabled, adjust "Vanilla Weight" to control playback probability
### Apply Changes
- Some changes require game restart
## Supported Formats
- .wav and .ogg
## File Naming Requirements
- File names should only contain: **letters, numbers, underscores, hyphens, spaces**
- Recommended to use simple English names
- Avoid special characters
## How to Remove Music
To remove a music file, you need to delete files in all three locations:
1. **Editable_music_manager/** - Original music files
2. **Sounds/** - Runtime copied files
3. **Sounds/Songs/** - Runtime copied files
**Steps:**
1. Close the game
2. Delete the original audio file from `Editable_music_manager` folder
3. Delete the corresponding file from `Sounds` folder
4. Delete the corresponding file from `Sounds/Songs` folder (if exists)
5. Launch game, go to settings, click "Save Settings" to rescan
## FAQ
**Q: Music not playing?**
A: Check if format is OGG or WAV, ensure filename has no special characters, try restarting game.
**Q: How to play only custom music?**
A: Check "Disable Vanilla Music" in settings.
**Q: Do I need to restart after changing settings?**
A: Most settings require game restart. After adding new music, click "Save Settings" to detect.
