AI Them'All
Module Foundry VTT de génération de texte et d'images par IA, pensé pour les tables de jeu de rôle : portraits de personnages, images d'objets ou de pouvoirs, descriptions, éléments d'histoire… directement depuis les feuilles d'Actor et d'Item.
AI Them'All (ATA) fonctionne seul, sur n'importe quel système de jeu. Lorsque le module Rule Them'All (RTA) est actif, il s'y intègre de façon optionnelle au travers de l'API d'intégration générique de RTA, sans dépendance obligatoire dans un sens comme dans l'autre.
Statut : en développement. Réglages des services texte et image, génération, cards et intégration à Rule Them'All (configurateur, champs des feuilles, concepteur de règles). Le mode autonome sans RTA n'offre pas encore de cards. Les interfaces décrites ici viennent de la Spécification technique d'interconnexion RTA v1.0 (21/10/2026) et restent des contrats à implémenter.
Fonctionnalités prévues
Génération texte et image
- Génération de texte (descriptions, biographies, notes) et d'images (portrait, token, objet, pouvoir…).
- Prompt de la card, complément facultatif saisi au moment de la génération.
- Images de référence avec un rôle explicite : identité à préserver, style à évoquer, fond/décor à intégrer, image actuelle à éditer.
- Pour les images : choix de la résolution, du format, de la qualité et du nombre de variantes (1 à X selon les capacités réelles du modèle ; plusieurs appels orchestrés si le fournisseur ne produit qu'une image par appel).
- Galerie de sélection : agrandir, comparer à l'original, relancer, modifier les instructions, annuler. La cible n'est modifiée qu'après validation explicite.
- Conservation de la référence de l'original et journal d'opération minimal.
Concepteur de règles (nouvelle fonction)
- Le MJ décrit une règle en français ; l'IA la traduit en réponses aux parcours de l'assistant de Rule Them'All, que l'assistant valide et prévisualise.
- Rien n'est écrit sans l'aperçu et le clic du MJ : passage obligé par
planAssistant puis applyAssistant de l'API stable de RTA.
- Disponible uniquement quand Rule Them'All (API ≥ 1.1.0) est actif. Plan détaillé : docs/CONSIGNES.md.
Cards de génération
Chaque type de génération est une card configurable et réutilisable (aucune n'est codée en dur ; exemples : Image PJ, Description PJ, Image PNJ, Image Objet, Image Pouvoir, Description Pouvoir). Une card regroupe :
| Rubrique | Contenu |
|---|
| Identité | ID stable, libellé, description, état actif, types de documents concernés, ordre |
| Destination | Champ cible typé (texte / texte riche / image), portée instance ou définition |
| Sources | 0..N sources ordonnées : champs, paramètres, observations narratives, contenus, image/nom du document |
| Instructions | Prompt, complément à l'exécution, politique compléter / réécrire / remplacer |
| Références visuelles | Identité, inspiration, fond, image actuelle, avec priorité |
| Exécution | Agent, profil, modèle, héritage ou surcharge des paramètres |
| Présentation et droits | Icône sur le champ, utilisateurs autorisés, mode verrouillé/déverrouillé |
| Validation | Aperçu, confirmation, conservation de l'original, reprise sur erreur |
Une petite icône de génération apparaît sur les champs éligibles et autorisés. Si plusieurs cards ciblent le même champ, un sélecteur de recettes s'ouvre.
Paramètres du monde
Une entrée AI Them'All dans les paramètres du monde Foundry ouvre une application dédiée :
| Onglet | Contenu |
|---|
| Agents | Plusieurs agents nommés : OpenAI, Ollama, API compatible OpenAI, futurs adaptateurs ; endpoint, authentification, test de connectivité |
| Modèles | Modèles texte et image par agent, découverte automatique quand c'est possible, capacités déclarées/vérifiées |
| Sorties image | Résolutions, formats, transparence, nombre de variantes (filtrés selon le modèle) |
| Profils | Profils réutilisables (Rapide, Qualité, Privé local, Coût réduit…) |
| Sécurité | Politique cloud/local, sources privées, secrets du MJ, confirmation d'envoi, journalisation limitée |
Deux modes de fonctionnement
Mode autonome (sans Rule Them'All)
- ATA enregistre ses propres menus de configuration, ses cards globales et des adaptateurs de documents Foundry natifs.
- Action par clic droit sur l'image ou un champ texte d'une feuille déverrouillée, dès que le document et le chemin de stockage sont détectables et éditables.
- Sélection avancée de la destination pour les systèmes tiers ; les champs dérivés ou éditeurs propriétaires peuvent demander un adaptateur spécifique.
- Aucune écriture aveugle dans le DOM.
Mode intégré (avec Rule Them'All)
Quand RTA est actif et expose une API d'intégration compatible, ATA :
- ajoute une entrée Systèmes → AI Them'All, juste après « Feuilles », dans le configurateur RTA ;
- affiche ses cards avec la présentation native des cards RTA (tuiles/lignes, tags, Créer, clic droit), filtrées par Ruleset ; leur persistance reste dans ATA ;
- cible les vrais champs des feuilles RTA (nœuds de layout identifiés par une référence stable), pas des nœuds HTML ;
- lit les sources (y compris les observations narratives : les mots de l'échelle de description, jamais le nombre) en respectant Permissions,
seenBy et visibleIf ;
- écrit les cibles via les services RTA (transactions, journal, relais MJ) après validation côté service ;
- place son icône dans l'emplacement d'action que RTA rend lui-même sur chaque champ compatible ;
- propose un concepteur de règles dans l'assistant de Ruleset quand RTA expose l'API de l'assistant (API 1.1.0) : le MJ décrit une règle en français, l'IA remplit les parcours, l'assistant valide et montre l'aperçu, le MJ clique pour appliquer. Il peut aussi créer ou configurer un Modèle de Contenu (donner une action à une arme, régler ses champs) : le panneau montre les changements et les écrit par l'API stable du configurateur quand le MJ clique sur Appliquer au Contenu. L'IA n'écrit jamais directement dans un Ruleset.
Interconnexion avec Rule Them'All
Le couplage repose sur l'API générique game.ruleThemAll.integrations (prévue pour RTA 1.1.0). RTA ne connaît pas ATA : il expose des points d'extension utilisables par n'importe quel module compagnon.
Détection et négociation
// Enregistrement au "setup" de Foundry, quel que soit l'ordre de chargement des modules
Hooks.on("ruleThemAllRegisterIntegrations", integrations => registerWithRTA(integrations));
// Filet de sécurité au "ready" (l'enregistrement est idempotent)
Hooks.once("ready", () => {
const integrations = game.ruleThemAll?.integrations;
if (integrations) registerWithRTA(integrations);
});
function registerWithRTA(integrations) {
const compatible = integrations.apiVersion?.split(".")[0] === "1"
&& REQUIRED_CAPABILITIES.every(c => integrations.capabilities.includes(c));
if (!compatible) return reportStandaloneFallback(integrations); // diagnostic visible, mode autonome conservé
// registerConfiguratorSection, registerSheetFieldAction, onRulesetChange…
}
Points d'extension utilisés
| Besoin ATA | API RTA |
|---|
| Entrée de navigation + cards hébergées | registerConfiguratorSection({ parentGroup: "systems", after: "sheetDefinitions", cards }) |
| Découverte des feuilles et des champs ciblables | listSheetDefinitions, listBindableFields, describeField |
| Lecture des sources | listSourceCandidates, resolveSource |
| Écriture des cibles | validateTarget, updateTarget (avec expectedCurrent pour éviter tout écrasement) |
| Icône sur les champs de feuille | registerSheetFieldAction |
| Champs supprimés ou modifiés | onRulesetChange / hook ruleThemAllRulesetChanged |
Un champ est désigné par une référence stable :
{ rulesetId, sheetId, target: "actor" | "item", contentTypeId?, nodeId? | slot?: "header.img" | "header.name" }
Si le champ disparaît ou change de type, la card est marquée invalide avec une explication ; elle n'est jamais réaffectée silencieusement à un autre champ.
Cycle de vie
| Situation | Résultat |
|---|
| ATA seul | Interface et génération autonomes |
| RTA seul | Aucune entrée ATA |
| RTA puis ATA, ou ATA puis RTA | Même intégration après rechargement |
| RTA désactivé | ATA conserve ses données et revient en autonome |
| RTA réactivé | Réintégration sans doublon de navigation ni de cards |
| API incompatible | Mode autonome conservé, diagnostic visible |
ATA ne déclare aucune dépendance à RTA dans son module.json.
Sécurité et confidentialité
- Une génération ne modifie jamais de données mécaniques (caractéristiques, règles) : seules les cibles configurées, typées et autorisées sont modifiables.
- Un joueur ne peut ni lire un champ secret via une source IA, ni contourner un droit d'écriture ; les contrôles sont faits au traitement, pas seulement sur le bouton.
- Les secrets (clés d'API) ne sont jamais copiés dans les cards, les prompts enregistrés ou les journaux accessibles aux joueurs. Les settings Foundry n'étant pas un coffre-fort, un proxy/backend dédié est envisagé pour ne pas exposer de clés aux joueurs.
- Le MJ décide quels champs peuvent être envoyés à une IA cloud.
- Étapes séparées : lecture des sources, appel au fournisseur, upload du fichier, écriture du document, avec reprise ou annulation en cas d'erreur.
- Quotas, coûts, délais, annulation et limite de variantes explicites ; nettoyage configurable des images temporaires.
Modèle de données (proposition)
- Agent (
id, provider, endpoint, credentialRef, models[], capabilities)
- Model (
id, agentId, modality, capabilities)
- Profile (
id, defaults)
- GenerationCard (
id, rulesetId?, documentTypes[], targetRef, sourceRefs[], prompt, visualRefs[], overrides, permissions, enabled)
- GenerationRun (
id, cardId, documentUuid, outputRefs[], selectedRef?, status)
Feuille de route
| Lot | Contenu |
|---|
| RTA-1 | (côté Rule Them'All) Contrat générique d'extension : navigation, cards, champs, sources, cibles, actions de champs, cycle de vie |
| ATA-1 | Module autonome, registre des agents et modèles, génération texte/image, permissions |
| ATA-2 | Cards, cibles/sources et recettes, intégration au configurateur RTA, icônes sur les feuilles |
| ATA-3 | Images de référence/inspiration/fond, résolution et variantes, galerie et sauvegarde validée |
| ATA-4 | Adaptateurs pour systèmes tiers, profils avancés, historique, robustesse |
| ATA-5 | Concepteur de règles dans l'assistant RTA (nécessite les lots RTA-J à L), actif seulement si RTA ≥ 1.1.0 est présent ; plan d'origine dans docs/CONSIGNES.md (sa dépendance obligatoire à RTA a été remplacée par le mode autonome) |
Compatibilité
- Foundry VTT v14 (ApplicationV2, menus de paramètres, FilePicker), à vérifier en exécution.
- Rule Them'All ≥ 1.1.0 pour le mode intégré (API d'intégration
1.x) ; facultatif.
Développement
- Tests :
npm test (runner Node intégré, aucun appel réseau ; les réponses d'IA sont simulées).
- Publication : monter la version dans
module.json (et l'URL download) et CHANGELOG.md, pousser sur main, lancer le workflow Release à la main. Après chaque mise à jour, Ctrl+F5 sur tous les clients.
