Command Reference

Attacks a specific serial, or a variable holding one. If the serial is already your last target, this repeats the last attack instead.

attack 0x2AB4
attack 'attackdummy'

Answers the cursor with whatever Razor has stored as Last Target.

cast 'magic arrow'
waitfortarget
lasttarget

See also setlasttarget · target

Stores a serial as Razor's Last Target without targeting anything.

setlasttarget 0x2AB4
cast 'magic arrow'
waitfortarget
lasttarget

Targets a serial directly, or picks a mobile by proximity. Notoriety accepts a comma list (any match) or an exclamation list (priority order: try the first, fall back to the next). Type narrows to 'humanoid' or 'monster'. Also takes 'cancel' and 'clear'.

cast 'lightning'
waitfortarget
target 'closest' 'enemy' 'monster'
 
# priority: try enemies first, then criminals
target 'closest' 'enemy!criminal'

See also waitfortarget · targettype · lasttarget · setlasttarget

Answers a ground target cursor with a fixed world location.

cast 'fire field'
waitfortarget
targetloc 5923 1145 0

Answers a ground target cursor at an offset from your own position.

cast 'fire field'
waitfortarget
targetrelloc 1 1

On UOSagas: The target uses your own Z rather than the height of the tile you are aiming at, because Razor has no access to the map files. This is fine on flat ground. On stairs or multi-level terrain it can miss.

Finds an object the same way findtype does, then targets it.

dclicktype 'scissors'
waitfortarget
targettype 'cloth' backpack

See also findtype · dclicktype

Blocks until a target cursor is up. Put this between a cast/skill and the target command. 'wft' is an alias.

Also spelled wft

cast 'energy bolt'
waitfortarget
target 'last'

See also target · targettype · targetexists

Blocks until a target cursor is up. Put this between a cast/skill and the target command. 'wft' is an alias.

cast 'energy bolt'
waitfortarget
target 'last'

See also target · targettype · targetexists

Stops Razor's pending lift/drop actions without dropping what you hold.

cleardragdrop

Moves the item in the named hand back to your backpack.

clearhands 'both'
dclicktype 'bandage'

Uses (double-clicks) a specific item or mobile. Instead of a serial you can pass 'left', 'right' or 'hands' to use what you are holding. 'useobject' is an alias.

Also spelled useobject

dclick 0x34AB
dclick 'right'

See also dclicktype

Finds an item by Tiledata name or graphic ID and uses it. It is the acting twin of findtype and takes the same arguments. Falls back to mobiles if no item matches. 'usetype' is an alias.

Also spelled usetype

dclicktype 'dagger'
waitfortarget
targettype 'robe'
 
dclicktype 0x0F0C backpack

See also findtype · targettype · lifttype

Equips everything in a dress list you defined on the Arm/Dress tab. You can also pass an item serial to equip a single item.

dress 'My Sunday Best'

See also undress · clearhands

Drops the held item at your feet, onto a layer, or at a specific location. Lift something first.

lift 0x400D54A7 1
drop 0x6311 InnerTorso

See also lift · droprelloc · cleardragdrop

Drops what you are holding at an offset from your own position.

lift 0x400EED2A 1
wait 1000
droprelloc 1 1

Lifts a specific item. The script waits until the item is actually in hand before moving on.

lift 0x400EED2A 1
wait 1000
droprelloc 1 1

See also lifttype · drop

Lifts the first matching item. Searches your backpack unless you name another source.

lifttype 'robe'
wait 1000
droprelloc 1 1

Finds and drinks a potion by type.

if hp < 40
    potion 'heal'
endif

On UOSagas: If 'Block heal while poisoned' is enabled in Options, a heal potion is refused while you are poisoned. Cure first.

With no argument you strip completely. Pass a dress list to remove only those items, or a layer name to clear a single layer.

undress
undress 'My Sunday Best'
undress 'shirt'

See also dress

Uses (double-clicks) a specific item or mobile. Instead of a serial you can pass 'left', 'right' or 'hands' to use what you are holding. 'useobject' is an alias.

dclick 0x34AB
dclick 'right'

See also dclicktype

Finds an item by Tiledata name or graphic ID and uses it. It is the acting twin of findtype and takes the same arguments. Falls back to mobiles if no item matches. 'usetype' is an alias.

