Difference between revisions of "Script.oos"
(→Specifying "if" conditions) |
|||
| Line 33: | Line 33: | ||
If any of the conditions of an "if" are false and an "else" clause is present, the actions given in the "else" clause are executed. | If any of the conditions of an "if" are false and an "else" clause is present, the actions given in the "else" clause are executed. | ||
| − | The form of the conditions is the same as for [[script.plist]] | + | The form of the conditions is the same as for [[script.plist|conditions]], except that <, >, and = are used in place of the words lessthan, greaterthan, and equal. |
=== do === | === do === | ||
Revision as of 02:18, 5 April 2006
script.oos Used by OXP's to check conditions and perform scripted actions accordingly.
The "oos" file format allows scripts to be written using a more BASIC-like syntax than the plist file format permits. Scripts in "oos" format have all the same features available as the plist scripts, except only one script per file can be defined.
If both script.plist and script.oos files exist in an OXP's Config directory, script.oos is loaded in preference to script.plist.
Structure
A script.oos file consists of the script name on the first non-comment, non-blank line, followed by one or more "if/then/else/endif" clauses.
Blank lines, leading and trailing whitespace, and lines starting with "//" are ignored.
The body of an "if/then" or "else" consists of one or more actions, one per line.
A trivial script is:
testscript
if dockedAtMainStation_bool = YES then
debugMessage: Player is docked at the main station.
else
debugMessage: Player is not docked at the main station.
endif
Specifying "if" conditions
An "if" statement must be followed by one or more conditions. If multiple conditions are required they must be separated by the keyword "and". There is no option for an "or".
Where multiple conditions are specified they must all be true for the actions following "then" to be executed.
If any of the conditions of an "if" are false and an "else" clause is present, the actions given in the "else" clause are executed.
The form of the conditions is the same as for conditions, except that <, >, and = are used in place of the words lessthan, greaterthan, and equal.
do
do consists of an array of actions (and further conditional statements if required), executed if the conditions are met.
Example:
<key>do</key>
<dict>
<array>
<string>addShips: asp-cloaked 1</string>
<string>addShips: pirate 12</string>
</array>
</dict>
else
else consists of an array of actions (and further conditional statements if required), executed if the conditions are NOT met.
Example:
<key>else</key>
<dict>
<array>
<string>addShips: super-pirate 1</string>
</array>
</dict>
