Audio Controller Mod

A Minecraft 1.20.1 Forge mod that allows adding custom music and managing it through a convenient interface.

Author: skaletun

Features

• 🎵 Play custom OGG files directly via LWJGL OpenAL
• 📁 Automatic music folder scanning
• 🎼 Create and manage playlists
• 🎲 Automatic playlist playback with random track selection (like vanilla Minecraft)
• 🔄 Replace vanilla Minecraft music
• 🎚️ Integration with Minecraft volume settings ("Music" setting)
• ⏸️ Automatic music pause when game is paused
• 🚪 Automatic music stop when leaving the world
• ⚙️ Mod configuration via mods menu (Mods → Config)
• ⌨️ Hotkeys for GUI access
• 🌍 Full localization (Russian, English)

Adding Music

1. Place OGG files in the config/audiocontroller/music/ folder
2. Open the mod GUI (default key M)
3. Click the refresh button (🔄) to scan for new files

Music Control

Hotkeys:

• M - Open music management GUI

Config

• The mod can also be configured via the mods menu

Automatic Playlist Playback

The mod works on the same principle as vanilla Minecraft - music plays automatically:

1. Open the mod GUI (key M)
2. Click the "Playlist" button
3. Select a playlist from the list
4. Click "Select Playlist"
5. The playlist will automatically start playing with random track selection
6. After each track ends, the next random track from the playlist automatically starts
7. Interval between tracks is controlled automatically (like vanilla Minecraft - ~10 minutes)

Creating Playlists

1. Open the mod GUI
2. Click the "Playlist" button
3. Enter playlist name and click "Create Playlist"
4. Select the playlist and click "Edit" to add tracks
5. Configure playlist parameters:
   • Shuffle - random track playback order
   • Repeat - repeat playlist after all tracks finish

Configuration

Mod settings are located in config/audiocontroller-client.toml:

• replaceVanillaMusic - Whether to replace vanilla Minecraft music
• autoPlay - Automatically start music when entering the game

Important: Custom music volume is controlled through the standard "Music" setting in Minecraft options. Changing volume in Minecraft settings automatically applies to custom music.

Features:

• Music automatically pauses when game is paused (ESC key)
• Music automatically stops when exiting to main menu
• Music only plays when the player is in a world

Playlist Format

Playlists are saved in JSON format

Technical Details

• The mod uses LWJGL OpenAL for direct OGG file playback, completely bypassing Minecraft's SoundManager
• Playback is implemented via STB Vorbis for OGG file decoding
• Volume is synchronized with Minecraft settings in real-time
• Playlists are automatically saved and loaded when entering a world
• Music automatically pauses when game is paused and stops when leaving the world
• Mod settings are accessible through the mods menu (Mods → Config)

License

MIT

Support

If you encounter any issues, create an issue in the project repository: https://github.com/skaletun/AudioControllerMod/issues