Révision #1529

Arcadia Admin Panel est le mod d'administration maison du pack, écrit par l'équipe Arcadia. Il regroupe dans une seule interface tout ce qu'il faut pour gérer un serveur: la fiche de chaque joueur, les sanctions, les inventaires, les outils de surveillance, l'état du serveur et, à partir de la version 2.0.33, un profileur de ticks qui montre quel mod, quelle machine ou quelle créature fait ramer le serveur. Sur le serveur officiel, c'est l'outil du staff. Sur ton serveur privé, c'est le tien: cette page t'explique comment t'en servir en tant qu'administrateur. Elle décrit la version 1.4.0 du mod.

Ouvrir le panneau et qui y a accès

Le panneau s'ouvre avec la commande /arcadia_adminpanel panel. Tu peux ajouter un nom après, par exemple /arcadia_adminpanel panel Steve, pour ouvrir directement la liste filtrée sur ce nom. Le mod ajoute aussi une entrée « Admin Panel » au Hub Arcadia, qui lance cette même commande (déduit du code: l'entrée est réservée au staff).

Le mod décide de l'accès à chaque outil dans cet ordre:

1. 1
   Opérateur: un joueur opérateur de niveau 2 ou plus a accès à tous les outils, sans rien configurer. Sur un serveur privé, c'est le plus simple pour toi.
2. 2
   Node LuckPerms: chaque outil a son node, par exemple arcadia.adminpanel.ban. Un node réglé à vrai donne l'outil, un node réglé à faux le retire, et dans les deux cas il l'emporte sur le rôle.
3. 3
   Rôle staff: sans node précis, le mod regarde le rôle du joueur, donné par les nodes arcadia.staff.helper, arcadia.staff.mod et arcadia.staff.admin (fichier config/arcadia/lib/staff.toml). Chaque outil a un rôle minimum par défaut: Helper, Modérateur ou Admin.

L'écran Mes accès (/arcadia_adminpanel access) liste chaque outil avec son rôle par défaut et la raison pour laquelle tu l'as ou non: opérateur, node, rôle, node à faux, rôle insuffisant. Un admin peut regarder les accès d'un autre membre avec /arcadia_adminpanel access <joueur>. Pour donner des rôles précis à des modérateurs sans leur donner l'opérateur complet, vois Administrer son serveur et Sécuriser son serveur.

Se déplacer dans le panneau

L'écran est découpé en trois zones: la colonne de gauche liste tous les écrans par catégorie (Joueurs, Modération, Serveur, Monde, Staff, Arcadia), le centre affiche le contenu, et un cadre de détails lit pour toi tout le texte de l'entrée ou du bouton que tu survoles. Les raccourcis sont rappelés en bas de l'écran.

Un bouton bascule l'affichage entre la vue en liste et la vue en grille. La recherche a deux niveaux: les mots tapés filtrent la page affichée, et la touche Entrée lance la recherche parmi tous les joueurs déjà venus sur le serveur. Les actions dangereuses demandent un second clic de confirmation.

La liste des joueurs

C'est l'écran d'accueil. Chaque tête est un joueur, et la couleur de son nom dit son état: vert en ligne, vert foncé inactif (AFK), rouge hors ligne, cyan sélectionné. Des marques signalent qui est en prison, muet, gelé, invisible, surveillé ou averti.

• Filtre: tous, en ligne, hors ligne, en prison, muets, bannis, avertis, surveillés, gelés, invisibles, AFK, sélectionnés. Clic pour avancer, clic droit pour reculer.
• Tri: nom, dernière connexion, temps de jeu, nombre d'avertissements.
• Sélection: Maj+clic ou clic droit sur des têtes, puis l'écran Actions groupées envoie un message à tous, les rassemble près de toi, les soigne, les avertit ou les expulse (deux clics). Un clic droit sur « Vider la sélection » sélectionne tous les joueurs connectés.

La fiche d'un joueur

Un clic sur une tête ouvre sa fiche. En haut, les informations: en ligne ou non, dimension et position, première venue, dernière connexion et dernière déconnexion, banni ou non, présent sur la liste blanche ou non, nombre d'avertissements. Viennent ensuite ses homes (clic pour t'y rendre), ses téléportations récentes, puis les actions.

