Bedrock Simple Voice einrichten.

Vorbereitung

Was du vor der Installation benötigst

Dateien verstehen

Welche JAR gehört auf welchen Server?

Schritt für Schritt

Installation auf Paper, Purpur, Spigot oder Folia

1. Stoppe den Gameserver vollständig, bevor du Plugin-Dateien austauschst.
2. Lade die aktuelle BedrockSimpleVoice-Bukkit-JAR von der offiziellen Modrinth-Projektseite herunter.
3. Lade außerdem die Bukkit-Versionen von Simple Voice Chat und Geyser. Installiere optional Floodgate.
4. Lege alle JAR-Dateien in den Ordner plugins. Entpacke die JAR-Dateien nicht.
5. Starte den Server und warte, bis er vollständig hochgefahren ist. Bedrock Simple Voice erstellt dabei plugins/BedrockSimpleVoice/config.yml und messages.yml.
6. Öffne config.yml. Für den normalen Betrieb musst du nur Servername, Sprache und bei Bedarf den Nachrichten-Prefix ändern.
7. Starte den Server neu oder führe nach Änderungen /bsv reload aus.
8. Führe in Minecraft /voice diagnose aus. Relay, Pairing und Simple Voice Chat sollten als verfügbar angezeigt werden.
9. Führe /voice aus und scanne den QR-Code mit deinem Handy. Alternativ öffnest du voice.byterider.xyz und gibst den einmaligen Zahlencode ein.
10. Erlaube im Browser den Mikrofonzugriff oder wähle „Nur zum Zuhören“. Eine gespeicherte Gerätesitzung verbindet sich beim nächsten Besuch automatisch wieder.

Java-Spieler mit installiertem Simple-Voice-Chat-Client-Mod verwenden weiterhin das normale Ingame-Menü. Bedrock-Spieler und Java-Spieler ohne native Client-Verbindung können den Browser verwenden; der Standard-Hinweis erscheint für beide Zielgruppen.

Downloads

Offizielle Beta auf Modrinth

Modrinth ist der offizielle Download-Ort für die Bukkit-JAR für Paper, Purpur, Spigot und Folia. Die optionale Velocity-JAR für Beta 12 ist ein separates Release-Artefakt; sie gehört nicht auf die Gameserver.

Beta-Hinweis: Paper, Purpur, Spigot und Folia verwenden dieselbe Bukkit-JAR. Fabric ist noch nicht als öffentlicher Download verfügbar. Die Velocity-JAR wird separat bei den Beta-12-Release-Dateien angeboten.

Velocity-Netzwerk

Installation auf einem Proxy mit mehreren Servern

Ab Beta 12 verfügbar: Das optionale Velocity-Begleitplugin unterstützt den automatischen Browser-Handoff zwischen Bukkit-Backends und die Wiederverbindung nach einem kurzen Logout.

Die Velocity-JAR verbindet mehrere Backend-Server zu einem gemeinsamen Bedrock-Simple-Voice-Netzwerk. Sie übergibt eine angemeldete Browser-Sitzung beim Serverwechsel sicher an das nächste Backend. Wenn ein Spieler Minecraft verlässt und innerhalb von zwei Minuten auf einem anderen Backend wieder joint, folgt ihm die Browser-Sitzung automatisch. Sprachpakete laufen dabei nicht durch Velocity: Jedes Backend bleibt selbst mit dem Relay und Simple Voice Chat verbunden.

Velocity Proxy
├── lobby      → Paper + Bedrock Simple Voice + Simple Voice Chat
├── survival   → Purpur + Bedrock Simple Voice + Simple Voice Chat
└── event      → Folia + Bedrock Simple Voice + Simple Voice Chat

Die automatische Übergabe unterstützt Bukkit-Backends: Paper, Purpur, Spigot und Folia. Fabric kann Bedrock Simple Voice einzeln verwenden, ist aber kein automatisches Handoff-Ziel. Für BungeeCord oder Waterfall gibt es kein Begleitplugin.

Proxy vorbereiten

1. Velocity-JAR installieren und Secret erzeugen

1. Stoppe Velocity und alle Backend-Server vollständig.
2. Lege BedrockSimpleVoice-Velocity-0.2.9-beta.12.jar ausschließlich in den Ordner plugins deines Velocity-Proxys.
3. Starte Velocity einmal. Das Plugin erstellt plugins/bedrocksimplevoice/config.yml mit einem zufälligen, mindestens 256 Bit starken Secret.
4. Stoppe Velocity wieder und öffne die erzeugte Konfiguration. Veröffentliche das Secret niemals und sende es nicht im Minecraft-Chat oder in Support-Screenshots.
5. Ändere bei Bedarf network.id zu einem kurzen Namen für dein Netzwerk. Erlaubt sind Buchstaben, Zahlen, Punkt, Unterstrich und Bindestrich.

