%%%%
welcome

<white>Welcome to Dungeon Crawl!</white>

Your objective is to lead a <w>{{ return you.race() }} {{ return you.class()
}}</w> safely through the depths of the dungeon, retrieving the fabled Orb of
Zot and returning it to the surface. In the beginning, however, let discovery
be your main goal. Try to delve as deeply as possible but beware; death lurks
around every corner.

For the moment, just remember the following keys and their functions:
  <white>$cmd[CMD_DISPLAY_COMMANDS]?</white> - shows the items and the commands
  <white>$cmd[CMD_SAVE_GAME]</white>  - saves the game, to be resumed later
(but note that death is permanent)
  <white>$cmd[CMD_LOOK_AROUND]</white>  - examines something in your vicinity

The hint mode will help you play Crawl without reading any documentation. If
you haven't yet, you might want to try out the tutorial. Also, if you feel
intrigued, there is more information available in the following files from the
docs/ directory (all of which can also be read in-game):
  <lightblue>quickstart.txt</lightblue>     - A very short guide to Crawl.
  <lightblue>crawl_manual.txt</lightblue>   - This contains all details on
species, magic, skills, etc.
  <lightblue>options_guide.txt</lightblue>  - Crawl's interface is highly
configurable. This document explains all the options.

Happy Crawling!
%%%%
death

Condolences! Your character's premature death is a sad, but common occurrence
in Crawl. Rest assured that with diligence and playing experience your
characters will last longer.

Perhaps the following advice can improve your playing style:
%%%%
death conjurer melee

As a Conjurer your main weapon should be offensive magic. Cast spells more
often! Remember to rest when your Magic is low.
%%%%
death berserker unberserked

Don't forget to go berserk when fighting particularly difficult foes. It's
risky, but makes you faster and beefier.
{{
  if you.hunger() < 3
    then return "Berserking is impossible while very hungry or worse, " ..
                "so make sure to stay fed at all times, just in case " ..
                "you need to berserk." end
}}
%%%%
death ranger melee

Your bow and arrows are extremely powerful against distant monsters. Be sure to
collect all arrows lying around in the dungeon.
%%%%
death random 0

Always consider using projectiles, wands or spells before engaging monsters in
close combat.
%%%%
death random 1

Learn when to run away from things you can't handle — this is important! It is
often wise to skip a particularly dangerous level. But don't overdo this as
monsters will only get harder the deeper you delve.
%%%%
death random 2

Rest between encounters, if possible in an area already explored and cleared of
monsters. In Crawl, searching and resting are one and the same. To search for
one turn, press <w>s</w>, <w>.</w>, <w>delete</w> or <w>keypad-5</w>. Pressing
<w>5</w> or <w>shift-and-keypad-5</w> <tiles>, or <w>clicking into the stat
area</w></tiles> will let you rest for a longer time (you will stop resting
after 100 turns, or when fully healed).
%%%%
death random 3

Remember to use those scrolls, potions or wands you've found. Very often, you
cannot expect to identify everything with the scroll only. Learn to improvise:
identify through usage.
%%%%
death random 4

If a particular encounter feels overwhelming don't forget to use emergency
items early on. A scroll of teleportation or a potion of speed can really save
your bacon.
%%%%
death random 5

Never fight more than one monster, if you can help it. Always back into a
corridor so that they are forced to fight you one on one.
%%%%
finished

Congrats! You survived until the end of the hint mode — be sure to try the
other ones as well. Note that the command help screen
(<w>$cmd[CMD_DISPLAY_COMMANDS]?</w>) will look very different from now on.
Here's a last playing hint:
%%%%
finished explored

Walking around and exploring levels gets easier by using auto-explore
(<w>$cmd[CMD_EXPLORE]</w>). Crawl will let you automatically move to and pick
up interesting items. <tiles>

Autoexploration can also be started by <w>left-clicking</w> on the minimap
while the <w>Control</w> key is pressed.</tiles>
%%%%
finished travel