Le bouton Outils joueur ouvre le reste, rangé en trois lignes:

• Enquêter: historique des sanctions, notes du staff, journal d'audit le concernant, liste de surveillance.
• Intervenir: gel, observation, ban temporaire, modèles de sanction, ajout à la sélection.
• Assister: éditeur d'inventaire, instantanés de mort, sauvegardes d'inventaire, don d'objets, courrier hors ligne, apparition d'une créature près de lui, waystones découvertes, déguisement.

Une dernière carte, Team Arcadia, montre ce joueur vu par les autres mods maison: ses annonces à l'hôtel des ventes, les zones Arcadia Guard où il se trouve, ses lootbox ouvertes, son familier actif, ses points de prestige ou sa téléportation au spawn en attente. Les actions qui modifient ces données demandent un clic droit de confirmation. Enfin, l'écran FTB Teams parcourt toutes les équipes du serveur: membres, zones revendiquées, chunks chargés en permanence, avec un bouton pour rassembler les membres en ligne et un autre pour leur envoyer un message.

Les sanctions

Toutes les sanctions sont enregistrées dans l'historique du joueur et dans le journal d'audit. Par défaut, le mod n'annonce pas les sanctions publiquement (option broadcastSanctions à false).

Les avertissements

Un avertissement se donne depuis la fiche, ou avec /arcadia_adminpanel warn <joueurs> <raison>. Le joueur voit un titre « ATTENTION » à l'écran. Chaque avertissement expire au bout de 180 jours (réglage warnExpiryDays): passé ce délai, le mod le supprime tout seul. À chaque connexion, un joueur qui a encore des avertissements actifs reçoit leur liste avec le temps restant, et peut la relire avec /arcadia_adminpanel checkwarn.

Le mute

/arcadia_adminpanel mute <joueur> <minutes> [raison] rend un joueur muet. S'il essaie d'écrire, il voit le temps restant et la raison. unmute <joueur> lève le mute. Un joueur muet ne peut pas non plus rejoindre un mini-jeu Arcadia.

La prison

Avant tout, place la prison: va à l'endroit voulu et tape /arcadia_adminpanel setjail. Sans prison définie, aucune peine de prison ne passe. Ensuite, jail <joueur> <minutes> [raison] l'y envoie et unjail <joueur> le libère. jaillist montre qui est en prison.

• Zone et anti-évasion: le prisonnier doit rester dans un rayon de 32 blocs autour de la prison. Toutes les 20 ticks (une seconde), un prisonnier sorti de la zone y est ramené, et toute téléportation qui le ferait sortir est annulée. jailradius affiche le rayon, jailradius <blocs> le change.
• Téléportation bloquée: en prison, le mod refuse le clic droit avec un objet dont l'identifiant contient waystone, warp, teleport ou return_stone, et sur un bloc dont l'identifiant contient waystone, warp_stone, portal ou teleport.
• Commandes bloquées: seules /msg, /tell, /w, /reply, /r, /me et /help restent permises.
• Reconnexion: se déconnecter ne sert à rien, le joueur est remis en prison et reçoit un rappel du temps restant.
• Libération: le mod enregistre la position du joueur au moment de l'emprisonnement et l'y renvoie à la fin de la peine (déduit des données enregistrées par le mod).

La matraque de prison

La Matraque de Prison est le seul objet du mod. Elle ne se fabrique pas: on la reçoit avec /arcadia_adminpanel givebaton. Elle ne s'empile pas, résiste au feu et porte la rareté « rare ». Un clic droit sur un joueur l'envoie 30 minutes en prison avec la raison « Frappé avec la Matraque de Prison »; un clic droit sur un joueur déjà en prison le libère. Il faut le node arcadia.adminpanel.jail (Modérateur par défaut), et la matraque refuse de frapper son porteur ou un autre membre du staff.

Le gel

