Guides

Premiers pas

Ce qui fonctionne immédiatement sans toucher à ton serveur Minecraft — et comment configurer le reste.

Une grande partie du bot n'a besoin de ton serveur pour rien. Statut, graphiques, images, embeds et salons vocaux fonctionnent depuis l'adresse publique — la même que celle utilisée par les joueurs. Seuls le chat, la liste blanche et les commandes nécessitent un vrai lien vers le jeu.

1. Invite le bot via invite.mc-sync.eu et choisis ton serveur Discord.
2. Lance /setup. Il demande d'abord ce que tu veux configurer, puis pose exactement une question par étape.
3. /server add name: Survival address: ton-adresse.net enregistre ton serveur une fois — /status, /embed, /voice-channel et /default-ip peuvent ensuite l'utiliser par son nom.
4. /language définit la langue dans laquelle le bot te répond.
5. Si tu préfères cliquer que taper : le tableau de bord fait la même chose, avec aperçus et listes déroulantes au lieu de commandes.

• Inviter le botChoisis ton serveur Discord, c'est tout
• Ouvrir le tableau de bordConnexion avec Discord
• Télécharger le plugin ou le modUn fichier par loader et par version

/help affiche le même aperçu dans Discord, classé dans les mêmes groupes que la référence des commandes sur ce site.

Le tableau de bord

Tout ce que font les commandes — dans le navigateur, avec des listes déroulantes, un aperçu et sans faute de frappe.

Le tableau de bord, c'est la même configuration que dans Discord, vue de l'autre côté. Ce que tu changes ici vaut là-bas immédiatement, et inversement — il n'y a pas de seconde configuration à tenir à jour. Ce qu'il ajoute, c'est de voir : lire la console en direct, l'évolution du nombre de joueurs en graphique, le journal de chaque modification, un aperçu d'un embed avant qu'il ne soit dans le salon.

1. Ouvre mc-sync.eu/dashboard et connecte-toi avec Discord.
2. Choisis le serveur Discord. Chaque serveur où tu as la permission « Gérer le serveur » apparaît — et là où le bot manque, tu peux l'inviter depuis cet écran.
3. Choisis une section à gauche. Son adresse est /dashboard/<id-du-serveur>/<section> et peut se mettre en favori.

• Ouvrir le tableau de bordConnexion Discord, session de huit heures
• SurveillanceAlertes de panne — les tiennes, pas celles d'un serveur

Les sections de la colonne de gauche, regroupées par la question à laquelle elles répondent :

Chacune a sa propre section plus bas. Les chemins les plus courts :

• Console, boutons et horaires
• Synchronisation du chat
• Embeds et salons vocaux
• Permissions et rôles
• Le journal
• Surveillance et page d'état

La liste des serveurs

Une entrée par serveur Minecraft — adresse, édition et chat sync réunis.

Avant /server, un serveur Minecraft était plusieurs choses séparées que rien ne reliait : une adresse tapée à la main dans /status, /embed et chaque salon vocal, et un chat sync créé avec /chat-sync add qui ne savait rien de cette adresse. Déménager vers un nouveau domaine voulait dire retrouver chacun de ces endroits.

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

Les deux moitiés restent facultatives, et chacune seule est un cas réel : une entrée sans adresse est un serveur qu'on ne peut pas pinguer de l'extérieur, une sans chat sync est un serveur sans plugin ni mod en marche. Le bot fonctionne aussi sans plugin — il affiche alors exactement ce que donne un ping.

settings modifie un champ à la fois ; clear retire une seule entrée (adresse, chat sync ou édition) sans supprimer tout le serveur. remove retire seulement le serveur de cette liste — un chat sync associé continue de tourner sous son propre nom.

Le tableau de bord porte la même liste sous « Serveurs », avec les mêmes quatre champs sous forme de formulaire. C'est là — et seulement là — qu'une entrée se publie aussi en page d'état publique : /s/<nom>, accessible sans connexion, plus un badge SVG pour un README ou une signature de forum. Sont publics l'état, le nombre de joueurs, la version, l'adresse et l'historique — pas la liste des joueurs, pas le serveur Discord derrière, pas la liste blanche.

• Liste des serveurs dans le tableau de bordChoisis un serveur, puis « Serveurs »
• En savoir plus sur la page d'état

Configurer la synchronisation du chat

Le chat Minecraft dans un salon Discord et les messages Discord de retour dans le jeu — via le plugin, sans port ouvert.

Cela demande le plugin MC-Sync sur ton serveur. Il ouvre lui-même la connexion vers l'extérieur : une requête HTTPS sortante ordinaire qui reste ouverte. Aucune redirection de port, aucune adresse à déclarer.

