Script editor

Description

The Script Editor allows you to create and edit behaviour scripts. You can also use it to debug scripts.

Using the Script Editor

_{The Script Editor with each component numbered and an absurd amount of errors to illustrate a stressful situation}

The Script Editor consists of the following components:

1. Menu
2. Quick Menu
3. Solution Explorer
4. Script Editor
5. Debug Panel

Menu

File

_{A closeup of the File menu}

The File menu allows you to create, save, open, or reload script files. It also allows you to exit the editor.

Edit

_{A closeup of the Edit menu}

The Edit menu allows you to undo or redo, cut/copy/paste, select all, or find within scripts.

View

_{A closeup of the View menu}

The View menu allows you to show the Solution Panel, the Errors Panel, the Watch Panel, and the Output Panel.

Build

_{A closeup of the Build menu}

The Build menu allows you to build the current file, build all files, rebuild all files, and reload the object lists.

Debug

_{A closeup of the Debug menu}

The Debug menu allows you to pause, continue, and step when debugging. These are not available while editing scripts. More information can be found here.

Quick Menu

The Quick Menu contains the most used options from the Menu and a couple more. All debugging related options on the Quick Menu are explained in detail on the debug scripts page. From left to right the Quick Menu buttons do the following:

1. Create a new script file
2. Open a script file
3. Save a script file
4. Save all script files
5. Cut selected text
6. Copy selected text
7. Paste text
8. Build the current script
9. Build all scripts
10. Rebuild all scripts
11. Reload the object lists
12. Collapse all regions by one level in the current script
13. Expand all regions by one level in the current script

Solution Explorer

_{The solution explorer}

The solution explorer shows the scripts in their respective project and folder as they appear in the Data folder. You can filter by typing in the filter textbox at the bottom and quickly clear the filter by pressing the X next to the filter. The Solution Explorer will only show files with the extensions .charScript, .itemScript, and .gameScript.

Script Editor

_{The script editor}

The script editor is a simple text editor, which also correctly color codes the script. It allows you to expand or collapse regions that are automatically created for each section (INIT, BEHAVIOUR, STORY, and EVENTS) and for each REACTION, EVENT, and SCRIPTFRAME. The status at the top of the script editor shows you whether the file has been built succesfully (meaning without any errors). A file can only be built when it is linked to a script resource.

Debug Panel

_{The debug panel, containing the error panel, watch panel, and output panel}

The debug panel contains three panels: error panel, watch panel, and output panel. The watch panel and output panel are explained in detail on the script debugger page. The error panel contains both errors and warnings that occured during the latest build (could be a single script or a full build of all scripts). It will show you the error/warning, the file, the line, and -if applicable- the template. Double clicking the error will automatically open the relevant script at the correct line and show the error/warning with a red/yellow highlight. If an error description is preceded by [Instantiating] it will open the affected character or item. Instantation errors usually mean that an EXTERN variable has been filled in incorrectly on a character or item.

Find Panel

_{The find panel}

The find panel (CTRL+F) allows you to search in the current script or in all scripts, with the options to match case or match the whole word.