Le gel immobilise un joueur pour une vérification, par exemple une vérification d'écran. /arcadia_adminpanel freeze <joueur> [raison] le gèle, unfreeze <joueur> le libère. Le joueur gelé voit un écran « VOUS ÊTES GELÉ » avec le temps écoulé et un rappel toutes les 10 secondes de répondre dans le chat. Il ne peut plus casser ni poser de blocs, interagir, attaquer, jeter un objet ou ouvrir un conteneur, et il ne prend plus de dégâts. Se déconnecter ne lève pas le gel: le staff est prévenu de la déconnexion et le joueur revient gelé.

Les bans

/arcadia_adminpanel tempban <joueur> <minutes> [raison] bannit pour une durée. Dans le panneau, le bouton Ban temporaire des outils joueur bannit pour la durée par défaut, 1440 minutes soit 24 heures (réglage defaultTempbanMinutes), et un clic droit bannit définitivement. L'écran Bans (banlist) liste les bannis avec le temps restant, et un clic débannit.

Les modèles de sanction

Les modèles sont des raisons prêtes à l'emploi avec une échelle: la première fois qu'un modèle est appliqué à un joueur, il reçoit le premier palier, la fois suivante le deuxième, et ainsi de suite jusqu'au dernier. Le modèle s'applique en deux clics depuis les outils joueur, ou avec /arcadia_adminpanel templates <joueur>. Le mod crée sept modèles par défaut:

Pour changer l'échelle, modifie config/arcadia/arcadiaadminpanel/templates.json, écrit au premier démarrage, puis recharge avec /arcadia_adminpanel reload. Le réglage escalationEnabled à false applique toujours le premier palier.

Les outils du staff pour soi

Ces bascules ne concernent que toi. Elles sont dans l'écran Outils staff (/arcadia_adminpanel tools), rubrique « Vos bascules », et ont chacune leur commande.

Le chat staff

/arcadia_adminpanel staffchat <message> envoie un message au seul staff. stafftoggle fait passer tous tes messages dans le canal staff jusqu'à ce que tu le coupes, et stafflist liste le staff connecté.

Le déguisement

Le déguisement donne à un joueur l'apparence d'une créature vivante, avec ses sons ambiants. Choisis la créature dans une grille depuis les outils joueur, ou utilise la commande:

• disguise <joueur> <créature>, par exemple minecraft:pig; disguise <joueur> random pour une créature au hasard, disguise <joueur> reset pour retirer.
• baby on, scale <valeur> et name on après le nom du joueur: forme bébé, échelle, nom de la créature affiché.
• disguise --all <créature>, --random, --clear et --list touchent tous les joueurs à la fois, pratique pour un événement.

Les noms affichés

La commande /arcadia_adminpanel nametag change le nom au-dessus de la tête d'un joueur: couleur (color), couleur hexadécimale (rgb #FF8800), dégradé de 2 à 4 couleurs (gradient), effet animé (effect: solid, gradient, rainbow, breathing, chase, wave, blink, fade, typewriter, random), vitesse (speed), style (style: bold, italic, underline, strikethrough, obfuscated, suivi de on ou off), pseudo affiché de 32 caractères au plus (name), grade affiché ou non (grade), et reset pour tout effacer.

Le mod peut aussi masquer les noms: derrière les murs (hide on, actif par défaut), pour tout le monde en mode événement (hideall on), ou pour un seul joueur en permanence (forcehide). exempt garde le nom d'un joueur toujours visible.

Les inventaires

Consulter et modifier

/arcadia_adminpanel invsee <joueur> affiche l'inventaire pour le consulter. invedit <joueur> ouvre l'éditeur: lignes 1 à 3 pour le sac, ligne 4 pour la barre rapide, ligne 5 pour l'armure portée et la seconde main. Des onglets montrent le coffre de l'Ender, les emplacements Curios, les accessoires et l'armure cosmétique. Tu prends et poses les objets librement, mais rien n'est écrit avant le clic sur Sauvegarder, et une sauvegarde de l'inventaire est prise juste avant l'écriture. L'éditeur fonctionne aussi sur un joueur déconnecté, à partir de ses données stockées; les emplacements supplémentaires (Curios et compagnie) demandent qu'il soit connecté.

Les sauvegardes d'inventaire