dclicktype 'dagger'
waitfortarget
targettype 'robe'
 
dclicktype 0x0F0C backpack

See also findtype · targettype · lifttype

Casts a spell by name or number. For spells that need a target, follow with waitfortarget and a target command.

cast 'greater heal'
waitfortarget
target 'self'

See also waitfortarget · target · interrupt

Interrupts your own cast by equipping and unequipping, so you do not waste the mana on a spell you no longer want.

cast 'greater heal'
if hp = maxhp
    interrupt
endif

On UOSagas: The layer argument is accepted but ignored. There is one generic interrupt path.

Sets a weapon ability or special move. Defaults to 'on' when you omit the state.

setability 'primary'
setability stun
setability 'primary' off

Changes whether a skill goes up, goes down, or is locked, the same as clicking the arrow in the skills window. Works on any skill, not just usable ones.

setskill 'blacksmithing' up
setskill 'mining' lock

Invokes a usable skill, the same as clicking its button in the skills window. Pass 'last' to repeat the previous one. 'useskill' is an alias.

Also spelled useskill

while mana < maxmana
    skill 'meditation'
    wait 11000
endwhile

See also setskill

Invokes a usable skill, the same as clicking its button in the skills window. Pass 'last' to repeat the previous one. 'useskill' is an alias.

while mana < maxmana
    skill 'meditation'
    wait 11000
endwhile

See also setskill

Runs the numbered organizer agent. 'set' prompts you for its hotbag instead. 'organize' and 'org' are aliases.

organizer 1
organizer 4 'set'

Runs the numbered organizer agent. 'set' prompts you for its hotbag instead. 'organize' and 'org' are aliases.

organizer 1
organizer 4 'set'

Runs the numbered organizer agent. 'set' prompts you for its hotbag instead. 'organize' and 'org' are aliases.

Also spelled organize , org

organizer 1
organizer 4 'set'

Runs the numbered restock agent. 'set' prompts you for its hotbag instead.

restock 1
restock 4 'set'

Turns the scavenger on or off, adds items, clears its cache or sets its hotbag. 'scav' is an alias.

scavenger 'off'

Turns the scavenger on or off, adds items, clears its cache or sets its hotbag. 'scav' is an alias.

Also spelled scav

scavenger 'off'

Prompts you to pick the Sell agent's hotbag.

sell

Uses the next item on your UseOnce list. 'add' lets you add an item, 'addcontainer' adds everything in a container.

useonce
useonce 'add'

Sends the message to your guild alliance.

alliance 'moving out'

Sends the message as an emote. Razor wraps it in *asterisks* for you.

emote 'looks around'

Sends the message to your guild.

guild 'incoming at brit gate'

Makes your character say the message. Pet commands and other keyword speech work as if you typed it. 'msg' is an alias.

say 'Hello world!'
say 'Hello world!' 454

See also whisper · yell · emote · guild · alliance

Makes your character say the message. Pet commands and other keyword speech work as if you typed it. 'msg' is an alias.

Also spelled msg

say 'Hello world!'
say 'Hello world!' 454

See also whisper · yell · emote · guild · alliance

Speaks quietly, so only mobiles very close to you hear it.

whisper 'over here'

Speaks loudly, so it carries much further than normal speech.

yell 'guards!'

Closes the last gump, or a specific one by ID.

gumpclose

Answers an open gump. Pass a gump ID to answer a specific gump instead of the last one that opened.

waitforgump 'any'
if ingump 'teleport home'
    gumpresponse 4
endif

Requests the context menu for an object and selects an entry by index. Pass 0 as the serial to use yourself.

# open your own context menu, pick the second entry
menu 0 1

Responds to a classic menu (not a context menu).

waitformenu
menuresponse 3 4

Responds to a server prompt, such as renaming a rune or setting a guild title.

dclicktype 'rune'
waitforprompt
promptresponse 'to home'

See also waitforprompt

Blocks until a gump appears. Pass 'any' for the next gump, or an ID to wait for a specific one.

dclicktype 'rune book'
waitforgump 'any'
gumpresponse 4

See also gumpresponse · gumpclose · gumpexists · ingump

Blocks until a classic menu appears.

waitformenu 'any'
menuresponse 3 4

Blocks until the server asks you for text input.

