Provided by: cyphesis-cpp-clients_0.6.2-2ubuntu1_amd64 
NAME
cycmd - cycmd game server process
SYNOPSIS
cycmd [ --section:option=value ... ] [ command [ server ] ]
DESCRIPTION
The cycmd program provides a commandline interface to a cyphesis server.
OPTIONS
Configuration options are divided up into named sections, which need to be specified when modifying or
overriding the options. In a config file the name of a section is specified in square brackets at the
beginning of the section. On the command line the section is given at the beginning of the option
specification, as shown in the synopsis above.
CLIENT OPTIONS
The following options used by cycmd are present in the client section of the config file, and overridden
by specifying the client section name on the command line.
serverhost=hostname
Hostname of the server to connect to.
This setting provides the hostname of the system where cyphesis is running that cycmd should try
and connect to.
SERVER OPTIONS
The following options are present in the cyphesis section of the config file, and overridden by
specifying the cyphesis section name on the command line. These options apply to the server, but are also
required by the client to ensure that the client can connect.
tcpport=6767
Network port for server TCP connections.
Specifies the port number to use when connecting to the server.
unixport="cyphesis.sock"
Local liston socket for Unix domain connections.
Specifies the filename to use to listen for local trusted client connections.
COMMANDS
add_agent [ type ]
Create an in-game agent.
Create an avatar or agent in the game to be used to manipulate the world. By default an avatar of
type "creator" is created, and this is required for most operations. Avatars of other types can be
created, but have limited ability to edit the world.
cancel
Cancel the current admin task.
Various commands begin a background admin task in the client. This command stops any currently
running task.
connect hostname
Connect the server to a peer.
Try and establish a connection to a peer server.
creator_create type
Use agent to create an entity.
Use the in-game agent owned by this client to create an in-game entity of any type.
delete id
Delete an entity from the server.
Delete the in-game entity with the given ID from the world.
dump [ filename ]
Write the contents of the world to an Atlas dump file.
An Atlas representation of every entity on the server is written to a file using the XML codec.
get id
Examine any object on the server.
Get an object description from the server, and display its contents.
find_by_name name
Find an entity with the given name.
Search the world for an entity with the given name, and return the first one found.
find_by_type type
Find an entity with the given type.
Search the world for an entity with the given type, and return the first one found.
flush type
Flush entities from the server
Search the world for entities with the given type, and delete them all.
This process does not work perfectly reliably, so may have to be run multiple times to fully clear
the server.
help Display online help.
Lists all the commands available, with a short description of what each one does.
install type_id parent_id
Install a new type in the server.
look Return a view of the current server lobby.
Look at the current server lobby, where all users currently logged in are represented. The view is
returned and displayed.
logout [ account ]
Log user out of server.
monitor
Enable server monitoring.
Direct the server to report all in-game operations to the client. A digest of each operation is
displayed, including the type, which entity the operation is from and which entity the operation
is to.
query entity_id
Synonym for "get" (deprecated).
reload type
Reload the script for a type.
Reload the Python script for a given type from the file on disk.
restore [ filename ]
Restore the contents of an Atlas dump file into the world.
Read entities from an Atlas XML codec dump file, and restore them into the server. The most
reliable use case for this is with an empty server to restore a snapshot of the world taken at an
earlier time.
It is possible to restore a dump file into server which already contains a world, but the
following caveats apply:
If there are collisions between the ID space being used in the existing world, and the ID space
used in the dump file, the tool will do its best to do the right thing, but the results are to
some extent undefined. If an entity with the same ID and type exists in both spaces, only one will
exist after the restore and it will have some of the properties of both copies of that entity.
stat Examine the current server status.
Get a description of the current server status, and display its contents.
unmonitor
Disable server monitoring.
Direct the server to stop reporting all in-game operations to the client.
EXAMPLES
The first example shows getting the current server status and checking the lobby to see if any users are
logged in.
cyphesis> stat
Info(
clients: 1
name: calcitration.ecs.soton.ac.uk
objtype: obj
parents: [ server ]
ruleset: mason
server: cyphesis
uptime: 1728.2
version: 0.3.2
)
cyphesis> look
Sight(
id: lobby
name: lobby
objtype: obj
parents: [ room ]
people: [ 1 ]
rooms: [ ]
)
cyphesis>
The first entity returned shows various information about the server, including when it was built, the
number of connected client, the current ruleset, and the server uptime. The second entity representing
the lobby shows that only one user is current logged in, and no chat rooms have been created.
The second example shows how to install a new type.
cyphesis> get thing
Info(
children: [ feature character plant food stackable structure arm arrow axe barrel block_house board boat boundary bow campfire cleaver coin fire gallows house lumber pelvis ribcage shin skull stall sword thigh tower twobyfour wall weather ]
contains: [ ]
id: thing
loc:
name:
objtype: class
parents: [ game_entity ]
pos: [ 0 0 0 ]
stamp_contains: 0
velocity: [ 0 0 0 ]
)
cyphesis> install box thing
cyphesis>
The third example shows server monitoring being enable, followed by information of a series of in-game
operations. The flow of messages in while monitoring the server can be large. In order to suppress the
flow, the unmonitor command must be used.
cyphesis> monitor
cyphesis>
tick(from="900006",to="900006")
tick(from="900007",to="900007")
cyphesis>
tick(from="900008",to="900008")
cyphesis>
tick(from="899982",to="899982")
cyphesis>
tick(from="899356",to="899356")
cyphesis>
tick(from="899357",to="899357")
cyphesis>
tick(from="899358",to="899358")
cyphesis>
tick(from="899359",to="899359")
cyphesis>
tick(from="899360",to="899360")
cyphesis>
tick(from="899361",to="899361")
cyphesis>
AUTHOR
Written by Alistair Riddoch.
REPORTING BUGS
Report bugs to <general@worldforge.org>.
COPYRIGHT
Copyright 2004 Alistair Riddoch.
SEE ALSO
cyphesis(1), cyclient(1), cyphesis-tools(1) 18 November 2010 CYCMD(1)