Pendant une partie, un joueur (ou un bêta-testeur) peut laisser un commentaire à l’attention de l’auteur directement dans l’invite de commande, sans interrompre sa partie.

Il suffit de commencer la ligne par * ou @ :

> * la description de la cave est confuse, je ne vois pas où est la porte
> @ super, ce passage m’a fait rire !

Une ligne qui commence par * ou @ :

• n’est pas interprétée comme une commande (pas de « Je ne comprends pas… ») ;
• ne produit aucune réponse du jeu ;
• est affichée dans la sortie avec un style distinct des commandes normales, afin de la repérer facilement ;
• n’est pas comptabilisée dans les statistiques (nombre de mots, nombre de caractères) ;
• est malgré tout enregistrée dans l’historique de la partie, à sa place exacte dans la chronologie.

C’est ce dernier point qui rend la fonctionnalité utile : le commentaire voyage avec la partie.

Le joueur n’a rien à envoyer automatiquement : Donjon FI ne transmet aucune donnée à l’auteur. Le transfert est manuel, via un fichier.

• Jouer normalement, en laissant des commentaires * ou @ au fil de la partie.
• Avant la fin du jeu, entrer la commande générer solution.
• Sauver le fichier .sol proposé, et l’envoyer à l’auteur (courriel, forum…).

Remarque : la commande générer enregistrement (.rec) conserve elle aussi les commentaires, en plus des sorties du jeu.

Deux façons de lire les retours :

• Dans le jeu : charger le .sol et lancer le mode triche. Les commentaires réapparaissent au bon endroit de la partie, dans le contexte exact où le joueur les a écrits.
• Dans un éditeur de texte : ouvrir le .sol (c’est du texte) et chercher les lignes c:* et c:@. Voir Format des fichiers sauvegarde (.sol).

• Partie terminée : une fois le jeu fini, seules quelques commandes restent acceptées (recommencer, annuler, générer solution…). Un commentaire entré après la fin affiche « Le jeu est terminé. » et n’est pas conservé — il faut donc commenter avant la fin, ou générer la solution puis annoter le fichier à la main.
• Question en cours : si le jeu attend une réponse (choix, question, appui sur une touche), la ligne saisie est prise comme réponse, pas comme commentaire. Il faut d’abord répondre, puis commenter au tour suivant.

Cette fonctionnalité n’est pas annoncée par le jeu : pensez à l’indiquer à vos bêta-testeurs, par exemple dans le texte d’introduction ou dans le texte d’aide de votre scénario :

Pour me laisser un commentaire, commencez votre ligne par une étoile :
* ici je suis bloqué, je ne vois pas quoi faire

• Fichier solution et mode triche — rejouer un .sol.
• Format des fichiers sauvegarde (.sol) — structure du fichier et préfixes des étapes.
• Magnétoscope — rejeu pas-à-pas avec vérification des sorties (.rec).