evennia/game/gamesrc/conf/examples/oobfuncs.py

37 lines
1.4 KiB
Python
Raw Normal View History

"""
2013-11-28 16:26:04 +01:00
OOB configuration.
2013-11-28 16:26:04 +01:00
This module should be included in (or replace) the
default module set in settings.OOB_PLUGIN_MODULES
2013-11-28 16:26:04 +01:00
All functions defined in this module are made available
to be called by the OOB handler.
2012-03-30 23:57:04 +02:00
2013-11-28 16:26:04 +01:00
See src/server/oob_msdp.py for more information.
2013-11-28 16:26:04 +01:00
function execution - the oob protocol can execute a function directly on
the server. The available functions must be defined
as global functions via settings.OOB_PLUGIN_MODULES.
repeat func execution - the oob protocol can request a given function be
executed repeatedly at a regular interval. This
uses an internal script pool.
tracking - the oob protocol can request Evennia to track changes to
fields on objects, as well as changes in Attributes. This is
done by dynamically adding tracker-objects on entities. The
behaviour of those objects can be customized via
settings.OOB_PLUGIN_MODULES.
2013-11-28 16:26:04 +01:00
oob functions have the following call signature:
function(caller, session, *args, **kwargs)
2013-11-28 16:26:04 +01:00
oob trackers should inherit from the OOBTracker class in src/server.oob_msdp.py
and implement a minimum of the same functionality.
2013-11-28 16:26:04 +01:00
a global function oob_error will be used as optional error management.
2013-11-28 16:26:04 +01:00
"""
2013-11-28 16:26:04 +01:00
# import the contents of the default msdp module
from src.server/oob_msdp import *