Modification de Mod:Créer un dialogue

Ce tutoriel vous expliquera comment créer ou modifier des dialogues dans ''Nous Aurons''.
[[file:Ecran Notepad++.jpg|thumb|Ce tutoriel utilise principalement l'éditeur de texte Notepad++.]]

== Outils requis ==
* [[Mod:Éditeurs#Notepad.2B.2B|Notepad++]]
* [[Mod:Éditeurs#.C3.89diteur_de_niveaux_.28Level_editor.29|Éditeur de niveaux (''Level Editor'')]]

== Avant de commencer ==
Prenez le temps de parcourir la section ''Speech'' du [http://10projets.org/nousaurons/editor_readme.html#Levelsection8 fichier "readme" de l'éditeur de Fallout Tactics] (anglais).

== Créer un dialogue ==
=== Accéder au fichier '''.txt''' du lieu ===
Chaque lieu possède son fichier de dialogues (au nom de code éponyme) déjà importé. Il se trouve dans ''Game/NousAurons/locale/'' (version française) et ''Game/core/locale/'' (version anglaise). Certains de ces fichiers sont dans un dossier du même nom pour permettre d'y stocker des voix.{{Idée|Tout fichier '''.mp3''' (dans le même dossier) avec le même nom de fichier qu'une entrée de dialogue (ex: '''AJOUT_Di_1_1.mp3''' pourra être entendu dans le jeu.}}
=== Commencer l'écriture ===
# Ouvrez les deux fichiers '''nom_de_code_du_lieu_ou_ajouter_le_dialogue.txt''' et pour chacun d'eux:
## Appuyez sur {{Faux bouton|ctrl|couleur=blanc}}+{{Faux bouton|f|couleur=blanc}} et cherchez "// DIALOGUES"
## Copiez/collez le code suivant: <syntaxhighlight>
AJOUT_Di_1 = {<Ck>- Portion de dialogue}
</syntaxhighlight>
# Ajouter autant de portions de dialogues qu'il vous faut.
# Accédez au menu {{Faux bouton|File|couleur=blanc}} puis {{Faux bouton|Save|couleur=gris}}.

=== Convention d'écriture ===
* Chaque nom de code de dialogue (ex:''AJOUT_Di_1'') doit être unique dans le fichier où il se trouve.
* '''''AJOUT_'':''' aide à retrouver le dialogue en premier dans la liste alphabétique lorsqu'il est intégré à l'[[Mod:Éditeurs#.C3.89diteur_de_niveaux_.28Level_editor.29|éditeur de niveaux]].
* '''''Di_'':''' indique qu'il s'agit d'une portion de dialogue.
* '''''Acc'':''' indique qu'il s'agit de la première portion de dialogue du personnage.
* '''''R'':''' indique qu'il s'agit d'une réponse du joueur.
* '''''Rdm'' suivi d'un chiffre de 1 à 6:''' est utilisé pour indiquer que la portion de dialogue flottera au dessus de la tête du personnage
* '''''OBJ'':''' indique que la portion de dialogue est une quête, ou relié à une quête.
* '''''Pers'' suivi d'un chiffre de 1 à 6:''' réfère à un personnage dont le nom de code est identique dans l'éditeur de niveaux.
* '''''Int'' et ''Cha'':''' indiquent une portion de dialogue qui se déclenche quand le joueur a un score d'[[Intelligence]] ou de [[Charisme]] bas.
* '''''<Ck>-'':''' est placé dans tout dialogue pour changer la couleur du texte pour noir et le précéder d'un tiret.
* Quelques expressions courtes peuvent être ajoutées au nom de code du dialogue pour le différencier (ex:Occupe){{Avertissement|Les caractères "/" et ":" ne peuvent être utilisés tels quels dans les dialogues. Remplacez les par "^" et "#" pour bien les afficher.}}

=== Étapes de rédaction ===
# Accédez aux fichiers '''.txt''' appropriés (ceux portant le nom de code du lieu où sera ajouté le dialogue)
# Choisissez le nom de code du personnage qui parle (si possible identique au nom de code d'un personnage déjà dans le lieu, comme ''Pers1'')
# Écrivez une ligne d'introduction:<syntaxhighlight>
AJOUT_Di_Pers1_Acc = {<Ck>- Bonjour!}
</syntaxhighlight>
# Ajoutez ou non une réponse du joueur:<syntaxhighlight>
AJOUT_Di_Pers1_AccR = {<Ck>- Allo!}
</syntaxhighlight>{{Idée|Cette réponse peut nécessiter certaines conditions, indiquées après la portion de dialogue sous forme de commentaire (précédé de ''// ''). Ex: ''//Intelligence < 5''}}
# Ajoutez les dialogues qui suivent logiquement:<syntaxhighlight>
AJOUT_Di_Pers1_1 = {<Ck>- Aurais-tu une minute pour m'aider?}
AJOUT_Di_Pers1_1R = {<Ck>- Avec plaisir!}
AJOUT_Di_Pers1_1R_Refuse_aider = {<Ck>- Oublie-ça!} //Insensible
AJOUT_Di_Pers1_2 = {<Ck>- Merveilleux. J'étais suis sur le point de m'évanouir, c'est trop lourd!}
AJOUT_Di_Pers1_2_Refuse_aider = {<Ck>- C'est tellement insensible de ta part!}
</syntaxhighlight>
# Ajoutez quelques portions de dialogue apparaissant au dessus de la tête du personnage:<syntaxhighlight>
AJOUT_Di_Pers1_Rdm1 = {Belle journée pareil<C->}
AJOUT_Di_Pers1_Rdm2 = {<Cr>C'est lourd!<C->}
AJOUT_Di_Pers1_Rdm3 = {C'est quoi ça?<C->}
AJOUT_Di_Pers1_Rdm4 = {J'aurais besoin d'aide...<C->}
AJOUT_Di_Pers1_Rdm5 = {<Co>Comment ils font, les autres?<C->}
AJOUT_Di_Pers1_Rdm6 = {J'ai beau essayer, c'est inutile.<C->}
</syntaxhighlight>

=== Codes d'écriture ===
Les codes suivants servent à colorer le texte et ajouter des caractères spéciaux, par exemple.
* '''''<C*>'' et ''<C->'':''' Ajouter/enlever une Couleur. Remplacez '''*''' par ''b'' (bleu), ''c'' (cyan), ''k'' (noir), ''m'' (magenta), ''o'' (orange), ''r'' (rouge), ''w'' (blanc) ou ''y'' (jaune).
* '''''<rgb:***,***,***>'':''' Ajouter une couleur RGB spécifique. Remplacez '''*''' par un chiffre de 1 à 255. 
* '''''<b+>'' et ''<b->'':''' Ajouter/enlever Gras.
* '''''<Jl>'', ''<Jc>'', ''<Jr>'' et ''<Jj>'':''' Texte aligné à gauche, au centre, à droite ou justifié.
 → [http://10projets.org/nousaurons/editor_readme.html#TextCodes Plus d'informations (anglais)]

== Ajouter le dialogue à l'éditeur de niveaux ==
=== Ouvrir le fichier du lieu (éditeur de niveaux) ===
# Ouvrez le dossier ''Game''/ puis '''FT Improver.EXE'''.{{Avertissement|Utiliser '''FT Tools.exe''' à la place résultera en une erreur.}}
# Passez les vidéos en cliquant dessus.
# Cliquez sur {{Faux bouton|MORE|couleur=noir|bouton=oui}}.
# Cliquez sur {{Faux bouton|LEVEL EDITOR|couleur=noir|bouton=oui}}.
# Accédez au menu {{Faux bouton|File|couleur=gris|bordure=noir}} puis {{Faux bouton|Open|couleur=gris}}.
# Ouvrez le fichier du lieu précédemment créé qui doit se terminer par '''.ent'''.

=== Intégrer le dialogue ===
# Cliquez sur l'onglet {{Faux bouton|Level|couleur=noir2}}.
# Cliquez sur le bouton {{Faux bouton|Speech...|couleur=gris|bordure=noir}} en bas.
# Cliquez sur le bouton {{Faux bouton|Add|couleur=gris|bordure=noir}} en haut.
# Faites défiler la liste à gauche jusqu'en bas.
# Cliquez sur {{Faux bouton|New Node|couleur=noir}} et remplacez le "New Node" par le nom de code de votre première portion de dialogue sous le bouton {{Faux bouton|Remove|couleur=gris|bordure=noir}}
#* {{Faux bouton|✔&nbsp;&nbsp;&nbsp;&nbsp;Floating&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|couleur=noir2}}'''(coché par défaut):''' fait flotter le dialogue au dessus de la tête du personnage.
#* {{Faux bouton|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Windowed&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|couleur=noir2}}''':''' ajoute le dialogue dans une boîte en bas avec le portrait du personnage et un bouton {{Faux bouton|OK|couleur=blanc|bouton=oui}}.
# Ajoutez le nom de code du dialogue sous {{Faux bouton|Default Event|couleur=gris}} (pour les scripts).
# Sélectionnez le code du dialogue à la droite de {{Faux bouton|Random 1|couleur=gris}}.{{Idée|Lorsque vous ajoutez les dialogues flottants ''Rdm1'' à ''6'', vous pouvez les ajouter les 6 un à la suite de l'autre. Le jeu les présentera au hasard.}}

=== Scripter le dialogue (avancé) ===
Coder un dialogue à l'intérieur de l'[[Mod:Éditeurs#.C3.89diteur_de_niveaux_.28Level_editor.29|éditeur de niveaux]] nécessite un grand nombre de scripts. Référez-vous à la section [[Mod:Scripts]] pour connaître les bases du codage dans l'éditeur de niveaux.

==== Préparer le code à ajouter ====
Le [https://docs.google.com/spreadsheets/d/18ThIXbzwQTrOZfpMNC0ySB2-eH5YKY_HKtT3xwHx6OM/edit#gid=0 tableau suivant] vous permet de connaître à l'avance les codes les plus complexes à utiliser pour programmer votre dialogue, suivant un certain nombre de conditions spéciales pré-déterminées (exemple: le joueur refuse d'aider, essaie de séduire, est menaçant.e, etc.)

==== Coder la première portion du dialogue ====
{{Avertissement|La section{{Faux bouton|Triggers...|couleur=gris|bordure=noir}} de l'éditeur de niveaux contient un très grand nombre de triggers, ajoutés avec les années. '''Évitez de les modifier à moins que vous sachiez exactement ce que vous faites.''' Ne soyez pas intimidé.e par cette liste, vous n'avez pas à interagir avec ; ajoutez simplement votre code à la fin de celle-ci en utilisant la barre de défilement pour atteindre rapidement à la fin.}}
# Cliquez sur l'onglet {{Faux bouton|Level|couleur=noir2}}.
# Cliquez sur {{Faux bouton|Triggers...|couleur=gris|bordure=noir}} en bas à gauche.
# Cliquez sur {{Faux bouton|New...|couleur=gris|bordure=noir}}.
# Ajoutez une description (exemple: ''PERS1 - Accueil'')
# L'onglet {{Faux bouton|✔&nbsp;Conditions|couleur=noir2}} est déjà ouvert. Cliquez sur {{Faux bouton|New...|couleur=gris|bordure=noir}}.
# La condition {{Faux bouton|Always|couleur=noir2}} est déjà sélectionnée. Cliquez sur {{Faux bouton|Ok|couleur=gris|bordure=noir}} en bas à droite.
# Cliquez sur l'onglet {{Faux bouton|&nbsp;&nbsp;Actions|couleur=noir2}}. Il se transforme ainsi : {{Faux bouton|✔&nbsp;Actions|couleur=noir2}}.
# Cliquez sur {{Faux bouton|New...|couleur=gris|bordure=noir}}.
# Cliquez sur l'onglet {{Faux bouton|Center View|couleur=noir2}} et sélectionnez {{Faux bouton|Set Click Speech|couleur=noir2}}.
# Sous {{Faux bouton|Set Click Speech for Unit|couleur=gris}}, cliquez sur {{Faux bouton|list...|couleur=gris|bordure=noir}} et sélectionner le nom de code du personnage que vous voulez faire parler. Si vous n'avez pas ajouté de personnage déjà, [[Mod:Créer_un_lieu#Ajouter_un_personnage|suivez ces étapes]].
# Sous {{Faux bouton|to|couleur=gris}}, sélectionnez le code du dialogue que vous avez précédemment intégré.
# Appuyez sur {{Faux bouton|Ok|couleur=gris|bordure=noir}}{{Idée|En tout temps, double-cliquer sur un élément de la liste de triggers vous permet d'y retourner pour le modifier.}}

==== Coder les autres portions du dialogue ====
Les portions de dialogue suivantes n'utiliseront plus la condition ''Always'', mais nécessiteront toutes une condition spéciale pour apparaître.
# Cliquez sur l'onglet {{Faux bouton|Level|couleur=noir2}}.
# Cliquez sur {{Faux bouton|Triggers...|couleur=gris|bordure=noir}} en bas à gauche.
# Cliquez sur {{Faux bouton|New...|couleur=gris|bordure=noir}}.
# Ajoutez une description (exemple: ''PERS1 - 01'')
# L'onglet {{Faux bouton|✔&nbsp;Conditions|couleur=noir2}} est déjà ouvert. Cliquez sur {{Faux bouton|New...|couleur=gris|bordure=noir}}.
# Cliquez sur l'onglet {{Faux bouton|Always|couleur=noir2}} et sélectionnez {{Faux bouton|Speech Occured|couleur=noir2}}, puis sous {{Faux bouton|Speech Event was|couleur=gris}}, sélectionnez la portion de dialogue que vous avez codé avant.
# Cliquez sur l'onglet {{Faux bouton|&nbsp;&nbsp;Actions|couleur=noir2}}. Il se transforme ainsi : {{Faux bouton|✔&nbsp;Actions|couleur=noir2}}.
# Cliquez sur {{Faux bouton|New...|couleur=gris|bordure=noir}}.
# Cliquez sur l'onglet {{Faux bouton|Center View|couleur=noir2}} et sélectionnez {{Faux bouton|Set Click Speech|couleur=noir2}}.
# Sous {{Faux bouton|Set Click Speech for Unit|couleur=gris}}, cliquez sur {{Faux bouton|list...|couleur=gris|bordure=noir}} et sélectionner le nom de code du personnage que vous voulez faire parler de nouveau.
# Sous {{Faux bouton|to|couleur=gris}}, sélectionnez le code de la prochaine section du dialogue.
# Appuyez sur {{Faux bouton|Ok|couleur=gris|bordure=noir}}{{Idée|Cette étape réalisée, après un premier dialogue, cliquer de nouveau sur le personnage lancera un nouveau dialogue.}}

==== Coder une réponse du joueur ou une série d'interactions ====
Il est possible de coder une série d'interactions apparaissant automatiquement après une portion de dialogue (après le clic du bouton{{Faux bouton|OK|couleur=blanc|bouton=oui}}de la fenêtre de dialogue).
# Cliquez sur l'onglet {{Faux bouton|Level|couleur=noir2}}.
# Cliquez sur {{Faux bouton|Triggers...|couleur=gris|bordure=noir}} en bas à gauche.
# Cliquez sur {{Faux bouton|New...|couleur=gris|bordure=noir}}.
# Ajoutez une description (exemple: ''PERS1 - 01R'')
# L'onglet {{Faux bouton|✔&nbsp;Conditions|couleur=noir2}} est déjà ouvert. Cliquez sur {{Faux bouton|New...|couleur=gris|bordure=noir}}.
# Cliquez sur l'onglet {{Faux bouton|Always|couleur=noir2}} et sélectionnez {{Faux bouton|Speech Occured|couleur=noir2}}, puis sous {{Faux bouton|Speech Event was|couleur=gris}}, sélectionnez la portion de dialogue à laquelle une réponse sera donnée.
# Cliquez sur l'onglet {{Faux bouton|&nbsp;&nbsp;Actions|couleur=noir2}}. Il se transforme ainsi : {{Faux bouton|✔&nbsp;Actions|couleur=noir2}}.
# Cliquez sur {{Faux bouton|New...|couleur=gris|bordure=noir}}.
# Cliquez sur l'onglet {{Faux bouton|Center View|couleur=noir2}} et sélectionnez {{Faux bouton|Set Variable|couleur=noir2}}.
# Sous {{Faux bouton|Variable|couleur=gris}}, tapez, par exemple: ''Pers1_message''.
# Sous {{Faux bouton|&nbsp;&nbsp;&nbsp;Value|couleur=gris}}, tapez, par exemple: ''AccR''.
# Appuyez sur {{Faux bouton|Ok|couleur=gris|bordure=noir}}
# Cliquez sur {{Faux bouton|New...|couleur=gris|bordure=noir}}.
# Ajoutez une description (exemple: ''PERS1 - 01R (message)'')
# L'onglet {{Faux bouton|✔&nbsp;Conditions|couleur=noir2}} est déjà ouvert. Cliquez sur {{Faux bouton|New...|couleur=gris|bordure=noir}}.
# Cliquez sur l'onglet {{Faux bouton|Always|couleur=noir2}} et sélectionnez {{Faux bouton|Variable|couleur=noir2}}, puis sous {{Faux bouton|Variable|couleur=gris}}, tapez la variable que vous venez juste de choisir, puis sous {{Faux bouton|is Value|couleur=gris}} la valeur que vous venez de choisir.
# Cliquez sur l'onglet {{Faux bouton|&nbsp;&nbsp;Actions|couleur=noir2}}. Il se transforme ainsi : {{Faux bouton|✔&nbsp;Actions|couleur=noir2}}.
# Cliquez sur {{Faux bouton|New...|couleur=gris|bordure=noir}}.
# Cliquez sur l'onglet {{Faux bouton|Center View|couleur=noir2}} et sélectionnez {{Faux bouton|Force Speech|couleur=noir2}}.
# Sous {{Faux bouton|Unit|couleur=gris}}, cliquez sur {{Faux bouton|list...|couleur=gris|bordure=noir}} et sélectionner le nom de code du personnage qui répondra. S'il s'agit du joueur, tapez "LeJoueur" plutôt.
# Sous {{Faux bouton|will use speech node|couleur=gris}}, sélectionnez le code de la section du dialogue correspondant à la réponse.
# Cochez la case {{Faux bouton|Blocking|couleur=noir2}} en haut à droite.
# Répétez les étapes à partir de '''18.''' pour ajouter toutes les portions de dialogues que vous le souhaitez. Elles s'enchaîneront toutes une à la suite de l'autre.
# Appuyez sur {{Faux bouton|Ok|couleur=gris|bordure=noir}}
{{Idée|Cette étape réalisée, après un premier dialogue, cliquer de nouveau sur le personnage lancera un nouveau dialogue.}}