Le mod copie l'inventaire de chaque joueur toutes les 24 heures et à chaque déconnexion, avec au moins 60 minutes entre deux copies, et garde les 7 dernières par joueur. Chaque copie contient l'inventaire, le coffre de l'Ender, les accessoires et même le contenu des sacs à dos Sophisticated Backpacks. Dans l'écran Sauvegardes:

• Un clic sur un objet le rend au joueur, s'il est connecté.
• Restaurer cette sauvegarde (deux clics) remplace tout l'inventaire actuel. Si le joueur est hors ligne, la restauration attend sa prochaine connexion.
• Le mod refuse de rendre un sac à dos qui existe encore sur un joueur connecté, pour ne pas ouvrir deux fois le même contenu.

Commandes: invbackup <joueur> ouvre ses sauvegardes, invbackupnow <joueur> en prend une tout de suite, invbackupnow seul sauvegarde tout le monde. Les objets mis en vente à l'hôtel des ventes ne sont pas dans les sauvegardes.

Les instantanés de mort

À chaque mort, le mod note la cause, le niveau et tout ce que le joueur portait. Il garde les 5 dernières morts par joueur (deaths <joueur>). Le bouton Restaurer, en deux clics, rend les objets; un instantané ne peut être restauré qu'une fois, pour éviter de dupliquer les objets. Les piles qui ne rentrent pas dans l'inventaire sont ignorées.

Donner, écrire, effacer

• Donner des objets (items): tous les objets du jeu et des mods. Cherche par mots, par mod avec @create ou par tag avec #logs. Clic pour en donner un, clic droit pour une pile. En commande: giveitem <joueur> <objet> [quantité], jusqu'à 6400.
• Courrier hors ligne (mail <joueur> <message>): message remis à sa prochaine connexion, 20 en attente au plus.
• Vider inventaire et Reset progression depuis la fiche, réservés aux admins.

Surveiller et enquêter

Le journal d'audit peut aussi partir sur Discord: renseigne l'adresse d'un webhook dans discordWebhookUrl (vide par défaut). Les actions faites en mode silencieux n'y sont pas envoyées par défaut.

Le profileur de ticks

Un serveur Minecraft vise 20 ticks par seconde, soit 50 millisecondes au plus par tick. Quand ça rame, il faut savoir qui mange ce temps. Le profileur de ticks répond à cette question: il chronomètre le tick de chaque entité (monstres, animaux, objets au sol, familiers...) et de chaque bloc-entité (machines, coffres, fours, tout bloc qui travaille à chaque tick), ainsi que le tick complet de chaque dimension. Il s'ouvre avec /arcadia_adminpanel profiler ou depuis l'écran État du serveur. Il faut le node arcadia.adminpanel.performance (Modérateur par défaut).

Lancer une mesure

Le bouton Arrêter maintenant termine la session en gardant ce qui a été mesuré. Hors session, le profileur ne coûte rien. À la fin, tu reçois un message cliquable qui ouvre les résultats.

Lire les résultats

Les résultats se lisent dans cinq onglets:

• Mods: le temps de tick regroupé par mod. Un clic montre les types de ce mod.
• Types: par type d'entité et de bloc-entité. Un clic montre tous les objets de ce type.
• Objets: les machines et les créatures les plus lourdes, un par un. Un clic t'y téléporte.
• Chunks: là où le coût se concentre. Un clic t'y téléporte.
• Dimensions: le temps de tick complet de chaque dimension.

Chaque ligne donne le coût par tick (en microsecondes ou en millisecondes), sa part du tick et le nombre d'objets. Le résumé de session indique le tick moyen, le nombre de ticks mesurés, le mode d'échantillonnage et le mod le plus lourd. Après un clic sur un mod ou un type, la liste est filtrée dessus; recliquer affiche tout.

Les couleurs de sévérité

L'affichage dans le monde

L'affichage 3D encadre chaque bloc-entité et chaque entité du profil affiché, avec son coût de tick écrit au-dessus, visible à travers les murs. Plus l'objet est lourd, plus il se voit de loin (tableau ci-dessus). Un bandeau à l'écran indique le profil affiché et le nombre d'objets à proximité. Active-le avec le bouton du profileur ou avec /arcadia_adminpanel profiler overlay, et retape la commande pour le couper. D'après le code, le serveur t'envoie au plus 4000 objets autour de toi et rafraîchit la liste quand tu as parcouru 48 blocs ou changé de dimension.