network:
  id: "mein-netzwerk"
  secret: "automatisch-erzeugtes-geheimes-secret"
  handoff-timeout-seconds: 10
  backend-freshness-seconds: 45

handoff-timeout-seconds darf zwischen 3 und 30 Sekunden liegen und muss auf Proxy und Backends gleich sein. backend-freshness-seconds bestimmt, wie lange ein Backend ohne neue Bereitschaftsmeldung als erreichbar gilt. Die Standardwerte 10 und 45 sind für normale Netzwerke geeignet.

Backends vorbereiten

2. Plugin auf jedem Gameserver installieren

1. Installiere auf jedem Backend die passende BedrockSimpleVoice-Bukkit-0.2.9-beta.12.jar. Die Velocity-JAR gehört nicht auf die Backends.
2. Installiere auf jedem Backend außerdem die passende Serverversion von Simple Voice Chat. Die Velocity-JAR ersetzt Simple Voice Chat nicht.
3. Starte jedes Backend einmal, damit plugins/BedrockSimpleVoice/config.yml erzeugt wird.
4. Aktiviere dort den Bereich network. Kopiere die Proxy-Werte network.id und network.secret als network-id und shared-secret.
5. Vergib auf jedem Backend eine eindeutige backend-id. Am übersichtlichsten ist derselbe Name wie in der Serverliste von Velocity, beispielsweise lobby oder survival.
6. Lasse die normale server.relay-Konfiguration auf jedem Backend unverändert und nutze Relay-Modus. Jedes Backend verbindet sich selbstständig ausgehend mit demselben Relay.

Beispiel für das Lobby-Backend:

network:
  enabled: true
  proxy: "velocity"
  network-id: "mein-netzwerk"
  backend-id: "lobby"
  shared-secret: "dasselbe-secret-wie-auf-velocity"
  handoff-timeout-seconds: 10

Beispiel für das Survival-Backend:

network:
  enabled: true
  proxy: "velocity"
  network-id: "mein-netzwerk"
  backend-id: "survival"
  shared-secret: "dasselbe-secret-wie-auf-velocity"
  handoff-timeout-seconds: 10

Die network-id, das shared-secret und handoff-timeout-seconds müssen auf Proxy und allen Backends übereinstimmen. Die backend-id muss dagegen pro Backend eindeutig sein. Verwende niemals das Secret eines anderen Netzwerks.

Spieleridentität

3. Velocity, Geyser und Floodgate richtig verbinden

Velocity und alle Backends müssen für denselben Spieler dieselbe UUID verwenden. Richte deshalb die normale sichere Spielerweiterleitung von Velocity ein und konfiguriere Geyser beziehungsweise Floodgate nach deren Proxy-Dokumentation. Bedrock Simple Voice ersetzt diese Identitätsweiterleitung nicht.

Start und Prüfung

4. Netzwerk starten und Übergabe testen

1. Starte zuerst alle Backend-Server und danach Velocity.
2. Prüfe auf jedem Backend mit /voice diagnose, ob Simple Voice Chat, Relay, Pairing und Netzwerkkonfiguration verfügbar sind.
3. Führe in der Velocity-Konsole /bsvnetwork aus. Als Spieler brauchst du die Berechtigung bedrocksimplevoice.network.admin.
4. Der Befehl sollte alle Backends als aktuell und bereit anzeigen. Secrets und Übergabe-Tokens werden dabei niemals ausgegeben.
5. Verbinde einen Testspieler über /voice im Lobby-Server mit dem Browser und wechsle danach auf das Survival-Backend.
6. Die Browser-Verbindung öffnet das Ziel parallel. Das alte Backend bleibt verbunden, bis das Ziel die Anmeldung bestätigt; ein neuer Pairing-Code sollte nicht nötig sein.

Backends melden ihre Bereitschaft über die ausgehende Relay-Verbindung – auch wenn sie leer sind. Für den Reconnect-Test verbindest du den Browser auf einem Backend, verlässt das Minecraft-Netzwerk vollständig und joint innerhalb von zwei Minuten auf einem anderen Backend erneut. Die Browser-Sitzung sollte ohne neuen Code folgen.

Proxy-Fehler beheben

Wenn der automatische Serverwechsel nicht funktioniert

