Modification de Mod:Ajouter une quête

Ce tutoriel vous expliquera comment ajouter une quête à ''[[Wikipédia 2197|Nous Aurons]]''. 
[[file:Ecran Level Editor.jpg|thumb|Ce tutoriel utilise principalement l'éditeur de niveaux (''Level Editor'').]]

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

== Avant de commencer ==
Comme programmer une quête demande l'utilisation de [[Mod:Scripts#Scripts|scripts]], de [[Mod:Créer_un_dialogue#Scripter_le_dialogue_.28avanc.C3.A9.29|dialogues codés]], peut-être même la création de [[Mod:Créer_un_personnage|personnages]] et d'[[Mod:Créer_un_item|items]], il est préférable de d'apprendre ces techniques avant de suivre les étapes suivantes.

== Préparation ==
=== Consulter la liste des quêtes ===
Avant de créer une quête, consultez [https://docs.google.com/spreadsheets/d/1nO8vhCp4vQLrxZZ5M2Avx3ReP6mHhJY-yzNZ--VCUI4/edit#gid=0 la liste complète de quêtes] pour vous assurer qu'elle est présente, sinon ajoutez-la. Notez le numéro de la quête ('''#''') pour plus tard.

[[file:Check.svg|35x35px]]&nbsp;[https://docs.google.com/spreadsheets/d/1nO8vhCp4vQLrxZZ5M2Avx3ReP6mHhJY-yzNZ--VCUI4/edit#gid=0 Accéder à la page]

=== Nommer la quête ===
Le nom de la quête est ajouté aux fichiers '''.txt''' du lieu où elle est donnée au joueur (dossiers ''Game/NousAurons/Locale/'' (version française) et ''Game/core/locale'' (version anglaise). Elle est ajoutée ainsi :<syntaxhighlight>
AJOUT_OBJ_Quete1 = {Trouver une paire de chaussures pour Simon\n<rgb:125,125,125>Il a dit qu'il pourrait y en avoir à Poston. Parlez de nouveau à Simon et cliquez sur "ÉCHANGE" pour lui donner la paire de chaussures.}  //Variable Quete1_complete
</syntaxhighlight>

=== Créer les dialogues reliés à la quête ===
Dans les mêmes fichiers que ceux utilisés pour nommer la quête, ajoutez les dialogues nécessaires à la quête, en indiquant pour ceux-ci les noms de code des personnages concernés. Si vous ne savez plus comment faire, [[Mod:Créer_un_dialogue#Scripter_le_dialogue_.28avanc.C3.A9.29|suivez ces étapes]].

=== Autres contenus reliés à la quête ===
Il est possible que vous ayez besoin de [[Mod:Créer_un_item|créer des objets]] uniques et/ou des [[Mod:Créer_un_personnage|personnages]]. Il est conseillé de les préparer en avance.

== Créer une quête ==
=== 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 '''.mis'''.

=== Accéder aux scripts ===
Les scripts sont stockés et codés dans l'[[Mod:Éditeurs#.C3.89diteur_de_niveaux_.28Level_editor.29|Éditeur de niveaux]].
# Ouvrez le fichier du lieu si ce n'est pas déjà fait ([[#Ouvrir_le_fichier_du_lieu_.28.C3.A9diteur_de_niveaux.29|voir plus haut]])
# Cliquez sur l'onglet {{Faux bouton|Level|couleur=noir2}}.
# Cliquez sur {{Faux bouton|Triggers...|couleur=gris|bordure=noir}} en bas à gauche.

=== Démarrer la quête ===
La quête devrait être ajoutée à la suite de quelques dialogues programmés.
# [[Mod:Créer_un_dialogue#Scripter_le_dialogue_.28avanc.C3.A9.29|Ajoutez les dialogues requis]].
# Accédez aux scripts ([[#Acc.C3.A9der_aux_scripts|voir plus haut]]).
# Cliquez sur {{Faux bouton|New...|couleur=gris|bordure=noir}} en haut à droite de la page "Triggers".
# ajoutez une courte description au script (exemple: ''QUÊTE 1 - Pers1)''.
# Cliquez sur {{Faux bouton|New...|couleur=gris|bordure=noir}} de nouveau.
# 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 qui déclenchera la quête.
# 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|Add Objective|couleur=noir2}}.
# Cliquez sur l'onglet sous {{Faux bouton|Add Objective|couleur=gris}} et sélectionnez le nom de code de votre quête. Cochez la case {{Faux bouton|with popup box|couleur=gris}}.
# Cliquez sur {{Faux bouton|New...|couleur=gris|bordure=noir}} de nouveau.
# Cliquez sur l'onglet {{Faux bouton|Center View|couleur=noir2}} et sélectionnez {{Faux bouton|Set Variable|couleur=noir2}}.
# Cochez la case sous {{Faux bouton|Campaign|couleur=gris}}.
# Sous {{Faux bouton|Variable|couleur=gris}}, tapez "Quete*_complete", où * est le numéro de votre quête.
# Sous {{Faux bouton|Value|couleur=gris}}, tapez "non", une valeur qui indique que la quête a été donnée. Les valeurs possibles de la variables sont :
* '''pas:''' La quête n'a pas encore été donnée.
* '''non:''' La quête a été donnée, mais n'a pas été accomplie.
* '''Etape*:''' La quête a été donnée, et l'étape indiquée par * a été accomplie.
* '''oui:''' La quête a été accomplie.
Cette variable est importante car les quêtes se déroulent souvent dans plusieurs lieux et le jeu a besoin de se souvenir si la quête a été réalisée ou non pour programmer des [[Mod:Créer_un_dialogue|dialogues]] et des [[Mod:Scripts|scripts]] en conséquence.

=== Suivre l'évolution de la quête ===
À tout moment, peu importe le lieu où le joueur se trouve, vous pouvez utiliser les scripts pour assigner une nouvelle valeur à votre variable de quête (''Campaign'') en suivant des conditions que vous avez choisies. Vous pouvez ensuite afficher des messages spéciaux quand certaines étapes sont accomplies.
# Accédez aux scripts du lieu ou cette étape se déroule ([[#Acc.C3.A9der_aux_scripts|voir plus haut]]).
# Cliquez sur {{Faux bouton|New...|couleur=gris|bordure=noir}} en haut à droite de la page "Triggers". 
# ajoutez une courte description au script (exemple: ''QUÊTE 1 - Pers1 (étape1 complétée)'').
# Cliquez sur {{Faux bouton|New...|couleur=gris|bordure=noir}} de nouveau.
# Ajouter une série de [[Mod:Scripts#Conditions|conditions]] de votre choix.
# 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}}.
# Cochez la case sous {{Faux bouton|Campaign|couleur=gris}}.
# Sous {{Faux bouton|Variable|couleur=gris}}, tapez "Quete*_complete", où * est le numéro de votre quête.
# Sous {{Faux bouton|Value|couleur=gris}}, tapez "etape1", une valeur qui indique qu'une étape de la quête a été complétée. Cliquez sur {{Faux bouton|Ok|couleur=gris|bordure=noir}}.
# Cliquez de nouveau sur {{Faux bouton|New...|couleur=gris|bordure=noir}}.
# Cliquez sur l'onglet {{Faux bouton|Center View|couleur=noir2}} et sélectionnez {{Faux bouton|Display World Text|couleur=noir2}}. Sélectionnez le nom de code du texte à afficher dans la liste, tel que rédigé dans les fichiers ''.txt'' du lieu (exemple: ''AJOUT_OBJ_Quete1_etape1_complete'').

=== Compléter la quête (variable à "oui") ===
Pour ajouter un script (habituellement de dialogue) réagissant quand la variable de quête indique "oui" (dans le lieu où la quête a été donnée):
# Accédez aux scripts ([[#Acc.C3.A9der_aux_scripts|voir plus haut]]).
# Cliquez sur {{Faux bouton|New...|couleur=gris|bordure=noir}} en haut à droite de la page "Triggers". 
# ajoutez une courte description au script (exemple: ''QUÊTE 1 - Pers1 (complétée)'').
# Cliquez sur {{Faux bouton|New...|couleur=gris|bordure=noir}} de nouveau.
# Cliquez sur l'onglet {{Faux bouton|Always|couleur=noir2}} et sélectionnez {{Faux bouton|Variable|couleur=noir2}}, Cochez la case sous {{Faux bouton|Campaign|couleur=gris}}, sous {{Faux bouton|Variable|couleur=gris}}, tapez le nom de votre variable (exemple:Quete1_complete) puis sous {{Faux bouton|is Value|couleur=gris}}, tapez "oui".
# 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|Complete Objective|couleur=noir2}}. Sélectionnez le nom de code de votre quête dans la liste.
# Cliquez sur {{Faux bouton|New...|couleur=gris|bordure=noir}}.
# Cliquez sur l'onglet {{Faux bouton|Center View|couleur=noir2}}, sélectionnez {{Faux bouton|Add Experience to Player|couleur=noir2}}, cliquez sur {{Faux bouton|change|couleur=gris|bordure=noir}} et au dessus de {{Faux bouton|Scenery|couleur=gris}}, tapez '''1''' (le numéro de ''player'' du joueur). Appuyez sur {{Faux bouton|Ok|couleur=gris|bordure=noir}}
# Sous {{Faux bouton|XP amount|couleur=gris}}, tapez un montant de [[Points d'Autonomie]], habituellement entre 1000 et 3000.

=== Compléter la quête (apporter un objet) ===
Pour certaines quêtes, sa variable est assignée à "oui" en même temps qu'elle est complétée suivant d'autres conditions. C'est le cas d'une quête qui requiert de rapporter un objet. La personne vous remercie (et la quête se complète) dès que vous lui donnez l'objet!
# Accédez aux scripts ([[#Acc.C3.A9der_aux_scripts|voir plus haut]]).
# Cliquez sur {{Faux bouton|New...|couleur=gris|bordure=noir}} en haut à droite de la page "Triggers". 
# Ajoutez une courte description au script (exemple: ''QUÊTE 1 - Pers1 (complétée)'').
# Cliquez sur {{Faux bouton|New...|couleur=gris|bordure=noir}} de nouveau.
# Cliquez sur l'onglet {{Faux bouton|Always|couleur=noir2}} et sélectionnez {{Faux bouton|Quantity - Unit|couleur=noir2}}, sous {{Faux bouton|Unit|couleur=gris}}, tapez le nom de code du personnage qui a donné la quête (exemple:Pers1) puis, sous {{Faux bouton|has|couleur=gris}} cliquez sur {{Faux bouton|change|couleur=gris|bordure=noir}}. Cliquez sur {{Faux bouton|More than|couleur=noir2}} et changez {{Faux bouton|1|couleur=noir2}} pour "0". Sous {{Faux bouton|type|couleur=gris}} cliquez sur {{Faux bouton|change|couleur=gris|bordure=noir}}. Cliquez sur {{Faux bouton|ItemsTagged|couleur=noir2}} et tapez, au dessus de {{Faux bouton|list...|couleur=gris|bordure=noir}} le nom de code de l'item à trouver (ex:Chaussures). Si vous ne savez pas comment assigner un nom de code à un item, [[Mod:Créer_un_item#Assigner_un_nom_de_code|suivez les étapes ici]].
# 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}}.
# Cochez la case sous {{Faux bouton|Campaign|couleur=gris}}.
# Sous {{Faux bouton|Variable|couleur=gris}}, tapez "Quete*_complete", où * est le numéro de votre quête.
# Sous {{Faux bouton|Value|couleur=gris}}, tapez "oui", une valeur qui indique que la quête a été complétée.
# Cliquez de nouveau sur {{Faux bouton|New...|couleur=gris|bordure=noir}}.
# Cliquez sur l'onglet {{Faux bouton|Center View|couleur=noir2}} et sélectionnez {{Faux bouton|Complete Objective|couleur=noir2}}. Sélectionnez le nom de code de votre quête dans la liste.
# Cliquez une dernière fois sur {{Faux bouton|New...|couleur=gris|bordure=noir}}.
# Cliquez sur l'onglet {{Faux bouton|Center View|couleur=noir2}}, sélectionnez {{Faux bouton|Add Experience to Player|couleur=noir2}}, cliquez sur {{Faux bouton|change|couleur=gris|bordure=noir}} et au dessus de {{Faux bouton|Scenery|couleur=gris}}, tapez '''1''' (le numéro de ''player'' du joueur). Appuyez sur {{Faux bouton|Ok|couleur=gris|bordure=noir}}
# Sous {{Faux bouton|XP amount|couleur=gris}}, tapez un montant de [[Points d'Autonomie]], habituellement entre 1000 et 3000.