Описание
# 📻 Apium Radio - Next-Gen Streaming Radio for Minecraft
**Apium Radio** brings real internet radio streaming into Minecraft with a level of immersion and technical sophistication never seen before. Forget about simple "jukeboxes" — this is a fully simulated audio system with 3D sound, multi-speaker networks, and realistic physics.
## ✨ Key Features
### 🎵 True Streaming Audio
- **Real-time MP3 Streaming:** Listen to any internet radio station or MP3 stream directly in-game.
- **Built-in Decoder:** No external libraries or codecs required on the client side. It just works.
- **High-Fidelity Audio Engine:** Custom-built audio engine with 64KB buffering and per-sample volume interpolation for crystal clear sound without crackling or lag.
### 🔊 Advanced 3D Audio System
- **Spatial Audio:** Sound is accurately positioned in 3D space. Walk around the radio, and you'll hear the sound pan from left to right.
- **Realistic Falloff:** Volume fades naturally with distance.
- **Occlusion:** Walls and obstacles muffle the sound, just like in real life.
- **Multi-Source Mixing:** Connect multiple speakers, and the mod will intelligently mix the audio sources to create a seamless surround sound experience. No "jumping" sound when moving between speakers!
### 📡 Network & Speakers
- **Expand Your Range:** Connect **Speakers** to your Radio to extend the broadcast area to other rooms or even outside.
- **Daisy-Chaining:** Speakers act as cables! Chain them together to cover huge areas.
- **Individual Control:** Rename speakers and adjust their volume individually via a dedicated GUI. Create zones with different volume levels!
- **Cables:** Use Audio Cables to connect components neatly.
### ⚡ Realistic Mechanics
- **Component System:** The Radio isn't a magic block. You need to craft and install 3 essential components:
- **Magnetic Coil**
- **Vacuum Tube**
- **Crystal Resonator**
- **Antenna Requirement:** You must place a **Lightning Rod** (or configured block) on top of the radio to receive a signal.
- **Lightning Hazard:** If lightning strikes your antenna, your radio might fry! Components can burn out, and connected speakers might overload. Protect your equipment!
### 🖥️ Modern UI
- **Vanilla-Style GUI:** Clean, intuitive interface that fits perfectly with the game's aesthetic.
- **Tabs:** Easily switch between Main controls and Speaker management.
- **Status Indicators:** Clear visual feedback on connection status, errors, and missing components.
## 🛠️ Installation
1. Install **Minecraft Forge** for 1.20.1.
2. Drop the `apiumradio-x.x.x.jar` into your `mods` folder.
3. Launch the game and craft your first Radio!
## 🎮 Getting Started
1. **Craft a Radio** and place it down.
2. **Place an Antenna** (Lightning Rod) on top of it.
3. **Insert Components:** Open the GUI and place the Coil, Lamp, and Resonator in their slots.
4. **Tune In:** Enter a stream URL (e.g., a direct MP3 link) and hit Play.
5. **Expand:** Craft Speakers and Cables to set up a sound system for your entire base.
## 🔧 Configuration
The mod is highly configurable via `apiumradio-common.toml`:
- **Max Speakers:** Limit the number of speakers per radio (Default: 32).
- **Default URL:** Set a default station for new radios.
- **Antenna Block:** Change which block acts as an antenna.
---
*Apium Radio is the only up-to-date, feature-rich radio mod for modern Minecraft versions. Experience music like never before!*