<p>This multidescer will not require any changes to the Character class, rather it
will use the <codeclass="docutils literal notranslate"><spanclass="pre">multidescs</span></code> Attribute (a list) and create it if it does not exist.
It adds a new <codeclass="docutils literal notranslate"><spanclass="pre">+desc</span></code> command (where the + is optional in Evennia).</p>
<p>Like for any custom command, you just add the new <codeclass="docutils literal notranslate"><spanclass="pre">+desc</span></code> command to a default
cmdset: Import the <codeclass="docutils literal notranslate"><spanclass="pre">evennia.contrib.game_systems.multidescer.CmdMultiDesc</span></code> into
<codeclass="docutils literal notranslate"><spanclass="pre">mygame/commands/default_cmdsets.py</span></code> and add it to the <codeclass="docutils literal notranslate"><spanclass="pre">CharacterCmdSet</span></code> class.</p>
<p>Reload the server and you should have the <codeclass="docutils literal notranslate"><spanclass="pre">+desc</span></code> command available (it
<h2>Usage<aclass="headerlink"href="#usage"title="Permalink to this headline">¶</a></h2>
<p>Use the <codeclass="docutils literal notranslate"><spanclass="pre">+desc</span></code> command in-game:</p>
<divclass="highlight-none notranslate"><divclass="highlight"><pre><span></span>+desc [key] - show current desc desc with <key>
+desc <key> = <text> - add/replace desc with <key>
+desc/list - list descriptions (abbreviated)
+desc/list/full - list descriptions (full texts)
+desc/edit <key> - add/edit desc <key> in line editor
+desc/del <key> - delete desc <key>
+desc/swap <key1>-<key2> - swap positions of <key1> and <key2> in list
+desc/set <key> [+key+...] - set desc as default or combine multiple descs
</pre></div>
</div>
<p>As an example, you can set one description for clothing, another for your boots,
hairstyle or whatever you like. Use <codeclass="docutils literal notranslate"><spanclass="pre">|/</span></code> to add line breaks for multi-line descriptions and
paragraphs, as well as <codeclass="docutils literal notranslate"><spanclass="pre">|_</span></code> to enforce indentations and whitespace (we don’t
include colors in the example since they don’t show in this documentation).</p>
<divclass="highlight-none notranslate"><divclass="highlight"><pre><span></span>+desc base = A handsome man.|_
+desc mood = He is cheerful, like all is going his way.|/|/
+desc head = On his head he has a red hat with a feather in it.|_
+desc shirt = His chest is wrapped in a white shirt. It has golden buttons.|_
+desc pants = He wears blue pants with a dragorn pattern on them.|_
+desc boots = His boots are dusty from the road.
+desc/set base + mood + head + shirt + pants + boots
</pre></div>
</div>
<p>When looking at this character, you will now see (assuming auto-linebreaks)</p>
<divclass="highlight-none notranslate"><divclass="highlight"><pre><span></span>A hansome man. He is cheerful, like all is going his way.
On his head he has a red hat with a feather in it. His chest is wrapped in a
white shirt. It has golden buttons. He wears blue pants with a dragon
pattern on them. His boots are dusty from the road.
</pre></div>
</div>
<p>If you now do</p>
<divclass="highlight-none notranslate"><divclass="highlight"><pre><span></span>+desc mood = He looks sullen and forlorn.|/|/
+desc shirt = His formerly white shirt is dirty and has a gash in it.|_
</pre></div>
</div>
<p>Your description will now be</p>
<divclass="highlight-none notranslate"><divclass="highlight"><pre><span></span>A handsome man. He looks sullen and forlorn.
On his head he as a red hat with a feathre in it. His formerly white shirt
is dirty and has a gash in it. He wears blue pants with a pattern on them.
His boots are dusty from the road.
</pre></div>
</div>
<p>You can use any number of ‘pieces’ to build up your description, and can swap
<p><small>This document page is generated from <codeclass="docutils literal notranslate"><spanclass="pre">evennia/contrib/game_systems/multidescer/README.md</span></code>. Changes to this
file will be overwritten, so edit that file rather than this one.</small></p>
