Gibt es nur, wenn du den Bot deinem eigenen Discord-Konto hinzufügst (Installation als User-App). Dann funktioniert er in jedem Chat, auch in DMs und auf Servern ohne den Bot.
Ohne server zeigt er den Server, den du zuletzt abgefragt hast.
Beim Tippen werden die Server vorgeschlagen, die du zuletzt abgefragt hast.
In /help taucht er nicht auf, weil er nicht zur Installation auf dem Server gehört.
/embed add type: Server performance server: Survival
/embed list
/embed remove embed: #server-info — status — play.example.eu
Hinweise
Status: Erreichbarkeit, MOTD, Version und Spielerzahl. Whitelist: freigeschaltete Spieler (braucht das Plugin). Diagram: Spielerzahl im Verlauf. Player stats: Statistiken des verknüpften Chat-Syncs. Connection: Zustand des Chat-Syncs inkl. letztem Lebenszeichen. Server performance: TPS, Tickdauer und Arbeitsspeicher, wie das Plugin sie misst.
server wählt einen mit /server registrierten Server und übernimmt Adresse, Edition und Chat-Sync. Für nicht registrierte Server gibst du ip an.
Connection und Server performance gehen nur mit einem Server aus /server, der eine Verbindung hat. Server performance braucht außerdem MC-Sync 2.1.0 oder neuer mit eingeschaltetem performance.report.
Ohne channel wird das Embed im aktuellen Kanal erstellt. Der Bot braucht dort Rechte zum Senden und Bearbeiten von Nachrichten.
language gilt nur für dieses Embed. Standard ist deine Sprache aus /language.
/embed remove stoppt nur die Aktualisierung. Die Nachricht bleibt stehen und muss bei Bedarf manuell gelöscht werden.
Zeitraum: 24 Stunden, 7 Tage oder 30 Tage. Standard ist 24 Stunden.
Das Diagramm zeigt, was für diese Adresse aufgezeichnet wurde. Die erste Abfrage eines neuen Servers startet die Aufzeichnung, einen Verlauf gibt es dann noch nicht.
Im Dashboard unter „Statistiken“ gibt es denselben Verlauf, zusätzlich mit Höchstwert und Erreichbarkeit in Prozent.
Ohne ip wird der Server aus /default-ip genommen. Das geht nur auf einem Discord-Server.
Auch in DMs
Syntax
/image ip: <adresse> [type: <Server list entry|MOTD only|Icon only>]
Beispiele
/image ip: hypixel.net
/image ip: hypixel.net type: MOTD only
/image ip: play.example.eu type: Icon only
Hinweise
Ohne type bekommst du den ganzen Eintrag aus der Serverliste: Icon, Name, Spielerzahl und MOTD, so wie er in Minecraft aussieht.
Das MOTD wird wie im Spiel dargestellt, inklusive Farbcodes und Formatierung.
Der Server muss online sein. /image braucht immer eine Adresse, der Standard aus /default-ip gilt hier nicht.
Minecraft-IntegrationDiscord mit deinem Minecraft-Server verbinden
Nur Administratoren
Nur auf Discord-Servern
Syntax
/setup
Beispiele
/setup
Hinweise
Zuerst wählst du, was du einrichten willst: Chat-Sync, ein Live-Embed, einen Whitelist-Kanal, einen Status-Sprachkanal, die Ping-Rolle und Protokollkanäle für Meldungen, die Standard-Serveradresse oder eine Übersicht der aktuellen Einrichtung.
Beim Chat-Sync bekommst du einen Befehl mit Code für die Serverkonsole. Solange sich der Server noch nie gemeldet hat, gibt es darunter den Knopf „Token anzeigen (manuell)“.
Jeder Schritt ist eine Frage mit Auswahlmenü. Du brauchst keine Kanal-IDs und keine feste Reihenfolge.
Die Übersicht zeigt, was auf diesem Discord-Server eingerichtet ist. Praktisch, um zu prüfen, ob etwas gespeichert wurde.
Die gleichen Einstellungen findest du auch im Dashboard unter mc-sync.eu/dashboard.
add mit channel verbindet das Plugin gleich mit. connect macht dasselbe für einen Server, der schon in der Liste steht. Beide fragen zuerst nach deiner Zustimmung zu den Nutzungsbedingungen und zeigen dann den Befehl /mcsync connect mit einem Code, nur für dich. Mit method: token bekommst du stattdessen den Token.
Den Befehl führst du in der Konsole deines Minecraft-Servers aus. Der Code gilt 15 Minuten und nur einmal, das Plugin trägt den Token danach selbst ein. Den Token trägst du sonst unter api.token ein. Behandle ihn wie ein Passwort.
token gibt einen neuen Zugang aus, ebenfalls per Code oder mit method: token. Mit Code gilt der alte Token, bis der Code eingelöst ist. Ein neuer Token macht den alten sofort ungültig. Im Dashboard kannst du ihn auch mit Übergangsfrist erneuern.
chat ohne Schalter zeigt die aktuellen Chat-Einstellungen. Was der Bot von sich aus postet, etwa Start, Stopp oder Ausfälle, stellst du mit /notices ein.
address und channel sind optional. Ohne Adresse lässt sich der Server von außen nicht anpingen. Ohne Verbindung läuft er ohne Plugin, nur mit den Daten, die ein Ping liefert.
clear entfernt Adresse oder Edition, ohne den Server zu löschen. disconnect entfernt nur die Verbindung, remove löscht den Server samt Verbindung.
In /embed, /whitelist-channel und /notices wählst du einen registrierten Server aus, statt die Adresse einzutippen.
require-link: True in chat lässt nur Spieler mit verknüpftem Konto auf den Server. Die anderen werden beim Betreten abgewiesen und bekommen einen Code für /link code.
event-images schickt Tode und Fortschritte als Bild statt als Zeile, mit design: toast, card, scene oder minimal, je Ereignis. Ohne event zeigt es die Einstellungen mit zwei Knöpfen für eine Vorschau mit deinem Skin.
discord-command stellt ein, was Spieler im Spiel mit /discord bekommen. Ohne invite-url legt der Bot selbst eine Einladung für den Chatkanal an, dafür braucht er dort „Einladung erstellen“.
Server und ihre Verbindungen verwaltest du jetzt an einer Stelle, unter /server. Die Unterbefehle hier ändern nichts mehr, sie sagen nur, was an ihre Stelle getreten ist.
add → /server add mit channel oder /server connect · list → /server list · settings → /server chat · token → /server token · remove → /server disconnect oder /server remove · guide → /server guide
permission add, remove und list können nur Administratoren nutzen.
Ohne server wird die Verbindung des aktuellen Kanals genutzt, sonst die einzige auf dem Discord-Server. Gibt es mehrere, listet der Bot sie auf, und du wählst mit server eine aus.
Jeder Aufruf, auch abgelehnte Versuche, landet im Befehlsprotokoll. Den Kanal dafür legst du mit /notices channel purpose: commands fest.
kategorie: playtime, sessions, kills (Spieler-Kills), mobkills oder deaths. Ohne Angabe zählt die Spielzeit.
zeitraum: 7d, 30d oder all, Standard ist 7d. Spielzeit und Sitzungen je Zeitraum stammen aus den Sitzungen, die MC-Sync seit dem Plugin-Update erfasst.
Kills, Mob-Kills und Tode gibt es nur als Gesamtwerte aus den Statistikdateien des Servers. Bei 7d oder 30d zeigt der Bot den Gesamtwert und sagt das dazu.
Ohne server wird der Server des aktuellen Kanals verwendet, sonst der einzige auf dem Discord-Server. Die Antwort sehen alle im Kanal.
Nur auf Discord-Servern
Syntax
/player name: <name>
/player name: <name> server: <server>
Beispiele
/player name: Notch
/player name: Notch server: Survival
Hinweise
Zeigt Kopf und Figur, ob der Spieler online ist oder wann er zuletzt da war, Spielzeit, Tode, Kills, seinen ersten Besuch und, wenn er verknüpft ist, sein Discord-Konto auf diesem Discord-Server.
Darunter stehen die Knöpfe Statistiken und Fortschritte, aus der Spielerdatei und auch für Spieler, die gerade nicht online sind. Inventar und Endertruhe gibt es mit dem Dashboard-Recht „Inventare ansehen“: live, solange der Spieler online ist, sonst der gespeicherte Stand. Alle Bilder siehst nur du.
Ohne server wird der Server des aktuellen Kanals verwendet, sonst der einzige auf dem Discord-Server. Die Antwort sehen alle im Kanal.
Jeder Name wird zuerst bei Mojang geprüft. Bei einem ungültigen Namen antwortet der Bot kurz und trägt nichts ein.
mode legt fest, was mit gültigen Namen passiert: über das Plugin zur Whitelist hinzufügen (Standard) oder nur prüfen, wenn ihr selbst freischalten wollt.
applications: True stellt einen Knopf „Bewerben“ in den Kanal, statt bloße Namen anzunehmen. Spieler füllen ein Formular aus, und ein Moderator nimmt jede Bewerbung an oder lehnt sie ab.
server legt fest, für welchen registrierten Server (/server add) der Kanal gilt. Bei nur einem Server kannst du es leer lassen.
Ohne role kann jeder im Kanal einen Namen einreichen. Mit bis zu drei Rollen kannst du das einschränken.
Wer -Name in den Kanal schreibt, nimmt den Namen wieder von der Whitelist. Das darf, wer ihn eingetragen hat, und wer den Server verwaltet. Verlässt ein Mitglied den Discord-Server, werden die Namen, die es eingetragen hat, ebenfalls entfernt.
/default-ip set ip: play.example.eu edition: Bedrock
/default-ip show
Hinweise
Gilt für den ganzen Discord-Server, nicht pro Person.
Wird von /status und /diagram genutzt, wenn keine Adresse angegeben ist.
Geht auch im Dashboard unter „Server“. Dort kannst du die Adresse direkt aus deiner Serverliste übernehmen.
Nur auf Discord-Servern
Syntax
/emoji-pack [version:]
Beispiele
/emoji-pack
/emoji-pack version: 1.20.4
/emoji-pack version: 1.8.9
Hinweise
Läuft mit jeder Version ab 1.6.1. Wähl die Version, mit der ihr spielt, dann bekommt das Paket das passende Format.
Damit Emojis aus Discord im Spiel als Bilder erscheinen, schalte im Dashboard unter Chat-Sync → Format „Emojis als Bilder“ ein.
Animierte Emojis bewegen sich ab Minecraft 1.21.9, davor sind sie ein Standbild. Wer das Paket nicht hat, sieht ab Minecraft 1.19.4 weiter :name:. Das Paket wird bei jedem Aufruf frisch gebaut und nicht gespeichert.
Nur auf Discord-Servern
Syntax
/link start
/link code code: <code>
/link show
/link remove
Beispiele
/link start
/link code code: H7K2QW
/link show
Hinweise
start gibt dir einen Code. Gib im Minecraft-Chat !link <code> ein, um die Verknüpfung abzuschließen.
code löst den Code ein, den der Minecraft-Server beim Betreten zeigt, wenn dort nur verknüpfte Konten mitspielen dürfen. Danach kannst du direkt beitreten.
Der Code ist 10 Minuten gültig und wird nie nach Discord weitergeleitet, auch nicht bei einem Fehlversuch.
Wird für /role-sync, für /profile ohne Namen und für echte @Erwähnungen aus dem Spielchat benötigt.
Die Verknüpfung gilt pro Discord-Server. Auf jedem Server musst du dich einzeln verknüpfen.
Ohne server gilt eine Einstellung als Vorgabe für alle Server. Mit server gilt sie nur für diesen einen, und was ein Server nicht selbst einstellt, erbt er von der Vorgabe. reset: True entfernt die eigene Einstellung eines Servers wieder.
Die Meldungen: server-start, server-stop, connection (Verbindung weg und wieder da), tps, delivery (nicht zugestellte Nachrichten), console, rank-role-blocked, token-leaked und weekly-recap. token-leaked lässt sich nicht abschalten.
Ab Werk ist alles an außer tps. Eingeschaltet warnt tps, wenn der Server länger als fünf Minuten unter der Schwelle liegt (Standard 15).
Eine abgebrochene Verbindung wird erst nach 20 Minuten ohne Kontakt gemeldet. Ab Werk pingt sie die Rolle aus ping-role, ebenso eine Rang-Rolle, die der Bot nicht vergeben kann. delivery und console pingen nie.
channel legt fest, wohin welche Art von Nachricht geht: events (Beitritte, Tode, Fortschritte), notices, reports (etwa der Wochenrückblick), console und commands (jedes /server-command run, auch abgelehnte). Ohne Kanal gehen events, notices und reports in den Chatkanal des Servers, console und commands werden gar nicht gepostet.
Den Chat selbst und welche Ereignisse darin erscheinen, stellst du mit /server chat ein. show listet, was gerade gilt, und markiert, was auf dieser Ebene eingestellt ist.
Alles aus /alerts steht jetzt unter /notices, zusammen mit den Meldungsschaltern, die vorher in den Chat-Einstellungen lagen. Die Unterbefehle hier ändern nichts mehr, sie sagen nur, was an ihre Stelle getreten ist.
role → /notices ping-role · audit-channel → /notices channel purpose: commands · console-channel → /notices channel purpose: console · notifications → /notices set · show → /notices show
Jede Person hat ein Budget für Fragen, das sich jeden Tag erneuert. Unter jeder Antwort zeigt der Bot, wie viel noch übrig ist.
Fragen dürfen bis zu 300 Zeichen lang sein, nach einer Stimme mit /vote bis zu 600. Eine Stimme füllt außerdem dein Budget auf.
Fragt der Bot zurück, stehen die möglichen Antworten als Knöpfe unter der Nachricht.
Antworten können falsch sein. Bei versionsabhängigen Details lieber im Wiki nachschauen.
Auch in DMs
Syntax
/minecraft-info info-to: <thema>
Beispiele
/minecraft-info info-to: Java Edition 1.21.4
/minecraft-info info-to: Redstone
Hinweise
Die Daten stammen aus einer Kopie des Minecraft-Wikis, die jede Woche aktualisiert wird. Beim Tippen werden passende Themen vorgeschlagen.
Auch in DMs
Syntax
/mc loot source: <beutetabelle>
/mc drops item: <gegenstand>
/mc trades profession: <beruf>
/mc structure name: <bauwerk>
/mc potion name: <trank>
/mc mob name: <kreatur>
Beispiele
/mc loot source: chests/village/village_armorer
/mc drops item: ender_pearl
/mc trades profession: librarian
/mc structure name: igloo/top
/mc potion name: strong_swiftness
/mc mob name: creeper
Hinweise
Jedes Feld schlägt beim Tippen passende Einträge vor. Nimm einen aus der Liste, die Kennungen tippt man leicht falsch.
loot zeigt, was eine Kreatur, ein Block oder eine Truhe fallen lässt, mit der Chance je Eintrag. drops geht den umgekehrten Weg: welche Beutetabellen einen Gegenstand fallen lassen.
trades listet die Angebote eines Dorfbewohner-Berufs je Stufe. structure zeigt Größe, Hauptmaterialien und ein Bild, potion die Effekte und Braustufen, mob Leben, Angriffsschaden, XP, Hitbox und wo die Kreatur spawnt.
Die Daten kommen von mc-api, das sie aus den Spieldateien von Minecraft liest. Lange Tabellen werden gekürzt, und die Antwort sagt, wie viele Zeilen zu sehen sind.
Die Antwort sehen alle im Kanal.
Auch in DMs
Syntax
/skin username: <name>
/skin username: <name> type: <darstellung>
Beispiele
/skin username: Notch
/skin username: Notch type: isometric
Hinweise
type wählt die Darstellung: full (Standard), isometric, bust, face, head, body, avatar oder skin, dazu die Posen, die mc-api anbietet. Alle werden beim Tippen vorgeschlagen.
Geht nur mit Java-Namen. Bedrock-Konten haben keinen Skin bei Mojang.
Nur auf Discord-Servern
Syntax
/profile
/profile user: <@mitglied>
/profile player: <name|UUID>
Beispiele
/profile
/profile user: @Steve
/profile player: Notch
Hinweise
Ohne Angabe zeigt er dein eigenes Konto, verknüpft mit /link start. user zeigt das verknüpfte Konto eines anderen Mitglieds dieses Discord-Servers, player einen beliebigen Java-Namen oder eine UUID, auch ohne Verknüpfung.
Du bekommst UUID, ein 3D-Render, die Namenshistorie, Capes und wie selten sie sind.
Die Namenshistorie ist das, was mc-api selbst beobachtet hat, seit das Konto zum ersten Mal nachgeschlagen wurde. Mojang veröffentlicht seit 2022 keine Namenshistorien mehr, ein einzelner Name heißt also nicht, dass der Spieler nie anders hieß.
Bedrock-Konten haben kein Profil bei Mojang, für sie gibt es deshalb nichts zu zeigen.
