evennia.server.profiling.dummyrunner_settings

Settings and actions for the dummyrunner

This module defines dummyrunner settings and sets up the actions available to dummy accounts.

The settings are global variables:

  • TIMESTEP - time in seconds between each ‘tick’

  • CHANCE_OF_ACTION - chance 0-1 of action happening

  • CHANCE_OF_LOGIN - chance 0-1 of login happening

  • TELNET_PORT - port to use, defaults to settings.TELNET_PORT

  • ACTIONS - see below

ACTIONS is a tuple

(login_func, logout_func, (0.3, func1), (0.1, func2) ... )

where the first entry is the function to call on first connect, with a chance of occurring given by CHANCE_OF_LOGIN. This function is usually responsible for logging in the account. The second entry is always called when the dummyrunner disconnects from the server and should thus issue a logout command. The other entries are tuples (chance, func). They are picked randomly, their commonality based on the cumulative chance given (the chance is normalized between all options so if will still work also if the given chances don’t add up to 1). Since each function can return a list of game-command strings, each function may result in multiple operations.

An action-function is called with a “client” argument which is a reference to the dummy client currently performing the action. It returns a string or a list of command strings to execute. Use the client object for optionally saving data between actions.

The client object has the following relevant properties and methods:

  • key - an optional client key. This is only used for dummyrunner output. Default is “Dummy-<cid>”

  • cid - client id

  • gid - globally unique id, hashed with time stamp

  • istep - the current step

  • exits - an empty list. Can be used to store exit names

  • objs - an empty list. Can be used to store object names

  • counter() - returns a unique increasing id, hashed with time stamp to make it unique also between dummyrunner instances.

The return should either be a single command string or a tuple of command strings. This list of commands will always be executed every TIMESTEP with a chance given by CHANCE_OF_ACTION by in the order given (no randomness) and allows for setting up a more complex chain of commands (such as creating an account and logging in).


evennia.server.profiling.dummyrunner_settings.c_login(client)[source]

logins to the game

evennia.server.profiling.dummyrunner_settings.c_login_nodig(client)[source]

logins, don’t dig its own room

evennia.server.profiling.dummyrunner_settings.c_logout(client)[source]

logouts of the game

evennia.server.profiling.dummyrunner_settings.c_looks(client)[source]

looks at various objects

evennia.server.profiling.dummyrunner_settings.c_examines(client)[source]

examines various objects

evennia.server.profiling.dummyrunner_settings.c_idles(client)[source]

idles

evennia.server.profiling.dummyrunner_settings.c_help(client)[source]

reads help files

evennia.server.profiling.dummyrunner_settings.c_digs(client)[source]

digs a new room, storing exit names on client

evennia.server.profiling.dummyrunner_settings.c_creates_obj(client)[source]

creates normal objects, storing their name on client

evennia.server.profiling.dummyrunner_settings.c_creates_button(client)[source]

creates example button, storing name on client

evennia.server.profiling.dummyrunner_settings.c_socialize(client)[source]

socializechats on channel

evennia.server.profiling.dummyrunner_settings.c_moves(client)[source]

moves to a previously created room, using the stored exits

evennia.server.profiling.dummyrunner_settings.c_moves_n(client)[source]

move through north exit if available

evennia.server.profiling.dummyrunner_settings.c_moves_s(client)[source]

move through south exit if available