ClubLight

# ClubLights 0.27.11-beta2

Gesammelter Changelog seit 0.26.0-beta.1. Enthält die Änderungen der Versionen 0.26.x-beta.1 und 0.27.x-beta2 bis einschließlich 0.27.11-beta2.

## Neue Funktionen

### Realistische Nebelmaschinen
- Aufheizen, Temperaturanzeige, begrenzte Ausstoßdauer und Nachheizen.
- Lokales Ein-/Ausschalten per Ducken + Rechtsklick, mit animiertem Kippschalter und Betriebsanzeige bei vorhandener Stromversorgung.
- Standard-, Quick- und Heavy-Nebelfluid, Tank sowie 5-L- und 10-L-Kanister. Mengenanzeige in Litern und Millilitern; Standardverbrauch maximal 5 ml/s bei voller Stärke.
- Getrennte Kanisterslots zum Befüllen und Entleeren des Tanks, auch für Teilmengen. Unterschiedliche Fluidarten werden nicht vermischt.
- Nebelbedienfeld mit Zustandsfarben: rot blinkend beim Aufheizen, grün bereit, blau während des Ausstoßes, grau bei fehlender Betriebsbereitschaft.
- Weltweit gespeicherter Realismusmodus über den OP-Befehl `/clublights fog realistic true|false`. Ohne Parameter wird der aktuelle Modus angezeigt.
- Ohne Realismus: keine Heizzeit, kein Fluidverbrauch und kontinuierlicher Ausstoß bis zum Abschalten. Strom, befüllter Tank, lokaler Maschinenschalter und Blackout bleiben wirksam.

### Motorisierte Traversen
- Kettenzüge, Motorpult und Up/Stop/Down-Bedienfelder mit Gruppensteuerung und Survival-Rezepten.
- Traversen bewegen unterstützte Geräte und Kabel mit; Licht und Audio bleiben angeschlossen.
- Unterschiedliche Motorpositionen ermöglichen Schräglagen. Manuelle Winkelgrenze 45°, Musikautomatik maximal 43°; Strom- und Hindernisprüfungen bleiben aktiv.
- Acht benennbare Szenen mit bis zu 64 Gruppenfahrten pro Szene, Ziellänge, individueller Geschwindigkeit und Wartezeit.
- Gruppen können gleichzeitig und in unterschiedliche Richtungen fahren. Jede Gruppe beginnt ihren nächsten Schritt nach eigener Zielankunft und Wartezeit.
- Musikmodus für alle mit dem Motorpult verbundenen Gruppen, mit maximaler Absenkung und musikalisch passenden Fahrten und Pausen.
- Rückfahrt auf 0 m erst nach endgültigem Musikende; keine Rückfahrt während Titelübergängen.

### Erweiterte Musikanalyse
- Gemeinsame algorithmische Voranalyse und gespeicherte Showplanung für musikgesteuerte Lichtgeräte, Tanzflächen und Motoren.
- Geschätztes Tempo, Beat-/Onset-Zeiten, Dynamik, Frequenzverteilung, dominante Tonhöhe, Tonart und stimmähnliche Passagen.
- Erkennung musikalischer Abschnitte und grob ähnlicher Passagen für abwechslungsreiche Bewegungen, Farben und Muster; Aufbauten, Breaks und Drops sind algorithmische Schätzungen.
- Hintergrundwarteschlange mit standardmäßig einem Analysearbeiter. Persistenter OP-Befehl `/clublights analysis parallel <1-4>`.
- Admin-Analysemonitor mit Suche, Importfortschritt, Analysezustand, Fehleranzeige und Neuanalyse-Button pro Lied.
- Monitor nur per `/give @s clublights:analysis_monitor`, ohne Rezept oder Kreativinventareintrag; Bedienung erfordert OP-Rechte.
- Fehlgeschlagene Neuanalyse bewahrt die bisherige gültige Show. Keine KI, Texterkennung oder externe kostenpflichtige API.

### Musikpult und Import
- WAV, OGG Vorbis, FLAC und MP4/M4A mit AAC-Audio zusätzlich zu MP3.
- MP4 spielt derzeit nur Audio; die Originaldatei bleibt für spätere Video-Funktionen erhalten.
- Separate Lautstärkefader für Deck A/B, die die Wiedergabelautstärke für andere Spieler mitsteuern.
- Manueller Crossfader mit direkt reagierenden Lautstärken; Automix bewegt die Faderanzeige während der Überblendung mit.
- Wellenform mit Positionsanzeige und Sprung zur angeklickten Wiedergabeposition; automatische Lichtshow folgt der neuen Position.

