YASMIAG

Yet Another Simple Multiple Instance Access Gatekeeper

YASMIAG (Yet Another Simple Multiple Instance Access Gatekeeper)

Mod Fabric pour Minecraft 1.21.1 – YASMIAG est un mod de gestion avancée de whitelist qui permet d’utiliser plusieurs listes d’accès et de basculer facilement entre elles. Il offre aux administrateurs de serveur la flexibilité de définir différents modes d’accès (ou profils de whitelist) pour, par exemple, ouvrir le serveur à tous les joueurs ou le restreindre à une liste de testeurs pendant une phase de maintenance. Ce mod remplace le système de whitelist vanilla de Minecraft afin d’appliquer ses propres règles (messages personnalisés, permissions, etc.), améliorant ainsi le contrôle et l’expérience des joueurs lors de la connexion au serveur.

Fonctionnalités

  • 🔒 Whitelists multiples (multi-whitelist) – Possibilité de créer plusieurs listes blanches distinctes (profils) et de passer de l’une à l’autre à la volée. Chaque profil de whitelist correspond à un mode (ex. ouvert, développement, maintenance, test) avec sa propre configuration. Cela permet, par exemple, d’alterner entre un mode ouvert à tous les joueurs et un mode restreint aux seuls membres autorisés, sans redémarrer le serveur.

  • 💡 MOTD personnalisable par mode – Pour chaque mode de whitelist, un MOTD (Message of the Day) spécifique peut être défini. Le MOTD du serveur (affiché dans la liste des serveurs Minecraft) est mis à jour dynamiquement en fonction du mode actif. Par exemple, en mode Maintenance le MOTD pourrait indiquer “Server is under maintenance” pour informer les joueurs de l’état du serveur.

  • 🚫 Messages d’expulsion personnalisés – YASMIAG permet de configurer des messages de kick personnalisés pour chaque mode. Deux types de messages peuvent être définis :

    • Message de kick (kickMessage) : message affiché à un joueur qui tente de se connecter alors qu’il n’est pas autorisé dans la whitelist active (exemple : “Vous ne pouvez pas accéder au serveur pendant la phase de développement.”).

    • Message d’application (enforceMessage) : message utilisé lorsqu’un changement de mode de whitelist expulse des joueurs déjà en ligne qui ne sont pas autorisés dans le nouveau mode (exemple : “Vous avez été expulsé du serveur en raison de l’activation de la whitelist.”).

  • 🔑 Gestion des permissions pour les commandes – Le mod utilise une permission unique yasmiag.* pour contrôler l’accès à toutes ses commandes administratives. Compatible avec les plugins de permissions (comme LuckPerms) et le système d’opérateurs natif (un joueur OP niveau 4 est considéré comme ayant yasmiag.*). Cela signifie que seuls les administrateurs ayant cette permission (ou étant OP4) peuvent utiliser les commandes /yasmiag du mod.

  • ⚙️ Remplacement du système de whitelist vanilla – YASMIAG désactive et remplace le gestionnaire de connexion par défaut de Minecraft. Il prend en charge le processus de validation des joueurs lors de la connexion au serveur à la place du système vanilla, afin d’appliquer ses propres règles (multi-whitelist, messages, etc.). Il est donc inutile d’utiliser la whitelist vanilla en parallèle (voir Notes importantes).

Installation

  1. Pré-requis : Assurez-vous d’avoir installé Fabric (modloader) pour Minecraft 1.21.1 sur votre serveur. (Voir le site officiel Fabric pour les instructions d’installation du modloader.) Il n’est pas nécessaire d’installer Forge, ce mod fonctionne uniquement avec Fabric.

  2. Téléchargement du mod : Obtenez le fichier JAR du mod YASMIAG (par exemple via CurseForge, Modrinth ou le dépôt GitHub du projet). Veillez à télécharger la version compatible avec Minecraft 1.21.1.

  3. Installation du mod : Placez le fichier YASMIAG-x.y.z.jar dans le dossier mods de votre serveur Minecraft (qui utilise Fabric Loader). Si votre serveur est déjà en cours d’exécution, arrêtez-le avant d’ajouter le mod.

  4. Premier lancement : Démarrez (ou redémarrez) votre serveur Minecraft. Le mod YASMIAG va générer automatiquement son fichier de configuration par défaut YASMIAG.json dans le dossier /config/. Vous pourrez éditer ce fichier par la suite pour ajuster les paramètres (voir section Configuration ci-dessous).

