say |
0 |
text: text |
no |
Shows a message and waits until it is read; the box stays up until closetext, release or the end |
sign |
1 |
text: text |
no |
As say, in the sign’s box. sign text, style, icon (or style:, icon:) compiles to signex |
choice |
2 |
prompt: text, options: [text…] |
yes |
Asks a question: the option’s place from 0, -1 if cancelled; up to 32 options, more than 8 scroll |
yesno |
3 |
prompt: text |
yes |
Asks yes or no: 1 or 0 |
closetext |
4 |
|
no |
Closes the message box |
buffer |
5 |
slot: int, kind: buffer, value: int = 0 |
no |
Puts a number or a name (the buffer words) in message buffer slot for {slot} in later text |
lock |
6 |
|
no |
Holds the player and everyone’s own movement |
release |
7 |
|
no |
Frees them and closes the box |
wait |
8 |
ticks: int |
no |
Waits ticks sixtieths of a second |
waitmoves |
9 |
|
no |
Waits until every movement list is done |
waitbutton |
10 |
|
no |
Waits until the player presses the button |
waitsound |
11 |
|
no |
Waits until the sound or fanfare has finished |
random |
12 |
below: int |
yes |
A number from 0 to below - 1, from the game’s generator |
lastresult |
13 |
|
yes |
The value of the last battle, choice or screen |
faceplayer |
14 |
who: actor = 253 |
no |
Turns who to the player |
face |
15 |
who: actor, dir: dir |
no |
Turns who to a direction |
look |
16 |
who: actor, at: actor |
no |
Turns who towards another actor |
approach |
17 |
who: actor = 253 |
no |
who walks up to the player in a straight line; the script waits |
show |
18 |
who: actor |
no |
Shows an actor |
hide |
19 |
who: actor |
no |
Hides an actor: not drawn, blocks nothing, sees nothing |
emote |
20 |
who: actor, emote: emote |
no |
Shows an emote above an actor and waits |
place |
21 |
who: actor, x: int, y: int |
no |
Puts an actor on a cell at once, until the map is left |
mover |
22 |
who: actor, kind: mover, param: int = 0 |
no |
Changes how an actor moves by itself (the mover words) |
xof |
23 |
who: actor |
yes |
An actor’s x; -1 for none |
yof |
24 |
who: actor |
yes |
An actor’s y; -1 for none |
facing |
25 |
who: actor |
yes |
An actor’s direction; -1 for none |
sees |
26 |
who: actor, range: int |
yes |
1 if the actor sees the player within range, by the rule of on sight |
warp |
27 |
map: map, x: int, y: int, facing: dir = 4 |
no |
Leaves for another map; the script ends |
setcell |
28 |
x: int, y: int, cell: cell |
no |
Changes a cell’s behaviour until the map is left (the cell words) |
door |
29 |
x: int, y: int, state: door |
no |
Opens or closes the door at a cell and waits |
fade |
30 |
way: fade, colour: colour = 0, ticks: int = 0 |
no |
Fades out to or in from black or white and waits |
shake |
31 |
strength: int, ticks: int |
no |
Shakes the picture by strength sixteenths of a cell for ticks |
camera |
32 |
who: actor |
no |
The camera follows this actor at once |
playsound |
33 |
sound: sound |
no |
Plays a sound effect |
playmusic |
34 |
music: music |
no |
Changes the music (none stops it, map is the map’s own) |
fanfare |
35 |
music: music |
no |
Plays a jingle over the music and waits |
weather |
36 |
kind: weather |
no |
Changes the weather (the weather words); it fades in |
giveitem |
37 |
item: item, count: int = 1 |
yes |
Gives items: 1 if they fitted in the bag |
takeitem |
38 |
item: item, count: int = 1 |
yes |
Takes items: 1 if the player had that many |
hasitem |
39 |
item: item, count: int = 1 |
yes |
1 if the player has that many |
givemon |
40 |
species: species, level: int |
yes |
Gives a creature: 1 party, 2 storage, 0 no room |
hasmon |
41 |
species: species |
yes |
1 if the party has a creature of the species |
healparty |
42 |
|
no |
Heals the party; where the player stands is where a lost battle returns |
wildbattle |
43 |
species: species, level: int |
yes |
A wild battle; waits: 0 lost, 1 won, 2 ran, 3 caught |
trainerbattle |
44 |
kind: trainer, name: text, version: int = 0, defeat: text = -1, lose: lose = 0, money: switch = 1, exempt: switch = 0, mode: mode = 0, called: name = 255, music: battlemusic = 0 |
yes |
A trainer battle with its texts and choices; waits: 1 won, 0 lost |
shop |
45 |
stock: shop, percent: int = 100 |
no |
Opens a shop with a stock list and waits |
storage |
46 |
|
yes |
Opens the storage screen and waits: 1 if anything changed |
save |
47 |
|
yes |
Saves the game: 1 if saved |
askname |
48 |
who: name |
yes |
Opens the naming screen for player or rival and waits: 1 if named |
givemoney |
49 |
amount: int |
no |
Adds money, to at most 999,999 |
takemoney |
50 |
amount: int |
yes |
Takes money: 1 if the player had that much |
money |
51 |
|
yes |
The player’s money |
showmoney |
52 |
|
no |
Shows the money box |
hidemoney |
53 |
|
no |
Hides the money box |
respawn |
54 |
map: map, x: int, y: int |
no |
Sets where a lost battle returns the player |
endgame |
55 |
|
no |
Saves, fades out and goes back to the title screen |
choosemon |
56 |
|
yes |
Opens the party screen to choose a creature and waits: its place, -1 if none |
ext |
57 |
call: int, args: int… |
yes |
A command the game adds in Rust, by number |
setaside |
58 |
species: species, slot: int |
yes |
The story keeps the party’s first creature of the species in place slot (0-3): 1 if it did |
bringback |
59 |
slot: int |
yes |
The creature kept in slot rejoins the party: 1 if it did |
tint |
60 |
red: int = -1, green: int = -1, blue: int = -1 |
no |
Sets the main light’s colour; tint alone gives the hour’s light back |
menuentry |
61 |
entry: entry, on: switch = 1 |
no |
Lists or unlists a menu entry (the entry words) |
cammove |
62 |
pitch: int = -1, distance: int = -1, ticks: int = 30, ease: ease = 3, fov: int = -1, wait: switch = 1 |
no |
Moves the camera’s framing (pitch, distance, field of view) over ticks |
campan |
63 |
x: int, y: int, ticks: int = 30, ease: ease = 3, wait: switch = 1 |
no |
Pans the camera to look at a cell |
camfollow |
64 |
who: actor, ticks: int = 30, ease: ease = 3, wait: switch = 1 |
no |
Moves the camera to an actor and follows it |
camreset |
65 |
ticks: int = 30, ease: ease = 3, wait: switch = 1 |
no |
Returns the camera to the map’s framing, following the player |
camwait |
66 |
|
no |
Waits until a camera move given wait: false is over |
trademon |
67 |
slot: int, species: species, level: int, item: item = 0 |
yes |
Trades the party’s creature in slot for a new one: 1 if it did |
evolveevent |
68 |
event: int |
yes |
Evolves every creature that evolves by event n; waits: how many were to |
canhold |
69 |
item: item, count: int = 1 |
yes |
1 if that many more of the item fit in the bag |
pocket |
70 |
item: item |
yes |
The item’s bag pocket, 1-8; 0 for no such item |
istm |
71 |
item: item |
yes |
1 if the item is a machine |
record |
72 |
record: record |
yes |
One of the game’s 32 counters (the record words) |
addrecord |
73 |
record: record, amount: int = 1 |
no |
Adds to a counter |
journal |
74 |
kind: int, a: int = 0, b: int = 0, c: int = 0, d: int = 0 |
no |
Notes an entry of a kind and four numbers in the journal |
journalentry |
75 |
entry: int, field: int = 0 |
yes |
A field of journal entry n, newest 0; -1 for none |
setflag |
76 |
flag: int |
no |
Sets saved flag n worked out at run time (0-4095) |
clearflag |
77 |
flag: int |
no |
Clears saved flag n |
checkflag |
78 |
flag: int |
yes |
Saved flag n: 1 or 0 |
cry |
79 |
species: species, pitch: int = 0 |
no |
Plays a species’ cry |
waitcry |
80 |
|
no |
Waits until the cry has played |
badge |
81 |
badge: int |
yes |
1 if the player has badge n (0-31) |
setbadge |
82 |
badge: int, on: switch = 1 |
no |
Gives or takes badge n |
badges |
83 |
|
yes |
How many badges the player has |
fademusic |
84 |
ticks: int = 30 |
no |
Fades the music out and waits |
gender |
85 |
|
yes |
The player’s gender |
setgender |
86 |
gender: gender |
no |
Sets the player’s gender |
option |
87 |
text: text |
no |
Hands over one option of a long choice (what choice with more than 8 compiles to) |
listchoice |
88 |
prompt: text |
yes |
Asks with the options handed over: the place, -1 if cancelled |
partycount |
89 |
|
yes |
How many creatures of the party are not eggs |
partyspecies |
90 |
slot: int |
yes |
The species in party place slot; 0 for none or an egg |
sayline |
91 |
first: text, n: int |
no |
Says the line n after first in its bank or file |
hour |
92 |
|
yes |
The game clock’s hour, 0-23 |
minute |
93 |
|
yes |
The minute, 0-59 |
weekday |
94 |
|
yes |
The day of the week, 0 Sunday to 6 |
day |
95 |
|
yes |
The day of the month, 1-31 |
month |
96 |
|
yes |
The month, 1-12 |
year |
97 |
|
yes |
The year |
clockchanged |
98 |
|
yes |
1 while new days are held back because the clock was turned back |
steps |
99 |
|
yes |
Steps taken in the whole game |
journalnote |
100 |
text: text |
no |
Writes a line in the journal screen’s diary |
canuse |
101 |
move: fieldmove |
yes |
The party place that would use field move move; 6 by an item; -1 for none |
fieldmove |
102 |
move: fieldmove |
yes |
Uses a field move here: 1, or 0 where it cannot |
travel |
103 |
|
yes |
How the player gets about: 0 walking, 1 cycling, 2 surfing, 3 diving |
monget |
104 |
slot: int, field: monfield, which: stat = 0, box: int = 0 |
yes |
A field of a creature of the party (box 0) or a box; -1 for none |
monset |
105 |
slot: int, field: monfield, value: int, which: stat = 0, box: int = 0 |
yes |
Sets a field of a creature, held to the engine’s rules; the field afterwards |
rule |
106 |
rule: rule |
yes |
One of the game’s rules (the rule words) |
setrule |
107 |
rule: rule, value: int |
no |
Sets a rule, from now on and in the save |
getoption |
108 |
option: option |
yes |
The value of one of the game’s own options; -1 for none |
setoption |
109 |
option: option, value: int |
no |
Sets one of the game’s own options |
text |
110 |
format: text, args: int… |
yes |
A line made of the format with {0}-{7} filled by the text values after it, in the next text register |
name |
111 |
kind: buffer, value: int = 0 |
yes |
The name buffer would show for the kind and value, in the next text register |
speciesget |
112 |
species: species, field: speciesfield |
yes |
A field of a species’ record (the speciesfield words); -1 for none |
moveget |
113 |
move: move, field: movefield |
yes |
A field of a move’s record (the movefield words); -1 for none |
itemget |
114 |
item: item, field: itemfield |
yes |
A field of an item’s record (the itemfield words); -1 for none |
partyfind |
115 |
kind: find, value: int |
yes |
The first party place whose creature fits (the find words); -1 for none |
partytally |
116 |
kind: tally, value: int = 0 |
yes |
How many of the party are of a kind (the tally words) |
menubegin |
117 |
prompt: text, at: side = 0, columns: int = 1, cancel: int = -1 |
no |
Begins a menu: its prompt, side (the side words), columns and the value of cancelling; menu(...) { } compiles to it |
menuitem |
118 |
text: text, value: int, enabled: int = 1 |
no |
Adds an entry with a value of its own; left out when enabled is 0; at most 64 |
menushow |
119 |
|
yes |
Shows the menu and waits: the value of the entry chosen, or the cancel value |
banner |
120 |
|
no |
Shows the location banner with the map’s name again, whatever the game’s [banner] says about arriving |
encounter |
121 |
method: method |
yes |
A wild meeting the player starts: the map’s table for the method is rolled once (time of day, swarm and radio count; no repellent does). Met: a wild battle, and the value is its outcome; nothing met, no table or nobody able to fight: -1. In on headbutt, headbutt is the tree faced (-1 for a tree the player’s identifier leaves empty) |
knowsmove |
122 |
move: move |
yes |
The party place, plus one, of the first creature that knows the move; 0 for none |
fruitstage |
123 |
tree: int, hours: int = 0 |
yes |
How far a fruit tree (0 to 127) has grown back: 0 just picked to 4 ripe; a tree never picked is ripe. hours is its time to grow, 0 overnight |
pickfruit |
124 |
tree: int, item: item, count: int = 1, hours: int = 0 |
yes |
Picks a ripe fruit tree: count of the item into the bag, and it grows again. The number given; 0 if it is not ripe or there is no room |
craftorder |
125 |
fruit: item, product: item, count: int = 0 |
yes |
Gives the craftsman count of a fruit (0: all the bag holds) to make into as many of a product, ready the next day. The number taken; 0 if an order waits or the bag has none |
craftstate |
126 |
|
yes |
The craftsman’s order: 0 none, 1 waiting, 2 ready |
craftcollect |
127 |
|
yes |
A ready order into the bag: the number given; 0 if none is ready or there is no room |
swarm |
128 |
map: map, on: switch = 1 |
no |
Today’s swarm is on the map (its ...Swarm tables are used there), or with false no longer; saved |
radio |
129 |
sound: int |
no |
The radio plays sound 1 or 2 (the ...RadioA, ...RadioB tables are used), or 0 for none; saved |
netbattle |
130 |
|
yes |
A link battle with whoever else asks for one on the game’s server (plan 33): 1 when asked for; 0 in a game built without online play |
daycare |
131 |
what: daycare, slot: int = 0 |
yes |
Asks the day care: count left, egg 1 when the keeper has one, and of place slot (0 or 1) its species (0 for none), level now, levels gained, the fee to take it back (100 and 100 a level), its gender (-1 for none); compat, how the two get on, 0 to 3 |
daycaregive |
132 |
slot: int |
yes |
Leaves the party’s creature in place slot at the day care, healed, for nothing: 1; 0 if both places are taken, it is an egg or the last that can fight |
daycaretake |
133 |
slot: int |
yes |
The day care’s creature in place slot joins the party as it has grown: 1; 0 with the party full, -1 with nobody there. The fee is the script’s to take |
daycareegg |
134 |
|
yes |
The keeper’s egg joins the party, made now from the two by the game’s daycare rules: 1; 0 with the party full, -1 with no egg |
yard |
135 |
who: actor, slot: int |
no |
The actor shows the day care’s creature in place slot, drawn with its follow sheet and wandering; hidden while the place is empty |
currency |
136 |
currency: currency |
yes |
The player’s amount of one of the game’s currencies ([rules.currencies] in game.toml, the currency words) |
givecurrency |
137 |
currency: currency, amount: int |
yes |
Gives an amount: 1, or 0 and nothing given when it would pass the currency’s most |
takecurrency |
138 |
currency: currency, amount: int |
yes |
Takes an amount: 1, or 0 and nothing taken when the player has less |
currencyroom |
139 |
currency: currency |
yes |
How much more of the currency fits |
showcurrency |
140 |
currency: currency |
no |
Shows the currency in the money box, which follows it; the box shows one thing at a time |
hidecurrency |
141 |
currency: currency |
no |
Hides the box if it shows that currency |
signex |
142 |
text: text, style: int = 0, icon: int = 0 |
no |
A sign with a style and an icon, what sign with them compiles to: style is a frame of the skin after the sign’s own (0: its own); icon a picture of graphics/ui/sign_icons/ beside the text (0: none) |
showpic |
143 |
picture: picture, x: int = 0, y: int = 0, front: switch = 0, touch: switch = 0 |
yes |
Shows a picture of graphics/art/ at a tile: behind, front: true in front, touch: true as the touch screen’s backdrop; 1 if shown |
hidepic |
144 |
which: pictures = 2 |
no |
Takes pictures down: back, front, touch or all (the default) |
showmon |
145 |
species: species, x: int = 10, y: int = 4 |
yes |
Shows a creature’s front picture in front at a tile (10, 4 unless given); 1 if shown |
choosepic |
146 |
first: picture, second: picture |
yes |
Two pictures side by side, the one not chosen darkened: 0 or 1 as chosen, -1 if cancelled |
doublebattle |
147 |
kind: trainer, name: text, version: int = 0, defeat: text = -1, lose: lose = 0, money: switch = 1, exempt: switch = 0, mode: mode = 0, called: name = 255, music: battlemusic = 0 |
yes |
A trainer battle fought two creatures a side, with trainerbattle’s arguments; waits: 1 won, 0 lost |
fish |
148 |
method: method |
yes |
A cast of a rod into the water ahead, as [world.fishing] plays it (task 25v): the battle’s outcome if something was landed; -1 nothing bit, -2 too early, -3 it got away, -4 no cast |
roamer |
149 |
what: roamer, slot: int = 0 |
yes |
Asks of the roaming creature in slot (0 to 5): count how many roam (the slot is ignored), state (0 none, 1 roaming, 2 beaten, 3 caught), the area it is in (-1 when it does not roam), its species, level, hp and status as the last meeting left them |
roamerstart |
150 |
slot: int, species: species, level: int |
yes |
A wild creature of the species at the level starts roaming in slot (0 to 5), on a route (a map of kind route) other than the one the player came from, and moves as the player changes maps by the game’s wild rules; saved: 1; 0 with no route or no such slot |
roamerend |
151 |
slot: int |
yes |
The roaming creature in slot is taken off its route and the slot emptied: 1; 0 when it was empty |
eyemusic |
152 |
kind: trainer |
no |
A trainer class’s eyes track for this map’s region ([audio.music] eyes); the map’s track comes back after the battle |
musicoverride |
153 |
music: music |
no |
A track over the map’s until musicoverride map, kept in [audio.music] override_var |
halloffame |
154 |
|
yes |
Enters the party in the Hall of Fame and shows it, a creature at a time; how many teams were ever entered (0, nothing shown, with nobody to enter) |
hallview |
155 |
|
yes |
The viewer of the Hall of Fame, until the player leaves it; how many teams were ever entered |
hallcount |
156 |
|
yes |
How many teams have ever been entered in the Hall of Fame |
credits |
157 |
part: int = 0 |
yes |
Shows a part (0 by default) of credits.txt, and waits: 1 shown to the end, 0 ended by a button or nothing to show |
meter |
158 |
label: text, value: int, max: int = 100 |
no |
Shows the HUD meter at the top right of the top screen: a label and a bar at value of max (100 by default); shown again with the same label, the bar moves to the value (plan 37) |
meterhide |
159 |
|
no |
Takes the HUD meter down |
tagbattle |
160 |
kind: trainer, name: text, kind2: trainer, name2: text, version: int = 0, version2: int = 0, defeat: text = -1, defeat2: text = -1, lose: lose = 0, money: switch = 1 |
yes |
Two trainers at once, a team and its own choices each (a tag battle, task 08z); the outcome as trainerbattle |
multibattle |
161 |
partner: trainer, partnername: text, kind: trainer, name: text, kind2: trainer, name2: text, defeat: text = -1, defeat2: text = -1, lose: lose = 0, money: switch = 1 |
yes |
Two trainers against the player and a partner trainer beside them, who chooses for its own place and team (a multi battle); the outcome as trainerbattle |
wilddouble |
162 |
species: species, level: int, species2: species, level2: int |
yes |
Two wild creatures at once (species and level of each); the outcome as wildbattle |
teachable |
163 |
tutor: tutor, slot: int, mode: int = 0 |
yes |
How many moves a tutor (a name of [rules.tutors], or relearn) could teach the creature in party place slot now: those its species may learn and it does not know; 0 for an egg. For the relearner mode is 0 (level-up moves up to its level), 1 (and egg moves) or 2 (every level-up move) (task 11l) |
teach |
164 |
tutor: tutor, slot: int, mode: int = 0 |
yes |
The list of what a tutor (or relearn) can teach the creature in party place slot, as a screen: the price of each as the cursor passes it, a forget-which question at four moves (a field move is kept where the game says: keep_field_moves in game.toml). Takes the price only when a move is learned. 1 if one was, else 0 (task 11l) |
movecount |
165 |
slot: int |
yes |
How many moves the creature in party place slot knows |
forgetmove |
166 |
slot: int |
yes |
The move deleter’s screen for the creature in party place slot: the moves it knows, one chosen and confirmed, the later ones moving up. 1 if one was forgotten; never its only move (check movecount) (task 11l) |
rateable |
167 |
slot: int |
yes |
Whether the name rater takes the creature in party place slot: 0 yes, 1 an egg, 2 another trainer’s (task 11l) |
namemon |
168 |
slot: int |
yes |
The naming screen for the creature in party place slot: 1 renamed, 2 the name it had, 0 left (task 11l) |
backwarp |
169 |
map: map, x: int, y: int |
no |
Sets where a back warp leads from now (the games’ dynamic warp) |
players |
170 |
|
yes |
How many players are in the field (several players, task 33c) |
playerson |
171 |
x: int, y: int, w: int = 1, h: int = 1 |
yes |
How many players stand in the rectangle of w x h cells from (x, y) |
triggerplayer |
172 |
|
yes |
The player (0 the first) whose step, talk or reading started the script |
leash |
173 |
cells: int |
no |
Sets the cells a player may go from the players’ middle (0 none) |
pendget |
174 |
field: pendfield, index: int = 0, which: stat = 0 |
yes |
In an editing hook: a field of the pending creature, or of member index of a pending party; -1 for none |
pendset |
175 |
field: pendfield, value: int, index: int = 0, which: stat = 0 |
yes |
In an editing hook: sets a field (a word, not an expression), held to the engine’s rules as monset is; the field afterwards, -1 when it cannot be set |
pendcount |
176 |
|
yes |
In an editing hook: the pending party’s members (1 for one creature; -1 outside a hook) |
pendadd |
177 |
species: species, level: int |
yes |
In on trainerparty: a member of the species at the level added at the end (up to 6); its index, or -1 |
pendremove |
178 |
index: int |
no |
In on trainerparty: the member at index taken out (never the last one) |
pendcancel |
179 |
|
no |
In on wildmon: no meeting and no battle |
settile |
180 |
x: int, y: int, tile: int, solid: int = 0 |
no |
Changes the tile at a cell of a tile map to another of its tilesets, at the same height, and the cell to the tile’s behaviour (or solid with solid 1), until the map is loaded again; a 3D map ignores it |
pickmon |
181 |
first: species, second: species, third: species = 0, fourth: species = 0 |
yes |
A choice among the front pictures of two to four creatures side by side (a starter’s screen): left and right choose, A takes one; the place chosen from 0, or -1 if cancelled |
pickitem |
182 |
pocket: int |
yes |
Opens the bag on one pocket (1 to 8) to choose an item, which stays in the bag: the item chosen, or 0 for none |
shopin |
183 |
stock: shop, currency: currency, percent: int = 100 |
no |
Opens a shop whose prices are in a currency of [rules.currencies] (the items’ prices times percent), and waits; it only sells |
mapnumber |
184 |
|
yes |
The number of the map the player is on, as its map name gives it |