Overview & installation
Eranio Published on: 14. October 2026
StreamBridge (Minecraft): Overview & Installation
StreamBridge is the Minecraft plugin (Paper/Spigot) that connects your Minecraft server to a streamer panel. Through it, viewers trigger actions directly in the game via TikTok gifts or Twitch channel points. This guide is for operators of their own Minecraft server, not for viewers.
How it works
The plugin periodically asks the panel for new actions (polling), so it runs as a client, your server does not need to be reachable from the outside.
- Protocol: HTTPS (REST API, JSON)
- Authentication: Bearer token in the HTTP header, which you get from the panel
- What the plugin sends: plugin version and status (paused or active), a snapshot of online players (name, health, hunger, level, world, dimension, game mode, dead or alive, active effects, running timers), the server whitelist (up to 200 names), the results of the latest actions, and once at startup a list of all registered items
- What the plugin receives: live stream information (streamer name, platform, link, viewer count), the list of actions to execute and the
viewer_controlblock (for which players viewer control should remove hostile creatures within which radius)
Installation
- Download the current version (
StreamBridge-1.9.2.jar) and place it in your Paper/Spigot server'spluginsfolder. - Start the server once so the plugin creates the
config.ymlfile inplugins/StreamBridge/. - Enter the authentication token from your panel into
config.yml(see below) and restart the server, or run/streambridge reload.
Configuration (config.yml)
| Field | Default | Description |
|---|---|---|
url |
(pre-filled by the panel it was downloaded from) | The API address of the panel this plugin stays in contact with. Only change it if you want to talk to a different panel instance running the same interface. |
token |
empty | Your secret authentication token from the panel |
poll-interval-ticks |
20 (= 1 second) | How often the plugin checks with the panel. Minimum: 10 ticks |
bossbar |
true |
Shows time-limited effects as a boss bar |
effect-bars |
true |
Shows effects above the hotbar (action bar) |
paused |
false |
Initial status of whether interventions are active |
language |
de |
Language of the plugin's messages (de or en) |
drop-hand.protect-valuable |
true |
For the drop_hand action, additionally protects tools, weapons, armor, elytra, totems, shulker boxes, tridents, bows, crossbows, netherite items, named items or items with lore, and items carrying another plugin's own tag. Enchanted items are always protected regardless of this setting |
drop-hand.glow |
true |
Makes a protected dropped item glow |
drop-hand.indestructible |
true |
Makes a protected dropped item indestructible (fire, lava, explosions, cactus) and keeps it from despawning over time |
drop-hand.owner-lock-seconds |
60 |
For this many seconds, only the player who dropped a protected item can pick it up, anyone else can afterwards. 0 disables the lock |
Metadata (plugin.yml)
- Name: StreamBridge
- Main class:
StreamBridgePlugin - API version: 26.1 (minimum, runs on Paper, Purpur and Spigot 26.1 to 26.3)
- Optional dependency: TAB (for placeholders in the player list, see below)
- Permission:
streambridge.admin(default: OP)
Tab placeholders (optional, with the TAB plugin)
If the TAB plugin is installed, the following placeholders are available:
| Placeholder | Shows |
|---|---|
%sb_live% |
"● LIVE" when the player is currently streaming, empty otherwise |
%sb_anylive% |
yes when any player on the server is live right now, otherwise no (for TAB conditions, e.g. a sidebar only during a stream) |
%sb_role% |
The player's role: streamer (only while live), moderator or player |
%sb_platform% |
Platform of the running stream, e.g. twitch or tiktok |
%sb_since% |
Stream uptime, "42 min" below one hour, then "1:05 h" |
%sb_viewers% |
Viewer count (formatted, e.g. "1,234") |
%sb_likes% |
Likes in the running stream (formatted) |
%sb_top% |
Top supporter of the stream, shortened, or - |
%sb_last% |
Last triggered action, shortened, or - |
%sb_feed_1% to %sb_feed_5% |
The latest messages from the stream feed |
All placeholders except %sb_anylive%, %sb_role% and the feed lines refer to the player the display belongs to and stay empty while that player is not live. They refresh every second.
Compatibility
- Minecraft 26.1 to 26.3 (Paper, Purpur or Spigot), running in production on Purpur 26.3
- Older versions (1.21 and earlier) do not load the plugin,
api-version26.1 is the minimum - Java 25 (required since Minecraft 26.1)
- Dependencies: Kyori Adventure (text/titles), Gson (JSON)
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 page, where you set up the connection to your server.
What happens if the panel is unreachable?
The plugin logs a warning in the server log and tries again at the next interval. You can see the current connection status with /streambridge status.