ClubLight

# ClubLights

Verwandle Minecraft in einen Club, eine Konzertbühne oder ein Festival: mit beweglichem Licht, Showlasern, Nebel, Tanzflächen, synchronisierter Musik und motorisierten Traversen.

**Aktuelle Version: 0.27.11-beta2 · Minecraft Java 26.2 · NeoForge**

Singleplayer und Multiplayer werden unterstützt. Installiere dieselbe ClubLights-Version auf dem Server und allen teilnehmenden Clients.

## Licht und Showsteuerung
- Moving Heads und Spot-Moving-Heads mit RGB-Farben, Bewegung, Strahlmustern und bis zu 36 Blöcken Reichweite.
- Showlaser mit verschiedenen Mustern und unterschiedlich gefärbten Einzelstrahlen sowie adressierbare RGB-Lichtleisten.
- Adressierbare Tanzflächen mit abwechslungsreichen Mustern; eine Variante erzeugt Bodennebel.
- Lichtpult mit manueller Steuerung, gespeicherten Szenen und Sequenzen, Musikautomatik und Verfolgung von Spielern oder festen Positionen.
- Strobe-, Nebel- und Blackout-Bedienfelder mit einstellbaren Universenbereichen.
- CO₂-Kanonen und visuelle Feuereffekte mit schwenkbaren Rohren, eigener Steuerung und gemeinsamem CO₂/Fire-Bedienfeld. Die Feuereffekte verursachen keine Brände oder Schäden.

## Verkabelung und Strom
Die Anlage orientiert sich an Veranstaltungstechnik: **512 DMX-Kanäle pro Universum**, separate XLR-Audioverbindungen und FE-Stromversorgung. Strom-, DMX- und XLR-Kabel passen gemeinsam in einen Block und lassen sich in Traversen verlegen.

Ein Adressierungswerkzeug findet freie DMX-Adressen und patcht ganze Tanzflächen. Manuelle Adressierung bleibt verfügbar. Generatoren und Batterien versorgen die Geräte; externe FE-Quellen werden unterstützt. Iron Generators wurde erfolgreich getestet.

## Musik und eigene Schallplatten
Das Musikpult bietet zwei Decks, getrennte Lautstärkefader, einen manuellen Crossfader, Automix, separate Auswurftasten und Wellenformen mit Klick zur gewünschten Wiedergabeposition.

Importiere eigene Musik mit Unterordnern und Sammelimport. Rohlingmaschine und Presse erzeugen Musikplatten; Plattenkoffer und sichtbare Regale helfen beim Sortieren. Benötigte Titel werden vom Server an andere Spieler übertragen und über angeschlossene PA-/Line-Array-Lautsprecher synchron wiedergegeben.

**Importformate:** MP3, WAV, OGG Vorbis, FLAC und MP4/M4A mit AAC-Audio. MP4 unterstützt derzeit ausschließlich Audio, noch keine Videowiedergabe. Die Originaldatei bleibt für spätere Video-Funktionen erhalten. Decoder sind enthalten; eine separate FFmpeg-Installation ist nicht erforderlich.

Es wird keine Musik mitgeliefert. Importiere und teile nur Dateien, für deren Nutzung und Weitergabe du die nötigen Rechte hast. Spotify ist nicht integriert.

## Automatische Musikshows
Die algorithmische Voranalyse erstellt gespeicherte Shows für Licht, Tanzflächen und Motoren. Tempo, Dynamik, Frequenzen, Tonhöhe und musikalische Abschnitte beeinflussen Bewegungen, Farben und Muster.

Es werden keine KI, Texte oder kostenpflichtigen Online-Dienste verwendet. Musikalische Merkmale sind Schätzungen, keine garantierte Interpretation.

Standardmäßig wird ein Lied gleichzeitig analysiert. Admins können mit `/clublights analysis parallel <1-4>` die Parallelität einstellen. Der OP-Analysemonitor zeigt Import-/Analysefortschritt und ermöglicht Neuanalyse pro Lied: `/give @s clublights:analysis_monitor`.

