worlds

Associated commands:

/addworld
define a new world
/world
connect to a defined world
/dc
disconnect from a world
/unworld
undefine a world
/purgeworld
undefine a group of worlds
/saveworld
save world definitions to a file
/loadworld
load world definitions from a file
/listworlds
display world definitions
/edworld
edit a world definition
world_info()
get world information

Fugue stores a list of "worlds" that it knows about. Each world has several fields associated with it:

name
a label used to refer to the world
type
an optional string for matching /def -T
character
optional login name
password
optional login password
host
server's internet host name, IPv4 address, or (if your platform supports it) IPv6 address
port
server's TCP port number or name
mfile
optional macro file
login
"1" if automatic login is enabled for the world's socket, "0" otherwise.
proxy
"1" if this world's socket is using a proxy, "0" otherwise
src
optional name or address used for client (tf) end of connection.
cipher
current cipher used by SSL connection to world.

The character name, password, and type are used by automatic login, if the %{login} flag is on.

The macro file is loaded when a socket is opened to the world. It can contain any commands you want executed automatically when you connect to that world. If the flag %{sockmload} is on, this file will also be loaded whenever you switch to a world with the SOCKETB and SOCKETF keys (see sockets, /dokey, hooks (CONNECT)).

World information can be accessed with the macro expansion ${world_fieldname} or the function world_info(worldname, fieldname), where fieldname is one of the fields described above.

For example:
/eval say I am ${world_character} on ${world_name}.
This would tell the rest of the world some stuff they probably don't care about, namely the label your Fugue has assigned to the current world and the character name under which it logged on.

Fugue also keeps track of a world named "default", which is just a dummy world with a character name and password, and optionally a macro file. If a default world is defined, worlds without character, password, or file fields will use the values from the default world.

See also: sockets


Back to index
Back to tf home page
Copyright © 1995, 1996, 1997, 1998, 1999, 2002, 2003, 2004, 2005, 2006-2007 Ken Keys