Description
A single identifying name of your choice can be passed to the name command in an object's Action field in order to assign a name to the object so that it may be referenced by an action on another object. This allows the implementation of multi-object behaviors, such as clicking on a sign, lever, or button to open a door, lower a bridge, close a window, or re-paint a house.
Once a name has been assigned to an object using the name command, it is then possible to place a command on another object, which uses that command's name parameter to effect the named object. Depending on the command used, the name parameter may be used to place a new light or corona on the named object, or to animate it, or even start or stop an animation on it, to texture it, attach a sound to it, change whether or not it is solid or visible, change it's color, add sign text to appropriately tagged surfaces of it, or even move or rotate the named object by remote control.
Multiple objects may have the same name or different names. Actions applied to a name will affect all objects with that name, which are already loaded into the current scene at the time, provided they have the same owner. Named objects and the objects on which the commands are placed to control them must have the same owner in order for the named objects to be effected. This feature helps keep builders from accidentally disturbing each other's builds.
The animate command requires a name to be specified, so the name me is used with the animate command to mean this object.
Examples
create name water
create name ceiling
create name sign1
create name jumper1; texture jump2 name=jumper1
create animate mask me jump 5 9 100 1 2 3 4 5 4 3 2 1, astop; activate astart off
create animate me turn 5 5 0, astart; activate frame +1; adone sign "Warning!" color=red bcolor=yellow name=sign1
activate color name=water blue
activate light type=spot color=blue name=ceiling pitch=45
create name door
bump visible door off
create name sign, visible off
activate rotate 0 name=sign, rotate -2 name=sign1
bump rotate 0 name=sign1, rotate -3 0 .3 name=sign
activate solid trapdoor off
create name trapdoor
activate visible sign true
bump visible sign1 yes
create name rock
activate visible rock off
bump visible rock on