Fritz Waypoint Tool (ET) User Guide

By Hobbit

Home
Navigation Files
Nodes
Actions
Routes
Compare Files
Write Navigation
AIScripts
Bots Files
BSP Reading
Requirements
Download
Mufaka Blog
AIScripts are a way for you to dynamically change waypoint attributes depending on state of actions during gameplay. They allow for opening / closing paths upon completion of objectives, activating or deactivating groups of actions, and a lot of other things. It's what allows the bots to react to different situations that occur. This tool provides a syntax highlited editor for these scripts that offers a lot of help and validation.

If you open the editor without a navigation file loaded, you will see the following:

It is not required that you have an open navigation file when editing an AIScript, but it is recommended because validation will be more complete and you will be shown a list of scriptable actions and a complete list of nodes available to use.

If you already have a navigation file and need to create an AIScript for it, click on the "New" toolbar button. This will prompt you for basic information.

After filling in this information and hitting the "OK" button, a script template will be filled in for you.

For help on what keyords are available, click on the "Help" toolbar button. This will show a dialog that will allow you to select keywords and fill in the expected parameters for them.

After filling in the parameters, clicking on the "Insert" button will insert the command at the current cursor position.

While editing, you can also use code-completion by pressing the ctrl and space (ctrl-space) keys at the same time. This will determine what commands or parameters are available for you depending on your position in the file. If you are at an empty line, you will be shown a list of keywords.

If you are entering in parameters for a keyword and the parameter you are on has a predefined list of values, you will be shown those values.

If you are entering in parameters for a keyword but there is no predefined list of values (node or action id), you can press the ctrl and i (ctrl-i) keys at the same time. This will give you information on the expected parameter.

Validation of the AIScript is pretty thorough. If you do not have a navigation file loaded, it will check for required keywords and basic layout of the file. If you do have a navigation file loaded, it will check node and action parameters against allowable values and attributes for them. Errors will be listed with a line number and message at the bottom of the editor and each error will have a red squiggly underline.