Funktionen

Chat-Sync

Den Minecraft-Chat in einen Discord-Kanal übertragen und Nachrichten aus dem Kanal zurück ins Spiel.

Der Chat-Sync verbindet einen Discord-Kanal mit dem Chat deines Minecraft-Servers. Dafür läuft das MC-Sync-Plugin oder die Mod auf dem Server. Einen Port musst du nicht freigeben.

Einrichten

Lade die passende Datei von der Download-Seite.
Leg sie in den Ordner plugins (Spigot, Paper, Folia) oder mods (Fabric, Quilt, Forge, NeoForge) und starte den Server. Dabei entsteht die Konfiguration.
Verbinde den Server mit einem Discord-Kanal:

Öffne im Dashboard den Bereich „Server“ und dann deinen Server. Fehlt er, leg ihn mit „+ Server hinzufügen“ an.
Öffne den Reiter „Verbindung & Chat“.
Wähle den Chatkanal.
Stimm den Nutzungsbedingungen zu und klick auf „Verbinden und Token erzeugen“.

Führ /server add name: Survival channel: #minecraft aus. Steht der Server schon in der Liste, nimm /server connect server: Survival channel: #minecraft.
Klick auf „Zustimmen und verbinden“. Der Bot zeigt den Token einmal und nur dir.

Trag den Token in die Konfiguration ein und starte den Server neu.

yaml

# Spigot, Paper, Folia: plugins/mc-sync/config.yml
api:
  token: "dein-token"

properties

# Fabric, Quilt, Forge, NeoForge: config/mc-sync.properties
api.token=dein-token

Schreib im Spiel eine Nachricht. Nach wenigen Sekunden steht sie im Discord-Kanal.

Steht sie dort nicht, sieh unter Probleme nach.

Einstellungen

Im Dashboard stehen die Schalter unter „Verbindung & Chat“. In Discord stellst du sie mit /server chat ein.

Dashboard	`/server chat`	Wirkung
Aktiv	`active`	Schaltet den Chat-Sync ab. Kanal und Token bleiben erhalten.
Chat	`chat-messages`	Chatnachrichten in beide Richtungen
Betreten/Verlassen	`join-leave-messages`	Meldet, wenn jemand den Server betritt oder verlässt
Tode	`death-messages`	Todesnachrichten aus dem Spiel
Fortschritte	`advancements`	Fortschritte, ab Minecraft 1.12
	`language`	Sprache der Nachrichten, die der Bot selbst schreibt
	`channel`	Verlegt den Chat in einen anderen Kanal

/server chat server: Survival death-messages: False

Nur im Dashboard gibt es:

Chat-Format: Nachrichten als Spieler mit Kopf und Namen, als Embed oder als einfache Zeile. Dazu eigene Vorlagen für Betreten, Verlassen, Tod und Fortschritt und ein Wortfilter.
Token: Ablaufdatum und eine Übergangsfrist beim Erneuern, in der der alte Token noch gilt.
Chatverlauf: die letzten Nachrichten des Kanals, direkt aus Discord geladen.

Start, Stopp, Ausfälle und den Wochenrückblick stellst du unter Meldungen ein.

Befehle im Spiel

Befehl	Wirkung
`/mcsync status`	Zeigt, ob die Verbindung steht, welche Befehle der Server annimmt und ob es ein Update gibt
`/mcsync reload`	Liest die Konfiguration neu. Der Token und einige Einstellungen brauchen weiterhin einen Neustart.
`/mcsync toggle`	Blendet den Discord-Chat nur für dich aus
`/mcsync link <code>`	Verknüpft dein Minecraft-Konto mit Discord, siehe Konten verknüpfen

status und reload brauchen die Permission mcsync.admin. Auf Fabric, Quilt, Forge und NeoForge darf sie, wer /kick darf. toggle und link darf jeder.

Verbindung trennen

Dashboard: „Verbindung & Chat“ → „Verbindung trennen“.
Discord: /server disconnect server: Survival.

Der Token wird dabei ungültig, der Server bleibt mit Adresse und öffentlicher Seite in der Liste. /server remove löscht auch den Server.

Probleme

Das Plugin meldet sich nicht

Prüf, ob der Token ohne Leerzeichen und vollständig in der Konfiguration steht.
Starte den Server nach dem Eintragen neu. /mcsync reload reicht für den Token nicht.
Der Server muss api.mc-sync.eu über HTTPS erreichen. Manche Hoster sperren ausgehende Verbindungen; frag dort nach.

Nachrichten aus Discord kommen im Spiel nicht an

Prüf, ob der Schalter „Chat“ an ist.
Der Bot muss den Kanal sehen dürfen („Kanal ansehen“).
Hat ein Spieler /mcsync toggle benutzt, sieht nur er den Discord-Chat nicht.

Nachrichten erscheinen als Embed statt mit Spielerkopf

Für Nachrichten im Namen des Spielers braucht der Bot im Kanal das Recht „Webhooks verwalten“. Ohne das Recht schreibt er als Embed. Gib es ihm in den Kanaleinstellungen von Discord unter „Berechtigungen“.

Der Kanal steht nicht zur Auswahl

Ein Kanal kann nur einen Server haben. Kanäle, die schon für etwas anderes eingetragen sind, fehlen in der Liste.

`/mcsync` gibt es nicht

Auf Forge vor Minecraft 1.19 hat die Mod den Befehl nicht. Ob die Verbindung steht, siehst du dort im Dashboard unter „Verbindung & Chat“.

Hintergrund: Wie der Chat ohne offenen Port durchkommt

Der Minecraft-Server baut selbst eine ausgehende HTTPS-Verbindung zum Bot auf und hält sie offen. Nachrichten aus Discord kommen über diese Verbindung. Bricht sie ab, fragt der Server jede Sekunde nach, bis sie wieder steht.

Ist Discord nicht erreichbar, warten Chat, Beitritte und Tode auf der Festplatte des Servers: in plugins/mc-sync/queue/ oder config/mc-sync-queue/. Sie überstehen auch einen Neustart. Wie lange sie warten, steht in der Konfiguration unter queue.*.