(Optionnel) Pour une gestion fine des permissions des commandes YASMIAG, installez un mod de permissions compatible Fabric tel que LuckPerms. Sans plugin de permissions, seuls les joueurs opérateurs (niveau OP 4) pourront exécuter les commandes du mod.

Configuration

Une fois le mod installé, un fichier de configuration /config/YASMIAG.json est créé. Ce fichier est au format JSON et définit les différents modes de whitelist et leurs propriétés. Vous pouvez l’éditer avec un éditeur de texte pour personnaliser les paramètres. Voici les champs principaux du fichier de config :

  • active (chaîne de caractères) – L’identifiant du mode de whitelist actuellement actif. Il doit correspondre à l’un des id définis dans la liste whitelists. C’est ce mode qui sera appliqué par le serveur. (Vous pouvez aussi changer ce mode via la commande /yasmiag mode <id> sans redémarrer.)

  • whitelists (tableau d’objets) – La liste des différentes configurations de whitelist disponibles. Chaque élément du tableau représente un mode de whitelist distinct avec les propriétés suivantes :

    • id (chaîne) : identifiant unique du mode. Par exemple "prod", "dev", "maintenance", "test"… C’est cet identifiant qu’on utilise avec la commande /yasmiag mode pour activer le mode.

    • displayName (chaîne) : nom d’affichage du mode (pour la lisibilité, par exemple "Open Mode" ou "Development Mode"). Ce nom est surtout indicatif pour l’admin et peut aider à décrire le mode, mais il n’est pas actuellement affiché en jeu aux joueurs.

    • motd (chaîne) : le Message of the Day affiché dans la liste des serveurs lorsque ce mode est actif. Il peut être mis en forme pour informer les joueurs (couleurs JSON, etc. sont supportées si Minecraft le permet). Exemple : "Server is under maintenance".

    • kickMessage (chaîne) : le message de refus/banque affiché à un joueur qui tente de se connecter quand il n’est pas autorisé dans la whitelist de ce mode. Il indique généralement pourquoi l’accès est refusé. Exemple : "Vous ne pouvez pas accéder au serveur pendant la phase de développement en cours."

    • enforceMessage (chaîne) : le message affiché aux joueurs qui sont expulsés lors de l’application de la whitelist (lorsqu’on active ce mode et que des joueurs non autorisés étaient connectés). Ce message explique la raison de l’expulsion due au changement de whitelist. Exemple : "Vous avez été expulsé du serveur en raison de l’activation de la whitelist."

    • entries (tableau de chaînes) : la liste des pseudos des joueurs autorisés pour ce mode de whitelist. Seuls les noms présents dans ce tableau pourront se connecter quand ce mode est actif (à l’exception des opérateurs serveurs qui, par défaut Minecraft, peuvent toujours entrer si la whitelist est active – mais voir note : avec YASMIAG, il est recommandé de gérer les accès uniquement via ce système). Spécificité : vous pouvez utiliser le joker "*" dans entries pour signifier un accès ouvert à tous. Si la liste contient "*" (et uniquement ce symbole), tous les joueurs sont autorisés dans ce mode, sans restriction. Par exemple, un mode "prod" pourrait avoir entries: ["*"] pour indiquer que le serveur en production est ouvert à tous. En revanche, pour un mode restreint, laissez la liste vide [] (aucun joueur sauf ceux ajoutés manuellement) ou renseignez des pseudos précis.

Exemple de configuration (YASMIAG.json)

Ci-dessous un exemple complet de fichier YASMIAG.json par défaut, fourni avec le mod. Il définit quatre modes de whitelist : prod (ouvert à tous), dev (développement), maintenance et test, avec chacun leurs messages et paramètres. Vous pouvez vous en inspirer pour créer ou modifier vos propres modes :

