<spanid="evennia-contrib-tutorials-evadventure-objects"></span><h1>evennia.contrib.tutorials.evadventure.objects<aclass="headerlink"href="#module-evennia.contrib.tutorials.evadventure.objects"title="Permalink to this headline">¶</a></h1>
<p>All items in the game inherit from a base object. The properties (what you can do
with an object, such as wear, wield, eat, drink, kill etc) are all controlled by
Tags.</p>
<p>Every object has one of a few <strong>obj_type</strong>-category tags:
- weapon
- armor
- shield
- helmet
- consumable (potions, torches etc)
- magic (runestones, magic items)
- quest (quest-items)
- treasure (valuable to sell)</p>
<p>It’s possible for an item to have more than one tag, such as a golden helmet (helmet+treasure) or
<emclass="property">class </em><codeclass="sig-prename descclassname">evennia.contrib.tutorials.evadventure.objects.</code><codeclass="sig-name descname">EvAdventureObject</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/tutorials/evadventure/objects.html#EvAdventureObject"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureObject"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">inventory_use_slot</code><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureObject.inventory_use_slot"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">size</code><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureObject.size"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">value</code><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureObject.value"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">obj_type</code><emclass="property"> = 'gear'</em><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureObject.obj_type"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/tutorials/evadventure/objects.html#EvAdventureObject.at_object_creation"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureObject.at_object_creation"title="Permalink to this definition">¶</a></dt>
<dd><p>Called once, when this object is first created. This is the
normal hook to overload for most object types.</p>
<codeclass="sig-name descname">get_display_header</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/tutorials/evadventure/objects.html#EvAdventureObject.get_display_header"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureObject.get_display_header"title="Permalink to this definition">¶</a></dt>
<dd><p>Get the ‘header’ component of the object description. Called by <strong>return_appearance</strong>.</p>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><ulclass="simple">
<li><p><strong>looker</strong> (<em>Object</em>) – Object doing the looking.</p></li>
<li><p><strong>**kwargs</strong>– Arbitrary data for use when overriding.</p></li>
</ul>
</dd>
<dtclass="field-even">Returns</dt>
<ddclass="field-even"><p><em>str</em>– The header display string.</p>
<codeclass="sig-name descname">get_display_desc</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/tutorials/evadventure/objects.html#EvAdventureObject.get_display_desc"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureObject.get_display_desc"title="Permalink to this definition">¶</a></dt>
<dd><p>Get the ‘desc’ component of the object description. Called by <strong>return_appearance</strong>.</p>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><ulclass="simple">
<li><p><strong>looker</strong> (<em>Object</em>) – Object doing the looking.</p></li>
<li><p><strong>**kwargs</strong>– Arbitrary data for use when overriding.</p></li>
<codeclass="sig-name descname">has_obj_type</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">objtype</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/contrib/tutorials/evadventure/objects.html#EvAdventureObject.has_obj_type"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureObject.has_obj_type"title="Permalink to this definition">¶</a></dt>
<dd><p>Check if object is of a particular type.</p>
<p>typeobj_enum (enum.ObjType): A type to check, like enums.TypeObj.TREASURE.</p>
<codeclass="sig-name descname">get_help</code><spanclass="sig-paren">(</span><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/contrib/tutorials/evadventure/objects.html#EvAdventureObject.get_help"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureObject.get_help"title="Permalink to this definition">¶</a></dt>
<dd><p>Get help text for the item.</p>
<dlclass="field-list simple">
<dtclass="field-odd">Returns</dt>
<ddclass="field-odd"><p><em>str</em>– The help text, by default taken from the <strong>.help_text</strong> property.</p>
<codeclass="sig-name descname">at_pre_use</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/tutorials/evadventure/objects.html#EvAdventureObject.at_pre_use"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureObject.at_pre_use"title="Permalink to this definition">¶</a></dt>
<dd><p>Called before use. If returning False, usage should be aborted.</p>
<codeclass="sig-name descname">use</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/tutorials/evadventure/objects.html#EvAdventureObject.use"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureObject.use"title="Permalink to this definition">¶</a></dt>
<dd><p>Use this object, whatever that may mean.</p>
<codeclass="sig-name descname">at_post_use</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/tutorials/evadventure/objects.html#EvAdventureObject.at_post_use"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureObject.at_post_use"title="Permalink to this definition">¶</a></dt>
<emclass="property">exception </em><codeclass="sig-name descname">DoesNotExist</code><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureObject.DoesNotExist"title="Permalink to this definition">¶</a></dt>
<emclass="property">exception </em><codeclass="sig-name descname">MultipleObjectsReturned</code><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureObject.MultipleObjectsReturned"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">path</code><emclass="property"> = 'evennia.contrib.tutorials.evadventure.objects.EvAdventureObject'</em><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureObject.path"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">typename</code><emclass="property"> = 'EvAdventureObject'</em><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureObject.typename"title="Permalink to this definition">¶</a></dt>
<emclass="property">class </em><codeclass="sig-prename descclassname">evennia.contrib.tutorials.evadventure.objects.</code><codeclass="sig-name descname">EvAdventureObjectFiller</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/tutorials/evadventure/objects.html#EvAdventureObjectFiller"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureObjectFiller"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">obj_type</code><emclass="property"> = 'quest'</em><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureObjectFiller.obj_type"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">quality</code><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureObjectFiller.quality"title="Permalink to this definition">¶</a></dt>
<emclass="property">exception </em><codeclass="sig-name descname">DoesNotExist</code><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureObjectFiller.DoesNotExist"title="Permalink to this definition">¶</a></dt>
<emclass="property">exception </em><codeclass="sig-name descname">MultipleObjectsReturned</code><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureObjectFiller.MultipleObjectsReturned"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">path</code><emclass="property"> = 'evennia.contrib.tutorials.evadventure.objects.EvAdventureObjectFiller'</em><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureObjectFiller.path"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">typename</code><emclass="property"> = 'EvAdventureObjectFiller'</em><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureObjectFiller.typename"title="Permalink to this definition">¶</a></dt>
<emclass="property">class </em><codeclass="sig-prename descclassname">evennia.contrib.tutorials.evadventure.objects.</code><codeclass="sig-name descname">EvAdventureQuestObject</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/tutorials/evadventure/objects.html#EvAdventureQuestObject"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureQuestObject"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">obj_type</code><emclass="property"> = 'quest'</em><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureQuestObject.obj_type"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">value</code><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureQuestObject.value"title="Permalink to this definition">¶</a></dt>
<emclass="property">exception </em><codeclass="sig-name descname">DoesNotExist</code><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureQuestObject.DoesNotExist"title="Permalink to this definition">¶</a></dt>
<emclass="property">exception </em><codeclass="sig-name descname">MultipleObjectsReturned</code><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureQuestObject.MultipleObjectsReturned"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">path</code><emclass="property"> = 'evennia.contrib.tutorials.evadventure.objects.EvAdventureQuestObject'</em><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureQuestObject.path"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">typename</code><emclass="property"> = 'EvAdventureQuestObject'</em><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureQuestObject.typename"title="Permalink to this definition">¶</a></dt>
<emclass="property">class </em><codeclass="sig-prename descclassname">evennia.contrib.tutorials.evadventure.objects.</code><codeclass="sig-name descname">EvAdventureTreasure</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/tutorials/evadventure/objects.html#EvAdventureTreasure"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureTreasure"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">obj_type</code><emclass="property"> = 'treasure'</em><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureTreasure.obj_type"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">value</code><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureTreasure.value"title="Permalink to this definition">¶</a></dt>
<emclass="property">exception </em><codeclass="sig-name descname">DoesNotExist</code><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureTreasure.DoesNotExist"title="Permalink to this definition">¶</a></dt>
<emclass="property">exception </em><codeclass="sig-name descname">MultipleObjectsReturned</code><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureTreasure.MultipleObjectsReturned"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">path</code><emclass="property"> = 'evennia.contrib.tutorials.evadventure.objects.EvAdventureTreasure'</em><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureTreasure.path"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">typename</code><emclass="property"> = 'EvAdventureTreasure'</em><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureTreasure.typename"title="Permalink to this definition">¶</a></dt>
<emclass="property">class </em><codeclass="sig-prename descclassname">evennia.contrib.tutorials.evadventure.objects.</code><codeclass="sig-name descname">EvAdventureConsumable</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/tutorials/evadventure/objects.html#EvAdventureConsumable"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureConsumable"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">obj_type</code><emclass="property"> = 'consumable'</em><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureConsumable.obj_type"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">size</code><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureConsumable.size"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">uses</code><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureConsumable.uses"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">at_pre_use</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">user</span></em>, <emclass="sig-param"><spanclass="n">target</span><spanclass="o">=</span><spanclass="default_value">None</span></em>, <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/tutorials/evadventure/objects.html#EvAdventureConsumable.at_pre_use"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureConsumable.at_pre_use"title="Permalink to this definition">¶</a></dt>
<dd><p>Called before use. If returning False, usage should be aborted.</p>
<codeclass="sig-name descname">use</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">user</span></em>, <emclass="sig-param"><spanclass="n">target</span><spanclass="o">=</span><spanclass="default_value">None</span></em>, <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/tutorials/evadventure/objects.html#EvAdventureConsumable.use"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureConsumable.use"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">at_post_use</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">user</span></em>, <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/tutorials/evadventure/objects.html#EvAdventureConsumable.at_post_use"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureConsumable.at_post_use"title="Permalink to this definition">¶</a></dt>
<dd><p>Called after this item was used.</p>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><ulclass="simple">
<li><p><strong>user</strong> (<em>Object</em>) – The one using the item.</p></li>
<emclass="property">exception </em><codeclass="sig-name descname">DoesNotExist</code><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureConsumable.DoesNotExist"title="Permalink to this definition">¶</a></dt>
<emclass="property">exception </em><codeclass="sig-name descname">MultipleObjectsReturned</code><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureConsumable.MultipleObjectsReturned"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">path</code><emclass="property"> = 'evennia.contrib.tutorials.evadventure.objects.EvAdventureConsumable'</em><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureConsumable.path"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">typename</code><emclass="property"> = 'EvAdventureConsumable'</em><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureConsumable.typename"title="Permalink to this definition">¶</a></dt>
<emclass="property">class </em><codeclass="sig-prename descclassname">evennia.contrib.tutorials.evadventure.objects.</code><codeclass="sig-name descname">EvAdventureWeapon</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/tutorials/evadventure/objects.html#EvAdventureWeapon"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureWeapon"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">obj_type</code><emclass="property"> = 'weapon'</em><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureWeapon.obj_type"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">inventory_use_slot</code><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureWeapon.inventory_use_slot"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">quality</code><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureWeapon.quality"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">attack_type</code><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureWeapon.attack_type"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">defense_type</code><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureWeapon.defense_type"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">damage_roll</code><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureWeapon.damage_roll"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><spanclass="o">=</span><spanclass="default_value">None</span></em>, <emclass="sig-param"><spanclass="o">**</span><spanclass="n">kwargs</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/contrib/tutorials/evadventure/objects.html#EvAdventureWeapon.get_display_name"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureWeapon.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. If not given, <strong>.name</strong> will be
returned, which can in turn be used to display colored data.</p>
</dd>
<dtclass="field-even">Returns</dt>
<ddclass="field-even"><p><p><em>str</em>–</p>
<dlclass="simple">
<dt>A name to display for this object. This can contain color codes and may</dt><dd><p>be customized based on <strong>looker</strong>. By default this contains the <strong>.key</strong> of the object,
followed by the DBREF if this user is privileged to control said object.</p>
</dd>
</dl>
</p>
</dd>
</dl>
<pclass="rubric">Notes</p>
<p>This function could be extended to change how object names appear to users in character,
but be wary. This function does not change an object’s keys or aliases when searching,
and is expected to produce something useful for builders.</p>
<codeclass="sig-name descname">at_pre_use</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">user</span></em>, <emclass="sig-param"><spanclass="n">target</span><spanclass="o">=</span><spanclass="default_value">None</span></em>, <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/tutorials/evadventure/objects.html#EvAdventureWeapon.at_pre_use"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureWeapon.at_pre_use"title="Permalink to this definition">¶</a></dt>
<dd><p>Called before use. If returning False, usage should be aborted.</p>
<codeclass="sig-name descname">at_post_use</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">user</span></em>, <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/tutorials/evadventure/objects.html#EvAdventureWeapon.at_post_use"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureWeapon.at_post_use"title="Permalink to this definition">¶</a></dt>
<emclass="property">exception </em><codeclass="sig-name descname">DoesNotExist</code><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureWeapon.DoesNotExist"title="Permalink to this definition">¶</a></dt>
<emclass="property">exception </em><codeclass="sig-name descname">MultipleObjectsReturned</code><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureWeapon.MultipleObjectsReturned"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">path</code><emclass="property"> = 'evennia.contrib.tutorials.evadventure.objects.EvAdventureWeapon'</em><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureWeapon.path"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">typename</code><emclass="property"> = 'EvAdventureWeapon'</em><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureWeapon.typename"title="Permalink to this definition">¶</a></dt>
<emclass="property">class </em><codeclass="sig-prename descclassname">evennia.contrib.tutorials.evadventure.objects.</code><codeclass="sig-name descname">EvAdventureThrowable</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/tutorials/evadventure/objects.html#EvAdventureThrowable"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureThrowable"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">attack_type</code><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureThrowable.attack_type"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">defense_type</code><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureThrowable.defense_type"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">damage_roll</code><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureThrowable.damage_roll"title="Permalink to this definition">¶</a></dt>
<emclass="property">exception </em><codeclass="sig-name descname">DoesNotExist</code><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureThrowable.DoesNotExist"title="Permalink to this definition">¶</a></dt>
<emclass="property">exception </em><codeclass="sig-name descname">MultipleObjectsReturned</code><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureThrowable.MultipleObjectsReturned"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">path</code><emclass="property"> = 'evennia.contrib.tutorials.evadventure.objects.EvAdventureThrowable'</em><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureThrowable.path"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">typename</code><emclass="property"> = 'EvAdventureThrowable'</em><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureThrowable.typename"title="Permalink to this definition">¶</a></dt>
<emclass="property">class </em><codeclass="sig-prename descclassname">evennia.contrib.tutorials.evadventure.objects.</code><codeclass="sig-name descname">EvAdventureRunestone</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/tutorials/evadventure/objects.html#EvAdventureRunestone"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureRunestone"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">obj_type</code><emclass="property"> = (<ObjType.WEAPON: 'weapon'>, <ObjType.MAGIC: 'magic'>)</em><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureRunestone.obj_type"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">inventory_use_slot</code><emclass="property"> = 'two_handed_weapons'</em><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureRunestone.inventory_use_slot"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">quality</code><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureRunestone.quality"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">attack_type</code><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureRunestone.attack_type"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">defense_type</code><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureRunestone.defense_type"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">damage_roll</code><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureRunestone.damage_roll"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">at_post_use</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">user</span></em>, <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/tutorials/evadventure/objects.html#EvAdventureRunestone.at_post_use"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureRunestone.at_post_use"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">refresh</code><spanclass="sig-paren">(</span><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/contrib/tutorials/evadventure/objects.html#EvAdventureRunestone.refresh"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureRunestone.refresh"title="Permalink to this definition">¶</a></dt>
<emclass="property">exception </em><codeclass="sig-name descname">DoesNotExist</code><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureRunestone.DoesNotExist"title="Permalink to this definition">¶</a></dt>
<emclass="property">exception </em><codeclass="sig-name descname">MultipleObjectsReturned</code><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureRunestone.MultipleObjectsReturned"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">path</code><emclass="property"> = 'evennia.contrib.tutorials.evadventure.objects.EvAdventureRunestone'</em><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureRunestone.path"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">typename</code><emclass="property"> = 'EvAdventureRunestone'</em><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureRunestone.typename"title="Permalink to this definition">¶</a></dt>
<emclass="property">class </em><codeclass="sig-prename descclassname">evennia.contrib.tutorials.evadventure.objects.</code><codeclass="sig-name descname">EvAdventureArmor</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/tutorials/evadventure/objects.html#EvAdventureArmor"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureArmor"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">obj_type</code><emclass="property"> = 'armor'</em><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureArmor.obj_type"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">inventory_use_slot</code><emclass="property"> = 'body'</em><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureArmor.inventory_use_slot"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">armor</code><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureArmor.armor"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">quality</code><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureArmor.quality"title="Permalink to this definition">¶</a></dt>
<emclass="property">exception </em><codeclass="sig-name descname">DoesNotExist</code><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureArmor.DoesNotExist"title="Permalink to this definition">¶</a></dt>
<emclass="property">exception </em><codeclass="sig-name descname">MultipleObjectsReturned</code><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureArmor.MultipleObjectsReturned"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">path</code><emclass="property"> = 'evennia.contrib.tutorials.evadventure.objects.EvAdventureArmor'</em><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureArmor.path"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">typename</code><emclass="property"> = 'EvAdventureArmor'</em><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureArmor.typename"title="Permalink to this definition">¶</a></dt>
<emclass="property">class </em><codeclass="sig-prename descclassname">evennia.contrib.tutorials.evadventure.objects.</code><codeclass="sig-name descname">EvAdventureShield</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/tutorials/evadventure/objects.html#EvAdventureShield"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureShield"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">obj_type</code><emclass="property"> = 'shield'</em><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureShield.obj_type"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">inventory_use_slot</code><emclass="property"> = 'shield_hand'</em><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureShield.inventory_use_slot"title="Permalink to this definition">¶</a></dt>
<emclass="property">exception </em><codeclass="sig-name descname">DoesNotExist</code><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureShield.DoesNotExist"title="Permalink to this definition">¶</a></dt>
<emclass="property">exception </em><codeclass="sig-name descname">MultipleObjectsReturned</code><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureShield.MultipleObjectsReturned"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">path</code><emclass="property"> = 'evennia.contrib.tutorials.evadventure.objects.EvAdventureShield'</em><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureShield.path"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">typename</code><emclass="property"> = 'EvAdventureShield'</em><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureShield.typename"title="Permalink to this definition">¶</a></dt>
<emclass="property">class </em><codeclass="sig-prename descclassname">evennia.contrib.tutorials.evadventure.objects.</code><codeclass="sig-name descname">EvAdventureHelmet</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/tutorials/evadventure/objects.html#EvAdventureHelmet"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureHelmet"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">obj_type</code><emclass="property"> = 'helmet'</em><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureHelmet.obj_type"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">inventory_use_slot</code><emclass="property"> = 'head'</em><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureHelmet.inventory_use_slot"title="Permalink to this definition">¶</a></dt>
<emclass="property">exception </em><codeclass="sig-name descname">DoesNotExist</code><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureHelmet.DoesNotExist"title="Permalink to this definition">¶</a></dt>
<emclass="property">exception </em><codeclass="sig-name descname">MultipleObjectsReturned</code><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureHelmet.MultipleObjectsReturned"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">path</code><emclass="property"> = 'evennia.contrib.tutorials.evadventure.objects.EvAdventureHelmet'</em><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureHelmet.path"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">typename</code><emclass="property"> = 'EvAdventureHelmet'</em><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.EvAdventureHelmet.typename"title="Permalink to this definition">¶</a></dt>
<emclass="property">class </em><codeclass="sig-prename descclassname">evennia.contrib.tutorials.evadventure.objects.</code><codeclass="sig-name descname">WeaponBareHands</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/tutorials/evadventure/objects.html#WeaponBareHands"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.WeaponBareHands"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">obj_type</code><emclass="property"> = 'weapon'</em><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.WeaponBareHands.obj_type"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">key</code><emclass="property"> = 'Bare hands'</em><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.WeaponBareHands.key"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">inventory_use_slot</code><emclass="property"> = 'weapon_hand'</em><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.WeaponBareHands.inventory_use_slot"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">attack_type</code><emclass="property"> = 'strength'</em><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.WeaponBareHands.attack_type"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">defense_type</code><emclass="property"> = 'armor'</em><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.WeaponBareHands.defense_type"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">damage_roll</code><emclass="property"> = '1d4'</em><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.WeaponBareHands.damage_roll"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">quality</code><emclass="property"> = None</em><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.WeaponBareHands.quality"title="Permalink to this definition">¶</a></dt>
<emclass="property">exception </em><codeclass="sig-name descname">DoesNotExist</code><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.WeaponBareHands.DoesNotExist"title="Permalink to this definition">¶</a></dt>
<emclass="property">exception </em><codeclass="sig-name descname">MultipleObjectsReturned</code><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.WeaponBareHands.MultipleObjectsReturned"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">path</code><emclass="property"> = 'evennia.contrib.tutorials.evadventure.objects.WeaponBareHands'</em><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.WeaponBareHands.path"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">typename</code><emclass="property"> = 'WeaponBareHands'</em><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.WeaponBareHands.typename"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-prename descclassname">evennia.contrib.tutorials.evadventure.objects.</code><codeclass="sig-name descname">get_bare_hands</code><spanclass="sig-paren">(</span><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/contrib/tutorials/evadventure/objects.html#get_bare_hands"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.contrib.tutorials.evadventure.objects.get_bare_hands"title="Permalink to this definition">¶</a></dt>