Fonctionnalités

Synchro du chat

Envoie le chat Minecraft dans un salon Discord et les messages du salon dans le jeu.

La synchro du chat relie un salon Discord au chat de ton serveur Minecraft. Pour cela, le plugin ou le mod MC-Sync tourne sur le serveur. Tu n'as pas besoin d'ouvrir de port.

Configurer

Récupère le fichier pour ton serveur sur la page de téléchargement.
Place-le dans le dossier plugins (Spigot, Paper, Folia) ou dans le dossier mods (Fabric, Quilt, Forge, NeoForge) et démarre le serveur. Cela crée la config.
Relie le serveur à un salon Discord :

Dans le tableau de bord, ouvre « Serveurs », puis ton serveur. S'il n'y est pas, ajoute-le avec « Ajouter un serveur ».
Ouvre l'onglet « Connexion et chat ».
Choisis le salon de chat.
Accepte les conditions et clique sur « Connecter et créer le jeton ».

Lance /server add name: Survival channel: #minecraft. Si le serveur est déjà dans la liste, utilise /server connect server: Survival channel: #minecraft.
Clique sur « Accepter et connecter ». Le bot affiche le jeton une seule fois, et à toi seul.

Mets le jeton dans la config et redémarre le serveur.

yaml

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

properties

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

Écris un message en jeu. Il apparaît dans le salon Discord au bout de quelques secondes.

Sinon, consulte Problèmes.

Réglages

Dans le tableau de bord, les interrupteurs se trouvent sous « Connexion et chat ». Dans Discord, tu les règles avec /server chat.

Tableau de bord	`/server chat`	Effet
Active	`active`	Désactive la synchro du chat. Le salon et le jeton restent.
Chat	`chat-messages`	Les messages de chat dans les deux sens
Arrivées et départs	`join-leave-messages`	Annonce quand quelqu'un rejoint ou quitte le serveur
Morts	`death-messages`	Les messages de mort du jeu
Progrès	`advancements`	Les progrès, à partir de Minecraft 1.12
	`language`	La langue des messages que le bot écrit lui-même
	`channel`	Déplace le chat vers un autre salon

/server chat server: Survival death-messages: False

Uniquement dans le tableau de bord :

Format du chat : les messages au nom du joueur avec sa tête et son nom, en embed ou en ligne simple. Tes propres modèles pour l'arrivée, le départ, la mort et les progrès, et un filtre de mots.
Jeton : une date d'expiration et, au renouvellement, un délai de grâce pendant lequel l'ancien jeton fonctionne encore.
Historique du chat : les derniers messages du salon, chargés directement depuis Discord.

Le démarrage, l'arrêt, les pannes et le rapport hebdomadaire se règlent sous Notifications.

Commandes en jeu

Commande	Effet
`/mcsync status`	Indique si la connexion fonctionne, quelles commandes le serveur accepte et s'il existe une mise à jour
`/mcsync reload`	Relit la config. Le jeton et certains réglages demandent quand même un redémarrage.
`/mcsync toggle`	Masque le chat Discord pour toi seul
`/mcsync link <code>`	Lie ton compte Minecraft à Discord, voir Lier des comptes

status et reload demandent la permission mcsync.admin. Sur Fabric, Quilt, Forge et NeoForge, quiconque peut utiliser /kick peut les utiliser. Tout le monde peut utiliser toggle et link.

Déconnecter

Tableau de bord : « Connexion et chat » → « Déconnecter ».
Discord : /server disconnect server: Survival.

Le jeton cesse de fonctionner. Le serveur reste dans la liste avec son adresse et sa page publique. /server remove supprime aussi le serveur.

Problèmes

Le plugin ne se signale pas

Vérifie que le jeton figure en entier dans la config, sans espaces.
Redémarre le serveur après l'avoir ajouté. /mcsync reload ne suffit pas pour le jeton.
Le serveur doit pouvoir joindre api.mc-sync.eu en HTTPS. Certains hébergeurs bloquent les connexions sortantes ; renseigne-toi auprès du tien.

Les messages de Discord n'apparaissent pas en jeu

Vérifie que l'interrupteur « Chat » est activé.
Le bot doit avoir le droit de voir le salon (« Voir le salon »).
Si un joueur a utilisé /mcsync toggle, lui seul ne voit pas le chat Discord.

Les messages apparaissent en embed au lieu d'avec la tête du joueur

Pour publier au nom du joueur, le bot a besoin de « Gérer les webhooks » dans le salon. Sans cette permission, il publie un embed. Accorde-la dans les paramètres Discord du salon, sous « Permissions ».

Le salon n'est pas dans la liste

Un salon ne peut appartenir qu'à un seul serveur. Les salons déjà utilisés pour autre chose ne sont pas proposés.

`/mcsync` n'existe pas

Sur Forge avant Minecraft 1.19, le mod n'a pas cette commande. Tu vois si la connexion fonctionne dans le tableau de bord, sous « Connexion et chat ».

Contexte : comment le chat passe sans port ouvert

Le serveur Minecraft ouvre lui-même une connexion HTTPS sortante vers le bot et la garde ouverte. Les messages de Discord arrivent par cette connexion. Si elle tombe, le serveur réessaie chaque seconde jusqu'à ce qu'elle revienne.

Tant que Discord est injoignable, le chat, les arrivées et les morts attendent sur le disque du serveur : dans plugins/mc-sync/queue/ ou config/mc-sync-queue/. Ils survivent aussi à un redémarrage. La durée d'attente se règle dans la config sous queue.*.