Dans cet exemple, le mode actif est "prod" (production) et il est configuré avec entries: ["*"] ce qui signifie que le serveur est ouvert à tous pendant la phase de production. Les autres modes (dev, maintenance, test) ont des listes vides, indiquant qu’aucun joueur n’est autorisé à se connecter lorsque ces modes sont actifs, sauf si on y ajoute manuellement des noms (via la configuration ou les commandes en jeu). Chacun de ces modes affiche un MOTD différent et possède ses propres messages d’expulsion. Vous pouvez modifier ces valeurs selon vos besoins (par exemple, ajouter vos administrateurs/amis dans entries pour le mode dev, personnaliser les messages en français, etc.). N’oubliez pas de recharger la configuration ou redémarrer le serveur pour appliquer les modifications manuelles du fichier.

Commandes disponibles

Le mod YASMIAG ajoute une commande principale /yasmiag (accessible uniquement aux administrateurs, voir section Permissions). Sous cette commande, plusieurs sous-commandes permettent de gérer la whitelist active et les entrées sans devoir éditer le fichier à la main. Voici la liste des commandes disponibles :

  • /yasmiag help – Affiche l’aide des commandes YASMIAG directement dans le chat. Cette commande liste toutes les sous-commandes disponibles et leur usage (similaire à la liste ci-dessous).

  • /yasmiag reload – Recharge la configuration de whitelist depuis le fichier YASMIAG.json. À utiliser après avoir modifié manuellement le fichier de config, afin d’appliquer les changements sans redémarrer le serveur. Après le rechargement, le mod applique immédiatement la whitelist active (même effet qu’un /yasmiag mode vers le mode courant).

  • /yasmiag list – Affiche la liste de tous les joueurs actuellement autorisés (whitelistés) dans le mode de whitelist actif. Chaque pseudo présent dans la whitelist active sera listé. Si la whitelist active est ouverte à tous ("*"), cette commande affichera vraisemblablement un message indiquant que tous les joueurs sont autorisés (ou éventuellement aucun nom spécifique).

  • /yasmiag add <joueur> – Ajoute un joueur à la whitelist du mode actif. Cette commande enregistre le pseudo <joueur> dans la liste entries du mode de whitelist actuellement en vigueur. Si le joueur était précédemment exclu, il pourra désormais se connecter tant que ce mode reste actif. (Note: le changement est normalement sauvegardé dans la configuration via le mod – il persistera donc après redémarrage.)

  • /yasmiag remove <joueur> – Retire un joueur de la whitelist du mode actif. Le pseudo spécifié sera supprimé de la liste des autorisés pour le mode courant. Si ce joueur est en ligne et que vous le retirez alors qu’il n’est pas autorisé par ailleurs (et qu’il n’est pas OP), il sera expulsé du serveur car plus autorisé dans la whitelist active.

  • /yasmiag mode <mode> – Change le mode de whitelist actif vers le mode dont l’identifiant est <mode>. Le <mode> doit correspondre à l’un des id définis dans le fichier de configuration. Par exemple, /yasmiag mode dev activera la whitelist de développement. Le mod appliquera immédiatement le nouveau profil : il mettra à jour le MOTD, et expulsera tout joueur non autorisé présent sur le serveur selon la whitelist du nouveau mode. Cette commande permet donc de basculer rapidement l’accès du serveur (ouvert/restreint) sans redémarrer.

  • /yasmiag getmode – Affiche l’identifiant du mode de whitelist actuellement actif. Le serveur indique par un message, par exemple : “Active whitelist mode: prod”. Utile pour vérifier en un coup d’œil quel profil de whitelist est en cours.

Toutes ces commandes doivent être exécutées par un compte ayant la permission requise (voir ci-dessous). En général, un OP (niveau 4) ou un administrateur disposant de yasmiag.* pourra les utiliser. Astuce : en tapant simplement /yasmiag ou /yasmiag help, vous obtiendrez la liste et le rappel de la syntaxe de toutes ces sous-commandes directement en jeu.