1. Télécharger le fichier adapté : mc-sync.eu/plugin. Il y en a un par loader et par plage de versions.
2. Le placer dans plugins (Spigot, Paper, Folia) ou mods (Fabric, Quilt, Forge, NeoForge) et redémarrer le serveur une fois. Cela crée le fichier de configuration.
3. Dans Discord, lancer /chat-sync add channel: #ton-salon name: Survie. Le bot répond avec un token, visible par toi seul.
4. Mettre le jeton dans la configuration et redémarrer le serveur à nouveau. /mcsync status dans le jeu dit ensuite si la connexion tient.

# plugins/mc-sync/config.yml
api:
  token: "ton-jeton-de-discord"

# Ce qui se passe quand une version plus récente sort :
# install (par défaut) | notify | off
update:
  mode: install

# La console en direct du tableau de bord. Tant que
# personne ne regarde, elle ne coûte rien.
console:
  live: true

Ce qui est transmis se règle ensuite, option par option, sur /chat-sync settings :

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

Le tableau de bord porte les mêmes interrupteurs sous « Synchro du chat », et y ajoute trois choses qu'aucune commande n'offre : le format du chat — à quoi ressemble une ligne dans Discord (comme le joueur via un webhook, en encadré ou en ligne simple), tes propres modèles pour l'arrivée, le départ, la mort et le progrès, et un filtre de mots dans les deux sens —, la durée de vie du jeton avec délai de transition et date d'expiration, et l'historique du chat, lu directement dans Discord.

• Synchro du chat dans le tableau de bordConnexions, format, jeton, historique
• /chat-sync dans la référence

Dans le jeu, le plugin apporte /mcsync : status montre si la connexion tient et quelles commandes le serveur accepte, reload relit la configuration sans redémarrage, et toggle coupe le chat Discord pour soi-même. Les deux premières demandent la permission mcsync.admin ; toggle est ouverte à tous — c'est son propre affichage.

Il existe un fichier par loader et par plage de versions. Celui dont tu as besoin dépend de ton serveur :

Exécuter des commandes depuis Discord

whitelist add, say ou kick depuis Discord — par la même connexion que le chat sync utilise déjà.

Une fois le chat sync en place, le même canal peut porter des commandes. Ni port ouvert, ni mot de passe supplémentaire nécessaires — c'est ce qui a pris ici la place de RCON.

Deux questions sont tranchées séparément, et c'est important. Qui a le droit de demander se règle sur Discord, par rôle, via /server-command permission. Ce que ton serveur accepte se règle dans config.yml. Les deux doivent concorder.

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

Côté serveur, commands.mode décide de ce qui passe :

# plugins/mc-sync/config.yml
commands:
  mode: allow
  allow:
    - say
    - whitelist add
    - lp user * parent add

La commande se saisit sans le slash initial. Les deux côtés répondent toujours : une commande rejetée revient comme « rejetée » plutôt que par un silence — et, si /alerts audit-channel est réglé, aussi comme une ligne dans le journal. Si le serveur renvoie une sortie console, elle figure dans la réponse ; beaucoup de commandes ne répondent cependant que dans le jeu, ou pas du tout, et elle reste alors vide.

La même chose se fait depuis le tableau de bord, et là avec la sortie : la console montre ce que le serveur renvoie, et qui est connecté.

• Console, boutons et horaires
• /server-command dans la référence

Console, boutons et horaires

Exécuter des commandes et voir le résultat — dans le navigateur plutôt que dans un salon Discord.

La console du tableau de bord emprunte le même chemin que /server-command run : la même connexion, la même vérification sur le serveur Minecraft, le même journal. Ce qu'elle ajoute, c'est la sortie. En haut, ce que le serveur dit de lui-même — accueil, nombre de joueurs, version —, en dessous qui joue, puis la fenêtre de console avec le champ de commande à l'intérieur, et tout en bas l'historique de ce qui a été lancé.

1. Ouvre ton serveur Discord dans le tableau de bord et choisis « Console » à gauche.
2. S'il y en a plusieurs : choisis le serveur Minecraft. Avec un seul, l'étape disparaît.
3. Saisis la commande — sans le slash initial — et envoie-la. La flèche du haut rappelle la précédente, et un clic sur le nom d'un joueur l'écrit dans le champ.

• Ouvrir la consoleChoisis un serveur, puis « Console »

La console en direct montre ce que le serveur Minecraft écrit, pendant qu'il l'écrit. Elle tient à un interrupteur dans la configuration :

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

Deux choses n'existent qu'ici et pas en commande :

• commands.mode et commands.allow
• Qui peut ouvrir la console

Salon de liste blanche

Un salon où les joueurs postent leur nom Minecraft et le bot les ajoute à la liste blanche.

Plutôt que quelqu'un de l'équipe tape chaque nom à la main, c'est le bot qui s'en charge : il lit le nom, le vérifie auprès de Mojang et l'ajoute à la liste blanche via le plugin. Un nom qui n'existe pas n'est jamais transmis.

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

