← Dashboard

DMX Controller Beta

Plugin offline
Master 100%

Fixtures auswählen

Vorschau

Steuerung

Neues Fixture

Name
Gruppe
Universe
DMX-Adresse
Position X (optional)
Position Y
Position Z
Kanäle dieses Fixtures
NameGruppeUniverseAdresseKanäle

Aktuellen Look als Szene speichern

Sek. Überblendzeit

Verbindung zum Minecraft-Plugin

Das Plugin fragt diese Adresse regelmässig ab und holt sich den aktuellen Zustand. Es braucht keinen offenen Port am Server – nur ausgehendes HTTPS.

Endpunkt
…
Token (Header X-DMX-Token)
••••••••••••••••

So spricht das Plugin mit dem Controller

1) Zustand abholen (GET)

GET  app.php?api=dmx-plugin&since=<letzte rev>&wait=5&v=<plugin-version>
Header: X-DMX-Token: <token>

→ nichts neu:  {"changed": false, "rev": 42}
→ Änderung:    {
  "changed": true,
  "rev": 43,            // bei jeder Änderung hochgezählt
  "seq": 17,            // zählt jede Eingabe/Szene (auch ohne Wertänderung)
  "fadeMs": 1000,       // so lange soll zum Zielwert übergeblendet werden
  "blackout": false,
  "master": 100,
  "fixtures": [{
    "id": "a1b2c3", "name": "Moving Head 1", "group": "Bühne",
    "universe": 1, "address": 1,
    "channels": ["pan","tilt","dimmer","r","g","b"],
    "values":   {"pan":128,"tilt":90,"dimmer":255,"r":0,"g":120,"b":255},
    "dmx":      [128,90,255,0,120,255],     // fertig, Master & Blackout eingerechnet
    "position": {"x":10,"y":64,"z":-3}      // oder null
  }]
}

Mit wait=5 hält der Server die Anfrage bis zu 5 Sekunden offen und antwortet sofort bei einer Änderung (Long-Polling, max. 8 s). Ohne wait antwortet er direkt. Empfohlen: wait=5, danach sofort neu anfragen – das ergibt eine Reaktionszeit von unter einer Sekunde.

2) Status zurückmelden (POST, optional)

POST app.php?api=dmx-plugin
Header: X-DMX-Token: <token>
Body:   {"version":"1.0.3","online":4,"info":"4 Fixtures geladen"}

Werte & Umrechnung

alle Werte 0–255
pan   0–255 → 0–540°      tilt 0–255 → 0–270°   (Mitte = 128)
dimmer 0 = aus            strobe 0 = aus, höher = schneller
Master & Blackout wirken bereits auf "dmx"/"values.dimmer"
fadeMs: lineare Überblendung vom aktuellen zum Zielwert

Kanal-Reihenfolge (DMX-Offset)

pan, tilt, dimmer, r, g, b, strobe, zoom, focus, gobo, prism
→ nur die beim Fixture aktivierten Kanäle zählen; "dmx" ist bereits in dieser Reihenfolge

Änderungsprotokoll

Lade…