Actions reference
Eranio Published on: 14. October 2026
StreamBridge (Hytale): Actions reference
Every action runs asynchronously with a fixed 5-second timeout so it never blocks the server. If execution takes longer, the action is cancelled with an error.
Shared parameters
| Parameter | Default | Limits | Meaning |
|---|---|---|---|
seconds |
10 | 1 to 600 | Duration of the effect |
strength |
1 | 1 to 5 | Intensity of the action |
count |
1 | 1 to 10 | Number of objects/effects |
label |
empty (falls back to the action name) | - | Text shown in chat/title |
viewer |
- | - | Name of the triggering viewer, shown in chat |
group |
- | - | If the value is sabotage, title displays are shown in red instead of green |
Every action needs a player (player name) as its target.
Action list
Status effects
| Action | Parameters | Effect | Category |
|---|---|---|---|
freeze |
seconds |
Freezes the player | Sabotage |
root |
seconds |
Roots the player to the ground | Sabotage |
slow |
seconds |
Slows the player | Sabotage |
stun |
seconds |
Stuns the player | Sabotage |
poison |
seconds |
Poisons the player | Sabotage |
burn |
seconds |
Burning effect | Sabotage |
stamina_drain |
seconds |
Drains stamina | Sabotage |
mana_drain |
seconds |
Drains mana | Sabotage |
vulnerable |
seconds |
Makes the player vulnerable (takes more damage) | Sabotage |
electric_shock |
seconds |
Electric shock, briefly stuns | Sabotage |
regeneration |
seconds |
Heals the player over time | Helpful |
stoneskin |
seconds |
Grants protection (stoneskin) | Helpful |
immune |
seconds |
Temporarily immune to effects | Helpful |
fall_immunity |
seconds |
No fall damage | Helpful |
fire_immunity |
seconds |
No fire damage | Helpful |
Transformation & size
| Action | Parameters | Effect | Category |
|---|---|---|---|
morph |
morph, seconds |
Turns the player into an animal (values see below) | Entertainment |
scale_giant |
seconds |
Makes the player giant (scale 2.0), automatically reset after it expires | Entertainment |
scale_tiny |
seconds |
Makes the player tiny (scale 0.5), automatically reset after it expires | Entertainment |
launch |
strength |
Launches the player vertically upward (8 + strength × 4) | Sabotage |
knockback |
strength |
Knocks the player in a random direction (6 + strength × 4) | Sabotage |
Teleport & dimensions
| Action | Parameters | Effect | Category |
|---|---|---|---|
dimension_teleport |
strength |
Teleports to a random spot in the same world or dimension. Distance by strength: 1 = up to 25, 2 = up to 50, 3 = up to 100, 4 = up to 150, 5 = up to 250 blocks. Lands safely on the ground (Hytale's height map), never in water or lava, only in already loaded areas |
Sabotage |
world_spawn |
- | Teleports to the spawn point of the current world or dimension (respects the player's own spawn point) | Helpful |
teleport_to_player |
- | Teleports to a random other player in the same world | Sabotage |
swap_places |
- | Swaps position with a random other player in the same world | Sabotage |
random_warp |
- | Teleports to a random warp on the server | Entertainment |
teleport_back |
- | Teleports back to the last saved location | Helpful |
random_instance |
instance (optional) |
Teleports into an instance (values see below, random = random) |
Entertainment |
leave_instance |
- | Sends the player out of the current instance | Helpful |
dimension_teleport, world_spawn, teleport_to_player, swap_places and random_warp save the previous location in the teleport history, so teleport_back brings the player back. leave_instance brings them back out of instances.
Portal time & void invasion
These actions only work in a portal world (instance with a time limit or void invasion).
| Action | Parameters | Effect | Category |
|---|---|---|---|
portal_time_add |
seconds |
Increases the remaining time in the portal level | Helpful |
portal_time_remove |
seconds |
Reduces the portal time (at least 30 seconds remain). If this reaches the start time of the void invasion, it begins immediately | Sabotage |
portal_timer_pause |
seconds |
Stops the portal timer, it resumes automatically afterward | Helpful |
void_hold |
seconds |
Holds back the void invasion (a running one is stopped), afterward it may start again | Helpful |
Camera, display & sounds
| Action | Parameters | Effect | Category |
|---|---|---|---|
camera_topdown |
seconds |
Top-down camera, automatically reset afterward | Sabotage |
camera_sidescroller |
seconds |
Side view, the player can only move left/right and up/down, automatically reset afterward | Sabotage |
hide_debug |
seconds |
Blocks the debug screen with the coordinates, unblocked afterward | Sabotage |
fake_sound |
sound |
Plays a scare sound for this player only (values see below), nothing else happens | Sabotage |
Spawning & weather
| Action | Parameters | Effect | Category |
|---|---|---|---|
spawn_mob |
mob, count |
Spawns up to 5 enemies right at the player (values see below) | Sabotage |
animal_rain |
animal, count |
Rains a number (count) of animals from the sky |
Entertainment |
night |
- | Sets the game time to midnight | Entertainment |
day_clear |
- | Sets the game time to noon and removes forced weather | Helpful |
weather |
weather |
Forces a specific weather (values see below) until day_clear removes it |
Entertainment |
Inventory & health
| Action | Parameters | Effect | Category |
|---|---|---|---|
drop_hand |
- | Drops the item from the active hotbar slot | Sabotage |
shuffle_hotbar |
- | Randomly shuffles all items in the hotbar | Sabotage |
half_health |
- | Sets health to at most 50% of the current value | Sabotage |
heal |
- | Fully heals the player immediately | Helpful |
stamina_refill |
- | Refills stamina immediately | Helpful |
antidote |
- | Removes all active status effects | Helpful |
give_item |
item, count |
Gives the player an item (default 1, max 64), overflow is dropped | Helpful |
Choice values
| Parameter | Possible values |
|---|---|
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 |
Unknown values result in unknown_action.
Sabotage marking
If group is set to sabotage, the in-game title is shown in red (#FF5555) in the large style. Normal actions appear in green (#55FF55) in the default style.
Known failure cases
| Situation | What happens |
|---|---|
| Player offline or reference invalid | Action fails with player_offline |
Empty hand on drop_hand |
Action fails with empty_hand |
No space on spawn_mob, no safe landing spot on dimension_teleport |
Action fails with no_space |
| Portal actions outside a portal world (or timer already stopped, no void invasion) | Action fails with not_in_portal |
teleport_to_player/swap_places without another player in the same world |
Action fails with no_other_player |
random_instance while the player is already in an instance |
Action fails with already_in_instance |
| Execution takes longer than 5 seconds | Action is cancelled with plugin_error |
| Player disconnects while a timed action is running (size, camera, debug block) | The automatic reset may not happen. If needed, trigger the action again with a short duration or log in again |
FAQ
Why does random_instance fail?
This action does not work when the player is already in an instance.
What does the red title display mean?
It shows that the action is classified as sabotage (group = sabotage), regardless of the actual effect.
Can dimension_teleport lead to another world?
No, the player always stays in the world or dimension they are currently in. Only random_instance and random_warp move them to another world.
What happens if the same timed action is triggered twice?
The second replaces the first, counted from the last trigger. Exception: portal_timer_pause fails while the timer is already stopped.