mode décide de ce qui arrive à un nom valide :

server choisit à quel serveur Minecraft enregistré (/server add) ce salon donne accès — à omettre s'il n'y en a qu'un. Sans role, n'importe qui dans le salon peut soumettre un nom ; jusqu'à trois rôles permettent de restreindre cela — à tous ceux qui ont passé une candidature, par exemple.

La section « Liste blanche » du tableau de bord montre qui y figure — avec le nom de celui qui l'a soumis, et y compris les noms saisis directement sur le serveur. L'inverse s'y fait aussi : ajouter ou retirer un nom, et avec « Coller une liste » une liste entière d'un coup, un nom par ligne. Virgules, points-virgules, puces et guillemets sont nettoyés au passage.

• Liste blanche dans le tableau de bordChercher, ajouter, importer des listes
• /whitelist-channel dans la référence

Embeds et salons vocaux

Deux façons de garder l'état du serveur visible sans que personne exécute de commande.

Un embed est un message que le bot réécrit toutes les cinq minutes. Il reste à sa place au lieu de remplir le salon de répétitions.

/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

Un salon vocal fait la même chose dans son nom — visible en haut de la liste sans que personne n'ouvre de salon. Statut, nombre de joueurs et version sont disponibles.

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

Pour les salons vocaux, le bot a besoin de « Gérer les salons », et pour les embeds, de la permission d'envoyer et modifier des messages dans le salon cible. S'il en manque une, il le signale à la création. Les deux acceptent aussi server: au lieu de ip: pour viser un serveur enregistré avec /server add.

Dans le tableau de bord, la zone s’appelle « Affichages » et réunit les deux au même endroit. Elle sait faire deux choses que la commande ne sait pas. D’abord l’aperçu : choisis le type, le salon et le serveur, et en dessous s’affiche à quoi ressemblera l’embed dans le salon — avant la publication, pas après. Ensuite la modification : un affichage en cours peut être changé au lieu d’être arrêté puis recréé. Pour un salon vocal, cela vaut aussi pour son nom : un modèle avec des espaces réservés comme {status} ou {players}, pour qu’il ne reste pas coincé sur une phrase anglaise.

• Affichages dans le tableau de bordEmbeds et salons vocaux, avec aperçu
• /embed dans la référence

Relier les comptes

Qui est quelqu'un sur Discord, et qui il est sur Minecraft.

/link start affiche un code à usage unique. Tapé dans le chat Minecraft sous la forme !link <code>, il prouve les deux côtés à la fois : le code, parce qu'il ne t'a été montré qu'à toi sur Discord, et le nom Minecraft, parce qu'il vient du jeu lui-même.

1. Lance /link start sur Discord. Tu reçois un code valable dix minutes.
2. Dans Minecraft, tape : !link <code>
3. Le bot confirme le lien sur Discord.

Le lien est propre à chaque serveur Discord, dans les deux sens, et disparaît avec /link remove. C'est ce qui rend /role-sync possible, et ce qui transforme @Nom écrit dans le chat Minecraft en une vraie mention, avec notification, sur Discord — pour un nom unique et sans ambiguïté, jamais pour @everyone ou @here.

La section « Comptes liés » du tableau de bord les montre tous d'un coup : quel nom Discord correspond à quel nom Minecraft, depuis quand, quand il a été vu pour la dernière fois et quelles règles de role sync le concernent. Un lien peut aussi y être coupé — utile quand quelqu'un a changé de compte Minecraft.

• Comptes liés dans le tableau de bordTous les comptes, avec recherche
• Ce que cela rend possible : role sync

Des rôles qui vont jusque dans le jeu

Un rôle Discord qui déclenche une commande dès qu'il est attribué ou retiré.

/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} est remplacé par le nom Minecraft de la personne qui a reçu ou perdu le rôle. Rien n'est enregistré au sujet d'un plugin de permissions particulier — seulement la commande elle-même, ce qui fonctionne aussi bien avec LuckPerms, PermissionsEx ou le système de rangs propre à un serveur.

Le tableau de bord l'entoure d'un formulaire, avec un sélecteur de rôle et les deux champs côte à côte, et en dessous la ligne qui s'exécutera réellement sur le serveur — avec le nom mis à la place de {player}. Si le marqueur manque, il le dit : sans lui, la même commande s'exécute pour tout le monde, ce qui peut être voulu mais l'est rarement.

• Synchro des rôles dans le tableau de bordAvec un aperçu de la commande finale
• /role-sync dans la référence

Alertes et journal d'audit

Qui est prévenu d'une panne, et où les commandes serveur laissent une trace.

Une brève reconnexion n'est pas une panne — le bot ne s'exprime qu'après 20 minutes de silence, et se rétracte dès que le serveur répond à nouveau. /alerts role décide qui est pingé quand cela arrive.

