ClubLight

ClubLights – Changelog seit 0.21.1

GERMAN

**Aktueller Stand: 0.26.0-beta.1 · Minecraft Java 26.2 · NeoForge**

Dieser Changelog fasst die Änderungen **nach 0.21.1 bis einschließlich 0.26.0-beta.1** zusammen. Zwischenzeitliche Überarbeitungen sind mit ihrem endgültigen Verhalten beschrieben.

## Lichtsteuerung und gespeicherte Shows

- Manuelle Lichteinstellungen, LED-Bar-Steuerung, Tanzflächensteuerung und manuelle Sequenzen repariert. Die Bedienung erfolgt über geprüfte Server-Nachrichten und benötigt keine OP-Rechte mehr.
- APPLY und STORE übertragen zusammengehörige Änderungen gemeinsam. Ungültige oder veraltete Änderungen werden vollständig abgewiesen, statt einen Teil davon zu übernehmen.
- STORE kann noch nicht angewendete Einstellungen direkt speichern; vorheriges APPLY ist nicht erforderlich.
- Konfliktschutz beim gemeinsamen Arbeiten: Änderungen eines anderen Spielers werden nicht unbemerkt durch einen älteren Bearbeitungsstand überschrieben. Cue-Listen und ausgewählte Shows werden pro Spieler angezeigt.
- Steuerungsprioritäten vereinheitlicht: Blackout sperrt die Ausgabe; Effekttaster überschreiben ihre jeweiligen Effekte; manuelle Eingaben und manuelle Shows übernehmen von der Musiksteuerung. MUSIC aktiviert die automatische Steuerung wieder ausdrücklich.
- Szenen speichern den Lichtzustand ohne eine vorübergehende Blackout-Sperre. Deaktivierte Musiksteuerung überschreibt keine manuellen Nebel- oder Strobowerte.
- Serverzeit und Abschluss von Shows bei entladenen Geräten verbessert. Kabelverbindungen werden beim Laden und Entladen von Chunks erneut ermittelt.
- Verhalten beim Verlassen des Bereichs und erneuten Beitreten verbessert, um doppelte Musik und unpassende Showpositionen zu verhindern.
- Automatische Sicherungen der ClubLights-Speicherdaten bei Einführung oder Änderung der Speicherformatkennung ergänzt. Sicherungen liegen im Weltordner unter `clublights-show-backups`; sie ersetzen keine vollständige Welt- oder Musikdateisicherung.

## Lichtpult und Bedienung

- Lichtpult-Interface mit Geräteauswahl, Programmer und Cue-Bearbeitung überarbeitet. Steuerungen verschiedener Gerätetypen können gemeinsam angezeigt werden.
- Cues lassen sich anfügen, ersetzen, duplizieren und umsortieren. Zeitwerte können bearbeitet werden, ohne dabei die gespeicherten Lichtwerte zu überschreiben.
- Bestätigungen für Löschen und Überschreiben ergänzt. Abbrechen erhält noch nicht gesendete Änderungen.
- Anpassung an verfügbare Bildschirmfläche und GUI-Skalierung verbessert. Zusätzlicher Interface-Zoom sowie vertikales und horizontales Scrollen ergänzt.
- Tastaturbedienung für Fokuswechsel und Bedienelemente verbessert.
- Direkten Diagnosezugang am Lichtpult ergänzt. Berichte können lokal im Ordner `clublights-diagnostics` gespeichert werden.

## Automatische Bewegung und Tanzflächen

- Automatische Bewegungen von Moving Heads und Spots überarbeitet: größere Bewegungsbereiche, wechselnde Zufallsbahnen und kontinuierliche Bewegung statt regelmäßiger Pausen zwischen Zielpositionen.
- Bewegungsgeschwindigkeit und Charakter berücksichtigen Tempo und ruhigere Musikphasen.
- Bewegungen von Moving Heads und Lasern auf dem Client geglättet, einschließlich langsamer Bewegungen und unregelmäßiger Server-Updates. Farben, Dimmer und Strobo bleiben unmittelbar steuerbar.
- Glättung verwendet eine fortlaufende lokale Zeitbasis; verspätete Netzwerkpakete setzen sie nicht zurück.
- Bei vorübergehend fehlenden Analysedaten bleibt die letzte Position erhalten, statt auf eine Ersatzposition zu springen.
- Tanzflächen-Menü erkennt die tatsächlich am Pult angeschlossenen und mit dem Tool adressierten Flächen. Muster, Musikmodus und weitere Einstellungen wirken auf deren tatsächliche Universen.
- Erneutes Adressieren derselben Fläche behält deren Einstellungen bei und löst keinen falschen Überlappungsfehler mehr aus. Tatsächliche teilweise Überlappungen werden weiterhin abgewiesen.
- Manuelle Tanzflächen-Einstellungen beenden konkurrierende automatische Steuerung.

