/*
** iroom.c - file for creating interrooms. NOTE: this file isn't used
** by itself. It is included in other files that inherit the
** proper base room. I HATE doing it this way, but I couldn't
** think of a way to make the inheritance work out.
**/
/**
* This file contains the functions for creating "irooms" (short for
* "interrooms"), rooms
* that exist between two (generally much larger) rooms. The purpose
* is to allow more resolution between widely-spaced rooms, such as
* roads, without requiring the player to traverse them all.<p>
* The two rooms on either end of a set of irooms (called "milestones")
* are reached via normal exit directions (eg, "east"). The irooms are
* reached via exits named with the same direction, prepended with a
* "motion verb" (eg, "walk", giving an iroom exit of "walk east").<p>
* <b>NOTE:<b> This file is not an object in itself. It is meant to be
* included in other files that implement the various types of rooms (I
* know, I know: it's very ugly. But it's the only way I could think to
* handle the inheritance without copying this file in each room file).
* @author Jeremy
* @see milestone
* @see interroom
* @see topography
*/
#include <dirs.h>
#include <room.h>
int *milestone_index;
string *milestone_dirs = ({ });
string iroom_handler;
mapping shorten = SHORTEN;
string topo_handler;
string motion_verb = "walk", exit_type = "road", short_mse;
string iroom_exit_mess = "$N $V$s away to the $T.";
string iroom_enter_mess = "$N $V$s in from the $F.";
// Note that move messages don't do $N subs.
string iroom_move_mess = "You $V a little to the $T.\n";
string *pass_mess = ({
"You $V a long while.",
"$N passes by heading $T.",
" On the way you pass $O.\n"
});
// These are for unspecified exits
mixed other_exits = ({ });
string *other_types = ({ });
mapping look_mess = ([ ]);
mapping dirs = ([
"north": ({ 1, 0, 0 }), "south": ({ -1, 0, 0 }),
"east": ({ 0, 1, 0 }), "west" : ({ 0, -1, 0 }),
"northeast": ({ 1, 1, 0 }), "northwest": ({ 1, -1, 0 }),
"southeast": ({ -1, 1, 0 }), "southwest": ({ -1, -1, 0 }),
"up": ({ 0, 0, 1 }), "down": ({ 0, 0, -1 })
]);
mapping opposites = ([
"north": "south", "south": "north", "west": "east",
"east": "west", "northeast": "southwest", "southwest": "northeast",
"northwest": "southeast", "southeast": "northwest", "up": "down",
"down": "up"
]);
/**
* This method is deprecated. Use set_topo_handler()
*/
void set_area_handler(string s) { topo_handler = s; }
/**
* This method sets the topology handler for this iroom.
* @param s pathname of topology handler
* @see topology
* @see query_topo_handler()
*/
void set_topo_handler(string s) { topo_handler = s; }
/**
* This method returns the topology handler set for this iroom.
* @return the topology handler for the iroom
* @see set_topo_handler()
*/
string query_topo_handler() { return topo_handler; }
/**
* This method sets the iroom handler for this section of irooms
* @param s pathname of iroom handler
* @see interroom
* @see query_iroom_handler()
*/
void set_iroom_handler(string s) { iroom_handler = s; }
/**
* This method returns the iroom handler for this section of irooms
* @return the iroom handler for this section of rooms
* @see set_iroom_handler()
*/
string query_iroom_handler() { return iroom_handler; }
/**
* This method sets the iroom's motion verb, the verb to be used in the
* iroom exit names; eg, "walk", "swim". The default is "walk".
* @param s motion verb
* @see interroom
* @see query_motion_verb()
*/
void set_motion_verb(string s) { motion_verb = s; }
/**
* This method returns the motion verb.
* @return the motion verb
* @see set_motion_verb()
*/
string query_motion_verb() { return motion_verb; }
/**
* This method sets the exit message for exits to irooms. The format
* is the same as for normal exit messages, except that $V can be used
* to represent the motion verb. The default is<pre><br>
* <code>"$N $V$s away to the $T."</code>
* </pre>
* @param s iroom exit message
* @see query_iroom_exit_mess()
* @see modify_exit()
*/
void set_iroom_exit_mess(string s) { iroom_exit_mess = s; }
/**
* This method returns the iroom exit message.
* @return iroom exit message
* @see set_iroom_exit_mess()
*/
string query_iroom_exit_mess() { return iroom_exit_mess; }
/**
* This method sets the entrance message used when entering from an
* iroom. The format is the same as for normal entrance messages, except
* that $V represents the motion verb. The default is<pre><br>
* <code>"$N $V$s in from the $F."</code>
* </pre>
* @param s iroom entrance message
* @see query_iroom_enter_mess()
* @see modify_exit()
*/
void set_iroom_enter_mess(string s) { iroom_enter_mess = s; }
/**
* This method returns the iroom entrance message.
* @return iroom entrance message
* @see set_iroom_enter_mess()
*/
string query_iroom_enter_mess() { return iroom_enter_mess; }
/**
* This method sets the "moving message" shown to the player when
* leaving an iroom. The format is the same as for normal moving
* messages, except that $V represents the motion verb. The default
* is<pre><br>
* <code>"You $V a little to the $T.\n"</code>
* </pre>
* @param s iroom moving message
* @see query_iroom_move_mess()
* @see modify_exit()
*/
void set_iroom_move_mess(string s) { iroom_move_mess = s; }
/**
* This method returns the iroom moving message.
* @return iroom moving message
* @see set_iroom_move_mess()
*/
string query_iroom_move_mess() { return iroom_move_mess; }
/**
* This method sets the messages printed when passing through a number
* of irooms in one move. The parameter should be an array of three
* strings: the first is the one printed to the moving player; the
* second is printed to all living objects that are passed. Both follow
* the same format as the other iroom messages. The third is a string which
* is appended to the first if any objects are passed along the way;
* $O can be used to represent the list of objects. Any or all of the
* strings can be set to 0, in which case that string will not be printed.
* The default passing messages are<pre><br><code>
* ({ "You $V a long while.",
* "$N passes by heading $T.",
* " On the way you pass $O.\n"
* </code></pre>
* @param s iroom passing messages (array of 3 strings)
* @see query_pass_mess()
* @see modify_exit()
*/
void set_pass_mess(string *s) { pass_mess = s; }
/**
* This method returns the current iroom passing messages.
* @return iroom move messages
* @set_pass_mess()
*/
string *query_pass_mess() { return pass_mess; }
/**
* This method adds or changes the message printed when looking in a
* certain direction. Messages set with modify_exit() have priority.
* If neither are set, the room's description is used.
* @param m a mapping of messages in the form ([<direc>:<mess>])
*/
void add_look_mess(mapping m) { look_mess += m; }
/**
* This method queries the message printed when looking in a certain
* direction.
* @return a mapping of messages in the form ([<direc>:<mess>])
* @see add_look_mess()
*/
mapping query_look_mess() { return look_mess; }
/**
* This method sets the exit type for the iroom exits. The default is "road".
* @param s exit type
* @see query_exit_type()
* @see add_exit()
*/
void set_exit_type(string s) { exit_type = s; }
/**
* This method returns the exit type used for iroom exits.
* @return exit type
* @see set_exit_type()
*/
string query_exit_type() { return exit_type; }
/**
* @ignore
* This method is called by the interroom handler when it clones
* the room. The iroom is room # <milestone_index[1]>, between
* <milestone_index[0]> and <milestone_index[0]+1> (eg, if
* milestone_index == ({3, 6}), the room is iroom 6 between
* milestones 3 and 4).
*/
void set_milestone_index(int *i) { milestone_index = i; }
/**
* @ignore
*/
int *query_milestone_index() { return milestone_index; }
/**
* @ignore
* This method adds an iroom exit in the direction given. The name comes
* from the fact that that's the direction to one of the milestones.
*/
void add_milestone_dir(string s) {
int i;
string ss, em, xm, mm;
i = sizeof(milestone_dirs);
milestone_dirs += ({ s });
if (!(iroom_handler)->query_endpoint(milestone_index[0],
milestone_index[1], i)) {
modify_exit(s, ({ "function", "passing_mess" }) );
}
add_exit(motion_verb + " " + s, "interroom", "hidden");
if (!undefinedp(shorten[s])) {
ss = shorten[s];
add_alias(motion_verb + " " + ss, motion_verb + " " + s);
} else {
ss = s;
}
remove_exit(motion_verb + " <" + short_mse + ">");
if (!short_mse) {
short_mse = ss;
} else {
short_mse += "/" + ss;
}
add_exit(motion_verb + " <" + short_mse + ">", "interroom", exit_type);
em = replace(iroom_enter_mess, ({ "$V", motion_verb, "$T", s, "$F",
opposites[s] }));
xm = replace(iroom_exit_mess, ({ "$V", motion_verb, "$T", s, "$F",
opposites[s] }));
mm = replace(iroom_move_mess, ({ "$V", motion_verb, "$T", s, "$F",
opposites[s] }));
modify_exit(motion_verb + " " + s, ({
"exit mess", xm,
"enter mess", em,
"move mess", mm
}));
} /* add_milestone_dir() */
/**
* @ignore
* This method returns all of the milestone directions.
*/
string *query_milestone_dirs() { return milestone_dirs; }
/**
* @ignore
* This method is called when a player passes through more than one
* iroom in a move.
*/
int passing_mess(string dir, object ob, string special_mess) {
int i;
object *obs, passed;
string mess1, mess2;
i = member_array(dir, milestone_dirs);
if (i < 0) {
return 0;
}
obs = (iroom_handler)->query_irooms_inv(milestone_index[0],
milestone_index[1], i);
if (stringp(pass_mess[0])) {
mess1 = replace(pass_mess[0], ({ "$V", motion_verb, "$T", dir, "$F",
opposites[dir] }));
if (stringp(pass_mess[2]) && sizeof(obs)) {
mess1 += replace(pass_mess[2], "$O", query_multiple_short(obs));
}
mess1 += "\n";
tell_object(ob, mess1);
}
if (stringp(pass_mess[1])) {
mess2 = replace(pass_mess[1], ({ "$V", motion_verb, "$T", dir, "$F",
opposites[dir], "$N", ob->a_short() }));
foreach (passed in obs) {
if (living(passed) && ob->query_visible(passed)) {
tell_object(passed, mess2 + "\n");
}
}
}
return 1;
} /* passing_mess() */
/**
* This method is called when the player quits, to save the current
* room. It uses a little-known alternate form that returns the
* room path and the coordinates.
* @return the iroom path and coordinates
*/
mixed query_quit_handler() {
string s;
s = explode(file_name(ENV(TP)), "#")[0];
return ({ s, query_co_ord() });
} /* query_quit_handler() */
/**
* This method is called at login, to move the player to the room.
* Since these rooms are always clones, the master has the responsibility
* of cloning one when a player logs in, and moving the player to it.
* @param player the player logging in
*/
void enter(object player) {
object new_room;
// I used to use clonep() here, but the "parent" of virtual rooms were
// coming up as clones.
if (sizeof(explode(file_name(TO), "#")) > 1) {
// We somehow called enter() from a clone...
return;
}
new_room = (iroom_handler)->find_room_at_coord(
player->query_saved_co_ords());
if (!objectp(new_room)) {
tell_creator("jeremy", "Couldn't find iroom for %O at %O...\n",
player, player->query_saved_co_ords());
player->move(player->query_start_pos());
return;
}
tell_creator("jeremy", "Moving %O to %O...\n",
player, new_room);
player->move(new_room);
} /* enter() */
/**
* This method masks the standard query_dest_other() function. It handles
* the motion verb for moving between irooms, and also the passing message
* when moving through irooms.
* @param direc room exit name
* @return structure describing the exit
* @see /std/room
*/
// This gives us time to clone the connecting room before the player
// moves into it.
varargs mixed *query_dest_other( string direc ) {
int i;
string verb, rest, *words;
object room;
mixed ret;
//tell_creator("jeremy", "%O:query_dest_other(%s)\n", TO, direc);
if (!stringp(direc)) {
return ::query_dest_other(direc);
}
words = explode(direc, " ");
verb = words[0];
if (verb != motion_verb) {
ret = ::query_dest_other(direc);
if (!stringp(ret[ROOM_DEST]) || (ret[ROOM_DEST] == "/") ||
(ret[ROOM_DEST] == "/terrain") || (ret[ROOM_DEST] == "/topography")) {
room = (topo_handler)->find_room_at_exit(TO, dirs[direc],
direc);
if (!objectp(room)) {
return 0;
}
ret[ROOM_DEST] = file_name(room);
}
return ret;
}
if (sizeof(words) < 2) {
notify_fail(motion_verb + " which way?\n");
return 0;
}
rest = implode(words[1..], " ");
i = member_array(rest, milestone_dirs);
if (i < 0) {
notify_fail("You can't " + motion_verb + " that way.\n");
return 0;
}
room = (iroom_handler)->find_room_at_index(milestone_index[0],
milestone_index[1]+2*i-1);
if (!objectp(room)) {
return 0;
}
ret = ::query_dest_other(direc);
if (!sizeof(ret)) {
return 0;
}
ret[ROOM_DEST] = file_name(room);
return ret;
} /* query_dest_other() */
/**
* This method masks the standard query_look(). If the exit is along
* an iroom path, motion_verb is appended to it. If a "look" message has
* been set with modify_exit(), it is returned. Next, the look_mess
* mapping is checked; if there is an entry for this exit, it is evaluated
* and returned. Finally, the room itself is loaded and the description
* is returned.
* @param direc exit name
* @return the description of the adjoining room
* @see modify_exit()
* @see add_look_mess()
*/
string query_look(string direc) {
int i, dark;
string s, direc_s;
mixed dest;
direc_s = direc;
i = member_array(direc_s, milestone_dirs);
if (i >= 0) {
direc_s = motion_verb + " " + direc_s;
}
if (s = ::query_look(direc_s)) {
return s;
}
if (s = look_mess[direc_s]) {
return evaluate(s);
}
dest = query_dest_other(direc_s);
if (!dest) {
return 0;
}
dest = dest[ROOM_DEST];
if (!dest) {
return 0;
}
if (query_door_open(direc_s) != 0) {
// it mustn't be dark in the destination room.
dest->force_load();
TP->set_looked( find_object( dest ) );
dark = (int)TP->check_dark((int)dest->query_light());
s = (string)dest->long( 0, dark );
if (s[<1] == '\n') {
// The look command automatically adds a '\n'
return s[0..<2];
}
return s;
}
return 0;
} /* query_look() */
/**
* This method adds exits for the iroom if they don't already exist.
* "compass4" and "compass8" can be specified as exit names to add
* exits for all of the normal 4 or 8 compass directions, respectively.
* Actually, the add_exit is deferred to add_topo_exits_int, so that these can
* be added after the milestone exits.
* @param e array of exit names
* @param type type of exit ("path", "road", etc)
*/
void add_topo_exits(string *e, string type) {
other_exits += ({ e });
other_types += ({ type });
} /* query_dest_other() */
/**
* @ignore
* A dummy exit name of "/topography" is used to avoid null strings.
*/
void add_topo_exits_int() {
int i;
string s;
for (i = 0; i < sizeof(other_exits); i++) {
foreach (s in other_exits[i]) {
if ((s == "compass4") || (s == "compass8")) {
if (!query_exit("north")) add_exit("north", "/topography",
other_types[i]);
if (!query_exit("south")) add_exit("south", "/topography",
other_types[i]);
if (!query_exit("east")) add_exit("east", "/topography",
other_types[i]);
if (!query_exit("west")) add_exit("west", "/topography",
other_types[i]);
if (s == "compass8") {
if (!query_exit("northeast")) add_exit("northeast", "/topography",
other_types[i]);
if (!query_exit("northwest")) add_exit("northwest", "/topography",
other_types[i]);
if (!query_exit("southeast")) add_exit("southeast", "/topography",
other_types[i]);
if (!query_exit("southwest")) add_exit("southwest", "/topography",
other_types[i]);
}
} else {
add_exit(s, "/topography", other_types[i]);
}
}
}
} /* add_topo_exits_int() */
