# MP3 Radio Player

> Streams custom .mp3 files directly into radios and boomboxes via an FMOD programmer instrument. https://github.com/cptsooper/mp3player

Mod for [Sons of the Forest](https://store.steampowered.com/app/1326470/Sons_Of_The_Forest/) by [cptsooper](https://sotf-mods.com/profile/cptsooper). Page: https://sotf-mods.com/mods/cptsooper/mp3-radio-player

## At a glance

- **Version:** 3.0.0 (released 2026-11-17)
- **Category:** Other
- **Tags:** Music, Sound
- **Declared game version:** 1.0.0
- **Loader:** RedLoader 0.8.6
- **Platform:** Client
- **Multiplayer:** singleplayer only
- **Dedicated server:** not supported
- **Dependencies:** none
- **File size:** 28.3 KB
- **Downloads:** 0 (as of 2026-11-17)
- **Followers:** 0
- **License:** MIT
- **Source code:** https://github.com/cptsooper/mp3player
- **First published:** 2026-11-17
- **Last release:** 2026-11-17

## Install

1. Install RedLoader, the Sons of the Forest mod loader (RedManager can do it for you).
2. Download the mod and put it in the `_RedLoader/Mods` folder inside the game directory.
3. Launch the game and press F1 to confirm it loaded.

Download 3.0.0: https://sotf-mods.com/mods/cptsooper/mp3-radio-player/download/3.0.0
Full guide: https://sotf-mods.com/install

## Description

### 📻 MP3Player[#](#md-mp3player)

A custom FMOD audio engine and radio replacement mod for **Sons of the Forest** (RedLoader) that allows you to stream custom `.mp3`, `.wav`, `.ogg`, and `.flac` files.

>

**Source Code & Releases:** [GitHub Repository](https://github.com/cptsooper/mp3player) — Open-source under the MIT License.

---

#### ✨ Features[#](#md-features)

- **Audio Formats:** Support for `.mp3`, `.wav`, `.ogg`, and `.flac` files.
- **Playback Modes:** 3D World Boomboxes (with real-time LCD countdown display), Golf Carts (seamless handoff), and 2D Headphones Mode.
- **Organization & Controls:** Multi-folder playlist support, full playback controls (skip, rewind, fast-forward, shuffle, repeat, volume), smart background fading, and live track rescanning.

---

#### 📥 Installation[#](#md-installation)

- **Automatic (RedManager):** Click **Install with RedManager**, add audio files to `Sons Of The Forest/Mods/mp3player/Tracks/`, and launch the game.
- **Manual:** Install via **RedLoader**, extract the `.zip` archive into your game directory, and place tracks inside `Mods/mp3player/Tracks/`.

---

#### 🎮 Default Controls[#](#md-default-controls)

_(Customizable in-game or via `UserData/mp3player.cfg`)_

- **Play / Pause:** `;`
- **Switch Playlist:** `'`
- **Next / Previous Track:** `\\` / `P`
- **Fast Forward (+30s) / Rewind (-15s):** `Right Arrow` / `Left Arrow`
- **Repeat / Shuffle:** `O` / `K`
- **Volume Up / Down:** `Numpad +` / `Numpad -`

---

#### 🛠 Links & Support[#](#md-links-support)

- **GitHub & Issues:** [https://github.com/cptsooper/mp3player](https://github.com/cptsooper/mp3player)
- **License:** MIT

## Changelog 3.0.0 (2026-11-17)

#### 🚀 Version 3.0.0 Release Notes[#](#cl-752-version-300-release-notes)

- **Multi-Format Audio Support:** Added full streaming support for `.wav`, `.ogg`, and `.flac` files alongside `.mp3`.
- **Subfolder Playlists & Switch Playlist Hotkey (Default: `'`):** Organize tracks into subfolders inside `Mods\\mp3player\\Tracks\\` and cycle between **All Playlists**, **Root**, and individual folders in-game.
- **Wear Headphones (Standalone 2D Mode):** Added a **Wear Headphones** toggle and **Headphones Volume** slider in Mod Settings to listen anywhere on the island in 2D stereo without needing a placed boombox.
- **Play / Pause Hotkey (Default: `;`):** Pause and resume playback in-place across 3D boomboxes, golf carts, and 2D headphones.
- **Seamless Track & Position Handoffs:** Picking up a boombox, entering a golf cart, or toggling **Wear Headphones** bookmarks your exact track and timestamp so playback resumes seamlessly.
- **Built-In Push-and-Hold Volume Controls (Defaults: `Numpad +` / `Numpad -`):** Added integrated volume adjustment with configurable step percentage, push-and-hold repeat, and a distortion-free `150%` max ceiling.
- **Automatic `sotfVolumeMod` Coexistence:** Automatically detects **Radio Volume Mod** (`sotfVolumeMod`), defers volume hotkeys to it, enforces a clean `150%` ceiling, and suppresses any colliding playback hotkeys.
- **Custom 3D Boombox LCD & Scrolling HUD Marquee:** Aligned the backlit cyan countdown timer onto placed boomboxes and added smooth scrolling marquee text + playlist badges to the on-screen HUD banner.
- **Audio & Persistence Improvements:** Tuned 3D boombox spatial range (`2m–60m`) and headroom (`-9.0 dB`) to prevent clipping at max volume, kept music active while browsing **Inventory (`I`)** or **Survival Book (`B`)**, and updated config persistence to save cleanly on exit.

All versions: https://sotf-mods.com/mods/cptsooper/mp3-radio-player/versions

## FAQ

### Does MP3 Radio Player work in multiplayer?

No. MP3 Radio Player only works in singleplayer.

### How do I install MP3 Radio Player?

Install RedLoader (RedManager can do it for you), download MP3 Radio Player 3.0.0 from this page and put it in the \_RedLoader/Mods folder inside your game directory. Launch the game and press F1 to confirm it loaded.

### What does MP3 Radio Player need?

Only Sons of the Forest on Steam and RedLoader. It has no other dependencies.

### Does MP3 Radio Player work on a dedicated server?

No. MP3 Radio Player does not work on a dedicated server.

---

Source: https://sotf-mods.com/mods/cptsooper/mp3-radio-player · SOTF Mods, the home of Sons of the Forest modding.
