Übersicht & Installation
Eranio Veröffentlicht am: 14. Oktober 2026
StreamBridge (Minecraft): Übersicht & Installation
StreamBridge ist das Minecraft-Plugin (Paper/Spigot), das dein Minecraft-Server mit einem Streamer-Panel verbindet. Darüber lösen Zuschauer per TikTok-Geschenk oder Twitch-Kanalpunkten Aktionen direkt im Spiel aus. Diese Anleitung richtet sich an Betreiber eines eigenen Minecraft-Servers, nicht an Zuschauer.
Funktionsweise
Das Plugin fragt in regelmäßigen Abständen beim Panel nach neuen Aktionen (Polling), es läuft also als Client, dein Server muss von außen nicht erreichbar sein.
- Protokoll: HTTPS (REST-API, JSON)
- Authentifizierung: Bearer-Token im HTTP-Header, das du im Panel erhältst
- Was das Plugin sendet: Plugin-Version und Status (pausiert oder aktiv), ein Abbild der Online-Spieler (Name, Gesundheit, Hunger, Level, Welt, Dimension, Spielmodus, aktive Effekte, laufende Timer), die Server-Whitelist (bis zu 200 Namen), die Ergebnisse der letzten Aktionen, und einmalig beim Start eine Liste aller registrierten Items
- Was das Plugin empfängt: Live-Stream-Informationen (Streamer-Name, Plattform, Link, Zuschauerzahl) sowie die Liste der auszuführenden Aktionen
Installation
- Lade die aktuelle Version herunter (
StreamBridge-1.8.0.jar) und lege sie in denplugins-Ordner deines Paper/Spigot-Servers. - Starte den Server einmal, damit das Plugin die Datei
config.ymlim Ordnerplugins/StreamBridge/anlegt. - Trage den Authentifizierungs-Token aus deinem Panel in
config.ymlein (siehe unten) und starte den Server neu, oder führe/streambridge reloadaus.
Konfiguration (config.yml)
| Feld | Standardwert | Beschreibung |
|---|---|---|
url |
(vom herunterladenden Panel vorbelegt) | Die API-Adresse des Panels, zu dem dieses Plugin Kontakt hält. Nur ändern, wenn du eine andere Panel-Instanz mit derselben Schnittstelle ansprechen willst. |
token |
leer | Dein geheimer Authentifizierungs-Token aus dem Panel |
poll-interval-ticks |
20 (= 1 Sekunde) | Wie oft das Plugin beim Panel nachfragt. Mindestwert: 10 Ticks |
bossbar |
true |
Zeigt zeitlich begrenzte Effekte als Bossbar an |
effect-bars |
true |
Zeigt Effekte über der Hotbar (Action-Bar) an |
paused |
false |
Anfangsstatus, ob Eingriffe aktiv sind |
language |
de |
Sprache der Plugin-Meldungen (de oder en) |
Metadaten (plugin.yml)
- Name: StreamBridge
- Hauptklasse:
StreamBridgePlugin - API-Version: 26.2 (Paper/Spigot)
- Optionale Abhängigkeit: TAB (für Platzhalter in der Spielerliste, siehe unten)
- Berechtigung:
streambridge.admin(Standard: OP)
Tab-Platzhalter (optional, mit dem Plugin TAB)
Ist das Plugin TAB installiert, stehen folgende Platzhalter zur Verfügung:
| Platzhalter | Zeigt |
|---|---|
%sb_live% |
„● LIVE", wenn der Spieler gerade streamt |
%sb_role% |
Rolle des Spielers (streamer, moderator, player) |
%sb_viewers% |
Anzahl der Zuschauer (formatiert, z. B. „1.234") |
%sb_feed_1% bis %sb_feed_5% |
Die letzten Nachrichten aus dem Stream-Feed |
Kompatibilität
- Paper/Spigot, API-Version 26.2
- Nutzt moderne API-Funktionen (Records,
teleportAsync), daher eine neuere Minecraft-Version (1.19+) erforderlich - Abhängigkeiten: Kyori Adventure (Text/Titel), Gson (JSON)
Häufige Fragen
Muss mein Server von außen erreichbar sein? Nein, das Plugin fragt selbst aktiv beim Panel nach (Polling), eine eingehende Verbindung ist nicht nötig.
Wo bekomme ich den Token? Im Streamer-Panel auf der Minecraft-Seite, dort richtest du die Verbindung zu deinem Server ein.
Was passiert, wenn das Panel nicht erreichbar ist?
Das Plugin protokolliert eine Warnung im Server-Log und versucht es beim nächsten Intervall erneut. Den aktuellen Verbindungsstatus siehst du mit /streambridge status.