### Licht und Bühneneffekte
- Adressierbare CO₂-Kanonen und visuelle Feuereffekte mit beweglichem Rohr, Höhensteuerung und Winkelbereich von −65° bis +65°.
- Je drei DMX-Kanäle: Ausstoß, Höhe und Winkel. CO₂-/Feuergeräte aus der ersten Zweikanal-Testversion müssen mit Platz für den dritten Kanal neu gepatcht werden.
- Eigenes CO₂/Fire-Zweierbedienfeld mit Universenbereich und Boden-/Wand-/Deckenmontage.
- CO₂ und Feuer lassen sich separat zur Musiksteuerung zuschalten. Manuelle Bedienfelder und Blackout bleiben verfügbar.
- Moving Heads und Spots mit maximal 36 statt 24 Blöcken Reichweite (+50 %).
- Verfolgung von Spielern oder festen Positionen direkt am Gerät und über die Auswahl im Lichtpult.
- Ein Follow-Schalter startet ausgewählte Heads/Spots mit Weiß und 40 % Dimmer. Spätere Farb-/Dimmeränderungen beenden die Verfolgung nicht.
- Kletterbare Traversen mit Außenkontakt und Halten durch Ducken.

## Optik und Bedienung
- Detailliertere Modelle für Kettenzüge, Motorpult, Generatoren, Batterien, Rohlingmaschine und Presse.
- Ineinandergreifende Kettenglieder mit Ausgabe am Motor, sichtbare Halterungen und mitfahrende Kabel.
- Animierter Motorlüfter folgt tatsächlicher Fahrtrichtung und Geschwindigkeit.
- Neue CO₂-/Feuermodelle mit hohlen, schwenkbaren Rohren und passenden Ausstoßpositionen.
- Größeres, übersichtlicheres Motorpult; Musikbereich und Meldungen werden nicht mehr vom Executor verdeckt.
- Einheitliche grüne/rote Statusstreifen für Musikshow-Schalter und ein einzelner Verfolgungsschalter.
- Lichtkegel reagieren bei niedrigen Dimmerwerten früher und reduzieren sowohl Deckkraft als auch Farbemission.

## Fehlerbehebungen
- Nebelkanisterrezepte unterschieden, manuelle Nebeladressierung wiederhergestellt und Tankentnahme ergänzt.
- Unbeabsichtigtes Burst-Ende im unrealistischen Nebelmodus behoben.
- Motor-Stoppposition bleibt erhalten; asymmetrische Rückfahrt unter eigenen Motoren funktioniert wieder.
- Unabhängige manuelle Motorgruppen stoppen sich nicht mehr gegenseitig.
- CO₂-/Feuerrohre springen beim Einschalten nicht mehr kurz nach links.
- Ausrichtung und Lesbarkeit des CO₂/Fire-Bedienfelds korrigiert.
- Verzögerte Decklautstärke und zusätzliche Überblendung bei manuellem Crossfader korrigiert.
- Durchfallen/Glitchen beim Traversenklettern behoben.
- Flackernde überlappende Flächen an Plattenmaschinen, Pultgrafiken und Kabel-/Kettenanschlüsse korrigiert.
- Beschädigte Zeichen in 49 deutschen/englischen Übersetzungseinträgen repariert.

## Performance und aktueller Stand
- Gemeinsame Kabelnetz-Snapshots statt wiederholter Kopien pro Gerät; indizierte Stromquellen und Lichtpulte.
- Showinterpolation einmal pro Universum/Tick, wiederverwendete Gerätelisten und Tanzflächen-Zuordnungen.
- Doppelte Verfolgungsberechnungen und unnötige Updates unbewegter Traversenbestandteile reduziert.
- Build und alle 38 erforderlichen Server-GameTests bestanden, einschließlich 50×50-Tanzfläche.
- Im bisherigen Nutzertest läuft eine Anlage mit ungefähr 29–30 Universen ohne Ruckler oder „Can't keep up“-Meldungen während der Show. Das ist kein allgemeines Leistungsversprechen; der aktuelle Stand wurde dabei allein auf dem Server getestet.
- Import und Neuanalyse können weiterhin Serverrückstand verursachen; im Nutzertest etwa 20–93 Ticks. Weitere Optimierung bleibt geplant.

Bitte dieselbe Version auf Server und Clients verwenden. Weitere Importformat- und Mehrspielertests stehen noch aus. Dies ist weiterhin eine Beta.

# ClubLights 0.27.11-beta2

Combined changelog since 0.26.0-beta.1, covering 0.26.x-beta.1 and 0.27.x-beta2 through 0.27.11-beta2.

## New features

### Realistic fog machines
- Warm-up, temperature display, limited bursts and reheating.
- Local power toggle using sneak + right-click, with an animated rocker switch and powered indicator.
- Standard, Quick and Heavy fog fluids, tanks and 5 L/10 L canisters. Quantities displayed in litres and millilitres; default maximum consumption is 5 ml/s at full output.
- Separate slots for filling and draining tanks, including partial quantities. Different fluid types cannot be mixed.
- Fog controls show machine status: flashing red while heating, green when ready, blue while emitting, grey when unavailable.
- World-persistent realism mode through the OP command `/clublights fog realistic true|false`. Omit the argument to query the current mode.
- Unrealistic mode removes heating and fluid consumption and allows continuous output until switched off. Power, a filled tank, the local machine switch and blackout still apply.

