Aktionen-Referenz
Eranio Veröffentlicht am: 14. Oktober 2026
StreamBridge (Hytale): Aktionen-Referenz
Jede Aktion läuft asynchron mit einem festen Zeitlimit von 5 Sekunden, damit der Server dadurch nicht blockiert wird. Benötigt eine Ausführung länger, wird die Aktion mit einem Fehler abgebrochen.
Gemeinsame Parameter
| 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/Effekte |
label |
leer (nutzt dann den Aktionsnamen) | - | Angezeigter Text im Chat/Titel |
viewer |
- | - | Name des auslösenden Zuschauers, erscheint im Chat |
group |
- | - | Ist der Wert sabotage, werden die Titel-Anzeigen rot statt grün dargestellt |
Jede Aktion benötigt einen player (Spielername) als Ziel.
Aktionsliste
Status-Effekte
| Aktion | Parameter | Effekt | Einordnung |
|---|---|---|---|
freeze |
seconds |
Friert den Spieler ein | Sabotage |
root |
seconds |
Verankert den Spieler am Boden | Sabotage |
slow |
seconds |
Verlangsamt den Spieler | Sabotage |
stun |
seconds |
Betäubt den Spieler | Sabotage |
poison |
seconds |
Vergiftet den Spieler | Sabotage |
burn |
seconds |
Verbrennungseffekt | Sabotage |
stamina_drain |
seconds |
Entzieht Ausdauer | Sabotage |
mana_drain |
seconds |
Entzieht Mana | Sabotage |
vulnerable |
seconds |
Macht den Spieler verwundbar (nimmt mehr Schaden) | Sabotage |
electric_shock |
seconds |
Stromschlag, betäubt kurz | Sabotage |
regeneration |
seconds |
Heilt den Spieler über Zeit | Hilfreich |
stoneskin |
seconds |
Verleiht Schutz (Stoneskin) | Hilfreich |
immune |
seconds |
Macht vorübergehend immun gegen Effekte | Hilfreich |
fall_immunity |
seconds |
Kein Fallschaden | Hilfreich |
fire_immunity |
seconds |
Kein Feuerschaden | Hilfreich |
Verwandlung & Größe
| Aktion | Parameter | Effekt | Einordnung |
|---|---|---|---|
morph |
morph, seconds |
Verwandelt den Spieler in ein Tier (Werte siehe unten) | Unterhaltung |
scale_giant |
seconds |
Macht den Spieler riesig (Skalierung 2,0), wird nach Ablauf automatisch zurückgesetzt | Unterhaltung |
scale_tiny |
seconds |
Macht den Spieler winzig (Skalierung 0,5), wird nach Ablauf automatisch zurückgesetzt | Unterhaltung |
launch |
strength |
Katapultiert den Spieler vertikal nach oben (8 + strength × 4) | Sabotage |
knockback |
strength |
Schlägt den Spieler in eine zufällige Richtung (6 + strength × 4) | Sabotage |
Teleport & Dimensionen
| Aktion | Parameter | Effekt | Einordnung |
|---|---|---|---|
dimension_teleport |
strength |
Teleportiert an einen zufälligen Ort in derselben Welt bzw. Dimension. Entfernung je nach strength: 1 = bis 25, 2 = bis 50, 3 = bis 100, 4 = bis 150, 5 = bis 250 Blöcke. Landet sicher auf dem Boden (Hytales Höhenkarte), nie in Wasser oder Lava, nur in bereits geladenen Bereichen |
Sabotage |
world_spawn |
- | Teleportiert zum Startpunkt der aktuellen Welt bzw. Dimension (berücksichtigt einen eigenen Startpunkt des Spielers) | Hilfreich |
teleport_to_player |
- | Teleportiert zu einem zufälligen anderen Spieler in derselben Welt | Sabotage |
swap_places |
- | Tauscht die Position mit einem zufälligen anderen Spieler in derselben Welt | Sabotage |
random_warp |
- | Teleportiert zu einem zufälligen Warp auf dem Server | Unterhaltung |
teleport_back |
- | Teleportiert zum letzten gespeicherten Ort zurück | Hilfreich |
random_instance |
instance (optional) |
Teleportiert in eine Instanz (Werte siehe unten, random = zufällig) |
Unterhaltung |
leave_instance |
- | Schickt den Spieler aus der aktuellen Instanz heraus | Hilfreich |
dimension_teleport, world_spawn, teleport_to_player, swap_places und random_warp speichern den Ort davor im Teleport-Verlauf, teleport_back bringt den Spieler also wieder zurück. Aus Instanzen führt leave_instance zurück.
Teleport-Zustand (ab Version 1.8.0): Vor jedem Teleport löst das Plugin ein Reittier oder Fahrzeug und beendet den Schlaf im Bett. Das Ergebnis meldet dann woken_bed (aus dem Bett geholt) oder dismounted:<Typ> (minecart, seat, other), das Panel zeigt es im Protokoll als lesbaren Text. Bleibt der Teleport hängen und wird nicht ausgeführt, meldet die Aktion teleport_failed und das Panel erstattet die Belohnung wie bei anderen Fehlern.
Spawn-Position (ab Version 1.8.0): spawn_mob und animal_rain setzen die Kreaturen etwa einen Block über dem Spieler ab, mit höchstens 1,5 Blöcken Versatz und nur auf begehbaren Stellen mit freiem Platz darüber. Findet sich keine freie Stelle, erscheinen sie direkt am Spieler. Golems erscheinen ohne Versatz.
Portal-Zeit & Leere-Invasion
Diese Aktionen wirken nur in einer Portal-Welt (Instanz mit Zeitlimit bzw. Leere-Invasion).
| Aktion | Parameter | Effekt | Einordnung |
|---|---|---|---|
portal_time_add |
seconds |
Erhöht die verbleibende Zeit im Portal-Level | Hilfreich |
portal_time_remove |
seconds |
Verringert die Portal-Zeit (mindestens 30 Sekunden bleiben erhalten). Ist dadurch der Startzeitpunkt der Leere-Invasion erreicht, beginnt sie sofort | Sabotage |
portal_timer_pause |
seconds |
Hält die Portal-Uhr an, nach Ablauf läuft sie automatisch weiter | Hilfreich |
void_hold |
seconds |
Hält die Leere-Invasion auf (laufende wird gestoppt), nach Ablauf darf sie wieder starten | Hilfreich |
Kamera, Anzeige & Geräusche
| Aktion | Parameter | Effekt | Einordnung |
|---|---|---|---|
camera_topdown |
seconds |
Kamera von oben (Vogelperspektive), danach automatisch zurück | Sabotage |
camera_sidescroller |
seconds |
Seitenansicht, der Spieler kann sich nur noch nach links/rechts und oben/unten bewegen, danach automatisch zurück | Sabotage |
hide_debug |
seconds |
Sperrt die Debug-Anzeige mit den Koordinaten, danach wieder frei | Sabotage |
fake_sound |
sound |
Spielt nur für diesen Spieler ein Schreck-Geräusch ab (Werte siehe unten), sonst passiert nichts | Sabotage |
Spawnen & Wetter
| Aktion | Parameter | Effekt | Einordnung |
|---|---|---|---|
spawn_mob |
mob, count |
Spawnt bis zu 5 Gegner direkt am Spieler (Werte siehe unten) | Sabotage |
animal_rain |
animal, count |
Lässt eine Anzahl (count) von Tieren vom Himmel regnen |
Unterhaltung |
night |
- | Setzt die Spielzeit auf Mitternacht | Unterhaltung |
day_clear |
- | Setzt die Spielzeit auf Mittag und entfernt erzwungenes Wetter | Hilfreich |
daytime |
mode (flip, day_to_night, night_to_day, sunrise, morning, noon, sunset, night, midnight), optional clear_weather (true) |
Stellt die Tageszeit der Welt des Spielers über die Weltzeit. flip liest die Zeit und stellt das Gegenstück ein (Tag wird Nacht 21:00, Nacht wird Morgen 7:30). day_to_night und night_to_day wirken nur in ihrer Richtung und melden sonst already_night beziehungsweise already_day. Feste Zeiten: Sonnenaufgang 5:00, Morgen 7:30, Mittag 12:00, Sonnenuntergang 17:30, Nacht 21:00, Mitternacht 0:00. Nacht ist von 19:12 bis 4:48 Uhr Spielzeit. Mit clear_weather wird zusätzlich erzwungenes Wetter entfernt, sonst bleibt es unverändert. In Welten mit angehaltener Zeit Fehler no_daylight_cycle. Ergebnis ok mit from_day, from_night oder set:<Uhrzeit als HHMM> (ab Version 1.8.0) |
Hilfreich |
weather |
weather |
Erzwingt ein bestimmtes Wetter (Werte siehe unten), bis day_clear es wieder entfernt |
Unterhaltung |
Inventar & Gesundheit
| Aktion | Parameter | Effekt | Einordnung |
|---|---|---|---|
drop_hand |
- | Wirft den Gegenstand aus dem aktiven Hotbar-Slot auf den Boden | Sabotage |
shuffle_hotbar |
- | Mischt alle Gegenstände in der Hotbar zufällig durch | Sabotage |
half_health |
- | Setzt die Gesundheit auf maximal 50 % des aktuellen Werts | Sabotage |
heal |
- | Heilt den Spieler sofort vollständig | Hilfreich |
stamina_refill |
- | Füllt die Ausdauer sofort auf | Hilfreich |
antidote |
- | Entfernt alle aktiven Status-Effekte | Hilfreich |
give_item |
item, count |
Gibt dem Spieler ein Item (Standard 1, maximal 64), Überschuss wird gedroppt | Hilfreich |
Auswahlwerte
| Parameter | Mögliche Werte |
|---|---|
mob |
zombie, skeleton, skeleton_archer, spider, ghoul, goblin, trork, wolf, rat, bear, golem_firesteel, skeleton_incandescent_mage, skeleton_incandescent_fighter, goblin_thief, goblin_lobber, void_spawn, void_crawler, void_eye, void_larva, void_spectre, shadow_knight, wraith, werewolf, hound_bleached, zombie_aberrant, zombie_burnt, zombie_frost, yeti, emberwulf, fen_stalker, sabertooth, hyena, golem_crystal_thunder, spirit_ember |
animal |
chicken, pig, sheep, bunny, frog, duck |
morph |
frog, dog, pigeon, mouse, rat, mosshorn |
weather |
blood_moon, terror, fog, poison, thunder_storm, sand_storm, snow_storm, ash_storm, void_storm, spooky, northern_lights, fireflies |
sound |
dragon_roar, bear_roar, scream, thunder, explosion, goblin_laugh, arena_horn, void_crawler |
instance |
random, goblin_breach, hedera, henges, jungles, oasis, taiga, deepworks, forgotten_temple, forgotten_temple_goblins, region_plains, region_desert, region_taiga, region_volcanic |
item |
bread, apple_pie, health_potion, health_potion_greater, regen_potion, stamina_potion, antidote_potion, iron_bar, gold_bar, diamond, emerald, iron_sword, steel_sword, iron_shield, iron_pickaxe, iron_helmet, goblin_teleporter, goblin_generator, goblin_console |
Unbekannte Werte führen zu unknown_action.
Zuschauer-Steuerung
Diese Aktionen setzt das Panel ein, wenn der Chat die Figur steuert. Sie kommen immer mit quiet: true in den Parametern und show_title: false: Es gibt weder Chat-Meldung noch Titel.
| Aktion | Parameter | Effekt |
|---|---|---|
steer |
direction (forward, back, left, right), strength |
Die Figur geht etwa eine Sekunde lang gleichmäßig in die Richtung (rund 3 Blöcke), bezogen auf ihre Blickrichtung. Eine Stufe von einem Block steigt sie von selbst hoch. Vor schädlichen Flüssigkeiten (zum Beispiel Lava), schädlichen Blöcken und Abgründen tiefer als 4 Blöcke bleibt sie an der Kante stehen |
jump |
strength |
Sprung |
turn |
degrees (-180 bis 180) |
Dreht die Blickrichtung |
look |
degrees (-90 bis 90) |
Schaut nach oben oder unten |
hotbar |
slot (1 bis 9) |
Wählt einen Hotbar-Platz, auch in der Anzeige des Spielers |
mine |
- | Baut den Block im Blick ab (bis 5 Blöcke weit). Das beste passende Werkzeug aus der Hotbar wird automatisch gewählt, Schläge im Abstand von 0,45 Sekunden mit der Abbauberechnung des Spiels, es dauert also so lange wie bei einem Spieler mit diesem Werkzeug |
place |
- | Setzt einen Block aus der Hotbar an die angezielte Fläche. Ohne Block in der Hand wird der erste Block der Hotbar genommen. Schaut die Figur ins Leere, wird der Block vor ihr auf Fußhöhe gesetzt (Brücke bauen) |
revive |
- | Belebt den Spieler nach dem Tod wieder, ohne dass er klicken muss |
Meldet das Panel im Feld viewer_control einen Spieler mit Umkreis, entfernt das Plugin jede Sekunde alle Kreaturen in diesem Umkreis, die Hytale dem Spieler gegenüber als feindlich führt. Freundliche und neutrale Tiere bleiben.
Sabotage-Kennzeichnung
Ist group auf sabotage gesetzt, wird der Titel im Spiel in Rot (#FF5555) und im großen Stil angezeigt. Normale Aktionen erscheinen in Grün (#55FF55) im Standard-Stil.
Bekannte Fehlerfälle
| Situation | Was passiert |
|---|---|
| Spieler offline oder Referenz ungültig | Aktion schlägt mit player_offline fehl |
| Steuer-Aktion, während der Spieler tot ist | player_dead |
revive, obwohl der Spieler lebt |
not_dead |
mine, während schon abgebaut wird |
busy |
mine ohne Block im Blick |
nothing_to_do |
mine an einem Block, der sich nicht abbauen lässt |
too_hard |
place ohne Block in der Hotbar |
no_block |
place ohne Fläche im Blick |
no_space |
place an eine belegte Stelle oder in den Spieler |
occupied |
Leere Hand bei drop_hand |
Aktion schlägt mit empty_hand fehl |
Kein Platz bei spawn_mob, kein sicherer Landeplatz bei dimension_teleport |
Aktion schlägt mit no_space fehl |
| Portal-Aktionen außerhalb einer Portal-Welt (bzw. Uhr schon angehalten, keine Leere-Invasion) | Aktion schlägt mit not_in_portal fehl |
teleport_to_player/swap_places ohne weiteren Spieler in derselben Welt |
Aktion schlägt mit no_other_player fehl |
random_instance, Spieler bereits in einer Instanz |
Aktion schlägt mit already_in_instance fehl |
| Ausführung dauert länger als 5 Sekunden | Aktion wird mit plugin_error abgebrochen |
| Spieler verliert Verbindung, während eine zeitlich begrenzte Aktion läuft (Größe, Kamera, Debug-Sperre) | Die automatische Rückstellung kann entfallen. Notfalls die Aktion erneut mit kurzer Dauer auslösen oder neu einloggen |
Häufige Fragen
Warum schlägt random_instance fehl?
Diese Aktion funktioniert nicht, wenn der Spieler sich bereits in einer Instanz befindet.
Was bedeutet die rote Titel-Darstellung?
Das zeigt an, dass die Aktion als Sabotage eingestuft ist (group = sabotage), unabhängig vom eigentlichen Effekt.
Kann dimension_teleport in eine andere Welt führen?
Nein, der Spieler bleibt immer in der Welt bzw. Dimension, in der er gerade ist. In eine andere Welt bringen nur random_instance und random_warp.
Was passiert, wenn dieselbe zeitlich begrenzte Aktion zweimal ausgelöst wird?
Die zweite ersetzt die erste, gezählt wird ab der letzten Auslösung. Ausnahme: portal_timer_pause schlägt fehl, solange die Uhr bereits angehalten ist.