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.
5. Wer lieber klickt als tippt: dasselbe geht im Dashboard, mit Vorschau und Auswahllisten statt Befehlen.

• Bot einladenDiscord-Server auswählen, fertig
• Dashboard öffnenAnmeldung mit Discord
• Plugin oder Mod herunterladenEine Datei je Loader und Version

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

Das Dashboard

Alles, was die Slash-Befehle können — im Browser, mit Auswahllisten, Vorschau und ohne Tippfehler.

Das Dashboard ist dieselbe Einrichtung wie in Discord, nur von der anderen Seite betrachtet. Was hier geändert wird, gilt sofort dort, und umgekehrt — es gibt keine zweite Konfiguration, die man abgleichen müsste. Was es zusätzlich kann: hinsehen. Die Konsole mitlesen, den Verlauf der Spielerzahl als Diagramm, das Protokoll aller Änderungen, eine Vorschau eines Embeds, bevor es im Kanal steht.

1. mc-sync.eu/dashboard aufrufen und sich mit Discord anmelden.
2. Den Discord-Server auswählen. Angezeigt wird jeder, auf dem du das Recht „Server verwalten“ hast — fehlt der Bot auf einem davon, lässt er sich von dort aus einladen.
3. Links den Bereich wählen. Die Adresse dazu lautet /dashboard/<Discord-Server-ID>/<Bereich> und lässt sich als Lesezeichen ablegen.

• Dashboard öffnenAnmeldung mit Discord, Sitzung acht Stunden
• BeobachtungAusfallmeldungen — gehören dir, nicht einem Server

Die Bereiche in der linken Spalte, nach der Frage gruppiert, die sie beantworten:

Jeder dieser Bereiche hat weiter unten seinen eigenen Abschnitt. Die kürzesten Wege dorthin:

• Konsole, Knöpfe und Zeitpläne
• Chat-Synchronisation
• Embeds und Sprachkanäle
• Rechte und Rollen
• Das Protokoll
• Beobachtung und Statusseite

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.

Im Dashboard steht dieselbe Liste unter „Server“, mit denselben vier Feldern als Formular. Dort — und nur dort — wird ein Eintrag auch als öffentliche Statusseite freigegeben: /s/<name>, ohne Anmeldung erreichbar, dazu ein Abzeichen als SVG für eine README oder eine Forensignatur. Öffentlich sind Zustand, Spielerzahl, Version, Adresse und der Verlauf — nicht die Spielerliste, nicht dieser Discord-Server, nicht die Whitelist.

• Serverliste im DashboardServer wählen, dann „Server“
• Mehr zur Statusseite

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, Folia) 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 Konfiguration eintragen und den Server erneut neu starten. /mcsync status im Spiel sagt danach, ob die Verbindung steht.

# plugins/mc-sync/config.yml
api:
  token: "dein-token-aus-discord"

# Was passiert, wenn eine neuere Fassung erscheint:
# install (Voreinstellung) | notify | off
update:
  mode: install

# Die Live-Konsole im Dashboard. Solange niemand hinsieht,
# kostet sie nichts — kein Byte geht raus.
console:
  live: true

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

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

Im Dashboard liegen dieselben Schalter unter „Chat-Sync“, und drei Dinge kommen dort hinzu, die es als Slash-Befehl nicht gibt: das Chat-Format — wie eine Zeile in Discord aussieht (als Spieler über einen Webhook, als Kasten oder als schlichte Zeile), eigene Vorlagen für Beitritt, Abschied, Tod und Fortschritt, ein Wortfilter in beide Richtungen —, die Lebensdauer des Tokens mit Übergangsfrist und Ablaufdatum, und der Chatverlauf, direkt aus Discord gelesen.

• Chat-Sync im DashboardVerbindungen, Format, Token, Verlauf
• /chat-sync in der Befehlsübersicht

Im Spiel selbst bringt das Plugin /mcsync mit: status zeigt, ob die Verbindung steht und was der Server an Befehlen annimmt, reload liest die Konfiguration ohne Neustart neu, und toggle schaltet den Discord-Chat für einen selbst ab. Die ersten beiden verlangen das Recht mcsync.admin, toggle darf jeder — es ist die eigene Anzeige.

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 — das ist, was hier an die Stelle von RCON getreten ist.

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
    - whitelist add
    - lp user * parent add

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. Gibt der Server eine Konsolenausgabe zurück, steht sie in der Antwort; viele Befehle antworten allerdings nur im Spiel oder gar nicht, und dann bleibt sie leer.