Les profils enregistrés

Chaque session terminée est enregistrée sur le serveur, dans config/arcadia/arcadiaadminpanel/profiler, et le mod garde les 50 dernières. L'écran Profils enregistrés les liste du plus récent au plus ancien, avec la couleur du tick moyen: vert sous 35 ms, orange à partir de 35 ms, rouge à partir de 50 ms. Clique sur un ancien profil pour en faire celui que tu lis: les onglets et l'affichage 3D passent dessus, pour toi seul. C'est idéal pour examiner après coup un lag signalé par un joueur. Choisis le plus récent pour revenir.

Les autres écrans de performance

• Résumé rapide: /arcadia_adminpanel lag écrit dans le chat les TPS (vert à 19 et plus, jaune à 15 et plus, rouge en dessous), le MSPT moyen, la mémoire, le nombre d'entités et de chunks chargés.
• Performances (lagpanel): une photo de la charge, recalculée au plus toutes les 10 secondes: MSPT moyen et maximum, dimensions, les 10 chunks les plus peuplés en entités (clic pour y aller), et les joueurs entourés du plus d'entités dans un rayon de 64 blocs.
• Navigateur de chunks (chunks): les zones revendiquées et les chunks chargés en permanence par équipe FTB Chunks, et les chunks forcés en vanilla. Un chunk chargé en permanence tourne même sans joueur, c'est souvent là que se cache un lag.

Diagnostiquer un lag pas à pas

1. 1
   Tape /arcadia_adminpanel lag. Si les TPS sont en vert et le MSPT sous 50, le serveur tient la cadence et le problème vient sans doute du client ou du réseau.
2. 2
   Ouvre le profileur et lance un profil complet de 20 secondes, ou un profil léger si le serveur est déjà à genoux.
3. 3
   Regarde l'onglet Dimensions pour savoir où ça se passe, puis l'onglet Mods pour savoir quel mod pèse. Clique sur le mod rouge pour voir ses types, puis sur le type pour voir chaque objet.
4. 4
   Clique sur l'objet le plus lourd pour t'y téléporter, et active l'affichage 3D: les cadres rouges et orange te montrent la ferme ou l'usine fautive.
5. 5
   Après ta correction, relance un profil et compare avec l'ancien dans Profils enregistrés.

Il remplace Observable

Jusqu'à la version 2.0.32, le pack embarquait Observable, un mod de diagnostic qui mesure ce qui fait ramer le serveur. À partir de la version 2.0.33, Observable est retiré du pack: le profileur du panneau prend le relais, puisqu'il couvre le même besoin avec la mesure par entité et par bloc-entité, l'affichage dans le monde, la téléportation vers les objets lourds et l'historique des 50 dernières sessions. Si tu avais l'habitude d'Observable, le profileur se trouve désormais dans le panneau, et les permissions passent par le node arcadia.adminpanel.performance.

Gérer le serveur

État du serveur

L'écran État du serveur (status) montre le serveur d'un coup d'oeil, rafraîchi toutes les deux secondes: TPS, pic de tick, joueurs, mémoire, temps en ligne, entités, chunks et dimensions chargées. Rappel du mod: 20 TPS, c'est la pleine vitesse; sous 18, les joueurs le sentent. Les distances de vue et de simulation se montent d'un clic et se baissent d'un clic droit. Comme ServerCore est dans le pack, l'écran montre aussi son réglage automatique et permet d'ajuster sa limite de créatures et ses distances (réservé aux admins). Pour comprendre ces réglages, vois Chunky et ServerCore.

File d'attente de connexion

Après un redémarrage, tout le monde se reconnecte en même temps et le serveur peut caler. La file d'attente étale les connexions: avec la config du pack, 2 joueurs toutes les 10 secondes, et personne n'attend plus de 60 secondes. Elle est coupée en temps normal, mais s'active toute seule pendant les 10 minutes qui suivent le démarrage du serveur. /arcadia_adminpanel loginqueue affiche son état, loginqueue on ou off la force.

