Anleitungen

Erste Schritte

Was sofort funktioniert, ohne den Minecraft-Server anzufassen — und wie man den Rest einrichtet.

Ein großer Teil des Bots braucht den Server gar nicht. Status, Diagramme, Bilder, Embeds und Sprachkanäle funktionieren über die öffentliche Adresse — dieselbe, mit der auch Spieler sich verbinden. Nur Chat, Whitelist und Befehle brauchen eine echte Verbindung ins Spiel.

1. Den Bot über invite.mc-sync.eu einladen und den Discord-Server auswählen.
2. /setup ausführen. Es fragt zuerst, was eingerichtet werden soll, dann genau eine Frage je Schritt.
3. /server add name: Survival address: deine-adresse.net registriert den Server einmal — /status, /embed, /voice-channel und /default-ip können ihn danach über den Namen ansprechen.
4. /language legt fest, in welcher Sprache der Bot antwortet.

/help zeigt dieselbe Übersicht in Discord, sortiert nach denselben Gruppen wie die Befehlsübersicht auf dieser Seite.

Die Serverliste

Ein Eintrag je Minecraft-Server — Adresse, Edition und Chat-Sync zusammen.

Vor /server war ein Minecraft-Server mehrere getrennte Dinge, die nichts voneinander wussten: eine Adresse, von Hand in /status, /embed und jeden Sprachkanal eingetippt, und ein mit /chat-sync add angelegter Chat-Sync, der von dieser Adresse nichts wusste. Ein Umzug auf eine neue Domain hieß, jede dieser Stellen zu suchen.

/server add name: Survival address: play.example.eu
/server settings server: Survival chat-sync: #minecraft - Survival
/server list

Beide Hälften bleiben freiwillig, und jede für sich ist ein echter Fall: ein Eintrag ohne Adresse ist ein Server, den man von außen nicht anpingen kann, einer ohne Chat-Sync ist ein Server ohne laufendes Plugin oder Mod. Der Bot funktioniert auch ohne Plugin — dann zeigt er genau das, was ein Ping hergibt.

settings ändert ein Feld nach dem anderen; clear entfernt einen einzelnen Eintrag (Adresse, Chat-Sync oder Edition), ohne den ganzen Server zu löschen. remove nimmt den Server nur von dieser Liste — ein verknüpfter Chat-Sync läuft unter seinem eigenen Namen weiter.

Chat-Synchronisation einrichten

Minecraft-Chat in einem Discord-Kanal und Discord-Nachrichten zurück ins Spiel — über das Plugin, ohne offenen Port.

Dafür braucht dein Server das MC-Sync-Plugin. Es baut die Verbindung von sich aus nach außen auf: eine gewöhnliche ausgehende HTTPS-Verbindung, die offen bleibt. Du musst keinen Port weiterleiten und keine Adresse hinterlegen.

1. Passende Datei herunterladen: mc-sync.eu/plugin. Es gibt eine je Loader und Versionsbereich.
2. Datei in den plugins-Ordner (Spigot, Paper) beziehungsweise mods (Fabric, Quilt, Forge, NeoForge) legen und den Server einmal neu starten. Dabei entsteht die Konfigurationsdatei.
3. In Discord /chat-sync add channel: #dein-kanal name: Survival ausführen. Der Bot antwortet mit einem Token — nur für dich sichtbar.
4. Token in die config.yml des Plugins eintragen und den Server erneut neu starten.

# plugins/MC-Sync/config.yml
token: "dein-token-aus-discord"

# Optional. poll ist der Rückfallweg für Netze, die lange
# Verbindungen abschneiden — sonst nicht nötig.
transport:
  mode: auto   # auto | poll

Was übertragen wird, entscheidest du danach einzeln. Alle Schalter liegen auf /chat-sync settings:

/chat-sync settings name: #minecraft - Survival death-messages: False
/chat-sync settings name: #minecraft - Survival channel: #minecraft-neu

Es gibt eine Datei je Loader und Versionsbereich. Welche davon du brauchst, entscheidet dein Server:

Befehle aus Discord ausführen

whitelist add, say oder kick aus Discord — über dieselbe Verbindung, die Chat-Sync schon benutzt.

Steht der Chat-Sync einmal, kann derselbe Weg auch Befehle tragen. Es braucht dafür weder einen offenen Port noch ein zusätzliches Passwort.

Zwei Fragen werden getrennt beantwortet, und das ist wichtig. Wer fragen darf, entscheidet Discord, je Rolle, unter /server-command permission. Was der Server annimmt, entscheidet die config.yml. Beides muss zusammenpassen.

/server-command permission add role: @Moderator commands: whitelist,say,kick
/server-command permission list
/server-command run command: whitelist add Notch

Auf der Serverseite entscheidet commands.mode, was überhaupt durchkommt:

# plugins/MC-Sync/config.yml
commands:
  mode: allow
  allow:
    - say
    - kick

Der Befehl wird ohne führenden Schrägstrich eingegeben. Beide Seiten antworten immer: Ein abgelehnter Befehl kommt als „abgelehnt" zurück statt als Stille — und, falls /alerts audit-channel gesetzt ist, auch als Zeile im Protokoll. Konsolenausgaben werden nicht übertragen — gemeldet wird, dass der Befehl gelaufen ist.

Whitelist-Kanal

Ein Kanal, in dem Spieler ihren Minecraft-Namen posten und der Bot sie freischaltet.

Statt dass jemand im Team jeden Namen von Hand eintippt, macht das der Bot: Er liest den Namen, prüft ihn bei Mojang und schaltet ihn über das Plugin frei. Ein nicht existierender Name wird nie weitergegeben.

