Download Here!
[You must be registered and logged in to see this link.]
The given documentation contains the description of language of the scripts of the program UOPilot of the version 1.07 beta 5. Be attentive at use of earlier versions of the program.
Conditional designations:
<> - obligatory parameter
[] - unessential parameter
SYNTAX
In one line there can be only one command. The first word in a line - command, other words - parameters. If the first word in a line not the command - the line is considered as the comment.
The words consist of symbols 0-9, À-z, À-ÿ.
Symbols *, $, %, +, -, *, /, >, <, =, :, ., (, ), [,] are service, other separators.
# numeric variable
$ string variable
% array identifier
+, -, *, /,>, <, = symbols operations
. used in references to variables and arrays in scripts running in parallel
() in some of the commands they contain some parameters (eg window handles)
: label
[] are used in arrays
It is possible to write the comments after all parameters. Also that consider everything, that goes after '//'. It is extremely recommended to use such method.
The pauses in commands are specified by default in ms (1/1000 seconds), but the instruction(indication) of time and obviously, in hours, minutes, seconds is possible:
wait 500 // to wait for 0.5 seconds
wait 5s // to wait for 5 seconds
wait 1m // to wait 1 minute
wait 1h // to wait 1 hour
Variable
In a name variable the symbols - are allowable ['0'.. '9', 'A'.. 'z', 'À'..'ÿ'], register am not taken into account. Maximal length of a name variable 255 symbols.
Variable can be numerical and line. Syntax numerical variable '#name', where name - name variable. Syntax line variable '$name', where name - name variable.
For example:
set #i 20
set $s test string
Also you can use arrays. The symbol of percent '%' is considered as the identifier of a array. The indexes of a array are specified after a name in square brackets '[' and ']'. The size of a array is equal to the maximal used index. The giving of values is carried out to each element individually by command set. The elements of a array can contain both line, and number. Is allowable to refer to arrays of the parallel scripts, having specified after a name of a array, through a point, number of the script. At the indication only of first index in two-dimension a array, result will be a line from all elements of the second dimension of a array appropriate to the specified index, and divided by a space.
For example:
set %ar [4] òåñò // an one-dimensional array on 4 elements
set %arr [50 1] 544
set %arr [50 2] 800 // an two-dimensional a array on 50 times till 2 elements
set %ar.2 [5] // an one-dimensional array in parallel script
left %arr [50] // click by the left button on coordinates 544 800
Take into account, that the elements of arrays cannot directly be used in the conditional operators:
if charposx <> %arr [50 1]
Before use variable in the scripts you should define it through the command 'set'. Variable change only at participation 'set' and 'for', the command 'repeat' uses value, not changing it.
For example:
set #i #i + 1
Syntax of the command Set:
--------------------------------------- --
set $<name> <value> or
set #<name> <value1> [<a mark of operation> <value2>]
set %<name> [an element] <value>
Between a mark of operation and values there should be a separator. The following operations are supported: +, -, *, /, also you can use brackets for change of priorities of performance of mathematical operations. At division the result is approximated to smaller whole.
For example:
set #q ((5+4)/(3+-2)* #e )-(2-(-5+9))*3
With line variable some mathematical operations are possible:
set $s1 1
set $s2 2
set $s $s1 + $s2
Result will be $s = '1 + 2', i.e. at giving something line variable, it all is appropriated up to the end of a line, with the appropriate replacements
set #n $s1 + $s2
Result will be #n = 3, i.e. if line variable, contains line performance of an integer, it can be used as numerical variable.
In the command 'set' you can use the generator of random numbers: random (number) returns number in a range from 0 up to number-1
For example:
set #a random (2)
At two or more started scripts you can address to variable, certain in other scripts of the pilot. Syntax of the instruction such variable following:
#i.2 - we address to variable #i from the script which is taking place in a window number 2.
Variable during performance of the script can be changed through the table of display variable. The change variable occurs synchronously to a character set.
Reserved variable
The note 1: [W] means, that you can change value by this variable in the scripts through the command 'set', all others variable only for reading
The note 2: For correct definition by the Pilot of the majority of parameters of the character at you on the UO screen the Character Status window should be opened.
hour - current time (hour)
min - current time (minute)
sec - current time (second)
For example:
say current time is hour : min . sec
timer - considers(counts) quantity(amount) ms from a beginning of performance of the script. Can be used practically in any operators and combinations.
set timer // establishes value timer in 0
name - name of the character
str - force
int - intelligence
dex - dexterity
hits - health
mana - mana
stam - stamina
gold - amount of money
wght - current weight
armor - armor class
charposx - position on a horizontal
charposy - position on a vertical
charposz - z coordinate (height)
chardir - direction of a sight of the character (where the character revolves)
0 - the character looks at north, everyone 45 degrees of turn clockwise add 1. i.e. 7 - the character looks at northwest
lastmsg - last message of the server
lastobjectid - identifier of last used object [W]
lastobjecttype - type of last used object [W]
lasttargetid - identifier of last purpose [W]
lasttargetx - coordinate of last purpose [W]
lasttargety - - ' - [W]
lasttargetz - - ' - [W]
lasttargetkind - class of last purpose (1 - item; 2 - ground; 3 - static's or water) (i.e. if is necessary for you by a shovel click on a surface of the cave in the given coordinates, it is necessary to specify '3'; if it is necessary to click through 'lasttarget' on a item, it is necessary to specify '1' and 'Id' of a item; catching a fish we indicate coordinates of a point and class '2'). [W]
lastliftedid - identifier of a thing, which by last was touched from a place (is moved, has visited in 'hand'). [W]
lastskill - number last scill which was used through the menu Skills [W]
lastspell - number of last spell which was used through the book [W]
laststatictype - type of last static purpose (tree...) [W]
target - kind of the cursor (0 - hand; 1 - sight) [W]
At two or more started scripts you can address to variable, certain in other scripts of the pilot for others characters, having added to a name variable number of the script through a point. For example:
set lasttargetid.1 7
say hits.1
The conditional operators, cycles, transitions
In the conditional operators and cycles you can use the following operations: >, <, =, <>, and also logic operations (and, or, xor). The priorities are not present, is processed consistently.
For example:
if hour = 23 and min = 45 or #count = 100
For change of priorities use parentheses:
while (#a > 1 and #a < 3) or ((#a = 1 and 130, 9 7295) or #a = 5)
In the conditional operators you can use the generator of random numbers: random (number) returns number in a range from 0 up to number-1
For example:
while (#a = #b) or (random (5) > 3)
For interruption of action of the operators 'while', 'for' and 'repeat' you can use the command 'Break'. Syntax:
Break [a level]
If the level is more 1, interrupts given amount parental cycles.
The operator 'Continue' continues execution of a cycle on the following step. Can be used in cycles 'repeat', 'for', 'while'.
At use of last message from the server in the conditional operators, there is some rule of syntax:
if lastmsg the text of last message or its part
Or
if lastmsg = $a [or lastmsg = $b ...]
I.e. if directly is specified in a condition the text of the message, there should not be more nothing, including marks of any operations.
The operator IF
--------------------
Syntax:
if <condition>
...
end_if
Or
if <condition>
...
else
...

Uopilot Download Free