## Nebel und bewegliche Bühnen
Nebelmaschinen besitzen Tanks, Standard-/Quick-/Heavy-Fluid und 5-L-/10-L-Kanister. Realistischer Betrieb bietet Aufheizen, Temperaturanzeige, begrenzte Ausstöße und Nachheizen. Der Standardverbrauch beträgt maximal 5 ml/s.

Admins können über `/clublights fog realistic false` Heizzeit und Verbrauch abschalten und kontinuierlichen Ausstoß erlauben. Mit `true` wird realistischer Betrieb aktiviert. Die Einstellung bleibt in der Welt gespeichert; Strom und ein befüllter Tank bleiben erforderlich.

Kettenzüge bewegen Traversen mit unterstützten Geräten und Kabeln. Motorgruppen, gespeicherte Fahrsequenzen und Up/Stop/Down-Panels ermöglichen unterschiedliche Höhen und Schräglagen. Musikmodus steuert alle angeschlossenen Gruppen und fährt nach endgültigem Musikende auf 0 m zurück. Winkel-, Hindernis- und Stromprüfungen bleiben aktiv.

## Survival und Bedienung
Survival-Rezepte, ein Handbuch, Diagnose und DMX-Belegungsübersicht unterstützen den Aufbau. Kabel und normale Tanzflächen ergeben vier Stück pro Rezept; Nebeltanzflächen und andere Geräte jeweils eines. Rohlinge entstehen ausschließlich in der Rohlingmaschine. Der Admin-Analysemonitor ist bewusst nicht craftbar.

Deutsche und englische Oberflächen sowie lokale Qualitätseinstellungen sind vorhanden. JEI ist optional.

## Bekannte Grenzen dieser Beta
- AstraLex und Complementary Reimagined wurden erfolgreich getestet. BSL ist derzeit nicht kompatibel; weitere Shaderkompatibilität ist geplant.
- Größere Anlagen und Shader können weiterhin hohe CPU-/GPU-/Netzwerklast erzeugen. Der Showbetrieb wurde gezielt optimiert; Import und Neuanalyse können noch Serverrückstand verursachen.
- BPM, Tonart, Gesang und Abschnittsgrenzen können ungenau erkannt werden. Es gibt keine Texterkennung und keine samplegenaue Beatgarantie.
- Neue Importformate sind implementiert und automatisch geprüft; zusätzliche Nutzer- und Mehrspielertests stehen noch aus. Ogg Opus, DRM und Mehrkanalton werden nicht unterstützt. FLAC: Mono/Stereo bis 24 Bit; MP4/M4A: AAC-Audio.
- Aktuelle Grenzen: 256 MiB pro Datei und 100 GiB für die Musikbibliothek.
- Kabelnetze benötigen geladene Weltbereiche. Allgemeines automatisches Chunkloading ist nicht enthalten.
- Bewegliche Traversen unterstützen die erfassten ClubLights-Geräte, keine beliebigen Fremdmod-Blöcke. Gemeinsame mechanische Grenzen gelten weiterhin für alle Motorgruppen derselben Traverse.
- Nicht jeder Laser-Musterwechsel wird stufenlos überblendet. Nicht alle Shader-, Geräte- und Multiplayerkombinationen sind vollständig geprüft.

## Weitere Entwicklung
Geplant sind unter anderem Displays für Videos/GIFs, platzierbare Bühnenvorlagen mit Adressierungsübernahme, Nebelfluid-Herstellung, Erweiterungen der Kettenlänge durch eingelegte Ketten sowie weitere Bedienungs-, Performance- und Shaderverbesserungen. Diese Punkte sind noch nicht enthalten und haben keinen zugesagten Veröffentlichungstermin.

# ClubLights

Turn Minecraft into a club, concert stage or festival with moving lights, show lasers, fog, dance floors, synchronized music and motorized trusses.

**Current version: 0.27.11-beta2 · Minecraft Java 26.2 · NeoForge**

Singleplayer and multiplayer are supported. Install the same ClubLights version on the server and all participating clients.