## Automatische DMX-Adressierung

- Neues Adressierungswerkzeug mit zwei Modi: **DMX-Geräte** und **Tanzflächen**. Der zwischenzeitliche XLR-Modus wurde entfernt.
- Moduswechsel nur per Ducken + Rechtsklick.
- Normaler Rechtsklick auf ein unterstütztes DMX-Gerät sucht einen freien zusammenhängenden Kanalbereich unter Berücksichtigung der belegten Adressen und des Geräte-Footprints.
- Bei einem vollen Universum kann die Adressierung im nächsten Universum fortgesetzt werden. Manuelle Adressierung bleibt möglich.
- Tanzflächen werden mit Linksklick über zwei gegenüberliegende Ecken auf gleicher Höhe markiert. Chatmeldungen bestätigen Position 1 und Position 2.
- Rechtsklick auf das angeschlossene Lichtpult führt das Patchen aus und meldet Erfolg oder eine konkrete Fehlerursache.

## Effekttaster und Effektpanel

- Kompaktes Panel für Strobo, Nebel und Blackout ergänzt.
- Platzierung und Beschriftung für Boden und Wand korrigiert; das Panel richtet sich beim Platzieren zum Spieler aus.
- Universumsbereich von/bis für Taster und Panel ergänzt. Ein Bedienelement kann dadurch mehrere Universen einer angeschlossenen Anlage steuern, einschließlich großer Tanzflächen.
- Geräte außerhalb des eingestellten Bereichs bleiben unverändert.
- Blackout gibt beim Ausschalten die zuvor gesperrte Ausgabe wieder frei, statt gespeicherte Dimmer- oder Nebelwerte dauerhaft zu löschen.

## Musik, Import und Multiplayer

- Titel auf dem inaktiven Deck werden bereits nach dem Einlegen der Platte für die betreffenden Clients vorgeladen. Dafür sind weder PLAY noch ein geöffnetes Musikpult nötig. Das andere Deck kann weiterlaufen.
- Bereit-/Downloadanzeigen ergänzt und Informationen zu Datei, Fortschritt und Fehlern verbessert.
- Plattenpressen-Interface deutlich vergrößert und an die GUI-Skalierung angepasst. Breitere Musikliste, mehr sichtbare Einträge, vollständige Titel als Tooltip und besser lesbare Importmeldungen.
- Button zum Öffnen des Musikordners an der Presse ergänzt.
- Sammelimporte lassen sich abbrechen. Fehler werden zusätzlich in `clublights/import-errors.log` protokolliert.
- Doppelte Dateien werden anhand ihres Inhalts erkannt, auch bei unterschiedlichen Dateinamen. Erneutes Importieren legt nicht unnötig eine zweite Serverkopie an.
- Importe laufen bei geschlossenem Menü und größerer Entfernung weiter, solange die Client-Verbindung besteht. Eine getrennte Verbindung beendet die laufende Client-Importwarteschlange.
- Hintergrundanalyse von Liedern mit Fortschritt, Abbruch, erneutem Start und Cache verbessert. Statusabfragen übertragen nicht ständig die gesamte Bibliothek.
- Multiplayer-Fehler am Titelende behoben: Musik springt vor dem Fade nicht mehr ungefähr acht Sekunden zurück.
- Musik, Automix-Fade und automatische Lichtshow verwenden auf dem Dedicated Server eine gemeinsame fortlaufende Zeitbasis. Verzögerte Server-Ticks verschieben die Wiedergabe nicht mehr auseinander.
- Singleplayer-Pausenverhalten bleibt erhalten.
- Verhalten bei Stromausfall überarbeitet: Musik kann mit gespeicherter Position pausieren und bei Stromrückkehr fortgesetzt werden. Bei deaktivierter Fortsetzung bleibt sie gestoppt. Eine während der Pause ausgeworfene Platte startet nicht später erneut.

## Kabel, Traversen und Modelle

