<spanid="evennia-contrib-rpg-rpsystem-rpsystem"></span><h1>evennia.contrib.rpg.rpsystem.rpsystem<aclass="headerlink"href="#module-evennia.contrib.rpg.rpsystem.rpsystem"title="Permalink to this headline">¶</a></h1>
<p>Roleplaying base system for Evennia</p>
<p>Contribution - Griatch, 2015</p>
<p>This module contains the ContribRPObject, ContribRPRoom and
ContribRPCharacter typeclasses. If you inherit your
objects/rooms/character from these (or make them the defaults) from
these you will get the following features:</p>
<ulclass="simple">
<li><p>Objects/Rooms will get the ability to have poses and will report
the poses of items inside them (the latter most useful for Rooms).</p></li>
<li><p>Characters will get poses and also sdescs (short descriptions)</p></li>
</ul>
<p>that will be used instead of their keys. They will gain commands
for managing recognition (custom sdesc-replacement), masking
themselves as well as an advanced free-form emote command.</p>
<p>In more detail, This RP base system introduces the following features
to a game, common to many RP-centric games:</p>
<ulclass="simple">
<li><dlclass="simple">
<dt>emote system using director stance emoting (names/sdescs).</dt><dd><p>This uses a customizable replacement noun (/me, @ etc) to
represent you in the emote. You can use /sdesc, /nick, /key or
/alias to reference objects in the room. You can use any
number of sdesc sub-parts to differentiate a local sdesc, or
use /1-sdesc etc to differentiate them. The emote also
identifies nested says and separates case.</p>
</dd>
</dl>
</li>
<li><dlclass="simple">
<dt>sdesc obscuration of real character names for use in emotes</dt><dd><p>and in any referencing such as object.search(). This relies
on an SdescHandler <strong>sdesc</strong> being set on the Character and
makes use of a custom Character.get_display_name hook. If
sdesc is not set, the character’s <strong>key</strong> is used instead. This
is particularly used in the emoting system.</p>
</dd>
</dl>
</li>
<li><dlclass="simple">
<dt>recog system to assign your own nicknames to characters, can then</dt><dd><p>be used for referencing. The user may recog a user and assign
any personal nick to them. This will be shown in descriptions
and used to reference them. This is making use of the nick
functionality of Evennia.</p>
</dd>
</dl>
</li>
<li><p>masks to hide your identity (using a simple lock).</p></li>
<li><dlclass="simple">
<dt>pose system to set room-persistent poses, visible in room</dt><dd><p>descriptions and when looking at the person/object. This is a
simple Attribute that modifies how the characters is viewed when
in a room as sdesc + pose.</p>
</dd>
</dl>
</li>
<li><dlclass="simple">
<dt>in-emote says, including seamless integration with language</dt><dd><p>obscuration routine (such as contrib/rpg/rplanguage.py)</p>
</dd>
</dl>
</li>
</ul>
<p>Installation:</p>
<p>Add <strong>RPSystemCmdSet</strong> from this module to your CharacterCmdSet:</p>
<dt>If you have any overriden calls in <strong>at_object_creation(self)</strong>:</dt><dd><p>Add <strong>super().at_object_creation()</strong> as the top line.</p>
</dd>
</dl>
</li>
<li><dlclass="simple">
<dt>In <strong>typeclasses/rooms.py</strong>:</dt><dd><p>Import the <strong>ContribRPRoom</strong> class:
<li><p>Reload the server (<strong>reload</strong> or from console: “evennia reload”)</p></li>
<li><dlclass="simple">
<dt>Force typeclass updates as required. Example for your character:</dt><dd><p><strong>type/reset/force me = typeclasses.characters.Character</strong></p>
<emclass="property">exception </em><codeclass="sig-prename descclassname">evennia.contrib.rpg.rpsystem.rpsystem.</code><codeclass="sig-name descname">EmoteError</code><aclass="reference internal"href="../_modules/evennia/contrib/rpg/rpsystem/rpsystem.html#EmoteError"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.EmoteError"title="Permalink to this definition">¶</a></dt>
<emclass="property">exception </em><codeclass="sig-prename descclassname">evennia.contrib.rpg.rpsystem.rpsystem.</code><codeclass="sig-name descname">SdescError</code><aclass="reference internal"href="../_modules/evennia/contrib/rpg/rpsystem/rpsystem.html#SdescError"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.SdescError"title="Permalink to this definition">¶</a></dt>
<emclass="property">exception </em><codeclass="sig-prename descclassname">evennia.contrib.rpg.rpsystem.rpsystem.</code><codeclass="sig-name descname">RecogError</code><aclass="reference internal"href="../_modules/evennia/contrib/rpg/rpsystem/rpsystem.html#RecogError"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.RecogError"title="Permalink to this definition">¶</a></dt>
<emclass="property">exception </em><codeclass="sig-prename descclassname">evennia.contrib.rpg.rpsystem.rpsystem.</code><codeclass="sig-name descname">LanguageError</code><aclass="reference internal"href="../_modules/evennia/contrib/rpg/rpsystem/rpsystem.html#LanguageError"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.LanguageError"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-prename descclassname">evennia.contrib.rpg.rpsystem.rpsystem.</code><codeclass="sig-name descname">parse_language</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">speaker</span></em>, <emclass="sig-param"><spanclass="n">emote</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/contrib/rpg/rpsystem/rpsystem.html#parse_language"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.parse_language"title="Permalink to this definition">¶</a></dt>
<dd><p>Parse the emote for language. This is
used with a plugin for handling languages.</p>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><ulclass="simple">
<li><p><strong>speaker</strong> (<em>Object</em>) – The object speaking.</p></li>
<li><p><strong>emote</strong> (<em>str</em>) – An emote possibly containing
<codeclass="sig-prename descclassname">evennia.contrib.rpg.rpsystem.rpsystem.</code><codeclass="sig-name descname">parse_sdescs_and_recogs</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">sender</span></em>, <emclass="sig-param"><spanclass="n">candidates</span></em>, <emclass="sig-param"><spanclass="n">string</span></em>, <emclass="sig-param"><spanclass="n">search_mode</span><spanclass="o">=</span><spanclass="default_value">False</span></em>, <emclass="sig-param"><spanclass="n">case_sensitive</span><spanclass="o">=</span><spanclass="default_value">True</span></em>, <emclass="sig-param"><spanclass="n">fallback</span><spanclass="o">=</span><spanclass="default_value">None</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/contrib/rpg/rpsystem/rpsystem.html#parse_sdescs_and_recogs"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.parse_sdescs_and_recogs"title="Permalink to this definition">¶</a></dt>
<dd><p>Read a raw emote and parse it into an intermediary
format for distributing to all observers.</p>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><ulclass="simple">
<li><p><strong>sender</strong> (<em>Object</em>) – The object sending the emote. This object’s
recog data will be considered in the parsing.</p></li>
<li><p><strong>candidates</strong> (<em>iterable</em>) – A list of objects valid for referencing
in the emote.</p></li>
</ul>
</dd>
</dl>
<p>string (str): The string (like an emote) we want to analyze for keywords.
search_mode (bool, optional): If <strong>True</strong>, the “emote” is a query string</p>
<blockquote>
<div><p>we want to analyze. If so, the return value is changed.</p>
</div></blockquote>
<dlclass="simple">
<dt>case_sensitive (bool, optional): If set, the case of /refs matter, so that</dt><dd><p>/tall will come out as ‘tall man’ while /Tall will become ‘Tall man’.
This allows for more grammatically correct emotes at the cost of being
a little more to learn for players. If disabled, the original sdesc case
is always kept and are inserted as-is.</p>
</dd>
<dt>fallback (string, optional): If set, any references that don’t match a target</dt><dd><p>will be replaced with the fallback string. If <strong>None</strong> (default), the
parsing will fail and give a warning about the missing reference.</p>
<dt>If <strong>search_mode</strong> is <strong>False</strong></dt><dd><p>(default), a tuple where the emote is the emote string, with
all references replaced with internal-representation {#dbref}
markers and mapping is a dictionary <strong>{“#dbref”:obj, …}</strong>.</p>
</dd>
<dt>result (list): If <strong>search_mode</strong> is <strong>True</strong> we are</dt><dd><p>performing a search query on <strong>string</strong>, looking for a specific
object. A list with zero, one or more matches.</p>
</dd>
</dl>
</p>
</dd>
<dtclass="field-even">Raises</dt>
<ddclass="field-even"><p><strong>EmoteException</strong>– For various ref-matching errors.</p>
</dd>
</dl>
<pclass="rubric">Notes</p>
<p>The parser analyzes and should understand the following
_PREFIX-tagged structures in the emote:
- self-reference (/me)
- recogs (any part of it) stored on emoter, matching obj in <strong>candidates</strong>.
- sdesc (any part of it) from any obj in <strong>candidates</strong>.
<codeclass="sig-prename descclassname">evennia.contrib.rpg.rpsystem.rpsystem.</code><codeclass="sig-name descname">send_emote</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">sender</span></em>, <emclass="sig-param"><spanclass="n">receivers</span></em>, <emclass="sig-param"><spanclass="n">emote</span></em>, <emclass="sig-param"><spanclass="n">msg_type</span><spanclass="o">=</span><spanclass="default_value">'pose'</span></em>, <emclass="sig-param"><spanclass="n">anonymous_add</span><spanclass="o">=</span><spanclass="default_value">'first'</span></em>, <emclass="sig-param"><spanclass="o">**</span><spanclass="n">kwargs</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/contrib/rpg/rpsystem/rpsystem.html#send_emote"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.send_emote"title="Permalink to this definition">¶</a></dt>
<dd><p>Main access function for distribute an emote.</p>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><ulclass="simple">
<li><p><strong>sender</strong> (<em>Object</em>) – The one sending the emote.</p></li>
<li><p><strong>receivers</strong> (<em>iterable</em>) – Receivers of the emote. These
will also form the basis for which sdescs are
‘valid’ to use in the emote.</p></li>
<li><p><strong>emote</strong> (<em>str</em>) – The raw emote string as input by emoter.</p></li>
<li><p><strong>msg_type</strong> (<em>str</em>) – The type of emote this is. “say” or “pose”
for example. This is arbitrary and used for generating
extra data for .msg(text) tuple.</p></li>
<li><p><strong>anonymous_add</strong> (<em>str</em><em> or </em><em>None</em><em>, </em><em>optional</em>) – If <strong>sender</strong> is not
self-referencing in the emote, this will auto-add
<strong>sender</strong>’s data to the emote. Possible values are
- None: No auto-add at anonymous emote
- ‘last’: Add sender to the end of emote as [sender]
- ‘first’: Prepend sender to start of emote.</p></li>
</ul>
</dd>
</dl>
<dlclass="simple">
<dt>Kwargs:</dt><dd><dlclass="simple">
<dt>case_sensitive (bool): Defaults to True, but can be unset</dt><dd><p>here. When enabled, /tall will lead to a lowercase
‘tall man’ while /Tall will lead to ‘Tall man’ and
/TALL will lead to ‘TALL MAN’. If disabled, the sdesc’s
case will always be used, regardless of the /ref case used.</p>
</dd>
<dt>any: Other kwargs will be passed on into the receiver’s process_sdesc and</dt><dd><p>process_recog methods, and can thus be used to customize those.</p>
<emclass="property">class </em><codeclass="sig-prename descclassname">evennia.contrib.rpg.rpsystem.rpsystem.</code><codeclass="sig-name descname">SdescHandler</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">obj</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/contrib/rpg/rpsystem/rpsystem.html#SdescHandler"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.SdescHandler"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">__init__</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">obj</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/contrib/rpg/rpsystem/rpsystem.html#SdescHandler.__init__"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.SdescHandler.__init__"title="Permalink to this definition">¶</a></dt>
<dd><p>Initialize the handler</p>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><p><strong>obj</strong> (<em>Object</em>) – The entity on which this handler is stored.</p>
<codeclass="sig-name descname">add</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">sdesc</span></em>, <emclass="sig-param"><spanclass="n">max_length</span><spanclass="o">=</span><spanclass="default_value">60</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/contrib/rpg/rpsystem/rpsystem.html#SdescHandler.add"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.SdescHandler.add"title="Permalink to this definition">¶</a></dt>
<dd><p>Add a new sdesc to object, replacing the old one.</p>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><ulclass="simple">
<li><p><strong>sdesc</strong> (<em>str</em>) – The sdesc to set. This may be stripped
of control sequences before setting.</p></li>
<li><p><strong>max_length</strong> (<em>int</em><em>, </em><em>optional</em>) – The max limit of the sdesc.</p></li>
</ul>
</dd>
<dtclass="field-even">Returns</dt>
<ddclass="field-even"><p><em>sdesc (str)</em>– The actually set sdesc.</p>
</dd>
<dtclass="field-odd">Raises</dt>
<ddclass="field-odd"><ulclass="simple">
<li><p><aclass="reference internal"href="#evennia.contrib.rpg.rpsystem.rpsystem.SdescError"title="evennia.contrib.rpg.rpsystem.rpsystem.SdescError"><strong>SdescError</strong></a>– If the sdesc is empty, can not be set or is</p></li>
<li><p><strong>longer than max_length.</strong>–</p></li>
<codeclass="sig-name descname">clear</code><spanclass="sig-paren">(</span><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/contrib/rpg/rpsystem/rpsystem.html#SdescHandler.clear"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.SdescHandler.clear"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">get</code><spanclass="sig-paren">(</span><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/contrib/rpg/rpsystem/rpsystem.html#SdescHandler.get"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.SdescHandler.get"title="Permalink to this definition">¶</a></dt>
<dd><p>Simple getter. The sdesc should never be allowed to
be empty, but if it is we must fall back to the key.</p>
<emclass="property">class </em><codeclass="sig-prename descclassname">evennia.contrib.rpg.rpsystem.rpsystem.</code><codeclass="sig-name descname">RecogHandler</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">obj</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/contrib/rpg/rpsystem/rpsystem.html#RecogHandler"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.RecogHandler"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">__init__</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">obj</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/contrib/rpg/rpsystem/rpsystem.html#RecogHandler.__init__"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.RecogHandler.__init__"title="Permalink to this definition">¶</a></dt>
<dd><p>Initialize the handler</p>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><p><strong>obj</strong> (<em>Object</em>) – The entity on which this handler is stored.</p>
<codeclass="sig-name descname">add</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">obj</span></em>, <emclass="sig-param"><spanclass="n">recog</span></em>, <emclass="sig-param"><spanclass="n">max_length</span><spanclass="o">=</span><spanclass="default_value">60</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/contrib/rpg/rpsystem/rpsystem.html#RecogHandler.add"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.RecogHandler.add"title="Permalink to this definition">¶</a></dt>
<dd><p>Assign a custom recog (nick) to the given object.</p>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><ulclass="simple">
<li><p><strong>obj</strong> (<em>Object</em>) – The object ot associate with the recog
string. This is usually determined from the sdesc in the
room by a call to parse_sdescs_and_recogs, but can also be
given.</p></li>
<li><p><strong>recog</strong> (<em>str</em>) – The replacement string to use with this object.</p></li>
<li><p><strong>max_length</strong> (<em>int</em><em>, </em><em>optional</em>) – The max length of the recog string.</p></li>
</ul>
</dd>
<dtclass="field-even">Returns</dt>
<ddclass="field-even"><p><em>recog (str)</em>– The (possibly cleaned up) recog string actually set.</p>
</dd>
<dtclass="field-odd">Raises</dt>
<ddclass="field-odd"><p><aclass="reference internal"href="#evennia.contrib.rpg.rpsystem.rpsystem.SdescError"title="evennia.contrib.rpg.rpsystem.rpsystem.SdescError"><strong>SdescError</strong></a>– When recog could not be set or sdesc longer
<codeclass="sig-name descname">get</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">obj</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/contrib/rpg/rpsystem/rpsystem.html#RecogHandler.get"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.RecogHandler.get"title="Permalink to this definition">¶</a></dt>
<dd><p>Get recog replacement string, if one exists.</p>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><p><strong>obj</strong> (<em>Object</em>) – The object, whose sdesc to replace</p>
</dd>
<dtclass="field-even">Returns</dt>
<ddclass="field-even"><p><p><em>recog (str or None)</em>–</p>
<dlclass="simple">
<dt>The replacement string to use, or</dt><dd><p>None if there is no recog for this object.</p>
</dd>
</dl>
</p>
</dd>
</dl>
<pclass="rubric">Notes</p>
<p>This method will respect a “enable_recog” lock set on
<strong>obj</strong> (True by default) in order to turn off recog
mechanism. This is useful for adding masks/hoods etc.</p>
<codeclass="sig-name descname">all</code><spanclass="sig-paren">(</span><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/contrib/rpg/rpsystem/rpsystem.html#RecogHandler.all"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.RecogHandler.all"title="Permalink to this definition">¶</a></dt>
<dd><p>Get a mapping of the recogs stored in handler.</p>
<dlclass="field-list simple">
<dtclass="field-odd">Returns</dt>
<ddclass="field-odd"><p><em>recogs (dict)</em>– A mapping of {recog: obj} stored in handler.</p>
<codeclass="sig-name descname">remove</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">obj</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/contrib/rpg/rpsystem/rpsystem.html#RecogHandler.remove"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.RecogHandler.remove"title="Permalink to this definition">¶</a></dt>
<dd><p>Clear recog for a given object.</p>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><p><strong>obj</strong> (<em>Object</em>) – The object for which to remove recog.</p>
<emclass="property">class </em><codeclass="sig-prename descclassname">evennia.contrib.rpg.rpsystem.rpsystem.</code><codeclass="sig-name descname">RPCommand</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="o">**</span><spanclass="n">kwargs</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/contrib/rpg/rpsystem/rpsystem.html#RPCommand"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.RPCommand"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">parse</code><spanclass="sig-paren">(</span><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/contrib/rpg/rpsystem/rpsystem.html#RPCommand.parse"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.RPCommand.parse"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">aliases</code><emclass="property"> = []</em><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.RPCommand.aliases"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">help_category</code><emclass="property"> = 'general'</em><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.RPCommand.help_category"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">key</code><emclass="property"> = 'command'</em><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.RPCommand.key"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">lock_storage</code><emclass="property"> = 'cmd:all();'</em><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.RPCommand.lock_storage"title="Permalink to this definition">¶</a></dt>
<emclass="property">class </em><codeclass="sig-prename descclassname">evennia.contrib.rpg.rpsystem.rpsystem.</code><codeclass="sig-name descname">CmdEmote</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="o">**</span><spanclass="n">kwargs</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/contrib/rpg/rpsystem/rpsystem.html#CmdEmote"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.CmdEmote"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">key</code><emclass="property"> = 'emote'</em><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.CmdEmote.key"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">aliases</code><emclass="property"> = [':']</em><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.CmdEmote.aliases"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">locks</code><emclass="property"> = 'cmd:all()'</em><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.CmdEmote.locks"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">arg_regex</code><emclass="property"> = re.compile('', re.IGNORECASE)</em><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.CmdEmote.arg_regex"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">func</code><spanclass="sig-paren">(</span><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/contrib/rpg/rpsystem/rpsystem.html#CmdEmote.func"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.CmdEmote.func"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">help_category</code><emclass="property"> = 'general'</em><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.CmdEmote.help_category"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">lock_storage</code><emclass="property"> = 'cmd:all()'</em><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.CmdEmote.lock_storage"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">search_index_entry</code><emclass="property"> = {'aliases': ':', 'category': 'general', 'key': 'emote', 'no_prefix': ' :', 'tags': '', 'text': '\n Emote an action, allowing dynamic replacement of\n text in the emote.\n\n Usage:\n emote text\n\n Example:\n emote /me looks around.\n emote With a flurry /me attacks /tall man with his sword.\n emote "Hello", /me says.\n\n Describes an event in the world. This allows the use of /ref\n markers to replace with the short descriptions or recognized\n strings of objects in the same room. These will be translated to\n emotes to match each person seeing it. Use "..." for saying\n things and langcode"..." without spaces to say something in\n a different language.\n\n '}</em><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.CmdEmote.search_index_entry"title="Permalink to this definition">¶</a></dt>
<emclass="property">class </em><codeclass="sig-prename descclassname">evennia.contrib.rpg.rpsystem.rpsystem.</code><codeclass="sig-name descname">CmdSay</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="o">**</span><spanclass="n">kwargs</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/contrib/rpg/rpsystem/rpsystem.html#CmdSay"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.CmdSay"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">key</code><emclass="property"> = 'say'</em><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.CmdSay.key"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">aliases</code><emclass="property"> = ['"', "'"]</em><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.CmdSay.aliases"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">locks</code><emclass="property"> = 'cmd:all()'</em><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.CmdSay.locks"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">arg_regex</code><emclass="property"> = re.compile('', re.IGNORECASE)</em><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.CmdSay.arg_regex"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">func</code><spanclass="sig-paren">(</span><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/contrib/rpg/rpsystem/rpsystem.html#CmdSay.func"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.CmdSay.func"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">help_category</code><emclass="property"> = 'general'</em><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.CmdSay.help_category"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">lock_storage</code><emclass="property"> = 'cmd:all()'</em><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.CmdSay.lock_storage"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">search_index_entry</code><emclass="property"> = {'aliases': '" \'', 'category': 'general', 'key': 'say', 'no_prefix': ' " \'', 'tags': '', 'text': '\n speak as your character\n\n Usage:\n say <message>\n\n Talk to those in your current location.\n '}</em><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.CmdSay.search_index_entry"title="Permalink to this definition">¶</a></dt>
<emclass="property">class </em><codeclass="sig-prename descclassname">evennia.contrib.rpg.rpsystem.rpsystem.</code><codeclass="sig-name descname">CmdSdesc</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="o">**</span><spanclass="n">kwargs</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/contrib/rpg/rpsystem/rpsystem.html#CmdSdesc"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.CmdSdesc"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">key</code><emclass="property"> = 'sdesc'</em><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.CmdSdesc.key"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">locks</code><emclass="property"> = 'cmd:all()'</em><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.CmdSdesc.locks"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">func</code><spanclass="sig-paren">(</span><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/contrib/rpg/rpsystem/rpsystem.html#CmdSdesc.func"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.CmdSdesc.func"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">aliases</code><emclass="property"> = []</em><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.CmdSdesc.aliases"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">help_category</code><emclass="property"> = 'general'</em><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.CmdSdesc.help_category"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">lock_storage</code><emclass="property"> = 'cmd:all()'</em><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.CmdSdesc.lock_storage"title="Permalink to this definition">¶</a></dt>
<emclass="property">class </em><codeclass="sig-prename descclassname">evennia.contrib.rpg.rpsystem.rpsystem.</code><codeclass="sig-name descname">CmdPose</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="o">**</span><spanclass="n">kwargs</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/contrib/rpg/rpsystem/rpsystem.html#CmdPose"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.CmdPose"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">key</code><emclass="property"> = 'pose'</em><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.CmdPose.key"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">parse</code><spanclass="sig-paren">(</span><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/contrib/rpg/rpsystem/rpsystem.html#CmdPose.parse"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.CmdPose.parse"title="Permalink to this definition">¶</a></dt>
<dd><p>Extract the “default” alternative to the pose.</p>
<codeclass="sig-name descname">func</code><spanclass="sig-paren">(</span><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/contrib/rpg/rpsystem/rpsystem.html#CmdPose.func"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.CmdPose.func"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">aliases</code><emclass="property"> = []</em><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.CmdPose.aliases"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">help_category</code><emclass="property"> = 'general'</em><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.CmdPose.help_category"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">lock_storage</code><emclass="property"> = 'cmd:all();'</em><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.CmdPose.lock_storage"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">search_index_entry</code><emclass="property"> = {'aliases': '', 'category': 'general', 'key': 'pose', 'no_prefix': ' ', 'tags': '', 'text': "\n Set a static pose\n\n Usage:\n pose <pose>\n pose default <pose>\n pose reset\n pose obj = <pose>\n pose default obj = <pose>\n pose reset obj =\n\n Examples:\n pose leans against the tree\n pose is talking to the barkeep.\n pose box = is sitting on the floor.\n\n Set a static pose. This is the end of a full sentence that starts\n with your sdesc. If no full stop is given, it will be added\n automatically. The default pose is the pose you get when using\n pose reset. Note that you can use sdescs/recogs to reference\n people in your pose, but these always appear as that person's\n sdesc in the emote, regardless of who is seeing it.\n\n "}</em><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.CmdPose.search_index_entry"title="Permalink to this definition">¶</a></dt>
<emclass="property">class </em><codeclass="sig-prename descclassname">evennia.contrib.rpg.rpsystem.rpsystem.</code><codeclass="sig-name descname">CmdRecog</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="o">**</span><spanclass="n">kwargs</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/contrib/rpg/rpsystem/rpsystem.html#CmdRecog"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.CmdRecog"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">key</code><emclass="property"> = 'recog'</em><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.CmdRecog.key"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">aliases</code><emclass="property"> = ['recognize', 'forget']</em><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.CmdRecog.aliases"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">parse</code><spanclass="sig-paren">(</span><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/contrib/rpg/rpsystem/rpsystem.html#CmdRecog.parse"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.CmdRecog.parse"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">func</code><spanclass="sig-paren">(</span><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/contrib/rpg/rpsystem/rpsystem.html#CmdRecog.func"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.CmdRecog.func"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">help_category</code><emclass="property"> = 'general'</em><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.CmdRecog.help_category"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">lock_storage</code><emclass="property"> = 'cmd:all();'</em><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.CmdRecog.lock_storage"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">search_index_entry</code><emclass="property"> = {'aliases': 'recognize forget', 'category': 'general', 'key': 'recog', 'no_prefix': ' recognize forget', 'tags': '', 'text': '\n Recognize another person in the same room.\n\n Usage:\n recog\n recog sdesc as alias\n forget alias\n\n Example:\n recog tall man as Griatch\n forget griatch\n\n This will assign a personal alias for a person, or forget said alias.\n Using the command without arguments will list all current recogs.\n\n '}</em><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.CmdRecog.search_index_entry"title="Permalink to this definition">¶</a></dt>
<emclass="property">class </em><codeclass="sig-prename descclassname">evennia.contrib.rpg.rpsystem.rpsystem.</code><codeclass="sig-name descname">CmdMask</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="o">**</span><spanclass="n">kwargs</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/contrib/rpg/rpsystem/rpsystem.html#CmdMask"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.CmdMask"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">key</code><emclass="property"> = 'mask'</em><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.CmdMask.key"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">aliases</code><emclass="property"> = ['unmask']</em><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.CmdMask.aliases"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">func</code><spanclass="sig-paren">(</span><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/contrib/rpg/rpsystem/rpsystem.html#CmdMask.func"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.CmdMask.func"title="Permalink to this definition">¶</a></dt>
<dd><p>This is the actual executing part of the command. It is
called directly after self.parse(). See the docstring of this
module for which object properties are available (beyond those
<codeclass="sig-name descname">help_category</code><emclass="property"> = 'general'</em><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.CmdMask.help_category"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">lock_storage</code><emclass="property"> = 'cmd:all();'</em><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.CmdMask.lock_storage"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">search_index_entry</code><emclass="property"> = {'aliases': 'unmask', 'category': 'general', 'key': 'mask', 'no_prefix': ' unmask', 'tags': '', 'text': "\n Wear a mask\n\n Usage:\n mask <new sdesc>\n unmask\n\n This will put on a mask to hide your identity. When wearing\n a mask, your sdesc will be replaced by the sdesc you pick and\n people's recognitions of you will be disabled.\n\n "}</em><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.CmdMask.search_index_entry"title="Permalink to this definition">¶</a></dt>
<emclass="property">class </em><codeclass="sig-prename descclassname">evennia.contrib.rpg.rpsystem.rpsystem.</code><codeclass="sig-name descname">RPSystemCmdSet</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">cmdsetobj</span><spanclass="o">=</span><spanclass="default_value">None</span></em>, <emclass="sig-param"><spanclass="n">key</span><spanclass="o">=</span><spanclass="default_value">None</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/contrib/rpg/rpsystem/rpsystem.html#RPSystemCmdSet"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.RPSystemCmdSet"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">at_cmdset_creation</code><spanclass="sig-paren">(</span><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/contrib/rpg/rpsystem/rpsystem.html#RPSystemCmdSet.at_cmdset_creation"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.RPSystemCmdSet.at_cmdset_creation"title="Permalink to this definition">¶</a></dt>
<dd><p>Hook method - this should be overloaded in the inheriting
class, and should take care of populating the cmdset by use of
<codeclass="sig-name descname">path</code><emclass="property"> = 'evennia.contrib.rpg.rpsystem.rpsystem.RPSystemCmdSet'</em><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.RPSystemCmdSet.path"title="Permalink to this definition">¶</a></dt>
<emclass="property">class </em><codeclass="sig-prename descclassname">evennia.contrib.rpg.rpsystem.rpsystem.</code><codeclass="sig-name descname">ContribRPObject</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="o">*</span><spanclass="n">args</span></em>, <emclass="sig-param"><spanclass="o">**</span><spanclass="n">kwargs</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/contrib/rpg/rpsystem/rpsystem.html#ContribRPObject"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.ContribRPObject"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">sdesc</code><aclass="reference internal"href="../_modules/evennia/contrib/rpg/rpsystem/rpsystem.html#ContribRPObject.sdesc"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.ContribRPObject.sdesc"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">at_object_creation</code><spanclass="sig-paren">(</span><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/contrib/rpg/rpsystem/rpsystem.html#ContribRPObject.at_object_creation"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.ContribRPObject.at_object_creation"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">get_posed_sdesc</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">sdesc</span></em>, <emclass="sig-param"><spanclass="o">**</span><spanclass="n">kwargs</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/contrib/rpg/rpsystem/rpsystem.html#ContribRPObject.get_posed_sdesc"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.ContribRPObject.get_posed_sdesc"title="Permalink to this definition">¶</a></dt>
<dd><p>Displays the object with its current pose string.</p>
<codeclass="sig-name descname">get_display_name</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">looker</span></em>, <emclass="sig-param"><spanclass="o">**</span><spanclass="n">kwargs</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/contrib/rpg/rpsystem/rpsystem.html#ContribRPObject.get_display_name"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.ContribRPObject.get_display_name"title="Permalink to this definition">¶</a></dt>
<dd><p>Displays the name of the object in a viewer-aware manner.</p>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><p><strong>looker</strong> (<aclass="reference internal"href="evennia.typeclasses.models.html#evennia.typeclasses.models.TypedObject"title="evennia.typeclasses.models.TypedObject"><em>TypedObject</em></a>) – The object or account that is looking
at/getting inforamtion for this object.</p>
</dd>
<dtclass="field-even">Keyword Arguments</dt>
<ddclass="field-even"><ulclass="simple">
<li><p><strong>pose</strong> (<em>bool</em>) – Include the pose (if available) in the return.</p></li>
<li><p><strong>ref</strong> (<em>str</em>) – The reference marker found in string to replace.
This is on the form #{num}{case}, like ‘#12^’, where
the number is a processing location in the string and the
case symbol indicates the case of the original tag input
- <strong>t</strong> - input was Titled, like /Tall
- <strong>^</strong> - input was all uppercase, like /TALL
- <strong>v</strong> - input was all lowercase, like /tall
- <strong>~</strong> - input case should be kept, or was mixed-case</p></li>
<li><p><strong>noid</strong> (<em>bool</em>) – Don’t show DBREF even if viewer has control access.</p></li>
<codeclass="sig-name descname">get_display_characters</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">looker</span></em>, <emclass="sig-param"><spanclass="n">pose</span><spanclass="o">=</span><spanclass="default_value">True</span></em>, <emclass="sig-param"><spanclass="o">**</span><spanclass="n">kwargs</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/contrib/rpg/rpsystem/rpsystem.html#ContribRPObject.get_display_characters"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.ContribRPObject.get_display_characters"title="Permalink to this definition">¶</a></dt>
<dd><p>Get the ‘characters’ component of the object description. Called by return_appearance.</p>
<codeclass="sig-name descname">get_display_things</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">looker</span></em>, <emclass="sig-param"><spanclass="n">pose</span><spanclass="o">=</span><spanclass="default_value">True</span></em>, <emclass="sig-param"><spanclass="o">**</span><spanclass="n">kwargs</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/contrib/rpg/rpsystem/rpsystem.html#ContribRPObject.get_display_things"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.ContribRPObject.get_display_things"title="Permalink to this definition">¶</a></dt>
<dd><p>Get the ‘things’ component of the object description. Called by <strong>return_appearance</strong>.</p>
<emclass="property">exception </em><codeclass="sig-name descname">DoesNotExist</code><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.ContribRPObject.DoesNotExist"title="Permalink to this definition">¶</a></dt>
<emclass="property">exception </em><codeclass="sig-name descname">MultipleObjectsReturned</code><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.ContribRPObject.MultipleObjectsReturned"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">path</code><emclass="property"> = 'evennia.contrib.rpg.rpsystem.rpsystem.ContribRPObject'</em><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.ContribRPObject.path"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">typename</code><emclass="property"> = 'ContribRPObject'</em><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.ContribRPObject.typename"title="Permalink to this definition">¶</a></dt>
<emclass="property">class </em><codeclass="sig-prename descclassname">evennia.contrib.rpg.rpsystem.rpsystem.</code><codeclass="sig-name descname">ContribRPRoom</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="o">*</span><spanclass="n">args</span></em>, <emclass="sig-param"><spanclass="o">**</span><spanclass="n">kwargs</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/contrib/rpg/rpsystem/rpsystem.html#ContribRPRoom"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.ContribRPRoom"title="Permalink to this definition">¶</a></dt>
<emclass="property">exception </em><codeclass="sig-name descname">DoesNotExist</code><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.ContribRPRoom.DoesNotExist"title="Permalink to this definition">¶</a></dt>
<emclass="property">exception </em><codeclass="sig-name descname">MultipleObjectsReturned</code><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.ContribRPRoom.MultipleObjectsReturned"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">path</code><emclass="property"> = 'evennia.contrib.rpg.rpsystem.rpsystem.ContribRPRoom'</em><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.ContribRPRoom.path"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">typename</code><emclass="property"> = 'ContribRPRoom'</em><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.ContribRPRoom.typename"title="Permalink to this definition">¶</a></dt>
<emclass="property">class </em><codeclass="sig-prename descclassname">evennia.contrib.rpg.rpsystem.rpsystem.</code><codeclass="sig-name descname">ContribRPCharacter</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="o">*</span><spanclass="n">args</span></em>, <emclass="sig-param"><spanclass="o">**</span><spanclass="n">kwargs</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/contrib/rpg/rpsystem/rpsystem.html#ContribRPCharacter"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.ContribRPCharacter"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">recog</code><aclass="reference internal"href="../_modules/evennia/contrib/rpg/rpsystem/rpsystem.html#ContribRPCharacter.recog"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.ContribRPCharacter.recog"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">get_display_name</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">looker</span></em>, <emclass="sig-param"><spanclass="o">**</span><spanclass="n">kwargs</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/contrib/rpg/rpsystem/rpsystem.html#ContribRPCharacter.get_display_name"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.ContribRPCharacter.get_display_name"title="Permalink to this definition">¶</a></dt>
<dd><p>Displays the name of the object in a viewer-aware manner.</p>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><p><strong>looker</strong> (<aclass="reference internal"href="evennia.typeclasses.models.html#evennia.typeclasses.models.TypedObject"title="evennia.typeclasses.models.TypedObject"><em>TypedObject</em></a>) – The object or account that is looking
at/getting inforamtion for this object.</p>
</dd>
<dtclass="field-even">Keyword Arguments</dt>
<ddclass="field-even"><ulclass="simple">
<li><p><strong>pose</strong> (<em>bool</em>) – Include the pose (if available) in the return.</p></li>
<li><p><strong>ref</strong> (<em>str</em>) – The reference marker found in string to replace.
This is on the form #{num}{case}, like ‘#12^’, where
the number is a processing location in the string and the
case symbol indicates the case of the original tag input
- <strong>t</strong> - input was Titled, like /Tall
- <strong>^</strong> - input was all uppercase, like /TALL
- <strong>v</strong> - input was all lowercase, like /tall
- <strong>~</strong> - input case should be kept, or was mixed-case</p></li>
<li><p><strong>noid</strong> (<em>bool</em>) – Don’t show DBREF even if viewer has control access.</p></li>
<codeclass="sig-name descname">at_object_creation</code><spanclass="sig-paren">(</span><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/contrib/rpg/rpsystem/rpsystem.html#ContribRPCharacter.at_object_creation"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.ContribRPCharacter.at_object_creation"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">at_pre_say</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">message</span></em>, <emclass="sig-param"><spanclass="o">**</span><spanclass="n">kwargs</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/contrib/rpg/rpsystem/rpsystem.html#ContribRPCharacter.at_pre_say"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.ContribRPCharacter.at_pre_say"title="Permalink to this definition">¶</a></dt>
<dd><p>Called before the object says or whispers anything, return modified message.</p>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><p><strong>message</strong> (<em>str</em>) – The suggested say/whisper text spoken by self.</p>
</dd>
<dtclass="field-even">Keyword Arguments</dt>
<ddclass="field-even"><p><strong>whisper</strong> (<em>bool</em>) – If True, this is a whisper rather than a say.</p>
<codeclass="sig-name descname">get_sdesc</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">obj</span></em>, <emclass="sig-param"><spanclass="n">process</span><spanclass="o">=</span><spanclass="default_value">False</span></em>, <emclass="sig-param"><spanclass="o">**</span><spanclass="n">kwargs</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/contrib/rpg/rpsystem/rpsystem.html#ContribRPCharacter.get_sdesc"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.ContribRPCharacter.get_sdesc"title="Permalink to this definition">¶</a></dt>
<dd><p>Single method to handle getting recogs with sdesc fallback in an
aware manner, to allow separate processing of recogs from sdescs.
Gets the sdesc or recog for obj from the view of self.</p>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><p><strong>obj</strong> (<em>Object</em>) – the object whose sdesc or recog is being gotten</p>
</dd>
<dtclass="field-even">Keyword Arguments</dt>
<ddclass="field-even"><p><strong>process</strong> (<em>bool</em>) – If True, the sdesc/recog is run through the
appropriate process method for self - .process_sdesc or
<codeclass="sig-name descname">process_sdesc</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">sdesc</span></em>, <emclass="sig-param"><spanclass="n">obj</span></em>, <emclass="sig-param"><spanclass="o">**</span><spanclass="n">kwargs</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/contrib/rpg/rpsystem/rpsystem.html#ContribRPCharacter.process_sdesc"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.ContribRPCharacter.process_sdesc"title="Permalink to this definition">¶</a></dt>
<dd><p>Allows to customize how your sdesc is displayed (primarily by
changing colors).</p>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><ulclass="simple">
<li><p><strong>sdesc</strong> (<em>str</em>) – The sdesc to display.</p></li>
<li><p><strong>obj</strong> (<em>Object</em>) – The object to which the adjoining sdesc
belongs. If this object is equal to yourself, then
you are viewing yourself (and sdesc is your key).
This is not used by default.</p></li>
</ul>
</dd>
</dl>
<dlclass="simple">
<dt>Kwargs:</dt><dd><dlclass="simple">
<dt>ref (str): The reference marker found in string to replace.</dt><dd><p>This is on the form #{num}{case}, like ‘#12^’, where
the number is a processing location in the string and the
case symbol indicates the case of the original tag input
- <strong>t</strong> - input was Titled, like /Tall
- <strong>^</strong> - input was all uppercase, like /TALL
- <strong>v</strong> - input was all lowercase, like /tall
- <strong>~</strong> - input case should be kept, or was mixed-case</p>
<codeclass="sig-name descname">process_recog</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">recog</span></em>, <emclass="sig-param"><spanclass="n">obj</span></em>, <emclass="sig-param"><spanclass="o">**</span><spanclass="n">kwargs</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/contrib/rpg/rpsystem/rpsystem.html#ContribRPCharacter.process_recog"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.ContribRPCharacter.process_recog"title="Permalink to this definition">¶</a></dt>
<dd><p>Allows to customize how a recog string is displayed.</p>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><ulclass="simple">
<li><p><strong>recog</strong> (<em>str</em>) – The recog string. It has already been
translated from the original sdesc at this point.</p></li>
<li><p><strong>obj</strong> (<em>Object</em>) – The object the recog:ed string belongs to.
This is not used by default.</p></li>
</ul>
</dd>
<dtclass="field-even">Returns</dt>
<ddclass="field-even"><p><em>recog (str)</em>– The modified recog string.</p>
<codeclass="sig-name descname">process_language</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">text</span></em>, <emclass="sig-param"><spanclass="n">speaker</span></em>, <emclass="sig-param"><spanclass="n">language</span></em>, <emclass="sig-param"><spanclass="o">**</span><spanclass="n">kwargs</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/contrib/rpg/rpsystem/rpsystem.html#ContribRPCharacter.process_language"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.ContribRPCharacter.process_language"title="Permalink to this definition">¶</a></dt>
<dd><p>Allows to process the spoken text, for example
by obfuscating language based on your and the
speaker’s language skills. Also a good place to
put coloring.</p>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><ulclass="simple">
<li><p><strong>text</strong> (<em>str</em>) – The text to process.</p></li>
<li><p><strong>speaker</strong> (<em>Object</em>) – The object delivering the text.</p></li>
<li><p><strong>language</strong> (<em>str</em>) – An identifier string for the language.</p></li>
</ul>
</dd>
<dtclass="field-even">Returns</dt>
<ddclass="field-even"><p><em>text (str)</em>– The optionally processed text.</p>
</dd>
</dl>
<pclass="rubric">Notes</p>
<p>This is designed to work together with a string obfuscator
such as the <strong>obfuscate_language</strong> or <strong>obfuscate_whisper</strong> in
<emclass="property">exception </em><codeclass="sig-name descname">DoesNotExist</code><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.ContribRPCharacter.DoesNotExist"title="Permalink to this definition">¶</a></dt>
<emclass="property">exception </em><codeclass="sig-name descname">MultipleObjectsReturned</code><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.ContribRPCharacter.MultipleObjectsReturned"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">path</code><emclass="property"> = 'evennia.contrib.rpg.rpsystem.rpsystem.ContribRPCharacter'</em><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.ContribRPCharacter.path"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">typename</code><emclass="property"> = 'ContribRPCharacter'</em><aclass="headerlink"href="#evennia.contrib.rpg.rpsystem.rpsystem.ContribRPCharacter.typename"title="Permalink to this definition">¶</a></dt>