dclicktype 'rune'
waitforprompt
promptresponse 'to home'

Cancels the target cursor, empties the action queues and drops whatever you are holding. A good first line for a script that must start from a known state.

clearall
cast 'greater heal'

Executes a hotkey exactly as if you pressed it. This is the bridge to everything the assistant can do that has no command of its own. Use the name shown on the Hot Keys tab.

skill 'detect hidden'
waitfortarget
hotkey 'target self'
 
hotkey 'Bandage self'

Stops the script for a while. Add a unit to write it in seconds or minutes instead of milliseconds. 'pause' is an alias.

wait 500
wait 5 seconds

Starts a different script by name. Only one script runs at a time, so this hands over control.

if hp < 40
    script 'healself'
endif

Ends the script immediately.

if dead self
    stop
endif

Stops the script for a while. Add a unit to write it in seconds or minutes instead of milliseconds. 'pause' is an alias.

Also spelled pause

wait 500
wait 5 seconds

Blocks until the given text shows up in the message queue. Substring match. 'wfsysmsg' is an alias.

Also spelled wfsysmsg

clearsysmsg
dclicktype 'pickaxe'
waitforsysmsg 'You put' 5000

See also insysmsg · clearsysmsg

Blocks until the given text shows up in the message queue. Substring match. 'wfsysmsg' is an alias.

clearsysmsg
dclicktype 'pickaxe'
waitforsysmsg 'You put' 5000

See also insysmsg · clearsysmsg

Everything is findable again.

clearignore

Removes every entry; the list still exists.

clearlist 'ore'

Starts a timer you can read back with the cooldown expression. It is the clean way to stop a loop from repeating an action too early.

cooldown 'bandage' 30000
 
if cooldown 'bandage' > 2000
    overhead 'not yet'
endif

On UOSagas: The duration is in milliseconds. Older scripts that pass seconds keep working: a value below 100 is read as seconds. The on-screen cooldown bar is not implemented yet, but the timer itself works.

See also createtimer · timer

Lists hold values you can loop over with foreach. Creating a list that already exists does nothing.

createlist 'ore'
pushlist 'ore' 0x19B9
foreach x in ore
    sysmsg x
endfor

See also pushlist · poplist · clearlist · removelist · list · inlist · atlist

Timers count up in milliseconds. Read them with the timer expression.

createtimer 'trip'
while timer 'trip' < 60000
    walk 'North'
endwhile

See also settimer · removetimer · timer · timerexists

Works like findtype, but instead of returning one serial it fills an existing list with all matches. Create the list first.

createlist 'loot'
findtypelist 'loot' 0x0EED ground 0 any 3
foreach item in loot
    dclick item
endfor

See also findtype · createlist

Ignored serials are skipped by findtype, dclicktype, targettype and friends. Pass a list name to ignore every entry in it.

if findtype 'corpse' ground as body
    ignore body
endif

See also unignore · clearignore

Removes one entry, either by value or from the front or back. Add ! to remove every match instead of one.

poplist 'ore' 'front'
poplist! 'ore' 0x19B9   // ! = remove all matches

Appends to the back by default. Add ! to only push when the value is not already in the list.

createlist 'ore'
pushlist 'ore' 0x19B9
pushlist! 'ore' 0x19B9   // ! = only if not already present

Destroys the list entirely. listexists will report false afterwards.

removelist 'ore'

Destroys the timer. timerexists reports false afterwards.

removetimer 'trip'

Sets the elapsed time in milliseconds, the same as starting it that long ago.

settimer 'trip' 5000

With only a name, the script pauses and asks you to click a target. Pass a serial to set it without prompting. Variables are saved in your profile and survive a restart; add ! to make it script-local instead. 'setvariable' is an alias.

Also spelled setvariable

setvar 'dummy'
cast 'magic arrow'
waitfortarget
target 'dummy'
 
@setvar! globalTimeout 650   // ! = not persisted, @ = quiet

See also unsetvar · varexist

With only a name, the script pauses and asks you to click a target. Pass a serial to set it without prompting. Variables are saved in your profile and survive a restart; add ! to make it script-local instead. 'setvariable' is an alias.

setvar 'dummy'
cast 'magic arrow'
waitfortarget
target 'dummy'
 
@setvar! globalTimeout 650   // ! = not persisted, @ = quiet