Dasselbe geht im Dashboard, und dort mit Ausgabe: die Konsole zeigt, was der Server zurückmeldet, und wer gerade online ist.

• Konsole, Knöpfe und Zeitpläne
• /server-command in der Befehlsübersicht

Konsole, Knöpfe und Zeitpläne

Befehle ausführen und dabei zusehen — im Browser statt in einem Discord-Kanal.

Die Konsole im Dashboard nimmt denselben Weg wie /server-command run: dieselbe Verbindung, dieselbe Prüfung auf dem Minecraft-Server, dasselbe Protokoll. Was hinzukommt, ist die Ausgabe. Oben steht, was der Server über sich sagt — Begrüßung, Spielerzahl, Version —, darunter wer gerade spielt, dann das Konsolenfenster mit dem Befehlsfeld unmittelbar darin, ganz unten der Verlauf des zuletzt Ausgelösten.

1. Im Dashboard den Discord-Server öffnen und links „Konsole“ wählen.
2. Falls es mehrere gibt: den Minecraft-Server auswählen. Bei nur einem entfällt der Schritt.
3. Befehl eintippen — ohne führenden Schrägstrich — und abschicken. Die Pfeiltaste nach oben holt den vorigen zurück, ein Klick auf einen Spielernamen schreibt ihn ins Feld.

• Konsole öffnenServer wählen, dann „Konsole“

Die Live-Konsole zeigt, was der Minecraft-Server ausgibt, während er es ausgibt. Sie hängt an einem Schalter in der Konfiguration:

# plugins/mc-sync/config.yml
console:
  live: true

Zwei Dinge gibt es nur hier und nicht als Slash-Befehl:

• commands.mode und commands.allow
• Wer die Konsole öffnen darf

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.

Der Bereich „Whitelist“ im Dashboard zeigt, wer daraufsteht — mit dem Namen dessen, der ihn eingereicht hat, und samt denen, die jemand direkt auf dem Server eingetragen hat. Von dort geht auch das Umgekehrte: einen Namen eintragen oder entfernen, und mit „Liste einfügen“ eine ganze Namensliste auf einmal, ein Name je Zeile. Kommata, Semikola, Aufzählungsstriche und Anführungszeichen werden dabei weggeräumt.

• Whitelist im DashboardSuchen, eintragen, listenweise importieren
• /whitelist-channel in der Befehlsübersicht

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.

Im Dashboard heißt der Bereich „Anzeigen“ und führt beides an einer Stelle. Zwei Dinge kann er, die der Befehl nicht kann. Erstens die Vorschau: Art, Kanal und Server wählen, und darunter steht, wie das Embed im Kanal aussehen wird — vor dem Posten, nicht danach. Zweitens das Ändern: eine laufende Anzeige lässt sich umstellen, statt sie zu beenden und eine neue anzulegen. Beim Sprachkanal gehört dazu auch sein Name — eine Vorlage mit Platzhaltern wie {status} oder {players}, damit dort nicht auf ewig ein englischer Satz steht.

• Anzeigen im DashboardEmbeds und Sprachkanäle, mit Vorschau
• /embed in der Befehlsübersicht

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.

Der Bereich „Verknüpfungen“ im Dashboard zeigt alle auf einmal: welcher Discord-Name zu welchem Minecraft-Namen gehört, seit wann, wann er zuletzt gesehen wurde und welche Rollen-Sync-Regeln auf ihn greifen. Trennen lässt sich eine Verknüpfung dort ebenfalls — nützlich, wenn jemand seinen Minecraft-Account gewechselt hat.

• Verknüpfungen im DashboardAlle Konten, durchsuchbar
• Was daraus folgt: Rollen-Sync

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.

Im Dashboard steht dazu ein Formular mit Rollenauswahl und beiden Feldern nebeneinander, und darunter die Zeile, die auf dem Server tatsächlich laufen wird — mit eingesetztem Namen statt {player}. Fehlt der Platzhalter, sagt es das: ohne ihn läuft für jeden derselbe Befehl, was so gewollt sein kann, aber selten ist.

