set_wall |
Discworld room help |
set_wall |
Name
set_wall - sets information relating to walls
Syntax
void set_wall( mixed *args );
Description
All locations can have walls which can be climbed up, down or across to reach other locations. This function can be used to set the relevant parameters for the wall, including destinations, climbing skill, climbing difficulties, climbing messages, locations below this location (locations through which things fall if they fall from this location) the location at the bottom (the location where things end up when they fall) and the message they get if they are unfortunate enough to die from falling. The elements of the mixed args array are paired, as for modify_exit, with the first a string to indicate what information is being set and the second a mixed variable containing the information.
As with modify_exit, more than one option can be passed to set_wall at a time.
The indicating strings and the corresponding information variables are as follows.
It is necessary to have set_wall() in all rooms referenced by the initial set_wall() (apparently).
"below"
The information variable is a string array consisting of the locations through which something would fall on its route to the bottom, but not including the location at the bottom. Each element is the file name of one of these locations.
"bottom"
There are a number of possibilities for the information variable in this case. If it is an array containing a single string, it is the file name of the location to which things fall. If it is an array containing two elements, then the first element is the file name of the location to which things fall. If the second element of this array is also a string, then it is the name of a function which is called on the bottom location, with arguments of what is falling and whence it fell, and the string that the function returns is the message (using $N and verb$s) which is present to people already at the bottom when the falling thing arrives. If the second element is an integer, then it is the percentage of blunt damage done to the falling thing if it is living based on how far it fell and its total weight.
"death_mess"
Simple enough. The information variable must be a string or 0. Normally the death_mess variable (which this information variable controls) has a value of 0, and if it's 0 when they die, the default message of "You hit the ground with a sickening crunch.\n" is sent. If, however, death_mess is anything else, death_mess itself will be sent. This means that if you don't want a death message you can set this to "". And you can make the information variable 0 if you want the default message to be sent. Note that this is the message given when the player falls to his death *from the room in which the variable was set*. I.e. if a player falls to his death from a room, and the death_mess was not set up via set_wall() in that room, they will get the default message.
"ghost_action"
This option controls the action taken when ghosts attempt to climb. It can be either 0, 1, a string containing a path, or an array containing a string containing a path and a string array containing three move messages.
If this is set to 0, as it is by default, the ghost will be able to climb the wall with no skill check, succeeding every time.
If it is set to 1, the ghost will always fail, since ghosts can't climb.
If it is set to a string, the ghost will be moved to the room whose path is in the string, with some default messages.
If it is set to an array, the ghost will be moved to the room whose path is in the first cell of the array. The second cell of the array will be taken to contain a string array with the move messages that are to be used - the first for the player, the second for the room they are arriving in, and the third for the room they are leaving. The move messages do not need to be terminated with newlines.
"move"
The information variable is a mixed array consisting of four elements. The first is a string, which is the direction, typically "up" or "down", for the move. The second is either an integer or an array containing an integer and a string; the integer is the base difficulty (to be compared against a skill bonus) for the climb if the climber is not carrying anything, and the string is the skill to be used in the skillcheck (defaulting to ad.mo.cl.wall if not specified). The third is a string, being the file name of the destination location and the fourth is either a string or an array of three strings providing the message(s) (using $N and verb$s) to print on a successful climb to the player, the room they're climbing from, and the room they're climbing to.
"aliases"
This sets up the aliases for the exits, the variable that comes after it in the list should be a mapping of the form: map = ([ alias : real exit, ...])
"no_drop"
This option is used in combination with the "bottom" option. If set to 0, which is the default, items will fall down to the bottom of your wall. If set to 1, they won't.
Examples
In wall_bottom:
set_wall( ({ "move", ({ "up",
({ 50, "adventuring.movement.climbing.rock" }), PATH + "wall_side",
({ "You carefully climb up the wall",
"$N carefully climb$s up the wall.",
"$N climb$s up from below to join you." }) }) }) );
set_wall( ({ "no_drop", 0 }) ); /* not required */
In wall_side:
set_wall( ({ "bottom", ({ PATH +"wall_bottom", 50 }) }) );
set_wall( ({ "move", ({ "down", 50, PATH + "wall_bottom",
({ "You climb down.", "$N climb$s down and vanish$es from view.",
"$N climb$s down from above to join you." }) }) }) );
set_wall( ({ "move", ({ "up", 150, PATH + "wall_ledge",
({ "You climb up.", "$N climb$s up and vanish$es from view.",
"$N climb$s up from below to join you." }) }) }) );
set_wall( ({ "death_mess", "You splat into the pavement, "
"throwing a few guts everywhere.\n" }) );
set_wall( ({ "no_drop", 1 }) );
In wall_ledge:
set_wall( ({ "bottom", ({ PATH +"wall_bottom", 50 }),
"below", ({ PATH +"wall_side" }) }) );
set_wall( ({ "move", ({ "down", 100, PATH + "wall_side",
({ "You climb down.", "$N climb$s down and vanish$es from view.",
"$N climb$s down from above to join you." }) }) }) );
set_wall( ({ "death_mess", "You splat into the pavement, "
"throwing lots of guts everywhere.\n" }) );
Anywhere on the wall:
set_wall( ({ "ghost_action", 1 }) );
set_wall( ({ "ghost_action", "/w/vashti/rooms/target.c" }) );
set_wall( ({ "ghost_action", ({
"/w/vashti/rooms/target.c", ({
"You fall through the wall. Ow.",
"$N dives through the wall and rolls painfully on "
"the floor.",
"$N takes a flying leap at the wall and disappears "
"into it." }) }) }) );
About aliases have a look at:
find -d set_djel_wall /d/klatch/djel/walls/wall_inherit.c
