Mod:Add a quest

This tutorial shows how to add a quest to The Sum. [file:Level Editor.jpg|thumb|This tutorial mainly uses the Level Editor.

Required tools

• Level Editor

Before you start

Since programming a quest requires the use of scripts, coded_dialogues, perhaps even the creation of characters and items, it is best to learn these techniques before attempting the following steps.

Preparation

Check the list of quests

Before you create a quest, check the full list of quests to make sure it is there, otherwise add it. Note the quest number (#') for later.
 Go to the page

Name the quest

The quest name is added to the .txt files of the location where it is given to the player (folders Game/NousAurons/Locale/ (French version) and Game/core/locale (English version). It is added as follows:

AJOUT_OBJ_Quete1 = {Find a pair of shoes for Simon<rgb:125,125,125>He said there might be some in Poston. Talk to Simon again and click "TRADE" to give him the pair of shoes.} //Variable Quete1_complete

Create the dialogues related to the quest

In the same files used to name the quest, add the dialogues needed for the quest, indicating for these the code names of the characters involved. If you are unsure how to do this, follow these steps.

Other quest-related content

You may need unique items and/or characters. It is advisable to prepare them in advance.

Create a quest

Open the location file (level editor)

1. Open the folder Game/ then FT Improver.EXE.
   
     Use FT Tools.exe instead will result in an error. 
   
   
   
2. Pass the videos by clicking on them.
3. Click on
   ⦿  MORE 
   .
4. Click
   ⦿  LEVEL EDITOR 
   .
5. Navigate to the
    File 
   menu then
    Open 
   .
6. Open the file of a location which must end with .mis.

Accessing scripts

Scripts are stored and coded in the Level editor.

1. Open the location file if it is not already open (see above)
2. Click on the
    Level 
   tab.
3. Click on the
    Triggers... 
   tab at the bottom left.

Start the quest

The quest should be added as a result of a few scheduled dialogs.

1. Add required dialogues.
2. Access the scripts (see above).
3. Click on
    New... 
   at the top right of the "Triggers" page.
4. Add a short description to the script (example: QUEST 1 - Pers1).
5. Click on
    New... 
   again.
6. Click on the
    Always 
   tab and select
    Speech Occured 
   , then under
    Speech Event was 
   select the portion of the dialog that will trigger the quest.
7. Click on the
     Actions 
   tab. It will change to
    ✔ Actions 
   .
8. Click on
    New... 
   .
9. Click on the
    Center View 
   tab and select
    Add Objective 
   .
10. Click on the tab under
     Add Objective 
    and select the code name of your quest. Check the
     with popup box 
    box.
11. Click on
     New... 
    again.
12. Click on the
     Center View 
    tab and select
     Set Variable 
    .
13. Check the box under
     Campaign 
    .
14. Under
     Variable 
    , type "Quete*_complete", where * is your quest number.
15. Under
     Value 
    , type "no", a value that indicates that the quest has been given. Possible values for the variable are:

• pas: The quest has not been given yet.
• non: The quest has been given, but has not been completed.
• Etape*: The quest has been given, and the step indicated by * has been completed.
• oui: The quest has been completed.

This variable is important because quests often take place in multiple locations and the game needs to remember if the quest has been completed or not in order to program dialogues and scripts accordingly.

Tracking Quest Progress

At any time, no matter where the player is, you can use the scripts to assign a new value to your quest variable (Campaign) based on conditions you have chosen. You can then display special messages when certain steps are completed.

1. Access the scripts of the location where this step is taking place (see above).
2. Click on
    New... 
   at the top right of the "Triggers" page.
3. Add a short description to the script (example: QUEST 1 - Pers1 (step1 completed)).
4. Click on
    New... 
   again.
5. Add a series of conditions of your choice.
6. Click on the tab
      Actions 
   . It will change to
    ✔ Actions 
   .
7. Click on
    New... 
   .
8. Click on the
    Center View 
   tab and select
    Set Variable 
   .
9. Check the box under
    Campaign 
   .
10. Under
     Variable 
    , type "Quete*_complete", where * is your quest number.
11. Under
     Value 
    , type "etape1", a value that indicates that a step in the quest has been completed. Click on
     Ok 
    .
12. Click
     New... 
    again.
13. Click on the
     Center View 
    tab and select
     Display World Text 
    . Select the code name of the text to display in the list, as written in the files .txt of the place (example: ADD_OBJ_Quete1_etape1_complete).

Complete quest (variable set to "oui")

To add a script (usually a dialog) that reacts when the quest variable indicates "yes" (in the location where the quest was given):

1. Access the scripts (see above).
2. Click on
    New... 
   at the top right of the "Triggers" page.
3. Add a short description to the script (example: QUEST 1 - Pers1 (completed)).
4. Click on
    New... 
   again.
5. Click on the
    Always 
   tab and select
    Variable 
   , Check the box under
    Campaign 
   , under
    Variable 
   , type the name of your variable (example: Quete1_complete) and then under
    is Value 
   , type "yes".
6. Click on the tab
      Actions 
   . It will change to
    ✔ Actions 
   .
7. Click on
    New... 
   .
8. Click on the
    Center View 
   tab and select
    Complete Objective 
   . Select the code name of your quest from the list.
9. Click on
    New... 
   .
10. Click on the
     Center View 
    tab, select
     Add Experience to Player 
    , click on
     Change 
    and above
     Scenery 
    , type 1 (the player's player number). Press
     Ok 
11. Under
     XP amount 
    , type an amount of Autonomy Points, between 1,000 and 10,000.

Complete the quest (bring an item)

For some quests, its variable is set to "oui" at the same time as it is completed under other conditions. This is the case for a quest that requires you to bring an item. The person thanks you (and the quest is completed) as soon as you give them the required item!

1. Access the scripts (see above).
2. Click on
    New... 
   at the top right of the "Triggers" page.
3. Add a short description to the script (example: QUEST 1 - Pers1 (completed)).
4. Click on
    New... 
   again.
5. Click on the
    Always 
   tab and select
    Quantity - Unit 
   , under
    Unit 
   , type the code name of the character who gave the quest (example: Pers1) and then, under
    has 
   click
    change 
   . Click on
    More than 
   and change
    1 
   to "0". Under
    type 
   choose
    change 
   . Click on
    ItemsTagged 
   and type, above
    list... 
   the code name of the item you want to find (e.g.: Shoes). If you don't know how to assign a code name to an item, follow the steps here.
6. Click on the
      Actions 
   tab. It will change to
    ✔ Actions 
   .
7. Click on
    New... 
   .
8. Click on the
    Center View 
   tab and select
    Set Variable 
   .
9. Check the box under
    Campaign 
   .
10. Under
     Variable 
    , type "Quete*_complete", where * is your quest number.
11. Under
     Value 
    , type "yes", a value that indicates the quest has been completed.
12. Click on
     New... 
    again.
13. Click on the
     Center View 
    tab and select
     Complete Objective 
    . Select the code name of your quest from the list.
14. Click
     New... 
    one last time.
15. Click on the
     Center View 
    tab, select
     Add Experience to Player 
    , click on
     Change 
    and above
     Scenery 
    , type 1 (the player's player number). Press
     Ok 
16. Under
     XP amount 
    , type in an amount of Autonomy Points, usually between 1000 and 3000.