default data storage…

.mudpy.data.*
(string, multiple) Everything in the key following “.mudpy.data” identifies a unique branch of the universe. The value designates where to save newly created nodes for long-term storage. The string begins with a method specification (for now, only “file” is implemented), followed by a colon (:) and then the storage location (file path/name). For the file method on Unix dericative platforms, an optional “(p)” can precede the : to indicate it should be private (readable only by the system user under which the mudpy process is running). Example: .mudpy.data.mudpy.account = “file(p):/var/lib/mudpy/account”

(non-programming) language features…

.mudpy.lang.actions
(dict, optional) This is used to tailor the appearance of output generated by the say command and its relatives, so as to add some readability and flavor. It matches a visible action to punctuation (ask, exclaim, et cetera). Example: { “?”: “ask”, “!”: “exclaim”, “.”: “say” }


.mudpy.lang.default_punctuation
(string, optional) Unpunctuated statements made by actors should be assumed to terminate with this value. Example: “.”


.mudpy.lang.typos
(dict, optional) Replacements for common typographical and capitalization errors. Example: { “i”: “I”, “i’d”: “I’d”, “i’ll”: “I’ll”, “i’m”: “I’m”, “teh”: “the” }

various configured limits…

.mudpy.lim.admin
(string, optional) The first user to create an account named the same as this string will automatically be given full administrative privileges. Example: “admin”


.mudpy.lim.avatars
(int, required) This is the maximum number of avatars allowed for each account. Example: 7


.mudpy.lim.backups
(int, optional) This is the number of backups to keep and rotate when overwriting data files. If unspecified or set to 0, no backup copies will be made. Example: 10


.mudpy.lim.password_tries
(int, required) This is the maximum number of password failures allowed during the login process. Once exceeded, the user will be disconnected. Example: 3

settings for logging…

.mudpy.log.file
(string, optional) If set, log messages will be recorded to this file. Example: “/var/log/mudpy.log”


.mudpy.log.lines
(int, optional) Number of log entries to keep in memory (the oldest are discarded)… If unset or 0, none will be written to mudpy’s internal memory. Example: 1000


.mudpy.log.stdout
(bool, optional) If set to True, messages will be logged to the standard output of the mudpy process. If unspecified, the default is False.


.mudpy.log.syslog
(string, optional) If set, mudpy will send messages to the system log, and under the name specified by this value (Unix derivatives only). Example: “mudpy”

movement definitions…

.mudpy.move.*.enter_term
(string, multiple) Word or words describing the direction from where you are seen to enter the next room when moving. Example: move.east.enter_term = “the west”


.mudpy.move.*.exit_term
(string, multiple) Word or words describing the direction where you are seen to exit the current room when moving. Example: move.east.exit_term = “to the east”


.mudpy.move.*.vector
(tuple, multiple) Vector of signed integer units for use in vector addition to derive the destination coordinates from the current coordinates when moving through a gridlink exit. The example coordinate system used is left handed (east, north and up are positive, west, south and down are negative) and three-dimensional with a tuple component order of (longitude, latitude, altitude). Example: move.east.vector = ( 1, 0, 0 )

network socket configuration…

.mudpy.net.host
(string, optional) The IP address on which to listen. If unspecified, the default is all available addresses. Example: “127.0.0.1”


.mudpy.net.port
(int, required) The TCP port on which to listen. Example: 4000

process settings…

.mudpy.proc.daemon
(bool, optional) If set to True, mudpy will immediately fork and detach a child to become a daemon process, then close all open file descriptors and terminate the parent process (Unix derivatives only). The default value is False.


.mudpy.proc.pidfile
(string, optional) If set, this filename will contain the daemon’s process ID (Unix derivatives only). Example: “/var/run/mudpy.pid”

main loop timing parameters…

.mudpy.time.idle.disconnect.*
(int, multiple) This value indicates the number of increments allowed to pass without input on a socket connection before it is terminated. This avoids accumulation of dead sockets which could otherwise max out the process’ allowed file descriptors. The differentiators are either default or a state name used to override the default value for that specific state (active, entering_account_name, et cetera). Example: 6000


.mudpy.time.idle.warn.*
(int, multiple) This value indicates the number of increments allowed to pass without input on a socket connection before it is warned that termination is imminent. The differentiators are either default or a state name used to override the default value for that specific state. It is recommended that this be less than the corresponding .mudpy.time.idle.warn.* value. Example: 5000


.mudpy.time.increment
(float, required) This value indicates the number of seconds (or more commonly, fraction thereof) each pass through the main loop is intended to take. This roughly sets the frequency with which queued socket I/O operations are performed, pending events are triggered, and directly impacts the speed at which time passes in the simulation. Example: 0.1


.mudpy.time.log
(int, optional) Number of increments to wait between logging mudpy status messages. If unspecified or set to 0, no mudpy status messages will be written. Example: 6000


.mudpy.time.save
(int, required) Number of increments between updates of changed persistent data storage. Example: 600

Leave a Reply

You must be logged in to post a comment.