User Guide

62
❍
To create a new script condition, click NEW. In the window, select a condition from the drop-down list.
The condition is displayed. Click any blue links to define the condition from the available list of
parameters. To define the condition, click OK.
NOTE: There are quite a few different conditions from which to choose, and you can build
very complicated scripting conditions if needed. However, it’s recommended that you begin
with simple conditions to learn how the Script tool works.
✯ When you create multiple conditions, it is assumed that they are connected by a logical AND. To create
a second condition with a logical OR, highlight the condition to compare, click OR and then click NEW
to define the second condition.
❍
To duplicate a condition, select it and click COPY. To delete a condition, select it and click DELETE.
❍
To move a condition in the window, click MOVE UP or MOVE DOWN.
5. Actions if True tab. You define what happens if the condition or conditions are met. The controls are
similar to the Script Conditions tab.
✯ By default, a script does nothing if its conditions are true. To create an action, delete the default action.
Then, click NEW to create the new one.
6. Actions if False tab. You define what happens if the condition or conditions are not met. The controls
are similar to the Script Conditions tab.
✯ The False condition does not often need to be defined. In most scripts, you can leave this area blank.
7. Your script has been defined. To create the script, click OK. The script is now listed in the script
directory.
❍
To view a created script, select it in the Scripts window. The contents of the script are displayed at the
bottom of the window. To edit the script, click EDIT.
✯ For more information on the Scripts window, ➤ Organizing Your Scripts on p. 64.
MAP TOOLS FOR SCRIPTING
Two tools in World Builder can be very useful to identifying locations and areas for use in scripts.
✯ Polygon Tool. Use the Polygon tool to define trigger areas that can be referred to by name in scripted
conditions and actions. For more information,
➤ Polygon Tool on p. 26.
✯ Waypoint Tool. In addition to defining unit movements, you can use waypoints to identify locations on
the map for your scripts. For more information,
➤ Waypoint Tool on p. 26.
MISSION INTROS
You can create mission briefings and scripted introductory sequences using scripts.
✯ Start Mission events. Unless they are subroutines, scripts created with the default TRUE as the
condition are executed as soon as the map is loaded.
✯ Multimedia. You can create a wide assortment of visual effects. Look in the Multimedia category for
available actions.
✯ Disabled Input. In the User category, you can disable user input until the scripted intro sequence is
completed.
✯ Camera effects. You can script a variety of camera effects including letter box and black-and-white
modes. See the Camera category of actions.
✯ Variables. Under the Scripting category, you can define and use variable counters, as well as set and
manage timers. Variables and timers can be referenced by any script in the map.