### Motorized trusses
- Chain hoists, a motor console and grouped Up/Stop/Down control panels, with survival recipes.
- Trusses carry supported devices and cables while lighting and audio remain connected.
- Different motor positions allow tilted assemblies. Manual angle limit: 45°; music-controlled limit: 43°. Power and obstacle checks remain active.
- Eight named scenes with up to 64 group movements per scene, target lengths, individual speeds and hold times.
- Groups can move simultaneously in different directions. Each group advances after reaching its own target and completing its own hold time.
- Music mode controls all groups connected to the motor console, with maximum lowering and musically driven movement and pauses.
- Return to 0 m only after music has fully ended, without returning during track transitions.

### Expanded music analysis
- Shared algorithmic pre-analysis and stored show planning for music-controlled lighting, dance floors and motors.
- Estimated tempo, beat/onset timing, dynamics, frequency distribution, dominant pitch, musical key and voice-like passages.
- Musical sections and roughly similar passages inform varied movement, colours and patterns. Builds, breaks and drops are algorithmic estimates.
- Background analysis queue with one worker by default. Persistent OP command `/clublights analysis parallel <1-4>`.
- Admin analysis monitor with search, import progress, analysis status, errors and a re-analysis button beside each track.
- Available only through `/give @s clublights:analysis_monitor`, without a recipe or creative-tab entry; operation requires OP permissions.
- Failed re-analysis preserves the previous valid show. No AI, lyrics transcription or paid external API.

### Music console and imports
- WAV, OGG Vorbis, FLAC and MP4/M4A with AAC audio added alongside MP3.
- MP4 currently plays audio only; the original file is retained for future video features.
- Separate Deck A/B volume faders control playback volume for other players too.
- Manual crossfader with directly responding volume; the fader display follows automatic mix transitions.
- Waveform with playback-position display and click-to-seek; the automatic light show follows the new position.

### Lighting and stage effects
- Addressable CO₂ jets and visual flame effects with moving nozzles, height control and −65° to +65° angle range.
- Three DMX channels per effect: output, height and angle. Devices from the initial two-channel test version need repatching with room for the third channel.
- Dedicated CO₂/Fire dual control panel with universe ranges and floor/wall/ceiling mounting.
- CO₂ and fire can be enabled separately in music mode. Manual panels and blackout remain available.
- Moving heads and spots now reach up to 36 blocks instead of 24 (+50%).
- Player/fixed-position tracking from device settings and selected fixtures on the lighting desk.
- A single Follow toggle starts selected heads/spots in white at 40% dimmer. Subsequent colour and dimmer edits preserve tracking.
- Climbable trusses using exterior contact and sneak-to-hold.

## Visuals and usability
- More detailed chain hoists, motor console, generators, batteries, record-blank machine and press.
- Interlocking chain links feeding from the hoist, visible mounting hardware and moving cables.
- Animated hoist fan follows actual travel direction and speed.
- Rebuilt CO₂/fire models with hollow moving nozzles and matching emission origins.
- Larger, clearer motor console; music controls and messages are no longer hidden beneath the executor.
- Consistent green/red state strips for music-show toggles and a single tracking toggle.
- Moving-head beams appear at lower dimmer values, with both opacity and colour emission reduced as they dim.

## Fixes
- Distinct fog-canister recipes, restored manual fog patching and tank draining.
- Removed unintended burst timeout in unrealistic fog mode.
- Preserved motor stop positions and fixed asymmetric return beneath the assembly's own hoists.
- Independent manual motor groups no longer stop each other.
- CO₂/fire nozzles no longer briefly jump left when enabled.
- Corrected CO₂/Fire control-panel orientation and label readability.
- Fixed delayed deck volume and unwanted fading during manual crossfader changes.
- Fixed clipping/falling through trusses while climbing.
- Fixed overlapping/flickering record-machine surfaces, console graphics and cable/chain connections.
- Repaired corrupted characters in 49 German/English translation entries.

## Performance and current status
- Shared cable-network snapshots replace repeated per-device copies; power sources and lighting desks are indexed.
- Show interpolation runs once per universe/tick, with reused fixture lists and dance-floor membership data.
- Reduced duplicate tracking calculations and redundant stationary rig updates.
- Build and all 38 required server GameTests passed, including a 50×50 dance floor.
- In the user's current server test, an approximately 29–30-universe installation runs without stuttering or “Can't keep up” messages during shows. This is not a universal performance guarantee; the current version was tested alone on that server.
- Importing and re-analysis can still cause server lag, approximately 20–93 ticks behind in the reported test. Further optimization is planned.

Use the same version on server and clients. Additional import-format and multiplayer testing remains outstanding. This is still a beta.