/whitelist-channel add channel: #whitelist role: @Mitglied
/whitelist-channel list

mode entscheidet, was mit einem gültigen Namen passiert:

server legt fest, zu welchem registrierten Minecraft-Server (/server add) dieser Kanal freischaltet — weglassen, wenn es nur einen gibt. Ohne role darf jeder im Kanal einen Namen einreichen; bis zu drei Rollen grenzen das ein — etwa auf alle, die eine Bewerbung durchlaufen haben.

Embeds und Sprachkanäle

Zwei Wege, den Serverstatus sichtbar zu halten, ohne dass jemand einen Befehl ausführt.

Ein Embed ist eine Nachricht, die der Bot alle fünf Minuten neu schreibt. Sie bleibt an ihrer Stelle, statt den Kanal mit Wiederholungen zu füllen.

/embed add type: Status ip: play.example.eu channel: #server-info
/embed add type: Diagram ip: play.example.eu
/embed list
/embed remove embed: #server-info — status — play.example.eu

Ein Sprachkanal macht dasselbe über seinen Namen — oben in der Liste sichtbar, ohne dass jemand einen Kanal öffnet. Status, Spielerzahl und Version stehen zur Verfügung.

/voice-channel add type: Status ip: play.example.eu
/voice-channel add type: Players ip: play.example.eu

Für Sprachkanäle braucht der Bot „Kanäle verwalten", für Embeds das Recht, Nachrichten im Zielkanal zu senden und zu bearbeiten. Fehlt eines, sagt er das beim Anlegen. Beide akzeptieren auch server: statt ip:, um auf einen mit /server add registrierten Server zu zeigen.

Konten verknüpfen

Wer jemand in Discord ist, und wer er in Minecraft ist.

/link start gibt einen einmaligen Code aus. Im Minecraft-Chat als !link <code> eingegeben, belegt er beide Seiten auf einmal: den Code, weil er nur dir in Discord gezeigt wurde, und den Minecraft-Namen, weil er aus dem Spiel selbst kam.

1. /link start in Discord ausführen. Du bekommst einen zehn Minuten gültigen Code.
2. In Minecraft eingeben: !link <code>
3. Der Bot bestätigt die Verknüpfung in Discord.

Die Verknüpfung gilt je Discord-Server, in beide Richtungen, und ist mit /link remove wieder weg. Sie macht /role-sync erst möglich und verwandelt @Name im Minecraft-Chat in eine echte, klingelnde Erwähnung in Discord — für einen einzelnen, eindeutigen Namen, nie für @everyone oder @here.

Rollen, die ins Spiel reichen

Eine Discord-Rolle, die einen Befehl auslöst, sobald sie vergeben oder entzogen wird.

/role-sync add role: @VIP on-grant: lp user {player} parent add vip on-revoke: lp user {player} parent remove vip
/role-sync list

{player} wird durch den Minecraft-Namen ersetzt, der die Rolle bekommen oder verloren hat. Gespeichert wird nichts über ein bestimmtes Rechte-Plugin — nur der Befehl selbst, damit funktioniert es mit LuckPerms, PermissionsEx oder dem eigenen Rangsystem eines Servers gleichermaßen.

Meldungen und Protokoll

Wer von einem Ausfall erfährt, und wo Serverbefehle eine Spur hinterlassen.

Ein kurzer Aussetzer ist kein Ausfall — der Bot meldet sich erst nach 20 Minuten Stille und nimmt es zurück, sobald der Server wieder antwortet. /alerts role legt fest, wer dabei gepingt wird.

/alerts role role: @Team
/alerts audit-channel channel: #server-protokoll
/alerts console-channel channel: #server-fehler
/alerts notifications server-start: False server-stop: False

Wird role, audit-channel oder console-channel leer gelassen, schaltet das die jeweilige Meldung wieder ab. /alerts show listet alles, was gerade gesetzt ist.

Benachrichtigungen und Verlauf

Nachricht, sobald ein Server den Zustand wechselt — und was der Bot dabei mitschreibt.

/notification add beobachtet einen Server und schickt dir eine Direktnachricht, sobald er online oder offline geht. Das funktioniert für jeden erreichbaren Server, nicht nur für den eigenen.

/notification add ip: play.example.eu
/notification settings notification: play.example.eu | Java active: False
/notification delete notification: play.example.eu | Java

Nebenbei schreibt der Bot den Zustand der abgefragten Server alle dreißig Sekunden mit. Daraus entstehen /diagram und die Diagramm-Embeds. Ein Server, der heute zum ersten Mal abgefragt wurde, hat deshalb noch keinen Verlauf über eine Woche.

Rechte und Rollen

Wer welchen Befehl sieht, wer ihn ausführen darf, und wo das jeweils eingestellt wird.

Discord vergibt Rechte je Befehl, nicht je Unterbefehl. Daraus ergeben sich drei Fälle, markiert als Abzeichen bei jedem Befehl in der Übersicht.

Der Bot selbst braucht: Nachrichten senden und bearbeiten (Embeds), Kanäle verwalten (Sprachkanäle), Webhooks verwalten (/news-channel) und Nachrichten im Kanal des Chat-Syncs lesen. Fehlt etwas, sagt er während der Einrichtung, was.

Wenn etwas nicht funktioniert

Die Fälle, die am häufigsten im Support landen — und worauf sie meist zurückgehen.

Hilft nichts davon, ist der Support-Server der schnellste Weg. Loader und Minecraft-Version nennen, den ausgeführten Befehl und die Antwort des Bots — das klärt die meisten Fälle in einer einzigen Nachricht.