- Ein einheitliches **DMX-Kabel** ersetzt die zuvor angebotenen Datenkabelvarianten. Das Audiokabel heißt jetzt **XLR-Kabel**.
- Neue Inventaricons für DMX-, XLR- und Stromkabel sowie deutsche und englische Tooltips zum jeweiligen Verwendungszweck.
- Alte Kabel-IDs bleiben für vorhandene Welten erhalten, werden aber nicht mehr als eigene Varianten angeboten. Alte getrennte Leitungen können nach Abbau und Neuaufbau eine erneute Zuordnung benötigen.
- Kabel können direkt aneinander platziert werden: Ein bereits vorhandener Kabeltyp wird am angeklickten Ende erweitert; ein fehlender Typ wird zuerst dem gemeinsamen Rahmen hinzugefügt.
- Dieses Verhalten gilt auch für Kabel in Traversen. Andere feste Blöcke werden nicht überschrieben.
- Das ursprüngliche Kabeldesign mit Rahmen außerhalb von Traversen wiederhergestellt.
- Traversen erkennen ihre Verbindungen selbstständig. Ecken, T-Verbindungen und Kreuzungen sowie deren Darstellung mehrfach überarbeitet.
- Traversen wieder mit schlanken Holmen und diagonalen Verstrebungen gestaltet; Anschlüsse werden an gemeinsamen Knoten verbunden.
- Displays des Musikpults nach hinten geneigt.
- Schallplatten im Regal liegen sichtbar in ihren Fächern und schauen etwas heraus. Labels zeigen den Musiktitel ohne den Ordnerpfad.

## Energie, Diagnose und Survival

- Batterie-Interface um einen Füllstandsbalken ergänzt.
- Batterieseiten können für Ein-/Ausgabe beziehungsweise als deaktiviert konfiguriert werden.
- Geschätzte Restlaufzeit und ein Redstone-Signal bei niedrigem Batteriestand ergänzt.
- Stromausfälle werden auch erkannt, wenn das Lichtpult noch Energie im internen Puffer hat. Fortsetzungsregeln für automatische Shows und Musik werden berücksichtigt.
- Verbindung und Energieübertragung mit externen FE-Generatoren verbessert. **Iron Generators wurde im Spiel erfolgreich getestet.**
- Externe Energie kann über die Stromkabel zu Batterien und Verbrauchern übertragen werden. Kabelsperren, Ein-/Ausgaberichtungen und tatsächlicher Speicherplatz werden berücksichtigt; die Kabel erzeugen keinen versteckten Energiepuffer.
- Netzwerkdiagnose für fehlenden Strom, getrennte Verbindungen und überlappende DMX-Adressen ergänzt.
- DMX-Belegungsübersicht mit freien, belegten und überlappenden Kanalbereichen sowie mehreren Universumsseiten ergänzt.
- Verbrauchs- und Erzeugungsübersichten ergänzt. Die genaue Erzeugungsrate fremder Generatoren wird nicht grundsätzlich ermittelt.
- Survival-Rezepte ergänzt und überprüft, einschließlich Hilfebuch. Normale Tanzfläche und DMX-/XLR-/Stromkabel liefern jeweils vier Stück; Nebeltanzfläche und übrige Geräte jeweils ein Stück.
- Drei unnötige DMX-zu-DMX-Rezepte entfernt.
- Plattenrohlinge bleiben ein Produkt der Rohlingmaschine und sind kein normales Crafting-Rezept.

## Darstellung, Sprache und Leistung

- Lokale Qualitätsoptionen für Strahlen und Nebel, Renderdistanz und Effektbudgets ergänzt.
- Rendering unsichtbarer beziehungsweise weit entfernter Effekte reduziert; Geräte- und Universumslisten zwischengespeichert und Tanzflächenaktualisierungen gebündelt.
- Lokale Strobobegrenzung beziehungsweise Abschaltung ergänzt, ohne die Show anderer Spieler zu verändern.
- Shader-Ausweichdarstellung überarbeitet, damit Moving-Head-Strahlen mit den getesteten Shadern sichtbar bleiben.
- Deutsche und englische Übersetzungen für öffentliche Bedienoberflächen, Hinweise, Tooltips und Hilfebuch erweitert. Technische Backend- oder Decoder-Logs können weiterhin englisch sein.
- Hilfebuch mit Erklärungen zu Aufbau und Bedienung ergänzt.
- Absturz durch gerundete Bewegungswerte außerhalb zulässiger Attributgrenzen behoben.

## Beta-Status und Prüfung

