CthulhuMud - Substitution Paramters

[ Index ]

Substitution paramters enable details from events to be embeded into commands that a mob scehdules for execution. This allows mobs to tailor their reaction to accomodate the mob that caused it.

Available Paramters

Substitution paramters are available for all parts of an event, although the paramteres available depend upon the nature of the item being referenced.

The basic form of a substitution parameter is:

@xy

Where x determines the item being referenced and y determines the attribute of it being referenced.

The following items can be referenced:

        x  Meaning
        -  ----------------
        g  global
        a  actor
        v  victim
        o  observer
        p  primary object
        s  secondary object
        t  text
        n  number  
        r  room

The attributes that can be referenced depend upon the nature of the item:

  y  Character      Object          Text           Number       Room        Global
  - -----------     -------------   ----           -------      -------     -------
  0  a/an           a/an            text           number       vnum        Mud Name  
  1  name           name            garbled text                name        Mud URL
  2  short desc     short desc                                              Mud IP
  3  his/her/its        
  4  him/her/it
  5  he/she/it
  6  man/woman/thing
  7  Sir/Lady/Thing
  8  Lad/Lass/Thingy
  9  Sir/Madam/Thing
  r  vnum of room
  d  vnum of dreaming from room
  t  true name
  l  level          level

If you want an @ sign, use @@.

True Names

A true name is a unique name for a mob within the current mud. The true name is comprised of a constant (@M or @P) followed by the hex address of the mobs storage location in memory. The main use of true names is to ensure that commands always refer to the correct mob. Consider a case where a room has two mobs called 'guard' in it. Any command issued simply against 'guard' will always affect the first mob, even if the seond one was the intended target. By using the true name to refer to the target mob, you can guarentee that the right mob will always be found.

[ Index ]