🎶 Spectra Audio
Spectra Audio is a high-performance, real-time audio analysis and 3D visualization engine designed for the next generation of Minecraft servers. It bridges the gap between high-fidelity audio processing and the Minecraft world, allowing server owners to create immersive musical experiences, live concerts, and rhythmic environments without requiring any client-side mods.
By utilizing a dedicated FFT (Fast Fourier Transform) engine and a custom OpenAL playback system, Spectra analyzes every beat, frequency, and jump in your audio to translate them into stunning block and particle animations.
📺 Video Showcase
🚀 Key Features
- Real-Time Audio Analysis: High-performance frequency tracking (Bass, Snare, and Hat detection) with customizable attack/decay smoothing for fluid animations.
- Dynamic Resource Pack Hosting: Built-in HTTP server that automatically compiles and serves a Resource Pack to players. Import a new
.oggfile, and players receive it instantly—no server restarts required. - 3D World-Space Visualizers: A robust "Preset" system allowing you to create complex shapes (Tornados, Helixes, Rings, Waves) that react to specific frequency bands.
- Intelligent Rendering Modes:
- Static: Perfect for stages and fixed structures.
- Player-Centric: Visualizers that follow players while walking or flying with Elytras.
- Web-Based Dashboard: A built-in web interface to monitor the audio spectrum, track "Hit Streaks," and control engine volume remotely.
- Asynchronous Engine: The audio processing and analysis are decoupled from the main server thread, ensuring that high-intensity music does not impact your TPS.
🛠️ How it Works
- Import: Drop an
.oggfile into the import folder and use/spectra import. The plugin handles the hashing, packaging, and hosting of the file. - Process: The engine decodes the audio and runs a real-time FFT analyzer to extract "Reactive Signals."
- Visualize: The
VisualizerManagertakes these signals and updates blocks and particles in the world based on your chosen preset.
📋 Compatibility & Requirements
Spectra Audio is built to push the boundaries of modern server environments:
- Software: Fully compatible with Folia.
- Minecraft Version: Supports Minecraft 26.1.2 .
- Java Version: Java 25.
💻 Commands & Usage
| Command | Description |
|---|---|
/spectra import <file.ogg> <id> |
Registers a new audio file and updates the resource pack. |
/spectra removesound <id> |
Deletes a sound, updates the pack, or unloads it if empty. |
/spectra play <id> |
Starts audio playback for all players with active visuals. |
/spectra stop |
Stops the current audio and terminates all active visualizers. |
/spectra sync <duration> |
Adjust the timing of the song you are on. |
/spectra visuals create <preset> [id] |
Launches a reactive 3D visualizer at your location. |
/spectra visuals stop [id] |
Stops a specific visualizer or all if no ID is provided. |
/spectra reload |
Hot-reloads configuration, thresholds, and pack state. |
⚙️ Installation Note
Ensure the ports defined in your config.yml (default 8080 for the pack server and 8081 for the web visualizer) are open on your host's firewall to allow player connections.
Spectra Audio turns your server into a living, breathing music visualizer. Whether you are hosting a digital festival or enhancing a lobby, Spectra provides the tools to make your world dance.
