Major Feature: Rigging (stuff that does things)

[seisatsu]

This is a major feature that will allow using items to make things actually happen in-game. It works in conjunction with imbuements to allow an item to be used in multiple ways. See #58.

rig item <id> <action> [toggle] <effect> <arguments>

This command allows fine-tuned control over stuff that will happen when specific custom commands are used on an item. It is useful to use imbue item in conjunction with this command. The first effect that will be added is teleport. Similar to imbue item, multi-word actions can be defined with triple-double quotes.

• Ex. 1: rig item 4 pull teleport 12
  • This is similar to using pair telekey, except while pair telekey will cause the item to teleport a user when the use command or any custom command is used on that item, with this example, the item will only teleport the user when they "pull" it. If there is custom broadcast text set for the "pull" action on item 4 with the imbue item command, that text will be broadcast. Otherwise the default decoration will be broadcast. One item will be able to have multiple different effects depending on how it's used.

Planned rig effects:

• [toggle] (un)hide item [room] <id>: Make an item disappear or reappear in the current room, or another room if given.
• [toggle] (un)hide exit [room] <id>: Make an exit disappear or reappear in the current room, or another room if given.
• [toggle] (un)lock exit [room] <id>: Lock or unlock an exit in the current room, or another room if given.
• [toggle] describe self/item/exit/room [room] <id> <desc>: Change the description of an object, with an optional room other than the current one for exits.
• [toggle] decorate item/exit [room] <id> <desc>: Change the decoration of an object, with an optional room other than the current one for exits.
• [toggle] affect self/item/exit/room [room] <id> <desc>: Add a line to the end of the description of an object, with an optional room other than the current one for exits.
• [toggle] (un)imbue item/exit [room] <id> <action> [<text>]: Imbue or unimbue an object, with an optional room other than the current one for exits, and text required for items.

Each rig effect has the option to toggle back and forth each time it is used. For rig effects on exits, if one argument is given, it is the exit id in the current room; if two arguments are given, they are the room id first, and then the exit id.