SmilouxMusic

# 🎵 SmilouxMusic (JukeboxPro)

SmilouxMusic is the ultimate music experience for Minecraft Fabric 1.21.1. Designed from the ground up to combine a modern glass interface (Glassmorphism), YouTube integration, immersive 3D spatial audio, karaoke-style synchronized lyrics, and ultra-optimized performance compatible with Sodium and Iris.

---

## ✨ Main Features

### 📻 1. Realistic 3D Radio Block in the World
* **Custom 3D Model:** Forget the traditional cubic jukebox. SmilouxMusic includes a detailed 3D model of a vintage/modern radio with an antenna, speaker grilles, and control dials.

* **Positive 3D Spatial Audio:** Logarithmic volume attenuation and binaural panel. If you turn your head or move away from the block, the music will naturally fade and shift between your headphones.

* **Configurable Range (2 to 32 blocks):** Control the audio range, HUD, and subtitles for you and your friends with a single design.

* **Redstone Integration:** Automatically activate or pause the radio using levers, redstone plates, or redstone circuits.

* **Property Protection:** Only the radio owner or an OP Administrator can modify its settings, unless public access mode is enabled.

---

### 🎧 2. Personal Mode (Private Headphones)
* Press the **`J`** key at any time to open the player in **Personal Mode**.

* Listen to your favorite music privately without disturbing other players and without needing to place a block in the world.

---

### 🌐 3. Global Server Streaming (OP/Admin Exclusive)
* Organizing an event or party on your server? Administrators with OP permissions can **stream music or entire playlists to all players on the server simultaneously**.

* Precise synchronization based on timestamps ensures all players hear the exact same second of the song.

* Master volume control for the service and an emergency stop function.

---

### 🔍 4. Integrated YouTube and Playlist Search
* **Instant Search:** Search for any song or artist directly from the game interface.

* **Playlist Sync:** Paste the link to any public YouTube playlist and import it with a single click (up to 50 tracks).

* * **Shuffle Mode and Autoplay:** Let the player automatically skip to the next song when the current one ends.

* **Local Cache Download (MP3):** Songs are downloaded and stored on your PC's cache mat, guaranteeing zero micro-cuts or annoying buffering.

---

### 🎤 5. Real-Time Synchronized Lyrics (Karaoke and Subtitles)

* **Multi-Provider Automatic Search:** Real-time connection with **LRCLIB**, **NetEase**, and **Kugou** for verse-to-verse synchronized subtitles (.LRC).

* **Continuous Subtitles:** Lyrics remain fluid on screen without flickering or disappearing during short pauses in the singer's voice.

* **Capitalization Normalizer:** Automatically corrects songs in "ALL CAPS" to display them in a clean and aesthetically pleasing format.

* * **14 Subtitle Visual Styles:**

* Modern Neon Capsule

* Panoramic Cinema

* Floating Minimalist

* Ancient Runic (with Enchanting Table font)

* Dark Illiterate

* Adventure RPG Dialogue

* Comic Book Bubble

* Retro 8-Bit Arcade

* Cyberpunk Synthwave

* Dynamic Neon Karaoke

* Vintage Cassette Tape

* Military Tech HUD, and more!

---

### 🖥️ 6. Floating On-Screen Interface (HUD) and FFT Spectrum
* **11 HUD Styles:** Displays the current song, artist, album chart in high resolution, and a timeline without interrupting your gameplay.

* **FFT Spectrum Visualizer:** A dynamic 16-band equalizer that dances to the beat of the bass and frequencies in your music.

* * **Floating Notifications (Toasted):** When changing songs or if a red issue occurs, discreet windows notify you in the corners of the screen.

* **Smart Auto-Close:** When leaving a section or disconnecting from a server, the audio stops instantly and the interface is automatically protected.

---

### 🚀 7. Extreme Performance (240+ FPS)
* **100% Free of Incompatible Shaders:** Fully compatible with **Sodium**, **Iris**, **Embeddium**, and other optimization mods.

* **Built-in Performance Mode:** Optimization of geometric rasterization and elimination of pixel overdraw (*zero overdraw*).

---

## 🎮 Default Controls

| Action | Key |

| :--- | :--- |

**Open Personal Player** | `J` |

| **Pause/Resume** | Bottom bar of the GUI |

**Next/Previous** | Bottom bar controls |

**Volume Adjustment** | Continuous slider in the player |

**Style Selector** | Available in the OP/Radio tab |

---

## 📦 Installation and Requirements

1. Make sure you have **Fabric Loader** installed