Betriebsarten

Zentral verbinden oder die Webseite selbst hosten

server:
  connection-mode: "relay"
  relay:
    url: "wss://voice.byterider.xyz/relay/server"
    public-url: "https://voice.byterider.xyz"

server:
  connection-mode: "direct"
  bind-address: "127.0.0.1"
  port: 8080
  public-url: "https://voice.example.com"
  context-path: "/"

Für normale Gameserver ist das öffentliche Byterider-Relay die empfohlene Einstellung. Der eingebaute Webserver ist die unterstützte Alternative für Betreiber, die Webseite und Domain selbst kontrollieren möchten.

Updates der zentralen Webseite erzwingen kein sofortiges Plugin-Update. Das Relay hält die Voice-Verbindung über eine stabile Protokollversion kompatibel; neue serverseitige Funktionen werden nur angezeigt, wenn das installierte Plugin sie unterstützt.

Webclient

Aktuelle Voice-Funktionen

Freiwillige Meldungen

Self-Hosted-Zahlen sind Opt-in

Eigene Relays und Direct-Mode-Installationen sind für das Byterider-Relay nicht automatisch sichtbar. Betreiber können anonyme Ökosystem-Zahlen freiwillig aktivieren; die Funktion ist standardmäßig ausgeschaltet.

status-reporting:
  enabled: false
  endpoint: "https://voice.byterider.xyz/api/ecosystem/heartbeat"
  interval-seconds: 60

Gemeldet werden nur eine lokale Zufalls-ID, Produktversion, Plattformkategorie, Relay-Modus, aktive Server sowie aggregierte Bedrock- und Java-Voice-Nutzer, Zeitstempel und Nonce. Nicht übertragen werden Servername, Domain oder IP als Nutzdaten, Servericon, Spielername oder UUID, Chat, Audio, Gruppen, Pairing-Codes oder Session-Tokens.

Zum Deaktivieren enabled: false setzen und neu starten. Zum Zurücksetzen der lokalen Reporting-ID und des Tokens den Server stoppen und data/status-reporting.json löschen.

Fehlerdiagnosen

Pseudonyme Plugin-Fehlerübersicht

Plugin-Diagnosen sind getrennt von den freiwilligen öffentlichen Statuszahlen und standardmäßig eingeschaltet. Sie helfen, wiederkehrende Fehler über mehrere Installationen hinweg zu erkennen.

diagnostics:
  enabled: true
  endpoint: "https://voice.byterider.xyz/api/diagnostics/heartbeat"
  interval-seconds: 60

Gemeldet werden eine zufällige Installations-ID, Plugin-Version, Plattform, Relay-Modus und Relay-Version/Build, die zufällige Relay-Server-ID zur Zuordnung im Admin-Panel, aggregierte Zahlen zu allen Spielern, Bedrock-Spielern, Bedrock-Voice-Nutzern und sämtlichen Browser-Voice-Nutzern sowie Spieler- und Voice-Höchststände. Höchststände sind gespeicherte Maxima ohne Verlauf und Zeitpunkt. Bedrock-Zahlen sind nicht verfügbar, wenn Geyser/Floodgate auf der Plugin-Plattform nicht abgefragt werden kann. Begrenzte Fehler-Fingerprints enthalten nur Plugin-Komponente, Operation, Exception-Klasse und Zähler. Fehlertexte, Stacktraces, Server- und Spielernamen, Adressen, Chat und Audio werden nicht übertragen. IP-Adressen werden nicht in Diagnose-Datensätzen gespeichert. Fehlerereignisse verfallen 30 Tage nach dem letzten Auftreten; inaktive Installationen 30 Tage nach dem letzten Heartbeat.

Die Übersicht unter /admin/ ist durch ein eigenes lokales Relay-Konto geschützt. Richte es mit java -jar relay.jar --set-admin-login in der Serverkonsole ein. Das Passwort wird mit PBKDF2 gehasht gespeichert; es gibt kein Standardpasswort. Zum Ausschalten diagnostics.enabled: false setzen. Die lokale Datei data/diagnostics-reporting.json enthält die zufällige ID und das Token.

Das private Betreiber-Dashboard trennt Relay-Server, Plugin-Installationen, Voice-Monitoring, Diagnosen, Statistiken und Systemeinstellungen. Live-Traffic und CPU/RAM stammen direkt aus dem Relay; ältere Plugins funktionieren weiter, liefern aber möglicherweise keine Bedrock-Zähler oder sichere Installationszuordnung. Minütliche Betriebsverläufe bleiben standardmäßig 30 Tage erhalten (einstellbar: 1–90). Individuelle Serverdaten, Fehler und Admin-Funktionen sind nicht Teil der öffentlichen Statusseite. Eine fehlende Diagnose ist kein Nachweis für einen fehlerfreien Voicechat.