There is a convenient way for travelling between far away dungeon levels: press
<w>$cmd[CMD_INTERLEVEL_TRAVEL]</w> or <w>G</w> and enter the desired
destination. If your travel gets interrupted, issuing
<w>$cmd[CMD_INTERLEVEL_TRAVEL] Enter</w> or <w>G Enter</w> will continue it.
%%%%
finished stashes

You can search among all items existing in the dungeon with the
<w>$cmd[CMD_SEARCH_STASHES]</w> command. For example,
<w>$cmd[CMD_SEARCH_STASHES] "knife"</w> will list all knives. You can then
travel to one of the spots. It is even possible to enter words like
<w>"shop"</w> or <w>"altar"</w>.
%%%%
finished random 0

The game keeps an automated logbook for your characters. Use
<w>$cmd[CMD_DISPLAY_COMMANDS]:</w> to read it. You can enter notes manually
with the <w>$cmd[CMD_MAKE_NOTE]</w> command. Once your character perishes, two
morgue files are left in the <w>morgue/</w> directory. The one ending in .txt
contains a copy of your logbook. During play, you can create a dump file with
<w>$cmd[CMD_CHARACTER_DUMP]</w>.
%%%%
finished random 1

Crawl has a macro function built in: press <w>~m</w> to define a macro by first
specifying a trigger key (say, <w>F1</w>) and a command sequence, for example
<w>za+.</w>. The latter will make the <w>F1</w> key always zap the spell in
slot a at the nearest monster. For more information on macros, type
<w>$cmd[CMD_DISPLAY_COMMANDS]~</w>.
%%%%
finished random 2

The interface can be greatly customised. All options are explained in the file
<w>options_guide.txt</w> which can be found in the <w>docs</w> directory. The
options themselves are set in <w>init.txt</w> or <w>.crawlrc</w>. Crawl will
complain if it can't find either file.
%%%%
finished random 3

You can ask other Crawl players for advice and help on the <w>##crawl</w> IRC
(Internet Relay Chat) channel on freenode (<w>irc.freenode.net</w>).
%%%%
dissection reminder

If you don't want to eat it, consider offering this corpse up under
<w>p</w>rayer as a sacrifice to {{ return you.god() }}<tiles>. You can also
chop up any corpse that shows in the floor part of your inventory tiles by
clicking on it with your <w>left mouse button</w></tiles>. Whenever you view a
corpse while in hint mode you can reread this information.
%%%%
HINT_CONVERT Xom

You've just converted to worshipping <w>Xom</w>. You can keep Xom happy by
keeping him amused; you do absolutely not want this god to grow bored with you!

If you keep Xom amused he'll treat you like a plaything, randomly helping and
harming you for his own amusement; otherwise he'll treat you like a disfavoured
plaything.
%%%%
HINT_CONVERT

#
# Not the case for Chei, but not sure if we need to go into that much
# detail here.
#
You've just converted to worshipping <w>{{ return you.god() }}</w>. Your piety
(divine favour) will gradually decrease over time, and if it runs out {{ return
you.god() }} will excommunicate you and punish you. You can prevent this,
however, and even gain enough piety to get powers and divine gifts, by doing
things to please {{ return you.god() }}. But don't panic: you start out with a
decent amount of piety, so any danger of excommunication is far off.

You can check your god's likes and dislikes, as well as your current standing
and divine abilities, by typing <w>^</w><tiles> (alternatively press
<w>Shift</w> while <w>right-clicking</w> on your avatar)</tiles>.
%%%%
HINT_SEEN_FIRST_OBJECT

That <console>$1 </console>is an item. If you move there and press <w>g</w> or
<w>,</w> you will pick it up.<console> Generally, items are shown by non-letter
symbols like <w>%?!"=()[</w>.</console><tiles> You can also pick up an item by
clicking on your <w>left mouse button</w> while standing on its square.</tiles>
Also, several types of objects will usually be picked up automatically.
<tiles>(In Tiles, these will be marked with a green frame around them.)</tiles>

Once it is in your inventory, you can drop it again with <tiles>a <w>left mouse
click</w> while pressing the <w>Shift key</w>. Whenever you <w>right-click</w>
on an item</tiles><console><w>d</w>. Any time you look at an item in your
<w>i</w>nventory</console>, you can read about its properties and its
description.
%%%%
