%%%%
pick-up

                   <h>Picking up and dropping items</h>

<h>Navigation and selecting items</h>
Use the usual navigation keys (<w>arrow</w> keys, <w>pgdn</w>/<w>pgup</w>, <w>home</w>, <w>end</w>) to select
items, and <w>Space</w>/<w>.</w> to toggle whether the selected item will be picked up or
dropped. Pressing an item's letter key will also toggle its pickup/drop state.
Gear, potions, scrolls, and evocable items are on separate pages which can be
switched between by <w>left arrow</w> and <w>right arrow</w> or <w>Tab</w> and <w>Shift-Tab</w>.
Press <w>Return</w> to accept the current set of items.

Entering a number before selecting by letter will toggle just that quantity of
a stack of items.

<h>Regular expressions</h>
You can press <w>Ctrl-F</w> to enter a word (or a regular expression). All matching
items will be selected.

<h>Category shortcuts</h>
You can quickly select items by type by pressing:
<w>!</w>   potions      <w>(</w>   weapons        <w>)</w>   ammunition      <w>[</w>   armour
<w>/</w>   wands        <w>|</w>   magical staves <w>?</w>   scrolls         <w>:</w>   books
<w>"</w>   amulets      <w>=</w>   rings          <w>}</w>   miscellaneous
Global selects:  <w>,</w>   select all     <w>*</w>   invert all      <w>-</w>   deselect all
                 <w>;</w>   select last unequipped
Note that for dropping, the <w>,</w> command uses the <w>drop_filter</w> option, which
narrows the range of items to be (de)selected. The default is all useless items.
%%%%
known-menu

                   <h>Known items menu</h>

<h>Navigation and selecting items</h>
Use the usual navigation keys (<w>arrow</w> keys, <w>pgdn</w>/<w>pgup</w>, <w>home</w>, <w>end</w>) to select
items, and <w>Space</w>/<w>.</w> to toggle the autopickup mode for the selected item type.
Pressing an item type's letter key will also toggle its autopickup state.

<h>Selecting item types</h>
Item types displayed in grey use the default autopickup options set in your
configuration file. (Items that are useless to your character are displayed
in <darkgrey>dark grey</darkgrey>.) Selecting a type of item overrides those options
(indicated by <w>white</w> text), and toggles the item between the states:
 <w>+</w>  Items of this type will be picked up automatically.
 <w>-</w>  Items of this type will not be picked up automatically.
Autopickup can also be toggled for all unknown items of a given category.

<h>Category shortcuts</h>
You can quickly select all item types in a given category by pressing:
<w>!</w>   potions      <w>?</w>   scrolls      <w>(</w>   ammunition        <w>"</w>   amulets
<w>=</w>   rings        <w>/</w>   wands        <w>|</w>   magical staves
Global selects:  <w>*</w>   invert all   <w>^</w>   reset all to default

<h>Viewing unknown and known items</h>
<w>\</w> and <w>-</w> toggle between the known and unknown items menus. Note
that none of the above features are available from the unknown items menu.

<h>Restoring autopickup defaults</h>
Pressing <w>Ctrl-D</w> followed by an item letter or a category shortcut
cancels the override and restores the selected item or items to their default
settings.

<h>Regular expressions</h>
You can press <w>Ctrl-F</w> to enter a word (or a regular expression).
All matching items will be selected.

%%%%
stash-search.prompt

<h>Searching the stash-tracker</h>

You can search for items and dungeon features by name (or a substring of the
name). In the list of search results, you can select a search result by its
hotkey to travel to its location.

Some examples of search strings:
<w>mutation</w>      find all potions of mutation, including potions in shops.
<w>throwing net</w>  finds every single throwing net and piles of nets.
<w>shop</w>          lists all shops. Press <w>!</w> and a shop's letter for the stock.
<w>Lair:2</w>        find everything known to be on Lair:2.
<w>/D:[2-4]</w>      finds everything on Dungeon levels 2-4. Regexes are allowed!
              Note that /D:[3-10] will not work as intended, since [x-y] is a
              regex character range.
<w>rPois</w>         finds all items with an rPois resistance.
<w>rC++</w>          finds all items with an rC++ resistance.
<w>+3</w>            finds all items with a +3 enchantment.
<w>/Lair.*axe</w> and <w>axe && Lair</w> both show all axes in the Lair.

Some shortcuts:
<w>.</w>             lists everything on your current level.
<w>..</w>            lists all items you know.
<w>0</w> to <w>9</w>        lists all items at the specified waypoint.
<w>*</w>             lists all items at all waypoints.
<w>@<<query></w>      lists everything matching <<query> on your current level.
<w>/<<regex></w>      lists items matching <<regex> as a regular expression.
<w>=<<string></w>     lists items containing <<string> as a substring.

You can also examine shops and items in the search results by pressing <w>?</w> and
then selecting the hotkey for the search result. This will give a description
of the item or the contents of the shop.

The stash search string is case-insensitive.

<h>Searching by item properties:</h>

You can search for spell names (such as <w>Ignite Poison</w>) to find spellbooks
that contain the spell.

You can search for artefact item properties (such as <w>/prevents.*teleport</w>)
to find artefacts that have the property.

You can search by some additional item properties: <w>artefact</w> or
<w>artifact</w> will find identified artefacts, <w>ego</w> or <w>branded</w>
will find non-artefacts with a brand and unidentified items which may be
branded, <w>throwable</w> will find things you can throw, <w>dropped</w> will
find items you have dropped, <w>in_shop</w> will find items in shops, and (if
the autopickup_search option is enabled) <w>autopickup</w> will find items that
would be automatically picked up.

Skill names (such as <w>Polearms</w> or <w>Long Blades</w>) will find all weapons that
train that skill. You can also look for <w>melee weapon</w> and <w>ranged weapon</w>.

You can also search by item types such as <w>book</w> or <w>manual</w> or <w>jewellery</w>.
For armour slots, use <w>helmet</w> (all headgear), <w>gloves</w>, <w>shield</w>, and <w>body</w>.
Use <w>armour && !!body</w> to list all armour pieces except for body armour.

<h>Finding Dungeon Features:</h>

You can search for dungeon features by name: all shops will be found by a search
for <w>shop</w> (including shops that do not have "shop" in their name); other
dungeon features can also be found by name: <w>dispersal trap</w>, <w>altar</w>,
etc. You can also search for altars by deity name: <w>Zin</w>.

<h>Non-regex operators:</h>

You can use !! to negate a search string, && for a boolean AND, || for
boolean OR, and <<<< >> for grouping.

For instance, to find rings (jewellery) but not ring mail you could use:
<w>ring && !!mail</w>

Note that <w>/</w> and <w>=</w> apply to individual patterns, not the entire query:
you should search for <w>armour && /r(C|F|Pois|Elec)</w>, not
<w>/armour && r(C|F|Pois|Elec)</w>.
%%%%
level-map

<h>Level Map ('<w>X</w>' in the main screen):</h>
<w>Esc</w>        : Leave level map (also <w>Space</w> or any unused key).
<w>Dir.</w>       : Move the cursor.
<w>Shift-Dir.</w> : Move the cursor in larger steps (7 by default).
<w>-</w> or <w>+</w>     : Scroll level map 20 grids up or down.
<w>.</w>          : Start travel (also <w>Enter</w> and <w>,</w> and <w>;</w>).
             (Moves cursor to the last travel destination if still on @.)
<w>[</w> or <w>]</w>     : Examine the next higher or lower level.
             (Moves cursor to the staircase destination if a known staircase is
             highlighted.)
<w>G</w>          : View another level by choosing a branch and depth.
<w>o</w>          : Move the cursor to the next autoexplore target.
<w>{</w> or <w>}</w>     : Zoom out or in (tiles only).

<h>Travel exclusions</h>
<w>e</w>          : Create a travel exclusion, change its radius, or remove it.
<w>R#</w>         : Create a travel exclusion with a specified radius or change
             its radius to #, where # is a number from 1 to 8.
<w>E</w>          : Cycle through travel exclusions.
<w>Ctrl-E</w>     : Erase all travel exclusions on the level.

<h>Waypoints</h>
<w>w</w>          : Set waypoint to current position.
<w>W</w>          : Cycle through all waypoints on the level.

<h>Cycle through features</h>
<w><<</w> or <w>></w>     : Cycle through up or down stairs.
<w>^</w>          : Cycle through traps.
<w>\</w> or <w>Tab</w>   : Cycle through shops and portals.
<w>I</w>          : Cycle forward through all items.
<w>O</w>          : Cycle backward through all items.
<w>_</w>          : Cycle through altars.

<h>Other</h>
<w>v</w>          : Examine the last remembered state of the indicated tile.
<w>!</w>          : Annotate level.
<w>Ctrl-C</w>     : Clear monster memory.
<w>Ctrl-F</w>     : Forget level map.
<w>Ctrl-U</w>     : Restore forgotten level map.{{
if you.wizard() then
    return "\n\n"
          .. "<h>Wizard commands</h>\n"
          .. "<w>T</w>          : Teleport to cursor.\n"
          .. "<w>Ctrl-X</w>     : Completely wipe out map."
end }}
%%%%
interlevel-travel.branch.prompt

<h>Interlevel Travel (choose a branch):
 Use the shortcut letter for a branch to select the branch for travel.

 Once you select a branch, you will be prompted for a depth in that
 branch (more help is available there).

 <w>Tab</w>    : Repeat last interlevel travel.
 <w>.</w>      : Travel to a level in the current branch.
 <w><<</w>      : Go up the nearest stairs.
 <w>></w>      : Go down the nearest stairs.
 <w>Ctrl-P</w> : Travel to a level in the branch above this one.
 <w>*</w>      : Show available waypoints (if any are set).
 <w>0</w>-<w>9</w>    : Go to the numbered waypoint.
 <w>_</w>      : Show available altars (if any are discovered).
%%%%
interlevel-travel.depth.prompt

<h>Interlevel Travel (go to a specific level in the selected branch)
 Type in the level number you want to go to and press Enter, or use:
 <w>Enter</w>  : Go to the default level.
 <w>0</w>      : Go to the entrance to the current branch.
 <w><<</w>      : Change the default to one level above the current.
 <w>></w>      : Change default to one level below the current.
 <w>-</w> or <w>p</w> : Change default to the branch above this one.
 <w>$</w>      : Change default to deepest visited level in this branch.
 <w>^</w>      : Change default to the entrance to the current branch.
%%%%
interlevel-travel.altar.prompt

<h>Interlevel Travel (go to an altar):
 Use the shortcut letter (the initial of a god, with TSO being replaced by 1)
 to select the altar for travel.

 Once you select a god, you will begin travelling to the nearst altar.

 <w>Enter</w>  : Repeat last interlevel travel.
%%%%
annotate.prompt

<h>Annotate (select level):
 <w>Enter</w> or <w>.</w> : Annotate current level.
 any <w>letter</w> : Annotate a level in the branch corresponding to the letter.
 <w><<</w>          : Annotate the level upstairs.
 <w>></w>          : Annotate the level downstairs.
 <w>Ctrl-P</w>     : Annotate a level in the branch above this one.
 <w>!</w>          : Show list of dungeon branches.

%%%%
skill-menu

                        <h>Skill management</h>

You gain experience for killing monsters (and very few other activities). This
experience is used to train skills. The skill screen allows you to select which
skills to train.

By pressing its letter, you can cycle if and how a skill is trained:
  <darkgrey>- deselected</darkgrey>    Skill will not be trained.
  + selected      Skill will be trained.
  <w>* focused</w>       Skill will be weighted higher for training.

Pressing a capital letter selects that skill and deselects all the others.
This shortcut is useful when you want to train only one skill.

Training can be done in two modes, which are toggled with the <w>/</w> key.
  - automatic:    Skills are weighted based on your use of them.
  - manual:       Experience is spread evenly across all activated skills.

In training target mode you can set skill training targets: target skill levels
at which training of the skill will be automatically disabled.

How fast you train a skill is governed by the following factors:
  - aptitude: Shown <white>white</white> in the Apt column. Higher numbers mean that less
              experience is needed to advance a skill. Depends on species.
  - skill manuals: Rare books giving an aptitude bonus of <lightred>+4</lightred> in one skill.

On top of that, there are some effects which directly modify a skill, for
example having trained a related skill (crosstraining), or certain god powers.
Reduced skills are shown in <magenta>magenta</magenta>, and enhanced skills in <green>green</green>.
The training percentage (in <brown>brown</brown>) shows the relative amount of experience
which will be used to train this skill.

Apart from (de)selecting skills, you also have the following toggles:
  <w>/</w> :  Switch between automatic and manual training modes.
  <w>*</w> :  Display all skills, even those which aren't currently useful.
  <w>?</w> :  Allows you to read the descriptions of skills.
  <w>_</w> :  Show or hide skill level modifications (god powers, crosstraining).
  <w>!</w> :  Switch between displaying training percentage, skill cost, or training
       targets.
%%%%
spell-library
<h>Spell Library</h>
<w>Tab</w> or <w>!</w>  : Cycle forward through <w>Memorise</w>, <w>Describe</w>, <w>Hide</w>, and <w>Show</w> pages.
<w>Shift-Tab</w> : Cycle backward through these pages.
<w>Ctrl-F</w>    : Filter the list of spells shown with a regex.
<w>?</w>         : Show this help.

By default, the spell library opens to the <w>Memorise</w> page; to begin memorising a
spell, just press its letter. To read a spell's description, first switch to
the <w>Describe</w> page by pressing <w>Tab</w>, then press the spell's letter.

Most characters will not be interested in memorising the majority of spells that
accumulate in their spell library; this is where the <w>Show</w> and <w>Hide</w> pages come in
handy. To hide a spell from the <w>Memorise</w> and <w>Describe</w> pages, press its spell
letter from the <w>Hide</w> page. Hidden spells can be shown again from the <w>Show</w> page.

The <w>auto_hide_spells</w> option can be useful; when enabled, all newly discovered
spells are hidden by default.

<w>Ctrl-F</w> can be used to filter the list of spells. Any filter set in this way will
persist until the spell library is closed and reopened, or until a new filter is
set with <w>Ctrl-F</w>. If <w>Enter</w> is pressed at the prompt without entering any text,
that will reset the filter to none.
You can filter spells by name and by spell school.
%%%%
wiz-monster
<h>Create specified monster</h>

To create a monster with the default equipment for its species, simply enter
the species name, such as <w>kobold</w> or <w>Yiuf</w>.

A hydra or slymdra can be given a specific number of heads by calling it an
n<w>-headed</w> <w>hydra</w> or n<w>-headed</w> <w>slymdra</w> (with a maximum of 20 heads):

<w>four-headed hydra</w>

To set the colour a (very) ugly thing takes when it is first created, use:

<w>white very ugly thing</w>

The valid colours are <w>brown</w>, <w>cyan</w>, <w>green</w>, <w>purple</w>, <w>red</w> and <w>white</w>.

A mutant beast can be customised by prefacing it with a maturity level and/or
hyphen-separated set of traits, as follows:

<w>mature shock-weird mutant beast</w>

The valid maturity levels are <w>larval</w>, <w>juvenile</w>, <w>mature</w>, <w>elder</w> and <w>primal</w>. The
facets are <w>sting</w>, <w>bat</w>, <w>fire</w>, <w>weird</w>, <w>shock</w> and <w>ox</w>.

A slime creature's size can be set to other than normal using the prefixes
<w>large</w>, <w>very large</w>, <w>enormous</w> or <w>titanic</w>:

<w>very large slime creature</w>

If a monster is a member of a band, you can request that it be eligible for
band members by adding the keyword <w>band</w> to the name. For instance:

<w>orc warlord band</w>

Specifying <w>band</w> doesn't force bands to be placed - it requests that the game
use the normal chances of creating a band. A band will only be placed if there
is space for it.

A monster can be given specific items by following the monster name with a
semi-colon and then with an item list. For example:

<w>orc ; rapier | quick blade . chain mail | plate armour</w>

will generate an orc wielding either a rapier or a quick blade and wearing
either chain mail or plate armour. Randarts and ego items are only generated
if they are explicitly requested. Note that any items that the monster was
originally generated with will be removed and destroyed. This can be used to
force a monster to have no items whatsoever:

<w>orc; nothing</w>

For further information, see <cyan>docs/develop/levels/syntax.txt</cyan>, section <cyan>ITEMS</cyan>.
Any reference to a slash (<w>/</w>) should be replaced with a pipe (<w>|</w>) and any comma
(<w>,</w>) with a full stop (<w>.</w>).

The same syntax is also used to create a specific type of dancing weapon:

<w>dancing weapon; rapier</w>

Limitations: If a monster is given a random launcher, there is no way to force
the ammo type to match the launcher type. As a special case, however, a
launcher dancing weapon is always generated with some suitable ammunition.

You can specify that a monster will always generate a corpse by using the tag
<w>always_corpse</w>, or that it will never generate a corpse with <w>never_corpse</w>.

By default, monsters are generated asleep. This is changed by prefixing the
name with <w>generate_awake</w>.

<w>generate_awake boulder beetle</w>

A prefix of <w>patrolling</w> prevents it from walking out of sight of the the place
where it was created.

You can set the monster's god using the <w>god</w>: specifier as follows:

<w>orc god:the_shining_one</w>

If the monster is to be a gift of the specified god, this should be suffixed
with <w>god_gift</w>:

<w>orc god:the_shining_one god_gift</w>

Note that the monster will not be considered a god gift unless <w>god_gift</w> is
explicitly set.

You can set the monster's faction by specifying <w>att</w>: one of:

* <w>att:hostile</w> -- the default
* <w>att:friendly</w> -- tame, will follow you
* <w>att:neutral</w> -- hostile to both you and att:hostile monsters
* <w>att:good_neutral</w> -- hostile to att:hostile
* <w>att:fellow_slime</w> -- tame, won't follow you

Monsters can be given colours that override their default colour:

<w>col:darkgrey fungus</w>

The colour <w>any</w> can be given, in which case a random colour will be chosen.

You can override the displayed monster tile using the <w>tile</w>: specifier as
follows:

<w>rat tile:mons_giant_bat</w>

In tiles version, this would create a monster that uses the "<cyan>mons_giant_bat</cyan>"
tile, but is otherwise identical to a rat. In ASCII mode, this will do
nothing.

If you want to place a random monster suitable for the level the map is
generated on, you can use

<w>random</w>

If you want to place a random monster suitable for some other place, you can
use a place: tag in the monster spec:

<w>place:Abyss</w>

Using <w>place</w>: implies that you want a random monster. You can also request
zombies from random monsters suitable for some other depth as (e.g.):

<w>place:Elf:3 zombie</w>

The available modifiers are <w>zombie</w>, <w>draugr</w>, <w>simulacrum</w>, and <w>spectre</w>.

<h>Overriding Monster Names</h>

Individual monsters can be given names as follows:

<w>kobold name:Durwent</w>

This will cause the monster to appear as "<cyan>Durwent the kobold</cyan>". Spaces can be
placed in the name by substituting them with the _ symbol. It is worth noting
that "<cyan>the <<race></cyan>" will be appended to all names, which should be considered
when coming up with them.

There are three different modifiers that can be used on a name:
<w>name_adjective</w>, <w>name_suffix and </w>name_replace. <w>name_adjective</w> makes the
name act as an adjective. For example:

<w>kobold name:ugly name_adjective</w>

Will cause "<cyan>An ugly kobold</cyan>", "<cyan>The ugly kobold hits you</cyan>", and so on.

<w>name_suffix</w> does the same, but after the monster's base name:

<w>kobold name:wearing_mittens name_suffix</w>

Will give "<cyan>A kobold wearing mittens</cyan>", "<cyan>The kobold wearing mittens hits you</cyan>",
and so on.

<w>name_replace</w> causes the base name to be replaced by given name, as if the
monster was a unique:

<w>kobold name:Durwent name_replace</w>

Will result in "<cyan>Durwent</cyan>" rather than "<cyan>Durwent the kobold</cyan>". The corpse will
still be a "<cyan>kobold corpse of Durwent</cyan>".

<w>name_species</w> uses the name for corpses as-is, without prefixing it with
"<cyan>kobold</cyan> <cyan>corpse of X</cyan>" for <w>name_replace</w>. It also avoids the usual name tag
that displays above unique and renamed monsters in local tiles.

In combination with <w>name_replace</w> or <w>name_species</w>, there are two further tags
that can be used when renaming monsters, but not giving them an actual "name":
<w>name_descriptor</w>, and <w>name_definite</w>.

For example:

<w>kobold name:goblin name_replace</w>

Will result in "<cyan>goblin hits you</cyan>". However, adding <w>name_descriptor</w> from the
above flags will result in "<cyan>The goblin hits you</cyan>" and in the description of the
monster, "<cyan>A goblin</cyan>".

<w>kobold name:goblin name_replace name_descriptor</w>

The <w>name_definite</w> flag ensures that it is never referred to as "<cyan>a</cyan>" or "<cyan>an</cyan>",
but that the definite object is always used. Therefore, you will see "<cyan>The
<cyan>goblin</cyan> <cyan>hits you</cyan>", as per above, but also "<cyan>The goblin</cyan>" in its description.
Setting <w>name_definite</w> will automatically set the flag <w>name_descriptor</w>,
therefore meaning that:

<w>kobold name:goblin name_replace name_definite</w>

is exactly the same as:

<w>kobold name:goblin name_replace name_descriptor name_definite</w>

<w>name_zombie</w> can be used to redefine already zombified monsters (including
draugr, simulacra and spectrals).

Finally, <w>name_nocorpse</w> will cause the name to be completely ignored for
corpses. For example:

<w>wizard name:sad name_adjective name_nocorpse</w>

will result in "<cyan>a sad wizard</cyan>" that leaves "<cyan>a wizard corpse</cyan>".

For instances where space in definitions is limited, you can use abbreviated
forms of these tags:

* <w>name_suffix</w> -> <w>n_suf</w>
* <w>name_adjective</w> -> <w>n_adj</w>
* <w>name_replace</w> -> <w>n_rpl</w>
* <w>name_species</w> -> <w>n_spe</w>
* <w>name_descriptor</w> -> <w>n_des</w>
* <w>name_definite</w> -> <w>n_the</w>
* <w>name_zombie</w> -> <w>n_zom</w>
* <w>name_nocorpse</w> -> <w>n_noc</w>

<h>Overriding Monster Stats</h>

Further monster customisation can be made by using <w>hd</w> and <w>hp</w>. These two tags
allow you to completely overwrite the original hit dice and hit points of a
monster:

<w>kobold hd:20</w>

Creates a kobold with a hit dice of 20. As its hp is randomised, based on its
hit dice, this will also be re-rolled. Monsters with a specific hit point
value will not have this value change.

You can also have a specific value for hit points:

<w>kobold hp:20</w>

Creates a kobold with 20 hit points. This is also useful for monsters (such as
statues) which come with non-randomised HP values.

Monsters can be marked as summoned by using <w>dur</w> and <w>sum</w> tags. The <w>dur</w> tag
accepts an integer between 1 and 6 inclusive. The <w>sum</w> tag accepts the name of
a spell (parsed as per the <w>spells</w> tag, described below) or any of <w>clone</w>
(Rakshasa), <w>animate</w> (from animate dead), <w>chaos</w> (made from pure chaos), <w>miscast</w>
(summoned from by spell miscast effect), <w>zot</w> (summoned by a Zot trap), <w>wrath</w>
(summoned by a god in an act of retribution), <w>aid</w> (summoned by a god in order
to give aid).

Of the spells, <w>shadow_creatures</w> has the most significant effect, in that
monsters will dissipate into the shadows rather than disappear in a puff of
smoke. Using non-summoning spells will also have no effect.

Tagging a monster with <w>seen</w> will override the system and force that monster to
be marked as already viewed; this means that it won't generate messages such
as "<cyan>A kobold comes into view</cyan>".

<h>Overriding Monster Spells</h>

Monster spell sets can be overridden with a <w>spells</w>: tag, used as follows:

*<w>goblin spells:throw_flame.50.wizard</w>
*<w>ancient lich spells:symbol_of_torment.26.wizard; glaciate.51.wizard</w>

(a list of spell slots, consisting of a spell name with spaces replaced with
underscores, a frequency of casting and set of spell slot flags specified
afterwards with <w>.</w>, with slots separated by <w>;</w>. There should be no spaces around
the <w>;</w> or after the <w>spells</w>: prefix)

Spell names must exactly match the names in <cyan>spl-data.h</cyan>, with spaces replaced
by underscores. Spell frequencies are an (x in 200) chance that that spell
will be cast. Spell flags include:

* <w>natural</w>, <w>magical</w>, <w>demonic</w>, <w>wizard</w>, or <w>priest</w> - the manner in which this
spell is being cast. Wizards and priests can be silenced and will trigger
appropriate conducts (Trog will appreciate killing wizards, Beogh will
appreciate killing priests). Magical, demonic, and wizard spells are subject
to anti-magic effects. Natural spells do not generate noise.
* <w>emergency</w> - the monster will only cast the spell when low on health.
* <w>breath</w> - the spell is a breath weapon, and using it triggers a breath
timeout during which the spell cannot be cast again.
* <w>no_silent</w> - the spell cannot be used while silent, even if it is an ability
type normally not subject to silence.
* <w>instant</w> - the spell does not expend the monster's energy; they may take
another action on the same turn.
* <w>noisy</w> - forces the spell to make noise even if it is a natural ability.

You may use <w>none</w> specify that a slot should be left empty. You can force a
spell-less monster with:

<w>orc wizard spells:none</w>

<h>Setting enchantments</h>

You may give a monster any number of enchantments. It may start hasted, blind,
have permanent RMsl, etc. The syntax is <w>ench:<<name>:<<duration>:<<degree></w> or
<w>perm_ench:<<name>:<<degree></w>. The <w><<degree></w> and <w><<duration></w> fields may be
omitted.

For example:

* <w>orc perm_ench:blind perm_ench:mad</w>
* <w>dream sheep ench:sticky_flame</w>
* <w>stone giant dur:1 ench:berserk</w>

%%%%
macro-menu

<h>Editing macros and keymaps</h>

To edit a current macro/keymap, select from the menu using the arrow keys or
by hotkey. (Hotkeys that are used to navigate the menu can be selected by
arrow keys). To create a new mapping by entering a key, use the [<w>~</w>] key
or the corresponding menu item, and then enter the key. This allows you to
create (and edit) mappings that use menu keys. Use the [<w>!</w>] key to switch
to keymap editing mode (see below for more information on keymaps).

<w>Macros</w> allow remapping keys that are sent to the game when inputting
commands. This can be used to redefine a command key, or to define an unused
key. They map a key to a sequence of keystrokes, and keystrokes do carry over
into submenus.

Example 1: mapping <w>e</w> to <w>p</w> would let the `e` key trigger the same
command as the `p` key (which on the default settings is autofire).

Example 2: mapping <w>1</w> to the sequence <w>zaf</w> would let the `1` key
cast a spell that is on the letter `a` with default targeting.

Example 3: mapping <w>F1</w> to <w>Q&a</w> would let the F1 key quiver the spell
that is on letter `a`.

<w>Keymaps</w> are lower-level key substitutions that replace keys entirely with
a sequence of keystrokes. They are recommended for changing keys uniformly to
deal with alternative keyboard layouts. Keymaps are contextual, and the
default/"regular" context is used anywhere that a non-specialised context is not
active. Macros take the result of keymaps as input.

Example: In some European keyboard layouts, the § symbol replaces ~. Therefore,
it could be useful to keymap § to ~ in both the regular and menu keymap contexts
so that the main menu and macro menu become a bit easier to access. (In other
layouts, this applies instead to ½.)

When used for mapping commands, keymaps can have unexpected side effects: e.g.
mapping <w>1</w> to <w>zaf</w> via keymap is not recommended, because this will
make it hard to type `1` when entering a skill target.

<w>Keycodes</w>: Both macros and keymaps accept keycodes when describing the
action, in the form of <w>\{n}</w> to enter keycode <w>n</w>. (Use <w>\\</w> to
enter a backslash.) For example, use <w>\{9}</w> to enter the keycode for the
<w>tab</w> button. You can bind macros and keymaps by keycode by using <w>~~</w>
at the macro edit menu.

<w>Saving</w>: Bindings edited at this menu are saved in a .macro file in your
save directory. They will be overridden by settings in your options file. See
the `macro` command in options_guide.txt for more information.

%%%%
console-keycodes

<h>Keycodes for console and webtiles</h>

Keycodes can be entered as numbers, or in some cases, human readable strings.
The following tables give both the numeric keycode, and the string; modified
keys generally must be entered by number. When entering a keycode  as part of a
macro action, it should be wrapped using the following syntax for keycode n:
<w>\{n}</w>. This should also be used when defining a keycode by number in your
rc file. Example: when defining a macro that triggers F1, you can write
"\{F1\}" or "\{-265}". For named keys as part of a macro definition, the \{}
may be omitted.

Positive numeric values are ASCII character codes. Negative values are
crawl-internal keycodes for special keys. The sign is required for these to
be interpreted correctly. Keyboards vary quite a bit, and so not all of these
bindings are available on all keyboards; cases where there is often variation
are indicated specifically below.

The following is a quick-reference for some of the main keys you might want to
bind.

<w>8</w>: Backspace (and/or Delete, depending on keyboard)
<w>9</w>: Tab
<w>13</w>: Enter (and/or the Return key, depending on keyboard)
<w>27</w>: Esc

<w>-233</w>: Shift-Tab
<w>-222</w>: Ctrl-Tab (on some keyboards)
<w>-255</w>: Delete (on some keyboards)
<w>-265</w>: F1   <w>-264</w>: F2   <w>-263</w>: F3   <w>-262</w>: F4   <w>-261</w>: F5
<w>-260</w>: F6   <w>-259</w>: F7   <w>-258</w>: F8   <w>-257</w>: F9   <w>-256</w>: F10

Keycodes up to F22 are defined, but may not work on all builds. (On webtiles,
F11 and F12 are reserved.)

<w>Number pad and navigation keys:</w>

On many keyboards, <w>numlock</w> switches between the number keys and
navigation keys. Modifiers for these keys may not work on all keyboards. When
modified number pad keys do work, Shift and Ctrl typically treats those keys as
modified navigation keys regardless of numlock status.

Navigation keys:

<w>-245</w>: PgDn    <w>-234</w>: Shift-PgDn    <w>-223</w>: Ctrl-PgDn
<w>-246</w>: PgUp    <w>-235</w>: Shift-PgUp    <w>-224</w>: Ctrl-PgUp
<w>-247</w>: Clear   <w>-236</w>: Shift-Clear   <w>-225</w>: Ctrl-Clear
<w>-248</w>: End     <w>-237</w>: Shift-End     <w>-226</w>: Ctrl-End
<w>-249</w>: Home    <w>-238</w>: Shift-Home    <w>-227</w>: Ctrl-Home
<w>-250</w>: Insert  <w>-239</w>: Shift-Insert  <w>-228</w>: Ctrl-Insert
<w>-251</w>: Right   <w>-240</w>: Shift-Right   <w>-229</w>: Ctrl-Right
<w>-252</w>: Left    <w>-241</w>: Shift-Left    <w>-230</w>: Ctrl-Left
<w>-253</w>: Down    <w>-242</w>: Shift-Down    <w>-231</w>: Ctrl-Down
<w>-254</w>: Up      <w>-243</w>: Shift-Up      <w>-232</w>: Ctrl-Up

Number pad keys:

<w>-1007</w>: NP7   <w>-1008</w>: NP8   <w>-1009</w>: NP9
<w>-1004</w>: NP4   <w>-1005</w>: NP5   <w>-1006</w>: NP6
<w>-1001</w>: NP1   <w>-1002</w>: NP2   <w>-1003</w>: NP3
<w>-1000</w>: NP0
<w>-1010</w>: NPenter
<w>-1012</w>: NP/   <w>-1015</w>: NP*   <w>-1016</w>: NP+   <w>-1018</w>: NP-
<w>-1019</w>: NP.   <w>-1021</w>: NP=

Some number pad punctuation keys may not be distinguished from their "regular"
counterparts, again depending on keyboard and build.