Der Relay-Betreiber kann optional BSV_RELAY_DISCORD_WEBHOOK_URL setzen, um nach dem ersten gültigen Heartbeat einmalig über eine neue Plugin-Installation informiert zu werden. Die Nachricht enthält nur zufällige Installations- und Relay-ID, Version, Plattform und Relay-Modus. Fehlgeschlagene Zustellungen werden wiederholt; vorhandene Installationen lösen keine rückwirkende Nachricht aus. Die Variable bleibt ungesetzt, ist die Benachrichtigung deaktiviert.

Klassisches Self-Hosting

Den eingebauten Webserver veröffentlichen

Setze server.connection-mode auf direct. Wenn Nginx auf demselben System läuft, sollte das Plugin nur an 127.0.0.1 gebunden werden. Nginx übernimmt anschließend HTTPS und WebSocket-Upgrades.

server {
    listen 443 ssl;
    server_name voice.example.com;

    ssl_certificate /etc/letsencrypt/live/voice.example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/voice.example.com/privkey.pem;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto https;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_read_timeout 3600s;
        proxy_buffering off;
    }
}

Diese Variante benötigt eine eigene Domain, ein gültiges SSL-Zertifikat und einen Web-Port, den der Reverse Proxy erreichen kann. Auf klassischen Gameserver-Panels ist deshalb meist Bedrock Simple Voice einfacher.

Spieler

Wichtige Befehle

Webchat

Serverchat als eigene Ansicht

Wenn Webchat auf dem Server aktiviert ist, erscheint nach dem Verbinden ein eigener Reiter Chat. Dort stehen öffentliche Nachrichten von Java- und Bedrock-Spielern links und die eigenen Browsernachrichten rechts – jeweils mit Spielername und Uhrzeit.

Neue Nachrichten werden am Reiter gezählt. Beim Wechsel zwischen Voice, Spielern, Gruppe, Chat und Einstellungen bleiben Mikrofon, Audio und Voice-Verbindung unverändert aktiv. Der Browser zeigt höchstens die letzten 200 Nachrichten der aktuellen Seitensitzung; Bedrock Simple Voice speichert keinen Chatverlauf.

Anpassung

Servername, Prefix und Nachrichten

Servername und Chat-Prefix stehen in der normalen Konfiguration. Minecraft-, Geyser- und Browsertexte können in messages.yml angepasst werden. Platzhalter wie {0} müssen erhalten bleiben. Änderungen werden mit /bsv reload übernommen.

server:
  name: "Mein Minecraft Server"
  prefix: "&7[&bVoice&7] &r"
  language: "de_DE"

Die mit dem Plugin ausgelieferte config.yml ist auf Englisch, damit sie international verständlich bleibt. Für deutschsprachige Server steht dieselbe Vorlage vollständig auf Deutsch bereit.

Vor dem Ersetzen einer vorhandenen Konfiguration immer eine Sicherung erstellen. Bereits eingetragene Servernamen, URLs, Passwörter und Velocity-Geheimnisse müssen in die neue Datei übernommen werden.

Eine gültige Datei server-icon.png im Serververzeichnis wird nach der Verbindung auf der Voice-Seite angezeigt.

Der QR-Code im Bedrock-Formular wird mit der Kamera eines zweiten Geräts gescannt. Minecraft Bedrock kann aus diesem Formular heraus keine externe Browserseite öffnen.

Aktualisierungen

So funktioniert der Update-Checker

Der Update-Checker vergleicht beim Serverstart offizielle Modrinth-Versionen von Bedrock Simple Voice mit dem öffentlichen Byterider-Versionsdienst. Er berücksichtigt Plattform und Minecraft-Version; so erkennt er auch einen neuen Release, bevor Modrinth seine Versionsliste synchronisiert hat. Ein Update-Hinweis mit Download-Link erscheint in der Serverkonsole.

updatechecker:
  enable: true

Die Prüfung ist standardmäßig aktiviert. Ältere Konfigurationen werden beim ersten Start einmalig migriert; mit enable: false lässt sie sich abschalten. Es werden keine JAR-Dateien automatisch heruntergeladen oder installiert.

Fehler finden

Wenn die Verbindung nicht sofort funktioniert

Sicherheit

Was bei der Verbindung wichtig ist