Eranio
Color theme

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_control block (for which players viewer control should remove hostile creatures within which radius)

Installation

  1. Download the current version (StreamBridge-1.9.2.jar) and place it in your Paper/Spigot server's plugins folder.
  2. Start the server once so the plugin creates the config.yml file in plugins/StreamBridge/.
  3. 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-version 26.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.