From 4a4e24a9cefa6bef6f2f23525ebd88042a3973eb Mon Sep 17 00:00:00 2001 From: dploog Date: Sun, 6 Jul 2008 00:16:09 +0000 Subject: Added three printable files (contact, key changes, quickstart) and put them into the new pdf/ directory. The corresponding tex files are in source/utils/ (feel free to rename the files, or move them to better locations). git-svn-id: https://crawl-ref.svn.sourceforge.net/svnroot/crawl-ref/trunk@6416 c06c8d41-db1a-0410-9941-cceddc491573 --- crawl-ref/pdf/contact.pdf | Bin 0 -> 43741 bytes crawl-ref/pdf/key_changes.pdf | Bin 0 -> 43999 bytes crawl-ref/pdf/quickstart.pdf | Bin 0 -> 59294 bytes crawl-ref/source/util/contact.tex | 146 +++++++++++++++++++++ crawl-ref/source/util/key_changes.tex | 111 ++++++++++++++++ crawl-ref/source/util/quickstart.tex | 236 ++++++++++++++++++++++++++++++++++ 6 files changed, 493 insertions(+) create mode 100644 crawl-ref/pdf/contact.pdf create mode 100644 crawl-ref/pdf/key_changes.pdf create mode 100644 crawl-ref/pdf/quickstart.pdf create mode 100644 crawl-ref/source/util/contact.tex create mode 100644 crawl-ref/source/util/key_changes.tex create mode 100644 crawl-ref/source/util/quickstart.tex diff --git a/crawl-ref/pdf/contact.pdf b/crawl-ref/pdf/contact.pdf new file mode 100644 index 0000000000..7455d45de2 Binary files /dev/null and b/crawl-ref/pdf/contact.pdf differ diff --git a/crawl-ref/pdf/key_changes.pdf b/crawl-ref/pdf/key_changes.pdf new file mode 100644 index 0000000000..c439fd607a Binary files /dev/null and b/crawl-ref/pdf/key_changes.pdf differ diff --git a/crawl-ref/pdf/quickstart.pdf b/crawl-ref/pdf/quickstart.pdf new file mode 100644 index 0000000000..43ffcff327 Binary files /dev/null and b/crawl-ref/pdf/quickstart.pdf differ diff --git a/crawl-ref/source/util/contact.tex b/crawl-ref/source/util/contact.tex new file mode 100644 index 0000000000..9b158810c4 --- /dev/null +++ b/crawl-ref/source/util/contact.tex @@ -0,0 +1,146 @@ +\documentclass[a4paper,10pt]{article} + +\usepackage{palatino} +\usepackage{mathpazo} % optional [sc] fuer real small caps +\usepackage[left=3cm,top=3cm,right=3cm,bottom=2cm,nohead,nofoot]{geometry} + +\usepackage{graphicx} + +\newcommand{\key}[1]{{{\texttt{\textbf{#1}}}}} % this does nasty things to underscores +\newcommand{\sex}[1]{{{\textbf{#1}}}} % \sec already defined + +\newcommand{\crawl}{\textsc{Crawl}} +\newcommand{\dungeon}{\textsc{Dungeon}} + +\newcommand{\spacecolumn}{\begin{minipage}[t]{2cm}\phantom{xxxx}\end{minipage}} +\newcommand{\para}{\vspace{1.5ex}} +\setlength{\parindent}{0em} + +\newcommand{\mc}[1]{\multicolumn{2}{l}{#1}} + +\newcounter{abccounter} +\newenvironment{abcliste}{\begin{list}{(\alph{abccounter})} + {\usecounter{abccounter} + \setlength{\topsep}{0ex} + \setlength{\partopsep}{0ex} + \setlength{\listparindent}{0ex} + \setlength{\itemsep}{0ex} + \setlength{\parsep}{0ex} + \setlength{\leftmargin}{2em} + \setlength{\labelwidth}{2em} + \setlength{\parskip}{0ex} + } + }{\end{list}} + +\pagestyle{empty} + +\begin{document} + + +\begin{center}\textbf{\LARGE +\dungeon\ \crawl: Files and Contact +}\end{center} + +This is the reference sheet for the roguelike game \dungeon\ \crawl, +specifically for the current version of the \textsc{Stone Soup} branch. +\crawl\ is a game of dungeon exploration, fighting and magic that is +renowned for its intricate skills and religion systems. Success requires +tactics, strategy, and perseverance. Though \crawl's reputation is +close to devilish, victories were reported\dots + +\para + +This page explains the various important files. The next page lists a +number of important changes introduced in version 0.4. The last two +pages give a very brief introduction to the game, which should be +enough to get you started. If you are completely new to this type of +game and still want to plunge right in, start up a new game and select +a tutorial (press \key{T} when asked for a species). + +\para\para + +\sex{The most important files} + +\para + +\begin{minipage}[t]{7cm} +The file \key{crawl.exe} in \crawl's main folder starts the game. +\\ \\ +The \sex{settings/} directory contains \key{init.txt}, the options file for +\crawl\ (on linux systems there may also be a \key{.crawlrc} in your home +directory). Since the defaults are well suited for playing, you can ignore +these at first. +\\ +This folder also contains \key{macro.txt}, a list of redefined key +bindings and macros. These make playing \crawl\ even more convenient. +You will probably not need to redefine key mappings until after you have +spent some time playing the game. +\end{minipage} +% +\spacecolumn +% +\begin{minipage}[t]{7cm} +The following files in the \sex{docs/} directory may be helpful: +\\ +\key{crawl\_manual.txt} is the full manual. It explains all races, classes, +item types etc. If you do not delight in manuals, you can put off the +reading this file until later. You can browse the manual while playing +(press \key{?}). +\\ +\key{options\_guide.txt} describes all the options in minute detail. While +tweaking these can improve your \crawl\ experience, you will probably prefer +to skip this at first. +\\ +\key{crawl\_macros.txt} explains macros and key bindings. You should probably +ignore this at first, too. + % (Unless you experience serious problems with some keys, in which case should + % look at the keymaps section.) +\end{minipage} + +\para\para + +\sex{Contact} + +\para + +If you have questions concerning the game, or think you have found a bug, +there are several places to contact the developers. First, there is the +newsgroup \key{rec.games.roguelike.misc}. Since other games are +discussed there as well, it is polite to flag your post with \key{-crawl-}. +If you are not familiar with Usenet netiquette, you might want to check +that first, too. +Also try to maintain netiquette to the benefit of your addresses. +\\ +Next, you are encouraged to file bug reports and feature requests on the +\crawl\ homepage at \key{http://crawl-ref.sourceforge.net}. From there, you +can also download the most recent version (both binaries or source, for +Unix, Windows, OS X, and DOS). +\\ +Finally, you can use the mailing list +\key{crawl-ref-discuss@lists.sourceforge.net} +to discuss specific details of the game's design and implementation. + +\para \para + +\sex{Internet play} + +\para + +You can play \crawl\ online, both competing with other players and watching +them. Check the homepage \key{crawl.akrasiac.org} for details, including +information about additional servers. You just need a \texttt{ssh} or +\texttt{telnet} console; on Windows, the \texttt{PuTTY} program works very +well. Read \key{ssh\_guide.txt} in the \key{docs} folder for a step by step +guide on how to set this up. + +\para \para + +\sex{Tiles} + +\para + +\crawl\ features an alternative to the classical ASCII display; Tile-based +Crawl is often easier accessible by new players. Tiles are available for +Linux, Windows and OS X. +Unfortunately, it is not yet possible to combine tiles and internet play. +\end{document} diff --git a/crawl-ref/source/util/key_changes.tex b/crawl-ref/source/util/key_changes.tex new file mode 100644 index 0000000000..b19b9c6928 --- /dev/null +++ b/crawl-ref/source/util/key_changes.tex @@ -0,0 +1,111 @@ +\documentclass[a4paper,10pt]{article} + +\usepackage{palatino} +\usepackage{mathpazo} % optional [sc] fuer real small caps +\usepackage[left=3cm,top=3cm,right=3cm,bottom=2cm,nohead,nofoot]{geometry} + +\usepackage{graphicx} + +\newcommand{\key}[1]{{{\texttt{\textbf{#1}}}}} % this does nasty things to underscores +\newcommand{\sex}[1]{{{\textbf{#1}}}} % \sec already defined + +\newcommand{\crawl}{\textsc{Crawl}} +\newcommand{\dungeon}{\textsc{Dungeon}} + +\newcommand{\spacecolumn}{\begin{minipage}[t]{2cm}\phantom{xxxx}\end{minipage}} +\newcommand{\para}{\vspace{1.5ex}} +\setlength{\parindent}{0em} + +\newcommand{\mc}[1]{\multicolumn{2}{l}{#1}} + +\newcounter{abccounter} +\newenvironment{abcliste}{\begin{list}{(\alph{abccounter})} + {\usecounter{abccounter} + \setlength{\topsep}{0ex} + \setlength{\partopsep}{0ex} + \setlength{\listparindent}{0ex} + \setlength{\itemsep}{0ex} + \setlength{\parsep}{0ex} + \setlength{\leftmargin}{2em} + \setlength{\labelwidth}{2em} + \setlength{\parskip}{0ex} + } + }{\end{list}} + +\pagestyle{empty} + +\begin{document} + +\begin{center}\textbf{\LARGE +\dungeon\ \crawl: Important changes in 0.4 +}\end{center} + +In DCSS 0.4, for better ergonomics, many key bindings were changed. Also, +a small number of new commands were introduced. The tables below list all +of these. If you have been playing an older version and want to restore +the old key set, do so by adding this line to the +\texttt{init.txt} file: \\ +\texttt{additional\_macro\_file = 034\_command\_keys.txt} + +\para + +The command for examining items (was \key{v}) is gone. Bring up the +inventory and press the key matching an item's slot in order to examine it. + +When chopping up a single corpse on the ground, there is no longer any +prompt. You will only be prompted if there are two or more corpses. When +answering this prompt, you can use the following shortcuts: \key{c} means +yes, so you can press \key{cccc}\dots to chop up all corpses in one place, +or you can just hit \key{a} to butcher of corpses on a square. + +The \key{* Direction} and \key{Ctrl-Direction} keys now both open and close +doors. + +\para\para + +\begin{center} +\begin{tabular}{lll} +key & new command \\ \hline +\key{\_} & \mc{read message (only used for online play)} \\ +\key{!} & \mc{annotate level (read annotations with \key{Ctrl-O};} \\ + & \mc{annotations with an ! prompt when entering the level)} \\ +\key{(} & \mc{cycle ammunition} \\ +\key{Q} & \mc{quiver item} \\ +\key{`} & \mc{redo previous command} \\ +\key{0} & \mc{repeat next command} \\ +\key{Ctrl-T} & \mc{toggle ally pickup mode (only for permanent allies)} \\ +\key{Ctrl-D} & \mc{add macro (a new synonym for \key{$\sim$})} \\ +\\ +\\ +new key & command & old key \\ \hline +\key{G} & auto-travel & was \key{Ctrl-G} \\ +\key{z} & cast spell & was \key{Z} \\ +\key{Z} & zap wand & was \key{z} \\ +\key{o} & auto-explore & was \key{Ctrl-O} \\ +\key{Ctrl-O} & dungeon overview\phantom{xxx} & was \key{O} \\ +\key{O} & open door & was \key{o} \\ +\key{C} & close door & was \key{c} \\ +\key{c} & chop up & was \key{D}, dissect \\ +\key{E} & show experience & was \key{C} \\ +\key{v} & evoke & was \key{E} \\ +\key{F} & manually throw & was \key{t} \\ +\key{t} & tell/yell & was \key{!} \\ +\key{Ctrl-V} & Tiles settings & was \key{Ctrl-Q} \\ +\key{Ctrl-Q} & quit & was \key{Q} +\end{tabular} +\end{center} + +There are additional changes to the targeting interface: \\ +The functions of \key{!} and \key{.} have been swapped. So firing with +\key{.} will now stop at the target, whereas \key{!} will shoot further +if the target was missed (and \key{Enter}, \key{Del}, \key{Space} still +behave as in 0.3.4). \\ +You can now target using the monster list as well; \key{Ctrl-L} toggles +this option.\\ +You may quiver an item, meaning that you will preferably fire this +ammunition (and keep doing so even if you run out of it temporarily). +Quivering is done via \key{Q} (quiver the currently fired item) or +\key{fi} (choose an item and quiver it) or also by using \key{(} (cycling +appropriate ammunition) and then firing. \key{F} also lets you select an +item to be thrown, but this command does not affect the quiver. +\end{document} diff --git a/crawl-ref/source/util/quickstart.tex b/crawl-ref/source/util/quickstart.tex new file mode 100644 index 0000000000..ac28e17b70 --- /dev/null +++ b/crawl-ref/source/util/quickstart.tex @@ -0,0 +1,236 @@ +\documentclass[a4paper,10pt]{article} + +\usepackage{palatino} +\usepackage{mathpazo} % optional [sc] fuer real small caps +\usepackage[left=3cm,top=3cm,right=3cm,bottom=2cm,nohead,nofoot]{geometry} + +\usepackage{graphicx} + +\newcommand{\key}[1]{{{\texttt{\textbf{#1}}}}} % this does nasty things to underscores +\newcommand{\sex}[1]{{{\textbf{#1}}}} % \sec already defined + +\newcommand{\crawl}{\textsc{Crawl}} +\newcommand{\dungeon}{\textsc{Dungeon}} + +\newcommand{\spacecolumn}{\begin{minipage}[t]{2cm}\phantom{xxxx}\end{minipage}} +\newcommand{\para}{\vspace{1.5ex}} +\setlength{\parindent}{0em} + +\newcommand{\mc}[1]{\multicolumn{2}{l}{#1}} + +\newcounter{abccounter} +\newenvironment{abcliste}{\begin{list}{(\alph{abccounter})} + {\usecounter{abccounter} + \setlength{\topsep}{0ex} + \setlength{\partopsep}{0ex} + \setlength{\listparindent}{0ex} + \setlength{\itemsep}{0ex} + \setlength{\parsep}{0ex} + \setlength{\leftmargin}{2em} + \setlength{\labelwidth}{2em} + \setlength{\parskip}{0ex} + } + }{\end{list}} + +\pagestyle{empty} + +\begin{document} + +\begin{center}\textbf{\LARGE +\dungeon\ \crawl: Very short introduction} +\end{center} + +Crawl is a large and very random game of subterranean exploration in a fantasy +world of magic and frequent violence. Your quest is to travel into the depths +of the Dungeon (which is different each time you play) and retrieve the Orb of +Zot. + +\para + +Crawl is a game of the 'roguelike' type, one of the descendants of Rogue. Its +graphics are simple but highly informative, designed to be understood at a +glance, and control is exercised largely through one-keystroke commands. + +\para\para + +\sex{Starting Out} \para + +After starting the program you will be greeted with a message asking for your +name. Don't spend too much time over this, as your first character will +\emph{not} last very long (sorry, but it's true). + +\para + +Next you are given menus of species and character classes from which to +choose. A dwarf, orc, ogre, or troll Fighter is a good bet. Elves are quite +fragile, humans are pretty average at everything, and the weirder species are +mostly too tricky for beginning players. Finally, you may be given a choice of +weapons. I suggest an axe (axes are fun). + +\para + +\begin{minipage}{10cm} +Now you are in the game. The game screen has three parts: \\ +The \textbf{Map} takes up the upper left part of the screen. In its very +centre is the \key{@} sign which represents You. The coloured parts of the map +is the area you can see, while places that you have visited before but cannot +currently see are shown in grey. \\ +The \textbf{Message box} is the large part of the screen below the map. It +describes all events as they happen. \\ +The \textbf{Stats area} contains information about your character. +\end{minipage} +\begin{minipage}{1cm} +\phantom{xx} +\end{minipage} +\begin{minipage}{4cm} +\includegraphics[scale=0.4]{screen} +\end{minipage} +\para\para + +\sex{Exploring} \para + +Try walking around, using either the numeric keypad (try numlock off and on) +or the \key{hjklyubn} keys. To move in a given direction until you reach +something interesting or see a hostile creature, press \key{Shift-direction}. + +If you want to know what a certain character on the screen represents, use the +\key{x} (examine) command to get a short description. Climb staircases with +the \key{<} (up) and \key{>} (down) commands. Doors are opened simply by +moving into them. Sometimes doors are hidden, and must be searched out by +standing next to walls and resting (a number of commands do the same thing: +\key{5} or \key{Shift-numpad-5} rest/search for a while, whereas \key{s} and +\key{.} (period) do so for just a single turn). + +The Dungeon gets more dangerous (but more interesting!) as you go down. If you +get lost, you can access a map of the whole level you are on with the \key{X} +command, which uses the whole screen. + +\para\para + +\sex{Items} \para + +After walking around for a while, you will no doubt come across some items +laying around (you may come across some monsters as well; for help in dealing +with them skip to the Monsters section). This table lists the most basic item +types that appear and typical commands to use them: + +\para + +\begin{tabular}{cll} +\sex{Symbol} & \sex{Item type (typical commands)} & \sex{Comments} \\ +\key{(} & Weapons (\key{w}ield) & Move into monsters to attack them.\\ +\key{)} & Missiles (\key{f}ire) & Wield a bow to fire arrows. Press \key{f?} for help.\\ +\key{[} & Armour (\key{W}ear and \key{T}ake off) & Can be cursed, like weapons and jewellery. \\ +\key{\%} & Food, corpses (\key{e}at and \key{c}hop up) & Dangerous chunks are coloured. \\ +\key{\$} & Gold & There are shops down below. \\ +\key{?} & Scrolls (\key{r}ead) & Scrolls mostly affect your environment.\\ +\key{!} & Potions (\key{q}uaff) & Potions affect you, in good or bad ways. \\ +\key{=} & Rings (\key{P}ut on and \key{R}emove) & Rings can be helpful as well as malignant. \\ +\key{"} & Amulets (\key{P}ut on and \key{R}emove) & Amulets can be even subtler than rings. \\ +\key{/} & Wands (\key{Z}ap) & Identify these by zapping at monsters. \\ +\key{+} & Books (\key{r}ead, \key{M}emorise and \key{z}ap) & Press \key{z?} for information on spells.\\ +\key{$\backslash$} & Staves and rods (\key{w}ield and e\key{v}oke) \hspace{0.2em} + & Rods carry spells but they are very rare. +%\key{\}} & Miscellaneous items (e\key{v}oke) & These will turn up only later. \\ +\end{tabular} + +\para + +Some vital commands are given next. For a full list of commands, press \key{??}. +Don't be scared by the abundance of commands, you will only need a handful at +the beginning. + +\para + +\begin{minipage}[t]{7cm} +\sex{Most basic commands for new players} \\ +\key{i} lists inventory \\ +\key{d} drops items \\ +\key{g} or \key{,} pick up items from the ground \\ +\key{gg} or \key{,,} for pickup menu \\ +\key{x} examines a seen monster (has help on \key{?}) \\ +\key{X} looks at the whole level (has help on \key{?}) \\ +\key{>} goes deeper one level \\ +\key{S} saves the game \\ +\key{?} prints the help screen +\end{minipage} +% +\spacecolumn +% +\begin{minipage}[t]{7cm} +\sex{Somewhat advanced commands} \\ +\key{p} prays (press \key{\^} for god information) \\ +\key{Ctrl-P} shows previous messages \\ +\key{Ctrl-F} searches for items dungeon-wide \\ +\key{G} provides automated travel between levels \\ +\key{o} provides automated exploration \\ +\key{\#} dumps character to the file \texttt{name.txt} \\ +\key{=} reassigns inventory or spell letters \\ +\key{m} checks your current skills \\ +\key{Ctrl-D} saves macros and key maps +\end{minipage} + +\para + +You will often want to get information on a particular item. If it is on the +ground, use the \key{x} command. If it is in your inventory, press \key{i}, +followed by the item's slot key. + +\para\para + +\sex{Monsters} \para + +You will also run into monsters (most of which are represented by letters of +the alphabet). You can attack a monster by trying to move into the square it +is occupying. +When you are wounded, you lose Health (displayed near the top of the stats +list); these return gradually over time through the natural process of +healing. If you lose all of your Health, you die. +To survive, you will need to develop a few basic tactics: \\ + +\begin{minipage}{7cm} +\begin{abcliste} +\item[$\bullet$] + Never fight more than one monster at a time if you can help it. Back + into a corridor so that they fight you one-on-one. +\item[$\bullet$] + If you are badly wounded, you can run away from monsters to buy some time. + Try losing them in corridors, or as a very last resort find a place where + you can run around in circles to heal while the monster chases you. +\end{abcliste} +\end{minipage} +\spacecolumn +\begin{minipage}{7cm} +\begin{abcliste} +\item[$\bullet$] + Remember to use projectiles before engaging monsters in close combat. +\item[$\bullet$] + Rest between encounters. Pressing \key{Shift-numpad-5} or \key{5} make + you rest for a while (you will stop resting when fully healed). +\item[$\bullet$] + Learn when to run away from things you can't handle --- this is important! + Often, it is wise to skip a dangerous level. +\end{abcliste} +\end{minipage} + + +\para\para + +\sex{Death} \para + +Before long, you'll probably end up dead. +Death in Crawl is permanent; you cannot just reload a saved game and start again +where you left off. The \key{S} (save) command exists only to let you leave a game +part-way through and come back to it later. + +\para + +Well, that's it for the quick-start guide. This should help you through your +first few games, but Crawl is extremely (some would say excessively) complex +and cannot be adequately described in so short a document. So when you feel +ready to start playing with magic, skills, and religions, browse the manual. + +\para + +Happy Crawling! +\end{document} -- cgit v1.2.3-54-g00ecf