Expression Reference

Checks for a target cursor, optionally of a specific kind.

if targetexists 'harmful'
    target 'closest' 'enemy'
endif

Returns the seconds left on the running bandage; 0 means you are free to apply the next one. Works for healing and veterinary.

if bandaging = 0 and hp != maxhp
    hotkey 'Bandage self'
endif

On UOSagas: Tracked from the bandage messages and estimated at about 8 seconds, because our server sends no bandage timer. Reliable enough to gate a heal loop, but do not treat it as a precise stopwatch.

Returns the skill value. Add ! to read the base value instead of the modified one.

if skill 'magery' > 50
    cast 'greater heal'
endif

Checks whether a specific gump, or any gump at all, is currently open.

if gumpexists 'any'
    gumpclose
endif

Substring search over the text of an open gump.

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

Returns the value at the given index, counting from 0.

if atlist 'loot' 0 as first
    dclick first
endif

Returns the remaining milliseconds, or 0 when the cooldown is finished or unknown, so a bare 'if cooldown' asks whether it is still running.

if cooldown 'bandage' > 2000
    overhead 'more than 2s left'
endif

Case-insensitive search through the list.

if not inlist 'loot' 0x19B9
    pushlist 'loot' 0x19B9
endif

Returns the list length.

if list 'loot' > 0
    poplist 'loot' 'front'
endif

Checks whether the list has been created.

if not listexists 'loot'
    createlist 'loot'
endif

The expression form of the poplist command: removes the entry and gives you its value.

while list 'loot' > 0
    if poplist 'loot' 'front' as item
        dclick item
    endif
endwhile

Returns how long the timer has been running.

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

Checks whether the timer has been created.

if not timerexists 'trip'
    createtimer 'trip'
endif

Checks for a saved variable. Add @ to check script-local variables instead. 'varexists' is an alias.

Also spelled varexists

if not varexist 'dummy'
    setvar 'dummy'
endif

Checks for a saved variable. Add @ to check script-local variables instead. 'varexists' is an alias.

if not varexist 'dummy'
    setvar 'dummy'
endif

True when your character is blessed / invulnerable. 'invul' and 'invuln' are aliases.

Also spelled invul , invuln

if blessed
    overhead 'safe'
endif

Without an argument, true when your character is a ghost. With a serial, true when that mobile is visible as a ghost.

if not dead
    # main loop
endif

Current dexterity.

if dex > 90
    overhead 'quick'
endif

maxhp minus hp, usually easier to read than comparing both. 'diffhp' is an alias.

Also spelled diffhp

if diffhits > 30
    potion 'heal'
endif

maxhp minus hp, usually easier to read than comparing both. 'diffhp' is an alias.

if diffhits > 30
    potion 'heal'
endif

maxmana minus mana.

if diffmana > 40
    skill 'meditation'
endif

maxstam minus stam.

if diffstam > 40
    potion 'refresh'
endif

maxweight minus weight.

if diffweight < 20
    overhead 'nearly full'
endif

Searches your active buffs by name.

if not findbuff 'magic reflection'
    cast 'magic reflection'
endif

On UOSagas: Always false right now. The buff and debuff packet handler is not wired up yet, so Razor sees no buffs at all. The expression parses and runs, it simply never matches. A fix is planned.

Searches your active debuffs by name.

if finddebuff 'bleed'
    potion 'heal'
endif

On UOSagas: Always false right now, for the same reason as findbuff: there is no buff or debuff tracking yet.

Current follower slots in use.

if followers < maxfollowers
    overhead 'can tame more'
endif

True while your character is not visible.

if not hidden
    skill 'hiding'
endif

Current hit points. 'hits' is an alias.

if hp < 50
    potion 'heal'
endif

See also maxhp · diffhits

Current hit points. 'hits' is an alias.

Also spelled hits

if hp < 50
    potion 'heal'
endif

See also maxhp · diffhits

Current intelligence.

if int >= 100
    overhead 'clever'
endif

True when your character is blessed / invulnerable. 'invul' and 'invuln' are aliases.

if blessed
    overhead 'safe'
endif

True when your character is blessed / invulnerable. 'invul' and 'invuln' are aliases.

if blessed
    overhead 'safe'
endif

