ClubLight

# ClubLights

Baue Clubs, Konzertbuehnen und Festivals in Minecraft mit Lichtshows, Musik, beweglichen Traversen und einer LED-Leinwand für Musikvisualisierungen.

Für Minecraft Java 26.2 mit NeoForge 26.2.0.88. Auf Server und Clients muss dieselbe Modversion installiert sein.

**RAM-Empfehlung: 8–10 GB für Minecraft (Client bzw. Server).** Der tatsächliche Bedarf hängt von der Größe des Aufbaus und weiteren Mods ab.

## Licht und Bühne
Moving Heads, Showlaser, LED-Bars, Tanzflächen, Nebelmaschinen sowie CO2- und Feuereffekte. Steuere Geräte über das Lichtpult, manuelle Einstellungen, Szenen oder analysierte Musikshows. Separate Tasten steuern Strobe, Nebel, Blackout, Spezialeffekte und Motorgruppen.

Traversen, Kettenzuege und ein Motorpult erlauben gemeinsame oder unabhaengige Bewegungen mit Szenen, Geschwindigkeitseinstellungen und mechanischen Winkelgrenzen. Generatoren nutzen Vanilla-Ofenbrennstoffe; Batterien und Kabel versorgen den Aufbau.

## Musik
DJ-Pult mit zwei Decks, Lautstärkereglern und Automix. Importiere MP3, WAV, OGG oder FLAC, stelle eigene Schallplatten her und spiele sie über PA-Boxen ab. Die benötigten Musikdateien werden an Mitspieler übertragen; der Client zeigt den Downloadfortschritt über der Hotbar an.

Die lokale algorithmische Analyse bereitet Musikshows vor. Keine KI und kein kostenpflichtiger Onlinedienst erforderlich. Ein Adminblock zeigt Import-/Analysestatus und erlaubt Neuanalysen. Analyseparallelitaet ist per OP-Befehl einstellbar.

## Leinwand und Produktion
Verbinde LED-Panels zu einer glatten rechteckigen Leinwand. Empfänger und Visualisierungspult besitzen Schalter und Startanimationen. Wähle Wellen, klassische Balken oder einen drehenden Kreis mit Modlogo; Bass links, Mitten mittig, Höhen rechts.

Eine 1 x 2 x 7 große Nebelfluid-Produktionsanlage verbindet Wasserfilter, Kürbispresse, Aufbereitung, Mixer und Kanisterabfüllung. Mengen werden in Litern und Millilitern dargestellt.

## Grenzen und Ausblick
Video-/Bildimport, Videowiedergabe und MP4/M4A-Musikimport sind in 1.0 deaktiviert und im Pult als Coming soon gekennzeichnet. Bestehende Mediendateien bleiben erhalten, sind aber vorerst nicht abspielbar.

Die Stromnetzberechnung wurde anhand einer JFR-Analyse optimiert. Im getesteten Aufbau liefen Solo- und Zwei-Spieler-Shows mit Motor-Musikmodus jeweils rund 13 Minuten flüssig und ohne gemeldete Serverwarnungen. Die mittleren Tickzeiten lagen bei etwa 14,5 bzw. 14,6 ms (Budget für 20 TPS: 50 ms).

Diese Tests sind keine Garantie für beliebige Aufbaugrößen, Spielerzahlen oder Modkombinationen. Minimales Traversenruckeln im Musikmodus kann auftreten; Shaderkompatibilität ist nicht für alle Shader bestätigt.

Handbuch und Oberflächen auf Deutsch und Englisch. Keine eigene Musik ist beigelegt.

# ClubLights

Build Minecraft clubs, concert stages and festivals with light shows, music, moving trusses and an LED wall for music visualizations.

For Minecraft Java 26.2 and NeoForge 26.2.0.88. Install the same mod version on the server and all participating clients.

**Recommended RAM allocation: 8–10 GB for Minecraft (client or server).** Actual requirements depend on installation size and other mods.

## Lighting and stage control
Moving heads, show lasers, LED bars, dance floors, fog machines, CO2 jets and flame effects. Operate fixtures through the lighting desk, manual settings, scenes or analyzed music shows. Dedicated buttons control strobe, fog, blackout, special effects and hoist groups.

Trusses, chain hoists and a motor desk support shared or independent movements, sequences, speed settings and mechanical angle limits. Generators use vanilla furnace fuels; batteries and cables power the installation.

## Music
A two-deck DJ desk with volume controls and Automix. Import MP3, WAV, OGG or FLAC, create custom records and play them through PA speakers. Required music files transfer to other players, with client download progress shown above the hotbar.

Local algorithmic analysis prepares music shows. No AI or paid online service is required. An admin block displays import/analysis status and supports reanalysis. Operators can configure analysis concurrency with a command.

## LED wall and production
Join LED panels into a smooth rectangular wall. The receiver and visualization desk have power switches and startup animations. Choose waves, classic bars or a rotating ring with the mod logo: bass left, mids center, highs right.

A 1 x 2 x 7 fog-fluid production multiblock combines water filtration, pumpkin pressing, processing, mixing and canister filling. Amounts are displayed in liters and milliliters.

## Limitations and plans
Video/image import, video playback and MP4/M4A music imports are disabled in 1.0 and marked Coming soon. Existing media files are retained but cannot currently play.

JFR-guided optimization reduced repeated power-network work. In the tested setup, solo and two-player shows with music-driven hoists each ran smoothly for about 13 minutes without reported server warnings. Mean tick times were approximately 14.5 and 14.6 ms respectively (20 TPS budget: 50 ms).

These tests do not guarantee performance for every installation size, player count or mod combination. Minor music-driven truss stutter may occur. Compatibility with every shader is not verified.

German and English interfaces and handbook. No custom music is bundled.