Aktionen-Referenz

Eranio Veröffentlicht am: 14. Oktober 2026

StreamBridge (Minecraft): Aktionen-Referenz

Jede Aktion, die Zuschauer über das Panel auslösen können, erhält vom Panel eine eindeutige ID (zur Vermeidung von Doppelausführung, bis zu 5000 IDs werden gespeichert) sowie je nach Aktion weitere Parameter.

Gemeinsame Parameter

Die meisten Aktionen verstehen folgende Parameter, sofern sie zur Aktion passen:

Parameter	Standard	Grenzen	Bedeutung
`seconds`	10	1 bis 600	Dauer des Effekts
`strength`	1	1 bis 5	Intensität der Aktion
`count`	1	1 bis 10	Anzahl der Objekte/Wiederholungen
`label`	leer (nutzt dann den Aktionsnamen)	-	Angezeigter Text
`viewer`	„Chat"	-	Name des auslösenden Zuschauers, erscheint im Spiel
`show_title`	`true`	-	Ob ein Titel-Bildschirm angezeigt wird

Aktionsliste

Aktion	Parameter	Effekt im Spiel	Einordnung
`commands`	`commands` (Liste von Server-Befehlen)	Führt eine Liste von Server-Befehlen als Konsole aus, nur erlaubte Muster (siehe unten)	Admin-Werkzeug
`drop_hand`	-	Wirft den Gegenstand aus der Haupthand in Blickrichtung weg	Chaos/Spaß
`drop_hotbar`	-	Wirft alle Gegenstände aus der Hotbar (Slots 0-8) zufällig weg	Chaos/Sabotage
`throw_item`	-	Wirft den Gegenstand aus der Hand mit einer Aufwärtskurve weg	Chaos/Spaß
`shuffle_inventory`	-	Mischt das gesamte Inventar des Spielers durch	Chaos/Sabotage
`hotbar_chaos`	`seconds`	Wechselt während der Dauer zufällig den aktiven Hotbar-Slot	Chaos/Sabotage
`pin`	`seconds`	Fixiert den Spieler an seiner Position	Chaos/Spaß
`knockback`	`strength`	Schlägt den Spieler mit Kraft `0,4 + (strength × 0,4)` zurück	Chaos/Spaß
`invert_controls`	`seconds`	Invertiert die Steuerung des Spielers	Chaos/Sabotage
`strip_armor`	-	Entfernt die gesamte Rüstung, die Teile fliegen um den Spieler	Sabotage
`damage_tool`	`strength`	Beschädigt das Werkzeug in der Hand (bis zu 10 % der Maximal-Haltbarkeit je Stufe)	Sabotage
`hot_potato`	`seconds`, `label`	Gibt dem Spieler eine „heiße Kartoffel". Läuft die Zeit ab, während er sie noch hält, explodiert er (ohne Baublöcke zu zerstören)	Spiel/Event
`jail`	`seconds`	Teleportiert den Spieler in einen temporären Glaskäfig	Spaß/Event
`cobweb`	`seconds`	Platziert Spinnweben um die Füße des Spielers	Chaos/Spaß
`ice_floor`	`seconds`	Ersetzt den Boden unter dem Spieler durch Packeis	Chaos/Spaß
`pumpkin_head`	`seconds`	Setzt dem Spieler einen geschnitzten Kürbis auf (mit Fluch der Bindung), wird nach Ablauf wieder entfernt	Spaß/Event
`sky_launch`	-	Katapultiert den Spieler 40 Blöcke in die Höhe beziehungsweise gibt ihm einen Aufwärtsschub mit Langsamem Fallen	Spaß/Event
`anvil_rain`	`count`	Bis zu 5 Ambosse fallen über dem Spieler vom Himmel (ohne echten Schaden, siehe Sicherheitshinweis unten)	Chaos/Sabotage
`harmless_tnt`	`count`	Platziert TNT ohne Explosionsschaden in der Nähe des Spielers	Spaß/Effekt
`half_health`	-	Setzt die Gesundheit des Spielers auf die Hälfte des aktuellen Werts (mindestens 2,0)	Sabotage
`swap_places`	`partner` (Spielername)	Tauscht die Position des Spielers mit einem anderen Spieler	Nützlich/Event
`firework_show`	`count`	Bis zu 10 Feuerwerke in der Nähe des Spielers	Effekt
`set_spawn`	-	Setzt den Respawn-Punkt des Spielers an seine aktuelle Position	Nützlich
`random_teleport`	`seconds`	Startet einen zufälligen Höhenfall-Teleport (siehe unten)	Event
`ground_teleport`	-	Beendet einen laufenden Höhenfall sicher auf dem Boden	Event
`fake_death`	-	Simuliert den Tod des Spielers, ohne dass er wirklich stirbt oder etwas verliert	Spaß/Prank

Sicherheits-Mechanismen

CommandGuard: Bei der Aktion commands werden nur Befehle ausgeführt, die einem vordefinierten, sicheren Muster entsprechen. Explizit blockiert sind unter anderem Command-Blöcke, Spawner, Barrieren, Struktur-Blöcke und Spawn-Eier.
Amboss-Regen: Landet ein Amboss, fängt das Plugin das Landungs-Ereignis ab, entfernt den Amboss wieder und erzeugt nur Partikel und Sound, echter Schaden entsteht nicht.
Doppelausführung: Jede Aktion hat eine eindeutige ID, bis zu 5000 davon werden gespeichert, damit dieselbe Aktion nicht zweimal ausgeführt wird.

Bekannte Fehlerfälle

Situation	Was passiert
Leere Hand bei `drop_hand`, `throw_item`, `damage_tool`	Aktion schlägt fehl (`empty_hand`)
Kein Platz bei `cobweb`, `ice_floor`	Aktion schlägt fehl (`no_space`)
Zielspieler bei `swap_places` offline oder identisch	Aktion schlägt fehl
Befehl bei `commands` nicht erlaubt	Wird als `blocked_command` abgelehnt, im Server-Log vermerkt
Plugin pausiert	Alle Anfragen werden mit `paused` abgelehnt
Spieler während der Übertragung offline	Aktion wird mit `player_offline` abgebrochen

Häufige Fragen

Kann ich einzelne Aktionen für meinen Server sperren? Die Aktionsliste selbst wird vom Panel vorgegeben, dort legst du auch fest, welche Aktionen zu welchem Geschenk/welcher Kanalpunkte-Belohnung gehören.

Was passiert, wenn zwei Aktionen gleichzeitig eintreffen? Jede Aktion wird einzeln anhand ihrer ID verarbeitet, es gibt keine feste Reihenfolge-Garantie zwischen unterschiedlichen Aktionen.

Warum wurde eine Aktion abgelehnt? Prüfe mit /streambridge status, ob das Plugin pausiert ist oder ein Verbindungsfehler vorliegt. Einzelne abgelehnte Aktionen (z. B. empty_hand, no_space) stehen im Server-Log.