Ultimate Simple script guide

Created by Chocolatepie33 (aka CP) with assistance from Kentl, made for 2.5 (2.6 changes will be added later)

• Adding a level trigger
  • Open up Sandbox
  • Select a spot to add a talking character (via F1)
  • Next to the character, select a spot, then use ` (above TAB) to start the console. Type "newent mapmodel -1."
  • Select the surrounding box and hit F3. Go to level_trigger and use the slider to pick a number. Remember it. Also, while the menu is still up, go to trigger type and select either 8 (for repeated pop-up text) or 12 (one-time).
  • Move the box "into" the character.
  • Save your map.
• Beginning scripting
  • Re-open the map you saved. Go into edit mode (E) and then hit F6. Go to the bottom of the menu and hit "Load", then "Execute".
  • You can also do this externally, outside of Sandbox: go to the Sandbox folder, then mystuff/packages/base. Either create a new .txt doc (make sure to save it as a .cfg) and edit it, or edit an existing one.
• Scripting
  • A pop-up menu is known as a gui. Anything modifying the gui would use the -gui or gui- keywords (with the proper beginning or ending respectively).
  • Let's make a character named Jon say Hello and ask you how you're doing with options:

    level_trigger_1 = [showgui Jon] 
    newgui Jon [
    guitext "Hello, I'm Jon. How are you?" 
    guibar 
    guibutton "Fine, thank you." [echo "OK then."] 
    guibutton "Not well. Goodbye." [cleargui] 

]

• Let's go over this code:
  • showgui Jon opens up the menu named Jon
  • newgui Jon creates a newgui, titled Jon, and the [] after the command "hold" the items within it.
  • guitext puts out the text specified within the "".
  • guibar creates a horizontal bar.
  • guibutton creates a selectable button, with a title within the "" marks. [] hold the commands that are executed when the button is selected. The echo command puts out text at the upper-left corner of the screen in Sandbox.
  • cleargui closes a gui, either permanently or until the NPC is approached again (trigger 12 or 8 respectively).
• Adding inventory
  • Inventory is an important part of every game. Here's the code on how to do it, and adding to it:

    on_start = [
      item1 = 0
      item2 = 0
    ]
    
    level_trigger_1 = [ item1 = ( + $item1 1 ) ]