Guide auteur
Ce guide couvre les bonnes pratiques pour créer des aventures interactives engageantes avec StoryForge — de la structure à la publication.
1. Introduction
StoryForge repose sur un principe simple : votre histoire est un **graphe de scènes**. Chaque scène contient du texte narratif et propose des choix au joueur. Chaque choix mène vers une autre scène.
Un bon scénario StoryForge se structure comme un arbre (ou un graphe avec des boucles) : une scène d'entrée, des embranchements, et plusieurs fins possibles.
Capture : éditeur graphe (canvas)
2. Structure d'un scénario
**Scène de départ** — obligatoire. C'est la première scène vue par le joueur. Définissez-la dans Paramètres → Scène de départ.
**Scènes intermédiaires** — le corps de l'histoire. Chaque scène a un titre (interne), un texte narratif et des choix.
**Scènes finales** — des scènes sans choix. Elles marquent une fin de l'aventure (bonne ou mauvaise).
**Boucles** — vous pouvez faire revenir le joueur vers une scène déjà visitée (ex: retour au carrefour). Évitez les boucles infinies sans issue.
Capture : panneau de détail nœud
Mini-jeux
Un mini-jeu transforme une scène en défi. Le joueur ne peut alors prendre que **deux chemins : Réussite ou Échec**.
Exemple Snake : atteindre le score cible pose le flag `snake_won` et la variable `snake_score`.
Exemple Labyrinthe : trouver la sortie pose `maze_ruins_won` (ou le flag du labyrinthe choisi). Un gouffre mène à l'échec.
Exemple Pac-Man : ramasser tous les fragments de carte pose `pac_courtyard_won` (ou le flag des ruines choisies). Se faire rattraper par un gardien mène à l'échec.
Exemple Canon : détruire l'obstacle, ouvrir la porte ou sauver le captif pose `cannon_palisade_won` (ou le flag du niveau choisi). Être à court de tirs mène à l'échec.
La section **Arène** ajoute des défis d'action (invasion, casse-briques, pong, chasse, estoc, clash, escorte, stealth, sumo). Même règle : Réussite ou Échec, 3 vies par partie.
Chaque partie commence avec **3 vies**. Un échec au mini-jeu retire une vie et permet de relancer le défi. À 0 vie, le joueur reprend le scénario depuis le début (3 vies à nouveau). Recommencer une partie remet aussi 3 vies.
Ajoutez le mini-jeu depuis le panneau de la scène, ou consultez le catalogue /minigames.
Capture : catalogue mini-jeux
3. Écrire de bons textes
• **Soyez concis** — Les joueurs lisent vite. Limitez chaque scène à 2-4 paragraphes.
• **Terminez par une tension** — Le texte doit donner envie de choisir. Finissez sur une question, un danger, une découverte.
• **Libellés de choix clairs** — « Ouvrir la porte » est mieux que « Option A ». Chaque choix doit être immédiatement compréhensible.
• **Cohérence de ton** — Choisissez un registre (aventure, horreur, humour) et maintenez-le sur tout le scénario.
Capture : exemples de textes bien rédigés
4. Publier
Avant de publier, lancez la **Validation** (bouton dans la barre d'outils). Corrigez toutes les erreurs bloquantes (rouge). Les avertissements (jaune) ne bloquent pas mais indiquent des scènes incomplètes.
Choisissez la **visibilité** :
- **Public** : indexé dans le catalogue, trouvable par tous.
- **Non répertorié** : accessible via lien direct uniquement.
Vous pouvez **dépublier** à tout moment depuis l'écran de publication.
Capture : écran publication
5. Gérer les versions
Chaque fois que vous atteignez un jalon important (fin d'un arc, refonte majeure), créez un **snapshot** depuis Versions & Visibilité.
Les snapshots vous permettent de **restaurer** une version précédente si une modification casse votre histoire. La version publiée dans le catalogue est toujours clairement identifiée.
Capture : historique des versions