True when nothing is equipped on the left hand layer.

if lhandempty
    overhead 'shield?'
endif

Current mana.

if mana >= 11
    cast 'greater heal'
endif

Maximum follower slots.

if followers = maxfollowers
    overhead 'full'
endif

Maximum hit points. 'maxhits' is an alias.

if hp != maxhp
    hotkey 'Bandage self'
endif

Maximum hit points. 'maxhits' is an alias.

Also spelled maxhits

if hp != maxhp
    hotkey 'Bandage self'
endif

Maximum mana.

while mana < maxmana
    skill 'meditation'
    wait 11000
endwhile

Maximum stamina.

if stam = maxstam
    overhead 'rested'
endif

Maximum weight before you are overloaded.

if diffweight < 20
    script 'bank run'
endif

True when something is on your mount layer.

if not mounted
    dclick 'lastobject'
endif

The name of your character.

if name = 'Rex'
    overhead 'hello'
endif

True while your character cannot move.

if paralyzed
    overhead 'Paralyzed!' 38
endif

True while your character is poisoned.

if poisoned
    potion 'cure'
endif

Compares your position to the given coordinates.

if position 5923 1145
    overhead 'on the spot'
endif

True when nothing is equipped on the right hand layer.

if rhandempty
    dclicktype 'dagger'
endif

Current stamina.

if stam < 20
    potion 'refresh'
endif

Current strength.

if str < 100
    overhead 'weak'
endif

True when your character is in war mode.

if not warmode
    warmode 'on'
endif

Current weight.

if weight > maxweight
    overhead 'overloaded' 38
endif

Reads one of your Display/Counters entries by name. If no counter matches, it counts items of that type instead. 'counter' is an alias.

Also spelled counter

if count 'bandage' < 20
    restock 1
endif

Reads one of your Display/Counters entries by name. If no counter matches, it counts items of that type instead. 'counter' is an alias.

if count 'bandage' < 20
    restock 1
endif

Adds up the stack sizes of every matching item.

if counttype 0x0F7A backpack < 50
    restock 1
endif

Like findtype, but you already know the serial. Returns the serial when it matches the filters, otherwise 0.

if find 0x40001234 backpack
    overhead 'still there'
endif

Looks up what you are wearing on a given layer. Returns 0 when the layer is empty.

if findlayer self righthand as weapon
    getlabel weapon weaponlabel
endif

Searches for an object by Tiledata name or graphic ID. Returns the serial, or 0 when nothing matches, so it reads as true or false inside an if. Use 'as' to keep the result. Item names support the %s% plural wildcard, e.g. "clean bandage%s%" matches both singular and plural.

if findtype "clean bandage%s%" backpack
    hotkey 'Bandage self'
endif
 
if findtype 3852 self as PotsHeal
    dclick PotsHeal
endif

See also find · findtypelist · counttype · dclicktype · targettype

Returns the hue of an item or mobile.

if hue 0x40001234 = 0x1809
    overhead 'right colour'
endif

Total item count in your backpack, including containers inside it.

if itemcount > 120
    overhead 'pack is full'
endif

Returns one of: innocent (blue), friend (green), hostile (grey), criminal (grey), enemy (orange), murderer (red), invulnerable (yellow).

if noto 'last' = 'murderer'
    attack 'last'
endif

Substring search over Razor's recent system messages. Clear the queue first if an old match would confuse you. 'insysmessage' is an alias.

if insysmsg 'You are frozen'
    dclicktype 'pouch' backpack
endif

See also clearsysmsg · waitforsysmsg

Substring search over Razor's recent system messages. Clear the queue first if an old match would confuse you. 'insysmessage' is an alias.

Also spelled insysmessage

if insysmsg 'You are frozen'
    dclicktype 'pouch' backpack
endif

See also clearsysmsg · waitforsysmsg

Reports whether structured-PvP restrictions are limiting what scripts may do.

if pvp
    overhead 'restricted'
endif

On UOSagas: Always false. UOSagas has no structured-PvP restriction system, so nothing is ever restricted. The expression stays registered so scripts that use it still parse and run.

True when the action queue is not empty. Useful to wait for a dress or organizer to finish.

dress 'My Sunday Best'
while queued
    wait 100
endwhile