/alerts role role: @Staff
/alerts audit-channel channel: #journal-serveur
/alerts console-channel channel: #erreurs-serveur
/alerts notifications server-start: False server-stop: False

Laisser role, audit-channel ou console-channel vide désactive à nouveau cette alerte. /alerts show liste tout ce qui est actuellement réglé.

Le tableau de bord réunit les mêmes cinq réglages sous « Alertes » en un seul formulaire — rôle et salons en listes déroulantes, les quatre signalements en interrupteurs. Qui veut une alerte qui ne passe pas par Discord mais par un e-mail, un webhook ou le téléphone la trouvera dans la surveillance.

• Alertes dans le tableau de bord
• Surveillance : e-mail, webhook, push

Surveillance et page d'état

Être prévenu d'une panne par e-mail, webhook, push ou Discord. Et une page qui montre l'état à tout le monde.

La surveillance t'appartient, elle n'appartient pas à un serveur Discord. Elle n'a besoin ni du bot ni de permissions où que ce soit — seulement que tu te connectes avec Discord. Tu la trouves dans le tableau de bord, sous /dashboard/watch, sous forme de tuile à côté du sélecteur de serveurs. Les liens des e-mails eux-mêmes — confirmer et se désabonner — fonctionnent toujours sans connexion.

• Mettre en place la surveillanceDans le tableau de bord, avec ton compte Discord

Chaque adresse enregistrée est pingée toutes les minutes. Rien n'est signalé tant qu'elle n'est pas restée muette pendant le délai de grâce que tu as réglé — de quoi éviter qu'un hoquet passager de l'hébergeur ne compte comme une panne.

Les alertes partent par quatre voies, plusieurs à la fois autorisées : e-mail, webhook (Discord, Slack, ntfy, Gotify ou quelque chose à toi — en https uniquement), push dans ce navigateur et, si tu es connecté, en message privé Discord. Chaque voie peut recevoir un délai : elle n'est servie que si l'affaire tient toujours après ce temps-là. Plusieurs voies deviennent ainsi une escalade au lieu de quatre copies du même message.

La page d'état publique répond à l'autre moitié de la question : non pas « préviens-moi », mais « va voir toi-même ». Elle se publie dans le tableau de bord sous « Serveurs », reçoit un nom dans l'adresse et vit ensuite sous /s/<nom> — sans connexion, ouverte à tous. Elle vient avec un badge SVG prêt à intégrer dans un README ou une signature de forum.

Au passage, le bot enregistre l’état de chaque serveur interrogé toutes les trente secondes. C’est de là que viennent /diagram, les embeds de graphique et la zone « Statistiques » du tableau de bord — là sur 24 heures, 7 ou 30 jours, avec le maximum et la part de requêtes joignables. Un serveur interrogé aujourd’hui pour la première fois n’a donc pas encore d’historique sur une semaine.

Permissions et rôles

Qui voit quelle commande, qui peut l'exécuter, qui entre dans le tableau de bord — et où chacun de ces réglages se fait.

Discord attribue les permissions par commande, pas par sous-commande. Cela produit trois cas, indiqués par des badges sur chaque commande de la référence.

Le bot lui-même a besoin de : envoyer et modifier des messages (embeds), gérer les salons (salons vocaux), gérer les webhooks (/news-channel et le style de chat « comme le joueur ») et lire les messages dans le salon du chat sync. S'il manque quelque chose, il dit quoi pendant la configuration.

Le tableau de bord a sa propre seconde couche. Qui peut gérer le serveur Discord y a de toute façon tous les droits ; sous « Droits d'accès », d'autres rôles s'ouvrent, domaine par domaine. Ce qui y figure ne peut que donner, jamais retirer.

• Droits d'accès dans le tableau de bordChoisis un serveur, puis « Droits d'accès »
• Qui a fait quoi : le journal

Le journal

Qui a changé quoi et quand — et comment le retrouver.

Le journal retient chaque modification : qui l'a faite, quand, sur quoi — et ce qui a été refusé. Une commande de console exécutée y figure, tout comme un jeton renouvelé, un lien coupé ou un accès tenté sans permission. Il se filtre par action, par période et par nom, et se télécharge en CSV.

• Le journal dans le tableau de bordSous « Administration » dans la colonne de gauche
• Qui peut quoi

Quand quelque chose ne fonctionne pas

Les cas qui reviennent le plus souvent au support — et à quoi ils tiennent généralement.

Si rien de tout cela n'aide, le serveur de support est le moyen le plus rapide. Mentionne le loader et la version de Minecraft, la commande exécutée et ce qu'a répondu le bot — cela règle la plupart des cas en un seul message.

• Serveur de support sur Discord
• Référence des commandes