Configuration AuthMe
Configurez la connexion et l'inscription pour votre serveur et obtenez des lignes prêtes à l'emploi pour config.yml avec une explication pour chacun.
Préréglages
Ce qu'il faut modifier dans config.yml : 0
Tout correspond pour l'instant à la configuration par défaut. Choisissez un préréglage ou modifiez les paramètres ci-dessous, et les lignes à coller apparaîtront ici.
Informations de base
Langue des messages et mode de compte
settings.messagesLanguageLa langue qu'AuthMe utilise pour dire aux joueurs « enregistrez-vous » et « saisissez votre mot de passe ». Anglais par défaut ; pour un serveur russe, mettez ru.
settings.perPlayerLocaleChaque joueur reçoit les messages dans la langue de son jeu, et la langue ci-dessus sert de secours.
settings.serverNameInséré dans les messages et les e-mails du plugin.
settings.enablePremiumLes joueurs avec un compte Minecraft officiel se connectent sans saisir de mot de passe, les autres comme d'habitude. Le plugin choisit lui-même la méthode de vérification.
settings.preventOtherCaseSi Xephi est enregistré, XEPHI et xephi ne pourront pas se connecter. Protège contre l'usurpation via une casse différente.
Inscription
Comment un joueur crée un compte pour la première fois
settings.registration.enabledDésactivez-la et les nouveaux joueurs ne pourront pas créer de compte.
settings.registration.forceSans inscription ni connexion, un joueur ne peut rien faire. Les exceptions se règlent dans la section des restrictions ci-dessous.
settings.registration.typePASSWORD : le joueur choisit son propre mot de passe. EMAIL : un mot de passe est généré et envoyé à l'adresse e-mail qu'il a fournie.
settings.registration.secondArgNONE : le mot de passe est saisi une fois. CONFIRMATION : il doit être répété comme second mot. EMAIL_OPTIONAL et EMAIL_MANDATORY : le second argument est un e-mail, facultatif ou obligatoire.
settings.registration.messageIntervalFréquence à laquelle le plugin répète le message « connectez-vous ou inscrivez-vous » au joueur.
settings.restrictions.maxRegPerIpCombien de fois on peut s'inscrire depuis une même adresse. 0 signifie aucune limite. Un est sévère pour ceux qui jouent ensemble depuis le même foyer.
settings.restrictions.registerTimeoutCombien de secondes un joueur a pour s'inscrire. 0 signifie ne jamais exclure.
settings.registration.forceLoginAfterRegisterAprès une inscription réussie, le joueur doit se connecter à nouveau avec la commande.
settings.registration.forceKickAfterRegisterLe joueur est exclu juste après son inscription pour qu'il se reconnecte. Ne pas activer avec l'exigence de /login ci-dessus.
Se connecter
Ce qui se passe quand un joueur saisit le mot de passe
settings.restrictions.loginTimeoutCombien de secondes un joueur a pour saisir le mot de passe. 0 signifie ne jamais exclure.
settings.restrictions.kickOnWrongPasswordLe joueur est exclu du serveur juste après une erreur. Aide contre la force brute mais agace les joueurs réguliers.
settings.restrictions.kickNonRegisteredUn joueur sans compte est exclu dès son arrivée. C'est le mode serveur privé.
settings.restrictions.ForceSingleSessionUn joueur en ligne ne peut pas être exclu par quelqu'un qui rejoint avec le même pseudo (« Logged in from another Location »). Ferme une faille connue de détournement de session.
settings.restrictions.maxLoginPerIpCombien de joueurs peuvent être connectés depuis une même adresse. 0 signifie aucune limite.
settings.restrictions.maxJoinPerIpCombien de connexions sont autorisées depuis une même adresse. 0 signifie aucune limite.
Sessions
Pour ne pas saisir le mot de passe après chaque déconnexion
settings.sessions.enabledLe plugin mémorise le pseudo et l'IP. Si le joueur se reconnecte depuis la même adresse avant expiration, aucun mot de passe n'est demandé.
settings.sessions.timeoutAprès combien de minutes le mot de passe est redemandé. La session se termine aussi quand l'IP change.
Avant la connexion
Ce qu'un joueur peut faire avant de saisir le mot de passe
settings.restrictions.allowChatDésactivé, l'invité ne peut pas discuter. Toutes les commandes sauf celles listées ci-dessous sont aussi bloquées.
settings.restrictions.hideChatUn joueur qui ne s'est pas connecté ne peut pas voir le chat des autres joueurs.
settings.restrictions.allowCommandsTout le reste est bloqué. Retirer /login ou /register d'ici bloque tout le monde.
settings.restrictions.allowMovementL'invité peut se déplacer. Le rayon est défini ci-dessous.
settings.restrictions.allowedMovementRadiusJusqu'où un invité peut marcher depuis le point d'arrivée. 0 signifie aucune limite.
settings.restrictions.teleportUnAuthedToSpawnAvant de se connecter, le joueur reste au spawn, et après la connexion il revient là où il était. Ainsi personne ne peut apercevoir la base de quelqu'un depuis sa vue.
settings.restrictions.ProtectInventoryBeforeLogInL'invité ne peut pas voir le contenu de son inventaire tant qu'il ne s'est pas connecté. Nécessite PacketEvents.
Fonctionne uniquement avec PacketEvents installé, selon la documentation du plugin.
settings.restrictions.DenyTabCompleteBeforeLoginL'invité ne peut pas apercevoir les pseudos et les commandes via l'autocomplétion. Nécessite PacketEvents.
settings.applyBlindEffectTant que le joueur ne s'est pas connecté, l'écran est assombri par l'effet Cécité.
settings.restrictions.noTeleportAuthMe ne déplace jamais les joueurs. Nécessaire si un autre plugin gère les téléportations et qu'ils entrent en conflit.
Mot de passe
Longueur, mots de passe interdits et méthode de stockage
settings.security.minPasswordLengthLes mots de passe plus courts ne seront pas acceptés.
settings.security.passwordMaxLengthLa limite supérieure de la longueur du mot de passe.
settings.security.passwordHashL'algorithme de hachage. BCRYPT et ARGON2 sont volontairement lents, ce qui est bien : la force brute devient coûteuse. Les autres valeurs de la liste sont nécessaires quand la base de mots de passe provient d'un moteur de forum.
Changer l'algorithme sur un serveur en production ? Ajoutez l'ancien à settings.security.legacyHashes, sinon les joueurs ne pourront pas se connecter avec leurs mots de passe.
settings.security.unsafePasswordsCeux-ci ne peuvent pas être utilisés comme mots de passe. Écrivez-les en minuscules. Veillez à conserver help : la documentation signale un conflit avec la commande.
settings.restrictions.allowedPasswordCharactersUne expression régulière. Par défaut [!-~] signifie tous les caractères ASCII visibles, ce que recommandent les auteurs.
Pseudos
Quels noms sont autorisés sur le serveur
settings.restrictions.minNicknameLengthLes pseudos plus courts ne seront pas acceptés.
settings.restrictions.maxNicknameLengthLa limite standard de Minecraft est 16.
settings.restrictions.allowedNicknameCharactersUne expression régulière. Par défaut, les lettres latines, les chiffres et le tiret bas, comme le jeu lui-même l'autorise.
Bots et force brute
Protection contre les connexions massives et la devinette de mots de passe
Protection.enableAntiBotLe plugin active la protection de lui-même quand trop de joueurs se connectent en peu de temps.
Protection.antiBotSensibilityCombien de connexions par intervalle comptent comme une attaque.
Protection.antiBotIntervalFenêtre de temps pendant laquelle les connexions sont comptées.
Protection.antiBotDurationNombre de minutes pendant lesquelles la protection reste active après son déclenchement.
Protection.quickCommands.denyCommandsBeforeMillisecondsSi une commande arrive plus tôt que ce délai après la connexion, c'est un bot et le joueur est expulsé.
Security.captcha.useCaptchaAprès plusieurs tentatives erronées, un code à saisir est affiché au joueur.
Security.captcha.maxLoginTryNombre d'erreurs autorisées avant qu'un code soit demandé.
Security.captcha.captchaLengthNombre de caractères du code.
Security.tempban.enableTempbanL'adresse est bloquée si un mot de passe erroné y est saisi trop de fois.
Security.tempban.maxLoginTriesNombre d'erreurs tolérées par le plugin avant de bannir l'adresse.
Security.tempban.tempbanLengthNombre de minutes pendant lesquelles le bannissement temporaire d'adresse dure.
Protection.enableProtectionLa connexion et l'inscription ne sont autorisées que depuis les adresses des pays de la liste ci-dessous. Nécessite une base GeoIP.
Protection.countriesCodes pays à deux lettres. LOCALHOST sert à se connecter depuis la machine du serveur elle-même.
FAQ
Où coller ces lignes ?
Dans le fichier plugins/AuthMe/config.yml du serveur. Le générateur n'affiche que les clés modifiées, en conservant leur imbrication : retrouvez le même chemin dans votre fichier et définissez la valeur. Il n'est pas nécessaire de remplacer tout le fichier, car il contient des paramètres absents ici. Après modification, redémarrez le serveur ou exécutez /authme reload.
Comment changer la langue des messages du plugin ?
Définissez settings.messagesLanguage sur le code de langue souhaité, par exemple ru. La valeur par défaut est en, donc une installation fraîche d'AuthMe parle aux joueurs en anglais. Il existe aussi settings.perPlayerLocale : lorsqu'il est activé, chaque joueur reçoit les messages dans la langue de son jeu, et la valeur ci-dessus sert de solution de repli.
Les joueurs se plaignent de devoir saisir leur mot de passe après chaque déconnexion
Activez les sessions : mettez settings.sessions.enabled sur true et définissez settings.sessions.timeout, par exemple à 30 minutes. Le plugin mémorise le pseudo et l'IP, et ne demandera pas le mot de passe depuis la même adresse pendant ce laps de temps. La session se termine si l'IP change, et cela n'est pas configurable.
Que faire si le serveur subit une attaque de bots ?
Le plugin dispose d'un antibot intégré : Protection.enableAntiBot est activé par défaut, et Protection.antiBotSensibility définit combien de connexions par intervalle comptent comme une attaque. Un captcha après plusieurs mots de passe erronés et un bannissement temporaire d'adresse en cas de force brute aident aussi. Le préréglage « Attaque de bots » ci-dessus active tout cela d'un coup.
Attention au filtre par pays
Protection.enableProtection restreint la connexion à une liste de pays, mais par défaut cette liste contient US, GB et LOCALHOST. Si vous activez la protection sans modifier la liste, les joueurs de tous les autres pays ne pourront plus se connecter. Les codes de pays sont des codes ISO 3166 à deux lettres.
Les joueurs premium peuvent-ils se connecter sans mot de passe ?
Oui, c'est le rôle de settings.enablePremium. Les joueurs possédant un compte Minecraft officiel sont vérifiés automatiquement et ne saisissent pas de mot de passe, tous les autres se connectent normalement. Le plugin choisit automatiquement la méthode de vérification.
Quelle méthode de stockage des mots de passe choisir ?
La valeur par défaut est SHA256. BCRYPT et ARGON2 sont volontairement lents à calculer, et c'est tout l'intérêt : la force brute devient coûteuse. Important : si vous changez l'algorithme sur un serveur en production, ajoutez l'ancien à settings.security.legacyHashes, sinon les joueurs ne pourront pas se connecter avec leurs mots de passe.
Un invité peut voir les constructions des autres avant de se connecter
Activez settings.restrictions.teleportUnAuthedToSpawn : avant de se connecter, le joueur reste au spawn, et après connexion il retourne là où il était. Cela s'accompagne généralement du masquage du chat et du blocage des déplacements.
D'où viennent les données
Les noms des paramètres et les valeurs par défaut proviennent de la documentation officielle du plugin du 1er septembre 2026. Le générateur contient les paramètres que les gens modifient réellement à la main ; le plugin crée les autres lui-même.