La Forge Unifiée est l'outil central de production de FRACTILIS. C'est ici que le lore devient des données, et que les données alimentent Godot 4.
Structure de l'interface
- Sidebar gauche — Navigation entre les vues (Dashboard, Timeline, Graphe, Kanban, IA, Carte, Articles...)
- Zone principale — Contenu de la vue active
- Barre supérieure — Recherche spotlight, autosave, mode L2, export
Raccourcis clavier essentiels
- Ctrl+K — Spotlight Search (recherche dans tout le corpus)
- Ctrl+N — Nouvel article
- Ctrl+S — Sauvegarde manuelle
- Ctrl+/ — Ouvrir l'assistant IA
- Backspace — Revenir à la vue précédente
Exercice pratique : créer un Personnage Non-Joueur (PNJ) pour le District Alpha.
- Clique "Nouveau +" en haut à gauche ou Ctrl+N
- Sélectionne le template "Personnage / PNJ"
- Remplis : Nom (obligatoire), Statut (brouillon → en_revision → canon), Description L1
- Ajoute les tags : ex. District Alpha, Dirigeants, PNJ secondaire
- Le Canon Checker analyse ton texte en temps réel — icône rouge = conflit lore
- Sauvegarde Ctrl+S — l'autosave Firebase se déclenche en arrière-plan
Champs disponibles par type
Chaque type d'article (personnage, lieu, faction, entité, artefact, événement, concept, game_item) a ses champs spécifiques. Le formulaire s'adapte automatiquement au type sélectionné.
La puissance de la Forge est dans les relations entre les entités. Utilise les Wikilinks pour connecter ton article à d'autres.
Syntaxe Wikilink
Éditeur de Relations
- Chaque article a une section "Relations" dédiée
- Types de relation : allié, ennemi, parent, enfant, lié à, appartient à...
- Les relations alimentent le Graphe force-directed (vue Graphe)
- Double-clic sur un nœud du graphe → ouvre l'article
La Forge intègre un assistant IA connecté à Groq (modèle llama-3.1-8b-instant). Il connaît le contexte FRACTILIS grâce au système prompt automatique.
Prompts recommandés par type
- Personnage : "Génère une description L1 pour un PNJ Arcaniste du District Bêta, ton : Transistor"
- Lieu : "Décris le District Gamma sous l'angle d'un habitant ordinaire 18 ans après la Fracture"
- Écho : "Crée une entité Écho de niveau Beta liée à la Fracture Omega de Tessyr"
- Événement : "Écris un fragment d'archive sur les 72h qui ont suivi la Fracture du 18/11/2047"
Limites de l'IA
L'IA peut suggérer des éléments qui violent le Canon (elle ne connaît pas toutes les décisions D1-D15 de mémoire). Toujours passer le Canon Checker sur le contenu généré avant de le sauvegarder.
Le Canon Checker analyse automatiquement le texte de tes articles pour détecter les violations des décisions canon D1-D15.
⚠ Patterns qui déclenchent une alerte
- "Alaric Kalen" → violation D1 (le père d'Eran s'appelle Nerys)
- "11 novembre 2047" ou "17 novembre" → violation D2
- "4 districts" ou "6 districts" → violation D3
- "classe mage" ou "guerrier" ou "voleur" → violation D11
- "guildes avant la Fracture" → violation D9
- "Veyra est malveillante" → violation D14
Comportement attendu
Le Canon Checker est formatif — il t'explique pourquoi c'est un problème et te propose une correction. Il ne bloque pas sec. Tu peux décider de sauvegarder malgré une alerte (avec avertissement visible).
Les Game Items sont des entités spéciales avec des statistiques numériques destinées à être exportées vers Godot 4 via DataHandler.gd.
- Clique sur "Items Godot 🎮" dans la sidebar
- Crée un nouvel article de type game_item
- Remplis les stats avec les sliders : PV base, Dégâts, Agilité, Résistance magie, Masse
- Indique le chemin asset : res://assets/items/mon_item.glb
- Coche "Export Godot Ready" quand tu es satisfait
UUID automatique
Chaque Game Item reçoit un UUID 36 caractères automatiquement. C'est la clé que DataHandler.gd utilise pour retrouver les données : DataHandler.get_stats("uuid-ici")
Avant d'exporter vers Godot, la Forge vérifie que les statistiques sont cohérentes avec les lois physiques de FRACTILIS.
Règles de blocage
- Masse arme > 100kg → BLOCAGE export (aucun humain ne peut le porter)
- Dégâts > 2× PV base → ALERTE (one-shot impossible sauf boss Omega)
- Résistance magie > 95% → ALERTE (boss Omega uniquement)
- PV base ≤ 0 ou > 99 999 → BLOCAGE validation
- Agilité > 100 → BLOCAGE
- Asset path sans "res://" → BLOCAGE
Pourquoi ces règles ?
Elles garantissent que le jeu reste équilibré et cohérent. Une arme de 150kg brise le game design. Un PNJ avec 100% de résistance magie casse le système Arcaniste.
Une fois tes Game Items validés, tu peux compiler l'export qui alimentera DataHandler.gd dans Godot 4.
- Va dans la vue "Export Godot" dans la sidebar
- Clique "Compiler l'export" — vérifie les stats de chaque item
- Télécharge data_export.json
- Place le fichier dans le projet Godot : res://data/data_export.json
- DataHandler.gd lit automatiquement ce fichier au démarrage
La Forge a deux couches de contenu. Le Layer 1 est ce que les joueurs peuvent découvrir. Le Layer 2 contient les vérités que seuls les Concepteurs connaissent.
Activer le mode L2
- Clique sur le badge "L2" en haut à droite de la Forge
- Contacte l'Architecte pour obtenir le code d'accès Layer 2
- Les sections [L2] et [ARCH ONLY] deviennent visibles
- Le badge passe en violet — tu es en mode protégé
Décisions L2 que tu as maintenant accès
D8 (Mort Grise), D13 (Mira dans l'Axion), D14 (Veyra piégée), D15 (Dirigeants responsables). Ces révélations doivent rester en Layer 2 dans la Forge — jamais exposées côté joueur.
En tant que Concepteur, tu as accès à l'onglet "Propositions en attente" — les idées soumises par les Membres via le Résonateur.
- Clique sur "📥 Propositions" dans la sidebar (badge rouge = nouvelles)
- Chaque proposition affiche : titre, auteur, description, résultat validation IA
- REJETER → archive la proposition + motif (le Membre peut voir la raison)
- FORGER → charge la proposition dans l'interface complète de la Forge. Tu ajoutes les stats, l'UUID, le vérificateur physique
- CANONISER → passe en statut canon + attribue +1 Mérite au Membre auteur
★ Règle d'or du FORGER
Quand tu forges une idée membre, tu la transformes et l'améliores — tu ne la trahis pas. Garder l'essence de l'idée originale, même si tu dois corriger des éléments lore ou technique.
✓ Tutoriel Forge terminé !
Tu connais maintenant tous les outils de la Forge. Commence par créer ton premier article et explore le graphe de relations.