Übersicht, Installation & Befehle

Eranio Veröffentlicht am: 14. Oktober 2026

StreamBridge (Hytale): Übersicht, Installation & Befehle

StreamBridge-Hytale ist das Hytale-Server-Plugin, das deinen Hytale-Server mit einem Streamer-Panel verbindet. Zuschauer lösen darüber per TikTok-Geschenk oder Twitch-Kanalpunkten Aktionen direkt im Spiel aus. Diese Anleitung richtet sich an Betreiber eines eigenen Hytale-Servers, nicht an Zuschauer.

Funktionsweise

Das Plugin fragt in regelmäßigen Abständen beim Panel nach neuen Aktionen (HTTP-Polling), dein Server muss von außen nicht erreichbar sein.

Protokoll: HTTPS (POST-Anfragen, JSON)
Endpunkt: über die Konfiguration festgelegt, vom Panel beim Download vorbelegt
Authentifizierung: Bearer-Token im HTTP-Header, den du im Panel erhältst
Datenübertragung: Das Plugin sendet einen Schnappschuss der aktuellen Spielerdaten (Name, Welt, Gesundheit, Spielmodus) und erhält eine Liste auszuführender Aktionen
Versionskennung: Das Plugin sendet seine Version im User-Agent (StreamBridge/<Version>) mit, zur Kompatibilitätsprüfung

Installation

Lade die aktuelle Version herunter (StreamBridge-Hytale-1.4.1.jar) und lege sie in den Plugin-Ordner deines Hytale-Servers.
Starte den Server einmal, damit das Plugin die Datei config.json im Plugin-Ordner anlegt.
Trage den Authentifizierungs-Token aus deinem Panel in config.json ein und lade die Konfiguration neu (/sb reload) oder starte den Server neu.

Konfiguration (`config.json`)

Feld	Typ	Standardwert	Beschreibung
`url`	String	(vom Panel vorbelegt)	Die API-Adresse des Panels, zu dem dieses Plugin Kontakt hält
`token`	String	leer	Dein geheimer Authentifizierungs-Token
`pollIntervalMs`	Zahl	1000	Intervall zwischen den Abfragen in Millisekunden. Minimum: 500
`paused`	Boolean	`false`	Wenn aktiv, werden keine Aktionen vom Panel ausgeführt
`showTitle`	Boolean	`true`	Ob Titel-Nachrichten im Spiel angezeigt werden
`language`	String	`de`	Sprache der Server-Befehlsausgaben (`de` oder `en`)

Server-Befehle

Alle Befehle laufen über den Basis-Befehl /streambridge (Kurzform: /sb).

Befehl	Wirkung
`/sb status`	Zeigt den Verbindungsstatus zum konfigurierten Panel an (verbunden/nicht verbunden), den aktuellen Fehler (falls vorhanden) und ob Eingriffe aktiv (`running`) oder pausiert (`paused`) sind
`/sb pause`	Pausiert sofort alle eingehenden Aktionen vom Panel
`/sb resume`	Aktiviert die Verarbeitung von Aktionen wieder
`/sb reload`	Lädt `config.json` neu und baut die Verbindung zum Panel neu auf

Die Befehlsausgaben erfolgen in der in language eingestellten Sprache.

Kompatibilität

Erfordert die Hytale-Server-API (nutzt Universe, World, PlayerRef und weitere Komponenten)
Die Versionsnummer wird automatisch aus dem Plugin-Manifest gelesen, Fallback-Wert 1.0.0

Häufige Fragen

Muss mein Server von außen erreichbar sein? Nein, das Plugin fragt selbst aktiv beim Panel nach, eine eingehende Verbindung ist nicht nötig.

Wo bekomme ich den Token? Im Streamer-Panel auf der Minecraft/Hytale-Seite, dort richtest du die Verbindung zu deinem Server ein.

Wie erkenne ich, ob die Verbindung steht? Mit /sb status. Die Verbindung gilt nur als aktiv, wenn die letzte erfolgreiche Kommunikation weniger als 15 Sekunden zurückliegt.