🇬🇧 Read in English

ArchCore Admin

Panneau MJ pour ArchRust et ArchCore
AddOn Lua · Ace3 · commandes MJ d'ArchCore

Panneau de maître du jeu (MJ) pour le client ArchRust, connecté à un serveur ArchCore. C'est un AddOn Lua qui reprend le principe d'AzerothAdmin (WoW 3.3.5 / AzerothCore) : des onglets de boutons qui tapent les commandes MJ à votre place, et la lecture des réponses du serveur pour remplir le panneau.

1. Ce que fait AzerothAdmin (analyse)

AzerothAdmin est un AddOn WoW 3.3.5 en Lua sur Ace3 (environ 130 000 lignes, dont 45 000 de données de modèles 3D). Son fonctionnement se résume en cinq mécanismes :

Mécanisme	Dans AzerothAdmin
Envoi	chaque bouton appelle SendChatMessage(".commande arguments") ; AzerothCore lit les commandes . dans la discussion et applique le niveau de sécurité du compte
Lecture des réponses	crochet sur ChatFrame:AddMessage : les messages système sont analysés pour remplir les résultats de recherche (.lookup item), les infos du serveur, des PNJ ou des objets, et le journal
Contexte	la cible courante sert d'argument (UnitName("target")) ; certains boutons sont activés ou grisés à PLAYER_TARGET_CHANGED
Organisation	un onglet par famille (Main, Char, Tele, Ticket, Server, NPC, GO, Misc, Log) ; pour chacun, un fichier Commands/*.lua (logique) et un Frames/Frames_Section*.lua (disposition)
Confort	confirmations des commandes dangereuses, favoris et historique, points de téléportation, mini-menu, AceDB (réglages par compte et par personnage), 12 langues

2. Transposition à ArchRust et ArchCore

AzerothAdmin (WoW)	ArchCore Admin (ArchRust)
commandes .gm on, .tele, .additem…	commandes /kill, /move x,z, /create… d'ArchCore (crates/archcore/src/world/gm.rs), les mêmes que le panneau « Admin Commands » d'Archonia
SendChatMessage(".cmd")	RunMacroText("/cmd") : le client envoie au serveur toute commande / qu'il ne connaît pas, sans écho dans la discussion
crochet ChatFrame:AddMessage	filtres ChatFrame_AddMessageEventFilter : ArchCore répond à chaque commande par un message de discussion de type système, qu'ArchRust remet en CHAT_MSG_SAY sans auteur (lignes [?]) ; CHAT_MSG_SYSTEM est écouté aussi
UnitIsPlayer("target")	sous ArchRust, UnitIsPlayer ne vaut que pour soi : un autre personnage se reconnaît à son CID (< 0x40000000 chez ArchCore ; PNJ à partir de 0x40000000, monstres de 0x50000000)
niveau de sécurité connu du client	le client ne donne pas le niveau MJ aux AddOns : l'AddOn envoie /SetExp sans argument (sans effet) et lit la réponse (Commande inconnue → 0, Niveau MJ 3 requis… (le vôtre : 2) → 2, erreur de syntaxe → 3 ou plus)
.lookup item (recherche par nom)	absente d'ArchCore : le catalogue des objets du client (ArchRust.GetItemTemplate, GetItemIcon : ItemTemplateAll.ini, icônes du jeu) sert à choisir les objets ; sans lui (client plus ancien), objets désignés par TID, nom appris dans la réponse de /create ou /additem, favoris
.lookup creature	absente aussi : liste des monstres déjà rencontrés (ArchRust.GetUnits(), ciblés, simulés), retenue d'une session à l'autre
.account onlinelist	absente : liste des personnages en vue (ArchRust.GetUnits())
AceGUI / AceConfig, XML, FrameLib	non fournis par ArchRust : frames créées en Lua (Widgets.lua) ; les ScrollFrame ne découpant pas leur contenu, les listes défilent par décalage des données (molette)
icône de mini-carte	bouton « MJ » déplaçable + raccourci clavier (ArchRust.SetBinding)

Les onglets reprennent ceux d'AzerothAdmin pour lesquels ArchCore a des commandes :

Onglet	Commandes
MJ	niveau MJ détecté, /invincible, /speed (vitesse ×1 à ×10), /recast, /questreset, commande libre avec historique, catalogue de toutes les commandes, réglages
Joueurs	/kill, /level, /money, /rename_char, /chatban (5 min, 15 min, 1 h, 1 jour, durée libre, lever) sur un nom saisi, ciblé ou choisi parmi les joueurs en vue
Objets	objets du jeu affichés avec leur icône, leur nom, leur TID et leur niveau requis, par catégorie, par recherche et par classe (catalogue d'ArchRust), /create "nom" <TID> <quantité> <0|1>, /additem <TID> [quantité] (pour soi), issue de la commande expliquée, favoris
Butin	simulateur de farm et de butin : /simloot <TID du monstre> <nombre> [taux de butin] [taux d'or], monstre choisi dans une liste avec recherche, objets obtenus listés avec leur icône, leur quantité et leur fréquence
Téléport	/move x,z vers des coordonnées, sa position, celle de la cible ou un point enregistré (villages de départ d'ArchCore fournis)
Serveur	taux /GetExp… /SetPrestigeRate, bonus de discussion, /announce_restart (et annulation)
Journal	commandes envoyées et réponses du serveur, horodatées, 300 lignes par personnage

Les onglets Ticket, NPC et GO d'AzerothAdmin n'ont pas d'équivalent : ArchCore n'a pas encore ces commandes. Les commandes d'Archonia qu'il ne gère pas (arène, événements, failles…) sont listées en gris dans le catalogue (case « Afficher les commandes d'Archonia non gérées ») et restent envoyables par la commande libre.

3. Installation

1. Télécharger ArchCoreAdmin-vX.Y.Z.zip sur la page Releases et copier le dossier ArchCoreAdmin/ qu'il contient dans le dossier addons/ d'ArchRust, à côté d'ArchRust.exe (addons/ArchCoreAdmin/ArchCoreAdmin.toc).

2. Donner les droits MJ au compte, côté serveur, puis se reconnecter :

   UPDATE archcore_auth.account SET gm_level = 3 WHERE username = 'admin';

3. En jeu : /addons doit lister « ArchCore Admin ». À l'entrée en jeu, la discussion affiche le niveau MJ détecté.

4. Utilisation

• Ouvrir : bouton MJ (déplaçable), Ctrl+Maj+A, ou /aca. Échap ferme la fenêtre ; le bouton - (à côté de la fermeture) la réduit à une barre sans perdre les champs remplis, + (ou le bouton MJ, le raccourci, /aca) la rétablit.
• /aca gm|players|items|loot|teleport|server|log : ouvre un onglet.
• Objets : choisir une catégorie, taper une partie du nom ou un TID, cliquer un objet (molette pour défiler, survol pour le détail) ; le TID, le nom du favori et l'aperçu se remplissent. Sous les boutons, une ligne dit ce qu'il est advenu de la commande : objet donné, refus expliqué, ou silence du serveur avec ses causes possibles. Le bouton Classe (clic, molette) filtre par classe si le client donne les classes des objets.
• Butin : choisir le monstre dans la vue Monstres (recherche par nom ou TID, clic), ou le désigner par son TID ou le bouton Cible. La liste contient les monstres déjà rencontrés, ceux en vue d'abord. Puis nombre de monstres (1 à 10 000), taux de butin et d'or (vides : ceux du serveur), Simuler. Le serveur tire le butin de chaque monstre comme à sa mort (or, groupes de butin, objets propres au monstre), sans rien créer ; le niveau du tueur est celui de votre personnage. Les 40 objets les plus fréquents sont listés, avec leur quantité et leur fréquence pour 100 monstres ; la réponse complète est dans le Journal.
• /aca probe : redétecte le niveau MJ. /aca send <commande> : envoie une commande libre.
• /aca bind <touche> (/aca bind seul : aucun raccourci), /aca confirm on|off, /aca replies on|off (réponses du serveur dans la discussion), /aca launcher on|off, /aca reset.
• Les boutons d'une commande que votre niveau ne permet pas sont grisés. Le niveau requis vient du catalogue, corrigé par le serveur dès qu'il répond « Niveau MJ X requis » (les niveaux se changent dans world.conf, GM.CommandLevel.<commande>).
• /kill, /level, /rename_char, /chatban et /announce_restart demandent une confirmation qui affiche la commande exacte.

Réglages enregistrés dans saved-variables/ArchCoreAdmin.lua : profil (réglages, positions), global (points de téléportation, objets favoris et noms appris, monstres rencontrés, niveaux requis appris), par personnage (journal, historique des commandes libres).

5. Organisation du code

ArchCoreAdmin/
  ArchCoreAdmin.toc   manifeste (ordre de chargement, SavedVariables)
  Locales.lua         textes anglais (par défaut) et français (AceLocale)
  Catalog.lua         catalogue des commandes : nom, niveau, arguments, confirmation ; classes et
                      parties du corps
  Core.lua            objet AddOn (Ace3), construction et envoi des commandes, issue des commandes,
                      niveau MJ, catalogue des objets d'ArchRust, monstres connus, /aca
  Replies.lua         lecture des réponses d'ArchCore (niveau, taux, objets, refus, invincibilité,
                      simulation de butin sur plusieurs lignes)
  Widgets.lua         boutons, champs, cases, listes à la molette, icônes et listes d'objets ;
                      grisage selon le niveau
  Frames.lua          fenêtre (logo en tête), onglets, réduction, bouton lanceur
  media/logo.png      logo de l'en-tête (512 × 228, fond transparent)
  Sections/*.lua      un fichier par onglet (Loot.lua : simulateur de butin)
tests/banc-essai/     banc d'essai Rust (moteur d'AddOns d'ArchRust, sans affichage)
docs/BESOINS-CLIENT-SERVEUR.md   ce que le panneau attend d'ArchRust et d'ArchCore

Ajouter une commande quand ArchCore en gère une nouvelle

1. Catalog.lua : def("nom", niveau, { NAME, INT_OPT… }, { section = "players", confirm = true }) (le nom respecte la casse du serveur).
2. Dans l'onglet voulu : W.Button(page, L["LIBELLE"], 120, function() ACA:Run("nom", { … }) end, L["TIP_…"], "nom").
3. Locales.lua : libellé et info-bulle en anglais et en français.
4. Si la réponse du serveur apporte une information utile au panneau, un analyseur dans Replies.lua.

6. Limites connues

• Les réponses d'ArchCore sont en français : leur lecture (Replies.lua) suit les textes de gm.rs. Si le serveur change une phrase, la commande marche toujours mais le panneau ne met plus à jour la valeur correspondante.
• La sonde du niveau MJ (/SetExp sans argument) apparaît dans le journal MJ du serveur, une fois par connexion (désactivable : case « Détecter mon niveau MJ »). Sa réponse est masquée dans la discussion.
• Une réponse est rattachée à la plus ancienne commande en attente (5 s au plus) : un message système sans rapport arrivé au même moment peut être noté comme réponse dans le journal.
• /move garde l'altitude actuelle (ArchCore n'a pas de carte des hauteurs).
• ArchRust dessine les boutons et champs du panneau par-dessus la fenêtre de confirmation quand elles se recouvrent : la confirmation de l'AddOn s'ouvre donc sous le panneau.
• Les réponses du serveur arrivant en CHAT_MSG_SAY sans auteur, tout message sans auteur reçu dans les 5 s qui suivent une commande peut lui être attribué.
• Le choix visuel des objets demande un client ArchRust qui donne le catalogue des objets aux AddOns ; sinon l'onglet Objets revient à la saisie du TID. Les noms sont ceux du client (anglais).
• Trois manques d'ArchRust, décrits dans docs/BESOINS-CLIENT-SERVEUR.md ; le panneau s'en sert dès qu'ils sont comblés :
  • les refus du serveur (messages en /) n'arrivent pas aux AddOns : au bout de 5 secondes, le panneau donne les causes possibles sans pouvoir dire laquelle est la bonne ;
  • le catalogue vient des fichiers du client, ajouts d'Archonia compris, et ne dit ni les objets absents du serveur, ni les classes, ni les emplacements, ni les statistiques : pas de filtre de classe, et l'info-bulle s'arrête à la partie du corps ;
  • pas de liste des monstres : seuls ceux déjà rencontrés sont proposés.
• Le catalogue est lu en une fois à la première ouverture de l'onglet Objets (environ 0,6 s et 14 Mo pour 23 000 objets, mesuré au banc).
• /simloot liste 40 sortes d'objets au plus (les plus fréquentes) ; les autres sont résumées en une ligne. 10 000 monstres au plus par simulation.

7. Tests

cd tests/banc-essai
cargo run --release

Le banc charge l'AddOn dans archrust-addons, le vrai moteur Lua d'ArchRust, pris dans le dépôt BlaMacfly/ArchRust (une copie locale se branche par [patch], voir tests/banc-essai/Cargo.toml). Il tourne sur GitHub Actions à chaque envoi et vérifie 152 points : chargement sans erreur, sonde et lecture des trois réponses possibles, sonde sans réponse, construction de chaque type d'argument et refus des entrées invalides, grisage selon le niveau, confirmation au clic, lecture des taux et des noms d'objets, discussion des joueurs non confondue avec les réponses, reconnaissance des personnages ciblés, clics à la souris sur les boutons, absence de chevauchement et de débordement dans les sept onglets, catalogue des objets (catégories, recherche, icônes, choix à la souris, favoris, info-bulle), issue de /create et /additem (objet donné, refus expliqués, silence du serveur), liste et recherche des monstres, simulation de butin (commande envoyée, en-tête et lignes lues, liste et résumé, refus et silence), réduction et rétablissement de la fenêtre, repli sans catalogue, SavedVariables. Les champs qu'ArchRust ne donne pas encore (objets absents du serveur, classes, emplacements, statistiques, liste des monstres) sont simulés en Lua : leur rendu est vérifié, pas leur lecture réelle.

Essai en jeu (2026-10-22) : client ArchRust contre ArchCore (Rust) et MariaDB locaux, compte MJ de niveau 3. Niveau détecté (« 3 ou plus ») et réponse de la sonde masquée, sept taux lus, objet créé (TID 136, nom appris), invincibilité activée puis désactivée, journal rempli, confirmation de /kill. Captures dans docs/captures/. Non essayés en jeu : /kill, /level, /money, /rename_char, /chatban, /move et /announce_restart sur un vrai personnage (seule leur construction est vérifiée par le banc), et la détection d'un niveau 1 ou 2.

Publier une version

1. Mettre à jour ## Version: dans ArchCoreAdmin/ArchCoreAdmin.toc et ajouter une section ## X.Y.Z — date en tête de CHANGELOG.md.
2. Pousser une étiquette : git tag vX.Y.Z && git push origin vX.Y.Z. Le workflow Release vérifie que l'étiquette correspond au .toc et publie le zip avec les notes du changelog.

Licence

GPL-3.0-or-later, comme ArchRust, ArchCore et AzerothAdmin (dont aucun code n'est repris : seul le principe l'est).