Permissions

Pour des raisons de sécurité, toutes les commandes du mod YASMIAG sont restreintes aux administrateurs. Une permission unique est définie : yasmiag.*.

  • Si vous utilisez un plugin de permissions (ex: LuckPerms), il suffit d’accorder yasmiag.* à vos rôles/admins pour leur donner accès aux commandes du mod. (Le mod utilise l’API de permissions Fabric, ce qui le rend compatible avec LuckPerms et autres mods de permissions.)

  • Si vous n’avez pas de système de permissions, alors par défaut seuls les opérateurs de niveau 4 (OP niveau 4, généralement les admins) pourront exécuter les commandes /yasmiag. Ce niveau d’OP est le plus haut dans Minecraft et est attribué par la commande vanilla /op <joueur> (les ops obtenus ainsi ont par défaut le niveau 4, sauf configuration contraire).

Aucune autre permission fine n’est requise ou disponible – yasmiag.* couvre l’ensemble des fonctionnalités du mod (il n’existe pas de permission séparée par sous-commande, le système est volontairement simple).

Notes importantes

  • ⚠️ Désactiver la whitelist vanilla : Assurez-vous que la whitelist native de Minecraft est désactivée sur votre serveur. Étant donné que YASMIAG remplace entièrement le système de whitelist/connexion par défaut, la whitelist vanilla ne doit pas être utilisée en parallèle. Concrètement, dans le fichier server.properties de votre serveur, mettez enforce-whitelist=false (ou désactivez la whitelist via les commandes vanilla si elle était active). Si la whitelist vanilla reste active, elle pourrait interférer avec YASMIAG et empêcher certains joueurs de se connecter même s’ils sont autorisés par YASMIAG, ou inversement. En résumé, laissez la gestion des accès exclusivement à YASMIAG pour éviter les conflits.

  • 💡 Compatibilité : Ce mod est conçu pour Minecraft 1.21.1 (Fabric). L’utilisation sur d’autres versions n’est pas garantie sauf si une version spécifique du mod existe. Vérifiez toujours que vous utilisez la bonne version du mod pour votre version de serveur. De plus, YASMIAG se concentre uniquement sur la whitelist ; il ne gère pas les banlist ou op list – continuez d’utiliser les commandes vanilla pour ces aspects (elles ne devraient pas entrer en conflit avec YASMIAG).

  • 🔄 Prise en compte des modifications : Si vous modifiez manuellement le fichier YASMIAG.json pendant que le serveur tourne, pensez à exécuter un /yasmiag reload pour appliquer les changements immédiatement. De même, changer le mode actif via /yasmiag mode met à jour instantanément la config en mémoire et dans le fichier. Les ajouts/suppressions de joueurs via /yasmiag add/remove sont normalement persistés dans le fichier de config automatiquement.

Liens utiles

  • Dépôt GitHub (code source) – Retrouvez le projet YASMIAG sur GitHub pour le code source, les releases et d’éventuelles informations complémentaires : SirHephaistos/YASMIAG. Vous y trouverez également un espace pour reporter des issues ou proposer des améliorations.

  • Documentation Fabric & Mods – Pour en savoir plus sur Fabric et comment installer des mods en général : consultez la documentation officielle de Fabric (en anglais). Ceci peut être utile si vous débutez avec les mods Fabric.

  • Communauté & Support – Si vous avez des questions ou des problèmes avec YASMIAG, recherchez sur les forums ou Discord de la communauté Minecraft/Fabric. Si le mod dispose d’un fil de discussion ou d’un canal dédié (par exemple sur le Discord du développeur ou de Fabric), n’hésitez pas à y poser vos questions.

Avec YASMIAG, gérez facilement l’accès à votre serveur Minecraft en fonction de vos besoins (ouverts à tous ou réservés) sans redémarrer, et offrez une expérience claire à vos joueurs grâce aux messages personnalisés ! Bon jeu !

Last updated

Was this helpful?