Meta Expressions
These expressions can set and retrieve variables, control chat output, and more.
This adds the "Expression" meta condition and the "Expression Action" and "Chat Expression" meta actions.
The "/vt mexec [expression]" command is used for testing these expressions
Notes
- true is the same as 1, false is the same as 0. There are no actual booleans, just numbers.
- There are two extra operators added since monster expressions: the ^ (xor) operator, and the ; operator. The ; operator works on any two types and simply returns the value of the first one. It has the lowest possible precedence. The idea is to use it to string together commands when you don't care about the result.
- Unlike monster expressions, meta expressions do not trim spaces from the ends of strings.
- Set variables persist until cleared by a command or until relog.
- Formatting during the conversion of number to string is a string like this: http://msdn.microsoft.com/en-us/library/kfsatb94%28v=vs.110%29.aspx
- All operator characters which occur in a string must be escaped with \
- All numbers in a string must also be escaped.
Function Information
Expand to view details and available examples.
There are currently 48 meta functions.
testvar[1]
Parameter count: 1
Param 0 (String): The variable name to test
Example: testvar[variableName]getvar[1]
Parameter count: 1
Param 0 (String): The variable name to get
Example: getvar[exampleVar]setvar[2]
Parameter count: 2
Param 0 (String): The variable name to set
Example: variables can be strings or integers
setvar[exampleVar, variable]
setvar[exampleVar, 1]touchvar[1]
Parameter count: 1
Param 0 (String): The variable name to touch
Example: touchvar[exampleVar]clearallvars[]
Parameter count: 0
clearvar[1]
Parameter count: 1
Param 0 (String): The variable name to clear
Example: clearvar[exampleVar]getcharintprop[1]
Parameter count: 1
Param 0 (Number): IntValueKey property id.getchardoubleprop[1]
Parameter count: 1
Param 0 (Number): DoubleValueKey property id.getcharquadprop[1]
Parameter count: 1
Param 0 (Number): QuadValueKey property idgetcharboolprop[1]
Parameter count: 1
Param 0 (Number): BoolValueKey property idgetcharstringprop[1]
Parameter count: 1
Param 0 (Number): StringValueKey property id.getplayerlandcell[0]
Parameter count: 0
getplayercoordinates[0]
Parameter count: 0
coordinategetns[1]
Parameter count: 1
Param 0 (Coordinates): The coordinates object.coordinategetwe[1]
Parameter count: 1
Param 0 (Coordinates): The coordinates object.coordinategetz[1]
Parameter count: 1
Param 0 (Coordinates): The coordinates object.coordinatetostring[1]
Parameter count: 1
Param 0 (Coordinates): The coordinates object.coordinateparse[1]
Parameter count: 1
Param 0 (String): The coordinates string.coordinatedistancewithz[2]
Parameter count: 2
Param 0 (Coordinates): The first coordinates object.
Param 1 (Coordinates): The second coordinates object.coordinatedistanceflat[2]
Parameter count: 2
Param 0 (Coordinates): The first coordinates object.
Param 1 (Coordinates): The second coordinates object.wobjectgetphysicscoordinates[1]
Parameter count: 1
Param 0 (WorldObject): The world object to examine.wobjectgetname[1]
Parameter count: 1
Param 0 (WorldObject): The world object to examine.wobjectgetobjectclass[1]
Parameter count: 1
Param 0 (WorldObject): The world object to examine.wobjectgettemplatetype[1]
Parameter count: 1
Param 0 (WorldObject): The world object to examine.wobjectgetisdooropen[1]
Parameter count: 1
Param 0 (WorldObject): The door world object to examine.wobjectfindnearestmonster[0]
Parameter count: 0
wobjectfindnearestdoor[0]
Parameter count: 0
Example: http://www.virindi.net/junk/door.jpgwobjectfindnearestbyobjectclass[1]
Parameter count: 1
Param 0 (Number): The objectclass number to look for.wobjectfindininventorybytemplatetype[1]
Parameter count: 1
Param 0 (Number): The template type number to look for.
Example: http://www.virindi.net/junk/expr-usingtemplates.jpgwobjectfindininventorybyname[1]
Parameter count: 1
Param 0 (String): The item name to look for.wobjectfindininventorybynamerx[1]
Parameter count: 1
Param 0 (String): The item name to look for. This parameter is a regex.wobjectgetselection[0]
Parameter count: 0
wobjectgetplayer[0]
Parameter count: 0
actiontryselect[1]
Parameter count: 1
Param 0 (WorldObject): The world object to attempt to select.
Example: http://www.virindi.net/junk/select.jpgactiontryuseitem[1]
Parameter count: 1
Param 0 (WorldObject): The world object to attempt to use.actiontryapplyitem[2]
Parameter count: 2
Param 0 (WorldObject): The world object to use first.
Param 1 (WorldObject): The world object to be used on.isfalse[1]
Parameter count: 1
Param 0 (Any): The object to examineistrue[1]
Parameter count: 1
Param 0 (Any): The object to examineiif[3]
Parameter count: 3
Param 0 (Any): The object to examine
Param 1 (Any): What to return if the first parameter is true.
Param 2 (Any): What to return if the first parameter is not truerandint[2]
Parameter count: 2
Param 0 (Number): Minimum
Param 1 (Number): Maximumcstr[1]
Parameter count: 1
Param 0 (Number): The number to convertstrlen[1]
Parameter count: 1
Param 0 (String): The string to examinegetobjectinternaltype[1]
Parameter count: 1
Param 0 (Any): The object to examinecstrf[2]
Parameter count: 2
Param 0 (Number): The number to convert
Param 1 (String): The format string to use. See: http://msdn.microsoft.com/en-us/library/kfsatb94.aspxstopwatchcreate[0]
Parameter count: 0
Example: http://www.virindi.net/junk/stopwatch.jpgstopwatchstart[1]
Parameter count: 1
Param 0 (Stopwatch): The stopwatch to startstopwatchstop[1]
Parameter count: 1
Param 0 (Stopwatch): The stopwatch to stopstopwatchelapsedseconds[1]
Parameter count: 1
Param 0 (Stopwatch): The stopwatch to query
Object Properties
| ObjectClass | |
| Unknown | 0 |
| MeleeWeapon | 1 |
| Armor | 2 |
| Clothing | 3 |
| Jewelry | 4 |
| Monster | 5 |
| Food | 6 |
| Money | 7 |
| Misc | 8 |
| MissileWeapon | 9 |
| Container | 10 |
| Gem | 11 |
| SpellComponent | 12 |
| Key | 13 |
| Portal | 14 |
| TradeNote | 15 |
| ManaStone | 16 |
| Plant | 17 |
| BaseCooking | 18 |
| BaseAlchemy | 19 |
| BaseFletching | 20 |
| CraftedCooking | 21 |
| CraftedAlchemy | 22 |
| CraftedFletching | 23 |
| Player | 24 |
| Vendor | 25 |
| Door | 26 |
| Corpse | 27 |
| Lifestone | 28 |
| HealingKit | 29 |
| Lockpick | 30 |
| WandStaffOrb | 31 |
| Bundle | 32 |
| Book | 33 |
| Journal | 34 |
| Sign | 35 |
| Housing | 36 |
| Npc | 37 |
| Foci | 38 |
| Salvage | 39 |
| Ust | 40 |
| Services | 41 |
| Scroll | 42 |
| CombatPet | 43 |
| NumObjectClasses | 44 |
| getcharintprop | |||||||||||||||||||||||||||||||||||||||||||||||||
| Species | 2 | ||||||||||||||||||||||||||||||||||||||||||||||||
| ContainerSlots | 7 | ||||||||||||||||||||||||||||||||||||||||||||||||
| BurdenUnits | 5 | ||||||||||||||||||||||||||||||||||||||||||||||||
| TotalValue(pyreal) | 20 | ||||||||||||||||||||||||||||||||||||||||||||||||
| SkillCreditsAvail | 24 | ||||||||||||||||||||||||||||||||||||||||||||||||
| Level | 25 | ||||||||||||||||||||||||||||||||||||||||||||||||
| Rank | 30 | ||||||||||||||||||||||||||||||||||||||||||||||||
| Deaths | 43 | ||||||||||||||||||||||||||||||||||||||||||||||||
| DateOfBirth(unix) | 98 | ||||||||||||||||||||||||||||||||||||||||||||||||
| Gender | 11 | ||||||||||||||||||||||||||||||||||||||||||||||||
| Age(seconds) | 125 | ||||||||||||||||||||||||||||||||||||||||||||||||
| XPForVPReduction | 129 | ||||||||||||||||||||||||||||||||||||||||||||||||
| ChessRank | 181 | ||||||||||||||||||||||||||||||||||||||||||||||||
| Heritage | 188 | ||||||||||||||||||||||||||||||||||||||||||||||||
| FishingSkill | 192 | ||||||||||||||||||||||||||||||||||||||||||||||||
| SocietyRibbonCount(CH) | 287 | ||||||||||||||||||||||||||||||||||||||||||||||||
| SocietyRibbonCount(WEB) | 288 | ||||||||||||||||||||||||||||||||||||||||||||||||
| SocietyRibbonCount(RB) | 289 | ||||||||||||||||||||||||||||||||||||||||||||||||
| Reinforcement of the Lugians 218 | Bleeargh's Fortitude 219 | Oswald's Enchantment 220 | Siraluun's Blessing 221 | Enduring Calm 222 | Steadfast Will 223 | Ciandra's Fortune 224 | Shadow of the Seventh Mule 229 | Might of the Seventh Mule 230 | Clutch of the Miser 231 | Enduring Enchantment 232 | Critical Protection 233 | Quick Learner 234 | Charmed Smith 236 | Innate Renewal 237 | Archmage's Endurance 238 | Enhancement of the Blade Turner 240 | Enhancement of the Arrow Turner 241 | Enhancement of the Mace Turner 242 | Caustic Enhancement 243 | Fiery Enhancement 244 | Icy Enhancement 245 | Storm's Enhancement 246 | Infused Creature Magic 294 | Infused Item Magic 295 | Infused Life Magic 296 | Infused War Magic 297 | Eye of the Remorseless 298 | Hand of the Remorseless 299 | Master of the Steel Circle 300 | Master of the Focused Eye 301 | Master of the Five Fold Path 302 | Frenzy of the Slayer 309 | Iron Skin of the Invincible 310 | Jack of All Trades 326 | Infused Void Magic 328 | InfusedVoid 328 | AuraValor 333 | AuraManaFlow 339 | AuraPurity 342 | AuraCraftsman 343 | AuraSpecialization 344 | MeleeMastery 354 | RangedMastery 355 | SummoningMastery 362 | AuraWorld 365 | Heal Boost Rating 376 | Vitality Rating379 | Total DmgRating 307 | Total DmgResist 308 |
Examples
Test for proximity to any portal.
coordinatedistancewithz[wobjectgetphysicscoordinates[wobjectfindnearestbyobjectclass[14]],getplayercoordinates[]]<5
Use closest portal.
actiontryuseitem[wobjectfindnearestbyobjectclass[14]]
Check if you have any Aged or Durable Legendary Keys in your inventory.
getobjectinternaltype[wobjectfindininventorybynamerx[\^\(Aged\|Durable\) Legendary Key\$]]==7
Check if there is any object currently selected.
getobjectinternaltype[wobjectgetselection[]]==7
Save the selected items name in a variable.
setvar[keyName,wobjectgetname[wobjectgetselection[]]]