- Versionsbezeichnung und interne Mod-Metadaten auf **0.26.0-beta.1** umgestellt. Gegenüber 0.25.4 enthält der reine Beta-Versionswechsel keine zusätzlichen Funktionsänderungen.
- Offline-Builds und Regressionstests wurden während der Entwicklung durchgeführt; beim letzten Funktionsstand bestanden alle 17 erforderlichen Server-GameTests.
- Die zuletzt offenen Tests zur gemeinsamen Pultbedienung und zum Vorladen des inaktiven Decks wurden ebenfalls erfolgreich bestätigt.
- Shaderstand: **AstraLex und Complementary Reimagined erfolgreich im Spiel getestet; BSL derzeit nicht kompatibel.** Weitere Shader-Kompatibilität und umfassende Performance-Optimierungen bleiben geplant.

ENGLISCH

ClubLights – Changelog since 0.21.1

**Current version: 0.26.0-beta.1 · Minecraft Java 26.2 · NeoForge**

This changelog covers changes **after 0.21.1 through 0.26.0-beta.1**. Features revised across several intermediate releases are described in their final form.

## Lighting control and saved shows

- Fixed manual lighting settings, LED bar control, dance floor control, and manual sequences. These actions now use validated server messages and no longer require operator permissions.
- APPLY and STORE submit related changes together. Invalid or outdated edits are rejected entirely instead of being partially applied.
- STORE can save pending settings directly; using APPLY first is not required.
- Added conflict protection for collaborative editing: another player's changes cannot be silently overwritten by an outdated editing state. Cue lists and selected shows are displayed individually for each player.
- Unified control priorities: Blackout blocks output; effect buttons override their respective effects; manual input and manual shows take over from music control. MUSIC explicitly re-enables automatic control.
- Scenes store lighting values without a temporary Blackout override. Disabled music control no longer overwrites manual fog or strobe values.
- Improved server timing and show completion when devices are unloaded. Cable connections are recalculated when chunks load or unload.
- Improved behavior when leaving the area and rejoining to prevent duplicate music playback and incorrect show positions.
- Added automatic backups of ClubLights save data when introducing or changing the storage format identifier. Backups are stored under `clublights-show-backups` in the world folder; they do not replace complete world or music file backups.

## Lighting console and interface

- Reworked the lighting console interface with fixture selection, a programmer, and cue editing. Controls for different fixture types can be displayed together.
- Cues can be appended, replaced, duplicated, and reordered. Timing values can be edited without overwriting stored lighting values.
- Added confirmation prompts for deleting and overwriting. Cancelling preserves unsent changes.
- Improved adaptation to available screen space and GUI scale. Added interface zoom and vertical and horizontal scrolling.
- Improved keyboard navigation between controls.
- Added direct access to diagnostics from the lighting console. Reports can be saved locally in `clublights-diagnostics`.

## Automatic movement and dance floors

- Reworked automatic movement for moving heads and spot fixtures: wider movement ranges, varied random paths, and continuous motion instead of repeated pauses between target positions.
- Movement speed and behavior respond to tempo and quieter sections of the music.
- Smoothed moving head and laser movement on the client, including slow motion and irregular server updates. Colors, dimmers, and strobe remain immediately responsive.
- Smoothing uses a continuous local time base that is not reset by delayed network packets.
- When analysis data is temporarily unavailable, fixtures retain their last position instead of jumping to a fallback position.
- The dance floor menu recognizes floors actually connected to the console and addressed with the tool. Patterns, music mode, and other settings affect their actual universes.
- Readdressing the same floor preserves its settings and no longer produces a false overlap error. Actual partial overlaps are still rejected.
- Manual dance floor settings stop competing automatic control.

## Automatic DMX addressing

- Added an addressing tool with two modes: **DMX fixtures** and **dance floors**. The intermediate XLR mode has been removed.
- Modes change only when sneaking and right-clicking.
- A regular right-click on a supported DMX fixture finds an available contiguous channel range, accounting for occupied addresses and the fixture's channel footprint.
- Addressing can continue in the next universe when a universe is full. Manual addressing remains available.
- Dance floors are selected by left-clicking two opposite corners at the same height. Chat messages confirm Position 1 and Position 2.
- Right-clicking the connected lighting console patches the selection and reports success or a specific failure reason.

## Effect buttons and effect panel

- Added a compact panel for strobe, fog, and Blackout.
- Fixed placement and label orientation for floor and wall mounting; the panel faces the player when placed.
- Added a start/end universe range for buttons and the panel. A single control can affect multiple universes in a connected installation, including large dance floors.
- Fixtures outside the selected range remain unaffected.
- Disabling Blackout restores the blocked output instead of permanently clearing saved dimmer or fog values.

