Actions reference

Eranio Published on: 14. October 2026

StreamBridge (Minecraft): Actions reference

Every action that viewers can trigger through the panel receives a unique ID from the panel (to prevent double execution, up to 5000 IDs are stored) plus further parameters depending on the action.

Shared parameters

Most actions understand the following parameters, where applicable:

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/repetitions
`label`	empty (falls back to the action name)	-	Displayed text
`viewer`	"Chat"	-	Name of the triggering viewer, shown in-game
`show_title`	`true`	-	Whether a title screen is shown

Action list

Action	Parameters	In-game effect	Category
`commands`	`commands` (list of server commands)	Runs a list of server commands as console, only allowed patterns (see below)	Admin tool
`drop_hand`	-	Throws the item in the main hand in the look direction	Chaos/fun
`drop_hotbar`	-	Drops all items from the hotbar (slots 0-8) randomly	Chaos/sabotage
`throw_item`	-	Throws the item in hand with an upward arc	Chaos/fun
`shuffle_inventory`	-	Shuffles the player's entire inventory	Chaos/sabotage
`hotbar_chaos`	`seconds`	Randomly switches the active hotbar slot for the duration	Chaos/sabotage
`pin`	`seconds`	Pins the player in place	Chaos/fun
`knockback`	`strength`	Knocks the player back with force `0.4 + (strength × 0.4)`	Chaos/fun
`invert_controls`	`seconds`	Inverts the player's controls	Chaos/sabotage
`strip_armor`	-	Removes all armor, pieces fly off around the player	Sabotage
`damage_tool`	`strength`	Damages the tool in hand (up to 10% of max durability per level)	Sabotage
`hot_potato`	`seconds`, `label`	Gives the player a "hot potato". If time runs out while still holding it, they explode (without destroying blocks)	Game/event
`jail`	`seconds`	Teleports the player into a temporary glass cage	Fun/event
`cobweb`	`seconds`	Places cobwebs around the player's feet	Chaos/fun
`ice_floor`	`seconds`	Replaces the ground under the player with packed ice	Chaos/fun
`pumpkin_head`	`seconds`	Puts a carved pumpkin on the player's head (with curse of binding), removed again after it expires	Fun/event
`sky_launch`	-	Launches the player 40 blocks up, or gives an upward boost with slow falling	Fun/event
`anvil_rain`	`count`	Up to 5 anvils fall from the sky over the player (no real damage, see safety note below)	Chaos/sabotage
`harmless_tnt`	`count`	Places TNT without explosion damage near the player	Fun/effect
`half_health`	-	Sets the player's health to half of the current value (minimum 2.0)	Sabotage
`swap_places`	`partner` (player name)	Swaps the player's position with another player	Useful/event
`firework_show`	`count`	Up to 10 fireworks near the player	Effect
`set_spawn`	-	Sets the player's respawn point to their current position	Useful
`random_teleport`	`seconds`	Starts a random high-altitude drop teleport (see below)	Event
`ground_teleport`	-	Safely ends a running high-altitude drop onto the ground	Event
`fake_death`	-	Simulates the player's death without them actually dying or losing anything	Fun/prank

Safety mechanisms

CommandGuard: For the commands action, only commands matching a predefined, safe pattern are executed. Explicitly blocked are, among others, command blocks, spawners, barriers, structure blocks and spawn eggs.
Anvil rain: When an anvil lands, the plugin intercepts the landing event, removes the anvil again and only produces particles and sound, no real damage occurs.
Duplicate execution: Every action has a unique ID, up to 5000 of which are stored so the same action is never executed twice.

Known error cases

Situation	What happens
Empty hand on `drop_hand`, `throw_item`, `damage_tool`	Action fails (`empty_hand`)
No space on `cobweb`, `ice_floor`	Action fails (`no_space`)
Target player offline or identical on `swap_places`	Action fails
Command not allowed on `commands`	Rejected as `blocked_command`, logged on the server
Plugin paused	All requests are rejected with `paused`
Player goes offline during transfer	Action is cancelled with `player_offline`

FAQ

Can I block individual actions on my server? The action list itself is provided by the panel, that's also where you set which actions belong to which gift/channel point reward.

What happens if two actions arrive at the same time? Each action is processed individually by its ID, there is no guaranteed order between different actions.

Why was an action rejected? Check /streambridge status to see whether the plugin is paused or there is a connection error. Individual rejected actions (e.g. empty_hand, no_space) appear in the server log.