evennia.commands.default.general

General Character commands usually available to all characters

class evennia.commands.default.general.CmdHome(**kwargs)[source]

Bases: evennia.commands.default.muxcommand.MuxCommand

move to your character’s home location

Usage:

home

Teleports you to your home location.

key = 'home'
locks = 'cmd:perm(home) or perm(Builder)'
arg_regex = re.compile('$', re.IGNORECASE)
func()[source]

Implement the command

aliases = []
help_category = 'general'
lock_storage = 'cmd:perm(home) or perm(Builder)'
class evennia.commands.default.general.CmdLook(**kwargs)[source]

Bases: evennia.commands.default.muxcommand.MuxCommand

look at location or object

Usage:

look look <obj> look *<account>

Observes your location or objects in your vicinity.

key = 'look'
aliases = ['ls', 'l']
locks = 'cmd:all()'
arg_regex = re.compile('\\s|$', re.IGNORECASE)
func()[source]

Handle the looking.

help_category = 'general'
lock_storage = 'cmd:all()'
class evennia.commands.default.general.CmdNick(**kwargs)[source]

Bases: evennia.commands.default.muxcommand.MuxCommand

define a personal alias/nick by defining a string to match and replace it with another on the fly

Usage:

nick[/switches] <string> [= [replacement_string]] nick[/switches] <template> = <replacement_template> nick/delete <string> or number nicks

Switches:

inputline - replace on the inputline (default) object - replace on object-lookup account - replace on account-lookup list - show all defined aliases (also “nicks” works) delete - remove nick by index in /list clearall - clear all nicks

Examples

nick hi = say Hello, I’m Sarah! nick/object tom = the tall man nick build $1 $2 = create/drop $1;$2 nick tell $1 $2=page $1=$2 nick tm?$1=page tallman=$1 nick tm=$1=page tallman=$1

A ‘nick’ is a personal string replacement. Use $1, $2, … to catch arguments. Put the last $-marker without an ending space to catch all remaining text. You can also use unix-glob matching for the left-hand side <string>:

    • matches everything

? - matches 0 or 1 single characters [abcd] - matches these chars in any order [!abcd] - matches everything not among these chars = - escape literal ‘=’ you want in your <string>

Note that no objects are actually renamed or changed by this command - your nicks are only available to you. If you want to permanently add keywords to an object for everyone to use, you need build privileges and the alias command.

key = 'nick'
switch_options = ('inputline', 'object', 'account', 'list', 'delete', 'clearall')
aliases = ['nicks', 'nickname']
locks = 'cmd:all()'
parse()[source]

Support escaping of = with =

func()[source]

Create the nickname

help_category = 'general'
lock_storage = 'cmd:all()'
class evennia.commands.default.general.CmdInventory(**kwargs)[source]

Bases: evennia.commands.default.muxcommand.MuxCommand

view inventory

Usage:

inventory inv

Shows your inventory.

key = 'inventory'
aliases = ['i', 'inv']
locks = 'cmd:all()'
arg_regex = re.compile('$', re.IGNORECASE)
func()[source]

check inventory

help_category = 'general'
lock_storage = 'cmd:all()'
class evennia.commands.default.general.CmdSetDesc(**kwargs)[source]

Bases: evennia.commands.default.muxcommand.MuxCommand

describe yourself

Usage:

setdesc <description>

Add a description to yourself. This will be visible to people when they look at you.

key = 'setdesc'
locks = 'cmd:all()'
arg_regex = re.compile('\\s|$', re.IGNORECASE)
func()[source]

add the description

aliases = []
help_category = 'general'
lock_storage = 'cmd:all()'
class evennia.commands.default.general.CmdGet(**kwargs)[source]

Bases: evennia.commands.default.muxcommand.MuxCommand

pick up something

Usage:

get <obj>

Picks up an object from your location and puts it in your inventory.

key = 'get'
aliases = ['grab']
locks = 'cmd:all()'
arg_regex = re.compile('\\s|$', re.IGNORECASE)
func()[source]

implements the command.

help_category = 'general'
lock_storage = 'cmd:all()'
class evennia.commands.default.general.CmdDrop(**kwargs)[source]

Bases: evennia.commands.default.muxcommand.MuxCommand

drop something

Usage:

drop <obj>

Lets you drop an object from your inventory into the location you are currently in.

key = 'drop'
locks = 'cmd:all()'
arg_regex = re.compile('\\s|$', re.IGNORECASE)
func()[source]

Implement command

aliases = []
help_category = 'general'
lock_storage = 'cmd:all()'
class evennia.commands.default.general.CmdGive(**kwargs)[source]

Bases: evennia.commands.default.muxcommand.MuxCommand

give away something to someone

Usage:

give <inventory obj> <to||=> <target>

Gives an items from your inventory to another character, placing it in their inventory.

key = 'give'
rhs_split = ('=', ' to ')
locks = 'cmd:all()'
arg_regex = re.compile('\\s|$', re.IGNORECASE)
func()[source]

Implement give

aliases = []
help_category = 'general'
lock_storage = 'cmd:all()'
class evennia.commands.default.general.CmdSay(**kwargs)[source]

Bases: evennia.commands.default.muxcommand.MuxCommand

speak as your character

Usage:

say <message>

Talk to those in your current location.

key = 'say'
aliases = ['"', "'"]
locks = 'cmd:all()'
func()[source]

Run the say command

help_category = 'general'
lock_storage = 'cmd:all()'
class evennia.commands.default.general.CmdWhisper(**kwargs)[source]

Bases: evennia.commands.default.muxcommand.MuxCommand

Speak privately as your character to another

Usage:

whisper <character> = <message> whisper <char1>, <char2> = <message>

Talk privately to one or more characters in your current location, without others in the room being informed.

key = 'whisper'
locks = 'cmd:all()'
func()[source]

Run the whisper command

aliases = []
help_category = 'general'
lock_storage = 'cmd:all()'
class evennia.commands.default.general.CmdPose(**kwargs)[source]

Bases: evennia.commands.default.muxcommand.MuxCommand

strike a pose

Usage:

pose <pose text> pose’s <pose text>

Example

pose is standing by the wall, smiling.

-> others will see:

Tom is standing by the wall, smiling.

Describe an action being taken. The pose text will automatically begin with your name.

key = 'pose'
aliases = ['emote', ':']
locks = 'cmd:all()'
parse()[source]

Custom parse the cases where the emote starts with some special letter, such as ‘s, at which we don’t want to separate the caller’s name and the emote with a space.

func()[source]

Hook function

help_category = 'general'
lock_storage = 'cmd:all()'
class evennia.commands.default.general.CmdAccess(**kwargs)[source]

Bases: evennia.commands.default.muxcommand.MuxCommand

show your current game access

Usage:

access

This command shows you the permission hierarchy and which permission groups you are a member of.

key = 'access'
aliases = ['hierarchy', 'groups']
locks = 'cmd:all()'
arg_regex = re.compile('$', re.IGNORECASE)
func()[source]

Load the permission groups

help_category = 'general'
lock_storage = 'cmd:all()'