# 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 Ken Keys