• Rollen-Sync im DashboardMit Vorschau des fertigen Befehls
• /role-sync in der Befehlsübersicht

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.

Im Dashboard stehen dieselben fünf Einstellungen unter „Alerts“ als ein Formular — Rolle und Kanäle als Auswahllisten, die vier Meldungen als Schalter. Wer eine Meldung sucht, die nicht Discord erreichen soll, sondern eine E-Mail, einen Webhook oder das Telefon, findet sie in der Beobachtung.

• Alerts im Dashboard
• Beobachtung: E-Mail, Webhook, Push

Beobachtung und Statusseite

Bescheid bekommen, wenn ein Server ausfällt — per E-Mail, Webhook, Push oder Discord. Und eine Seite, die den Zustand für alle zeigt.

Die Beobachtung gehört keinem Discord-Server, sondern dir. Sie braucht weder den Bot noch Rechte irgendwo — nur eine Anmeldung mit Discord. Du findest sie im Dashboard unter /dashboard/watch, als Kachel neben der Serverauswahl. Die Links aus den Meldungen selbst — bestätigen und abmelden — führen weiterhin ohne Anmeldung ans Ziel.

• Beobachtung einrichtenIm Dashboard, mit deinem Discord-Konto

Jede eingetragene Adresse wird jede Minute angepingt. Gemeldet wird erst, wenn sie die eingestellte Karenz lang nicht antwortet — ein kurzer Aussetzer beim Hoster ist damit kein Ausfall.

Gemeldet wird auf vier Wegen, mehrere gleichzeitig erlaubt: E-Mail, Webhook (Discord, Slack, ntfy, Gotify oder etwas Eigenes — nur über https), Push in diesen Browser und, wer angemeldet ist, als Discord-Direktnachricht. Jedem Weg lässt sich eine Verzögerung geben: er wird erst bedient, wenn die Sache so lange später immer noch gilt. Damit wird aus mehreren Wegen eine Eskalation statt vierfacher Post.

Die öffentliche Statusseite beantwortet die andere Hälfte der Frage: nicht „sag mir Bescheid“, sondern „sieh selbst nach“. Sie wird im Dashboard unter „Server“ freigegeben, bekommt einen Namen in der Adresse und steht danach unter /s/<name> — ohne Anmeldung, für jeden. Dazu gibt es ein Abzeichen als SVG, das sich in eine README oder eine Forensignatur einbetten lässt.

Nebenbei schreibt der Bot den Zustand der abgefragten Server alle dreißig Sekunden mit. Daraus entstehen /diagram, die Diagramm-Embeds und der Bereich „Statistiken“ im Dashboard — dort über 24 Stunden, 7 oder 30 Tage, mit Höchstwert und dem Anteil erreichbarer Abfragen. 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, wer ins Dashboard kommt — 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 der Chatstil „als Spieler“) und Nachrichten im Kanal des Chat-Syncs lesen. Fehlt etwas, sagt er während der Einrichtung, was.

Das Dashboard hat eine eigene, zweite Ebene davon. Wer den Discord-Server verwalten darf, hat dort ohnehin alles; unter „Zugriffsrechte“ lassen sich weitere Rollen freischalten, und zwar bereichsweise. Was dort steht, kann nur geben, nie nehmen.

• Zugriffsrechte im DashboardServer wählen, dann „Zugriffsrechte“
• Wer was getan hat: das Protokoll

Das Protokoll

Wer wann was geändert hat — und wie man es wiederfindet.

Das Protokoll hält jede Änderung fest: wer sie gemacht hat, wann, woran — und was abgelehnt wurde. Ein ausgeführter Konsolenbefehl steht darin ebenso wie ein erneuerter Token, eine gelöschte Verknüpfung oder ein Zugriff, den jemand ohne Recht versucht hat. Filtern lässt es sich nach Aktion, Zeitraum und Name; herunterladen als CSV.

• Das Protokoll im DashboardUnter „Verwaltung“ in der linken Spalte
• Wer was darf

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.

• Support-Server auf Discord
• Befehlsübersicht