## Music, importing, and multiplayer

- Tracks on the inactive deck are preloaded for relevant clients as soon as a record is inserted. Neither PLAY nor an open music console is required. The other deck can continue playing.
- Added ready/download indicators and improved file, progress, and error information.
- Significantly enlarged the record press interface and improved GUI scaling. Added a wider music list, more visible entries, full titles in tooltips, and more readable import messages.
- Added a button on the press to open the music folder.
- Bulk imports can be cancelled. Errors are also logged in `clublights/import-errors.log`.
- Duplicate files are recognized by their content, even when filenames differ. Importing the same file again does not unnecessarily create another server copy.
- Imports continue with the menu closed and at greater distances while the client remains connected. Disconnecting ends the active client import queue.
- Improved background track analysis with progress, cancellation, restart, and caching. Status requests no longer repeatedly transfer the entire library.
- Fixed a multiplayer issue at the end of a track: playback no longer jumps back approximately eight seconds before the fade.
- Music playback, Automix fades, and automatic lighting shows share a continuous time base on dedicated servers. Delayed server ticks no longer cause their timelines to drift apart.
- Preserved singleplayer pause behavior.
- Reworked power loss behavior: music can pause at its saved position and resume when power returns. If resuming is disabled, playback remains stopped. A record ejected while paused does not restart later.

## Cables, trusses, and models

- A single **DMX Cable** replaces the previously offered data cable variants. The audio cable is now named **XLR Cable**.
- Added new inventory icons for DMX, XLR, and power cables, with German and English tooltips explaining their purpose.
- Legacy cable IDs are retained for existing worlds but are no longer offered as separate variants. Legacy separate lines may require reassignment after being dismantled and rebuilt.
- Cables can be placed directly against other cables: an existing cable type extends from the clicked end; a missing type is added to the shared frame first.
- This behavior also applies to cables inside trusses. Other solid blocks are not overwritten.
- Restored the original framed cable design outside trusses.
- Trusses automatically recognize their connections. Corners, T-junctions, intersections, and their appearance have been revised.
- Redesigned trusses with slim rails and diagonal braces, connecting branches at shared junctions.
- Tilted the music console displays backward.
- Records visibly lie in their shelf compartments and protrude slightly. Labels display the track title without its folder path.

## Energy, diagnostics, and Survival

- Added a charge bar to the battery interface.
- Battery sides can be configured for input/output or disabled.
- Added estimated remaining runtime and a Redstone signal at low charge.
- Power outages are detected even when the lighting console still has energy in its internal buffer. Resume settings for automatic shows and music are respected.
- Improved connections and energy transfer with external FE generators. **Iron Generators has been successfully tested in-game.**
- External energy can flow through power cables to batteries and consumers. Cable disconnections, input/output directions, and available storage capacity are respected; cables do not create a hidden energy buffer.
- Added network diagnostics for missing power, disconnected connections, and overlapping DMX addresses.
- Added a DMX occupancy overview showing free, occupied, and overlapping channel ranges across multiple universe pages.
- Added consumption and generation overviews. Exact generation rates are not available for every external generator.
- Added and checked Survival recipes, including the handbook. Regular dance floor blocks and DMX/XLR/power cables yield four items each; fog dance floor blocks and other devices yield one each.
- Removed three unnecessary DMX-to-DMX recipes.
- Blank records remain a product of the blank record machine and do not have a regular crafting recipe.

## Rendering, localization, and performance

- Added local quality settings for beams and fog, render distance, and effect budgets.
- Reduced rendering work for invisible or distant effects, cached fixture and universe lists, and batched dance floor updates.
- Added local strobe limiting or disabling without changing other players' shows.
- Reworked shader fallback rendering to keep moving head beams visible with the tested shaders.
- Expanded German and English translations for public interfaces, messages, tooltips, and the handbook. Technical backend or decoder logs may still be in English.
- Added a handbook explaining setup and operation.
- Fixed a crash caused by rounded movement values exceeding allowed attribute limits.

## Beta status and validation

- Updated the version label and internal mod metadata to **0.26.0-beta.1**. The Beta version change itself adds no functional changes compared with 0.25.4.
- Offline builds and regression tests were performed during development; all 17 required server GameTests passed for the latest functional build.
- The remaining tests for collaborative console editing and inactive deck preloading have also been confirmed successful.
- Shader status: **AstraLex and Complementary Reimagined have been successfully tested in-game; BSL is currently incompatible.** Further shader compatibility and comprehensive performance improvements remain planned.