@action

This program creates a new action.

Synopsis

@action name = object [= registration_name]

Parameters

name: A string that will become the name of the new action.
object: The parent object where the new action will be stored.
registration_name: The name of the /_reg/ property that will be used to record the dbref of the new action. Optional.

Description

This program creates a new action and attaches it to the specified object. The object can be a thing, room, or player object. You may only attach actions you control to a object you control.

If a registration_name is specified, the dbref of the new action is stored in the _reg/registration_name property of the character that creates the action. Other commands issued by the character can refer to the action by using $registration_name instead of the dbref of the action.

Example:
@action honkbutton=myhorn=honk
examine me=/_reg/
ref /_reg/honk:myhorn(#123456)
@desc $honk=A bright red button that honks the horn.

Note that the registration of the new action is distinct from the action; if the action is recycled, the registration remains and would have to be manually removed.

Example:
@recycle #123456
@set me=/_reg/honk:

Creating an action costs 1 penny.

Returns

If the action is created successfully, the server returns a message in this format:

Action created with number dbref and attached. Registered as regname
Example:
@action honkbutton=myhorn=honk
Action created with number #123456E and attached. Registered as $honk

Errors

<Empty>

Open Issues