See also unsetvar · varexist

Undoes ignore for one serial or for every entry of a list.

unignore 0x40001234

Removes a stored variable. 'unsetvariable' is an alias.

Also spelled unsetvariable

unsetvar 'dummy'

Removes a stored variable. 'unsetvariable' is an alias.

unsetvar 'dummy'

Invokes one of the three virtues.

virtue 'honor'

Moves your character one step. Razor throttles this to roughly one step every 0.4s, so a walk in a tight loop will not spam the server.

walk 'North'
walk 'East'

Switches your character between peace and war mode.

if not warmode
    warmode 'on'
endif

Single-clicks the object and collects every label line the server sends back into a variable. Use the 'in' operator to test the result.

if findtype 3852 self as pot
    getlabel pot potlabel
    if 'next usable' in potlabel
        sysmsg 'not ready'
    endif
endif

See also in

Renames a mobile you control. The name must be longer than one character.

rename 0x0004E2A9 'Fluffy'

Sets a ClassicUO profile property at runtime. 'cuo' is an alias.

Also spelled cuo

cuo 'usecustomlight' true

On UOSagas: Not supported. The client is compiled ahead-of-time, so it has no reflection with which to reach profile properties. The command still parses and warns instead of breaking your script. We may route it through the assistant interface later.

Razor keeps a buffer of recent system messages for insysmsg and waitforsysmsg. This clears it. Do that before waiting for a message you expect soon, so an old one cannot match. 'clearjournal' is an alias.

clearsysmsg
dclicktype 'pickaxe'
waitforsysmsg 'You put'

See also insysmsg · waitforsysmsg

Razor keeps a buffer of recent system messages for insysmsg and waitforsysmsg. This clears it. Do that before waiting for a message you expect soon, so an old one cannot match. 'clearjournal' is an alias.

Also spelled clearjournal

clearsysmsg
dclicktype 'pickaxe'
waitforsysmsg 'You put'

See also insysmsg · waitforsysmsg

Sets a ClassicUO profile property at runtime. 'cuo' is an alias.

cuo 'usecustomlight' true

On UOSagas: Not supported. The client is compiled ahead-of-time, so it has no reflection with which to reach profile properties. The command still parses and warns instead of breaking your script. We may route it through the assistant interface later.

Draws a private message over your character (or another mobile). Nobody else sees it; it is never sent to the server. Supports {{...}} interpolation: {{myvar}} inserts a variable, and an expression such as {{skill 'Alchemy'}} or {{hits}} inserts its current value. 'headmsg' is an alias.

if stam = 100
    overhead 'ready to go!' 68
endif
 
overhead "Alchemy: {{skill 'Alchemy'}}" 88
overhead 'hp {{hits}}/{{maxhits}}'

See also sysmsg

Starts a music track locally.

music 8

Draws a private message over your character (or another mobile). Nobody else sees it; it is never sent to the server. Supports {{...}} interpolation: {{myvar}} inserts a variable, and an expression such as {{skill 'Alchemy'}} or {{hits}} inserts its current value. 'headmsg' is an alias.

Also spelled headmsg

if stam = 100
    overhead 'ready to go!' 68
endif
 
overhead "Alchemy: {{skill 'Alchemy'}}" 88
overhead 'hp {{hits}}/{{maxhits}}'

See also sysmsg

Shows a random number between 1 and max as a system message.

random 15

Plays a sound effect locally at your position. Useful as an alert.

if hp < 30
    sound 0x1E9
endif

Prints a message in the lower-left of the client. Local only. Supports {{...}} interpolation: {{myvar}} inserts a variable, and an expression such as {{skill 'Alchemy'}} or {{hits}} inserts its current value. 'sysmessage' is an alias.

sysmsg 'ready to go!' 33
sysmsg "Alchemy: {{skill 'Alchemy'}}"

See also overhead · insysmsg · clearsysmsg

Prints a message in the lower-left of the client. Local only. Supports {{...}} interpolation: {{myvar}} inserts a variable, and an expression such as {{skill 'Alchemy'}} or {{hits}} inserts its current value. 'sysmessage' is an alias.

Also spelled sysmessage

sysmsg 'ready to go!' 33
sysmsg "Alchemy: {{skill 'Alchemy'}}"

See also overhead · insysmsg · clearsysmsg