Redémarrages planifiés

/arcadia_adminpanel restart <minutes> [raison] programme un redémarrage, restart cancel l'annule. Dans le panneau, le bouton Redémarrage programmé le lance dans 15 minutes (clic) ou 5 minutes (clic droit). Les joueurs sont prévenus à 15, 10, 5, 3 et 1 minute, puis un compte à rebours s'affiche les 10 dernières secondes. À l'heure dite, le mod expulse tout le monde et arrête le serveur: c'est ton hébergeur ou ton script de lancement qui doit le relancer (déduit: le mod arrête le serveur, il ne le relance pas lui-même).

Pour des redémarrages quotidiens, ajoute des heures au format HH:MM dans restartScheduleTimes, par exemple ["06:00", "18:00"]. La liste est vide dans le pack.

Annonces

L'écran Annonces (announcer) compose un message, avec un sous-titre si tu veux et les codes couleur & (par exemple &6 pour doré), et choisit où l'afficher: dans le chat, en titre à l'écran, au-dessus de la barre d'action, en barre de boss, avec ou sans son de cloche. Le bouton Aperçu te le montre à toi seul avant l'envoi, et les dix dernières annonces restent là pour être renvoyées. announce <message> fait la même chose en commande.

Les annonces automatiques (broadcast) envoient une liste de messages à tour de rôle, toutes les 15 minutes par défaut. Elles sont coupées et la liste est vide: remplis autoBroadcastMessages puis bascule-les avec broadcast toggle.

Chat, monde et le reste

• Chat: chatlock verrouille le chat public (le staff peut toujours parler), clearchat fait défiler 100 lignes vides chez tout le monde.
• Contrôle du monde (world): heure (aube, jour, midi, crépuscule, nuit, minuit) et météo pour ta dimension, difficulté et règles du jeu pour tout le serveur.
• Liste blanche (whitelist): la même que /whitelist, avec activation, ajout par pseudo et retrait en deux clics.
• Waystones, warps et hologrammes: listes cliquables pour s'y rendre, création et suppression des warps de FTB Essentials, édition ligne par ligne des hologrammes Elite Holograms.
• Faire apparaître (summon): toutes les créatures du jeu et des mods; clic pour une, clic droit pour cinq.
• Mods Arcadia: les autres mods maison installés, avec un bouton vers leur propre écran et ce qui peut être coupé ou rechargé, par exemple ouvrir ou fermer l'hôtel des ventes.

Les commandes

Toutes les commandes commencent par /arcadia_adminpanel, suivi du mot du tableau. /arcadia_adminpanel help les liste dans le chat (clic sur une commande pour la placer dans la zone de saisie), et help <section> n'affiche qu'une section: panel, investigate, moderate, inventory, server, self ou cosmetic.

Les permissions et leurs rôles par défaut

Tous les nodes commencent par arcadia.adminpanel. suivi du mot du tableau. Le rôle indiqué est celui qui reçoit l'outil sans node particulier; un opérateur a tout.

Pour changer le rôle minimum d'un outil sans passer par LuckPerms, la config accepte une table staffRoleOverrides qui associe un node à HELPER, MOD, ADMIN ou NONE (personne, node seul). Mettre staffRoleAccess à false coupe les rôles: seuls les nodes et l'opérateur comptent alors.

La configuration fournie

Les fichiers sont dans config/arcadia/arcadiaadminpanel/. Le pack fournit quatre fichiers: config.json (réglages), jail_location.json (position de la prison dans l'Overworld), et jail.json et logins.json, vides, qui se remplissent en jeu. Voici les valeurs livrées dans config.json:

Les autres réglages gardent la valeur par défaut du mod (celles citées sur cette page: sauvegardes, instantanés de mort, invisibilité, AFK, radar, annonces automatiques, webhook...). D'après le code, le mod relit le fichier au démarrage et le réécrit au complet, si bien que ces réglages apparaissent dans le fichier après un premier lancement. Le fichier templates.json des modèles de sanction est créé de la même façon. Pense à /arcadia_adminpanel reload après une modification.

Le panneau est l'un des plus gros mods maison du pack: retrouve les autres dans la liste des mods.