Overview, installation & commands

Eranio Published on: 14. October 2026

StreamBridge (Hytale): Overview, installation & commands

StreamBridge-Hytale is the Hytale server plugin that connects your Hytale server to a streamer panel. Viewers use it to trigger actions directly in the game via TikTok gifts or Twitch channel points. This guide is for operators of their own Hytale server, not for viewers.

How it works

The plugin periodically asks the panel for new actions (HTTP polling), your server does not need to be reachable from the outside.

Protocol: HTTPS (POST requests, JSON)
Endpoint: set in the configuration, pre-filled by the panel it was downloaded from
Authentication: Bearer token in the HTTP header, which you get from the panel
Data transfer: the plugin sends a snapshot of current player data (name, world, health, game mode) and receives a list of actions to execute
Version identification: the plugin sends its version in the User-Agent (StreamBridge/<version>) for compatibility checks

Installation

Download the current version (StreamBridge-Hytale-1.4.0.jar) and place it in your Hytale server's plugin folder.
Start the server once so the plugin creates the config.json file in the plugin folder.
Enter the authentication token from your panel into config.json and reload the configuration (/sb reload) or restart the server.

Configuration (`config.json`)

Field	Type	Default	Description
`url`	String	(pre-filled by the panel)	The API address of the panel this plugin stays in contact with
`token`	String	empty	Your secret authentication token
`pollIntervalMs`	Number	1000	Interval between checks in milliseconds. Minimum: 500
`paused`	Boolean	`false`	When active, no actions from the panel are executed
`showTitle`	Boolean	`true`	Whether title messages are shown in-game
`language`	String	`de`	Language of the server command output (`de` or `en`)

Server commands

All commands run through the base command /streambridge (short form: /sb).

Command	Effect
`/sb status`	Shows the connection status to the panel (connected/not connected), the current error (if any), and whether interventions are active (`running`) or paused (`paused`)
`/sb pause`	Immediately pauses all incoming actions from the panel
`/sb resume`	Re-enables processing of actions
`/sb reload`	Reloads `config.json` and rebuilds the connection to the panel

Command output is shown in the language set in language.

Compatibility

Requires the Hytale Server API (uses Universe, World, PlayerRef and other components)
The version number is read automatically from the plugin manifest, fallback value 1.0.0

FAQ

Does my server need to be reachable from the outside? No, the plugin actively polls the panel itself, no incoming connection is needed.

Where do I get the token? In your streamer panel, on the Minecraft/Hytale page, where you set up the connection to your server.

How do I know if the connection is up? With /sb status. The connection only counts as active if the last successful communication was less than 15 seconds ago.