====== Commentaires du joueur à l’auteur ======

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 ''@'' :

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

===== Ce que fait Donjon FI =====

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 [[reference:divers:nombre_de_mots|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.

===== Récupérer les commentaires =====

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

==== Côté joueur ====

  * 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.//

==== Côté auteur ====

Deux façons de lire les retours :

  * **Dans le jeu** : charger le ''.sol'' et lancer le [[reference:debogage:mode_triche|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 [[reference:divers:format_fichier_solution|Format des fichiers sauvegarde (.sol)]].

===== Limitations =====

  * **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.

===== Conseil aux auteurs =====

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 [[faq:modifier_texte_aide|texte d’aide]] de votre scénario :

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

===== Voir aussi =====

  * [[reference:debogage:mode_triche|Fichier solution et mode triche]] — rejouer un ''.sol''.
  * [[reference:divers:format_fichier_solution|Format des fichiers sauvegarde (.sol)]] — structure du fichier et préfixes des étapes.
  * [[reference:debogage:magneto|Magnétoscope]] — rejeu pas-à-pas avec vérification des sorties (''.rec'').

{{tag>commentaire commentaires auteur joueur bêta beta bêta-test beta_test testeur testeurs retour retours feedback étoile etoile arobase générer_solution generer_solution sol rec débogage debogage}}