## Lighting and show control
- Moving heads and spot moving heads with RGB colours, motion, beam patterns and up to 36 blocks of reach.
- Show lasers with multiple patterns and individually coloured beams, plus addressable RGB light bars.
- Addressable dance floors with varied patterns, including a ground-fog variant.
- Lighting desk with manual control, stored scenes and sequences, automatic music shows and player/fixed-position tracking.
- Strobe, fog and blackout control panels with configurable universe ranges.
- CO₂ jets and visual flame effects with moving nozzles, dedicated controls and a shared CO₂/Fire panel. Flame effects do not start fires or cause damage.

## Wiring and power
The installation follows stage-technology concepts: **512 DMX channels per universe**, separate XLR audio connections and FE power. Power, DMX and XLR cables can share one block and run inside trusses.

A patching tool finds free DMX addresses and patches entire dance floors. Manual addressing remains available. Generators and batteries power devices; external FE sources are supported. Iron Generators has been successfully tested.

## Music and custom records
The music console provides two decks, separate volume faders, a manual crossfader, automix, individual eject buttons and waveforms with click-to-seek.

Import your own music using subfolders and batch imports. The blank machine and record press create custom records; record cases and visible shelves help organize them. Required tracks are transferred from the server to other players and played in sync through connected PA/line-array speakers.

**Import formats:** MP3, WAV, OGG Vorbis, FLAC and MP4/M4A with AAC audio. MP4 currently supports audio only, without video playback. The original file is retained for future video features. Decoders are included; no separate FFmpeg installation is required.

No music is bundled. Only import and share files you have permission to use and distribute. Spotify is not integrated.

## Automatic music shows
Algorithmic pre-analysis creates stored shows for lighting, dance floors and motors. Tempo, dynamics, frequencies, pitch and musical sections inform motion, colours and patterns.

No AI, lyrics transcription or paid online service is used. Musical features are estimates rather than guaranteed interpretations.

One track is analyzed at a time by default. Admins can configure parallel workers through `/clublights analysis parallel <1-4>`. The OP-only analysis monitor shows import/analysis progress and allows per-track re-analysis: `/give @s clublights:analysis_monitor`.

## Fog and moving stages
Fog machines include tanks, Standard/Quick/Heavy fluid and 5 L/10 L canisters. Realistic operation includes heating, temperature display, limited bursts and reheating. Default maximum consumption is 5 ml/s.

Admins can disable heating and consumption and allow continuous output with `/clublights fog realistic false`. Use `true` to enable realistic operation. The setting persists in the world; power and a filled tank are still required.

Chain hoists move trusses carrying supported devices and cables. Motor groups, stored movement sequences and Up/Stop/Down panels allow different heights and tilted assemblies. Music mode controls all connected groups and returns to 0 m once music fully ends. Angle, obstacle and power checks remain active.

## Survival and usability
Survival recipes, a handbook, diagnostics and a DMX occupancy overview help you build your setup. Cable and regular dance-floor recipes produce four items; ground-fog floors and other devices produce one. Record blanks are made exclusively in the blank machine. The admin analysis monitor intentionally has no recipe.

German and English interfaces and local quality settings are available. JEI is optional.

## Known beta limitations
- AstraLex and Complementary Reimagined have been successfully tested. BSL is currently incompatible; additional shader compatibility is planned.
- Large installations and shaders may still place significant load on CPU, GPU and networking. Show playback has received targeted optimization; importing and re-analysis can still cause server lag.
- BPM, key, voice estimates and section boundaries may be inaccurate. There is no lyrics recognition or sample-accurate beat guarantee.
- Additional import formats are implemented and automatically tested; further user and multiplayer testing remains outstanding. Ogg Opus, DRM and multichannel audio are unsupported. FLAC: mono/stereo up to 24-bit; MP4/M4A: AAC audio.
- Current limits: 256 MiB per file and 100 GiB for the music library.
- Cable networks require loaded world areas. General automatic chunk loading is not included.
- Moving trusses support captured ClubLights devices, not arbitrary third-party mod blocks. Shared mechanical limits still apply to all groups supporting the same truss.
- Not every laser-pattern change blends seamlessly. Not all shader, device and multiplayer combinations have been fully tested.

## Further development
Planned additions include video/GIF displays, placeable stage templates with inherited addressing, fog-fluid production, chain-length expansion using inserted chains, and further usability, performance and shader improvements. These features are not included yet and have no promised release date.