← Tous les projets
Projets 02/Open source · Lua, TypeScript, MCP

WoW Companion

Depuis une fenêtre dans WoW Forever, vous posez une question à Claude ou à Codex sur une quête ou un objet. L’IA voit votre personnage, vos quêtes et vos sacs, interroge la base de données du monde et peut proposer un repère sur la carte.

Ouvrir le dépôt ↗

01Ce que ça fait

Tapez /ai et une question dans le jeu, et une fenêtre flottante s’ouvre avec la réponse. L’IA peut lire votre personnage, votre position, votre journal de quêtes, vos sacs et votre équipement, chercher des quêtes, des PNJ et des objets dans la base de données du monde, et proposer un repère. Le repère n’est posé que lorsque vous cliquez sur un bouton de la fenêtre. Le projet a trois parties : un addon Lua, un compagnon TypeScript qui tourne sur votre PC et un serveur MCP.

02Comment le jeu parle à l’IA

Un addon de jeu ne peut ni ouvrir de connexion réseau ni lancer un programme. L’addon dessine donc une fine ligne de pixels colorés le long du bord de la fenêtre du jeu, et le compagnon la lit par capture d’écran. Les réponses reviennent par 200 petits dossiers d’addon que le compagnon remplit de fichiers Lua. J’ai posé une règle dès le départ : aucune saisie clavier ou souris simulée et aucune lecture de la mémoire du jeu, pour rester dans les conditions d’utilisation de Blizzard.

03Comment l’IA reste en lecture seule

Le compagnon lance l’outil d’IA que vous avez choisi et lui donne un serveur MCP avec six outils : l’état du jeu, la recherche d’un PNJ, d’une quête ou d’un objet, les suggestions d’amélioration d’équipement et la pose d’un repère. Aucun fournisseur n’a accès à un shell ni à l’écriture de fichiers. Claude peut faire une recherche web limitée à trois sites, et la recherche web est désactivée pour Codex. Un adaptateur Cursor existe, mais il est désactivé par défaut.

04Comment je l’ai construit

Je suis parti d’une spécification écrite : 18 décisions, 25 critères d’acceptation et 14 tranches, chacune relue avant d’être fusionnée. La première version a pris trois jours. Le lien par pixels est testé avec le vrai encodeur Lua exécuté sous Lua 5.1.5, le dialecte utilisé par le jeu, et décodé par le côté TypeScript. Je ne l’ai testé que sous Windows 11.

Comment c’est construit

  1. Jeu

    WoW Forever

  2. Passerelle

    Ni saisie, ni lecture mémoire

  3. Compagnon

    Sur votre PC

  4. Outil d’IA

    Votre propre compte

  5. Outils du jeu

    MCP en lecture seule

Sélectionnez un élément du schéma pour voir son rôle. Chaque couleur est un flux à travers le système.

© 2026 Benoit Ardiet · Quito, Équateur · UTC−5GitHubLinkedInAucun pistage, aucun cookie.