.ds vr "NetHack 3.6
.ds f0 "\*(vr
.ds f1
-.ds f2 "May 31, 2015
+.ds f2 "June 1, 2015
.\" labeled paragraph start (should be part of tmac.n, but I don't want to
.\" make changes to that file)
.\" .PS word
attack to which it is resistant (default on).
.lp standout
Boldface monsters and ``\fB--More--\fP'' (default off).
+.lp statuscolors
+Enable coloring of status fields (default off).
+See ``Configuring Status Hilites'' for futher information.
.lp suppress_alert
This option may be set to a NetHack version level to suppress
alert notification messages about feature changes for that
You can have multiple MENUCOLOR entries in your config file,
and the last MENUCOLOR-line in your config file that matches
a menu line will be used for the line.
-.pg
.hn 2
Configuring User Sounds
.pg
The pattern should be a POSIX extended regular expression.
.pg
.hn 2
+Configuring Status Hilites
+.pg
+Your copy of NetHack may have been compiled with support for {\tStatus Hilites}.
+If so, you can customize your game display by setting thresholds to
+change the color or appearance of fields in the status display.
+.pg
+For example, the following line in your config file will cause
+the hitpoints field to display in the color red if your hitpoints
+drop to or below a threshold of 30%:
+.si
+.lp OPTION=hilite_status: hitpoints/30%/red/normal
+.ei
+.pg
+For another example, the following line in your config file will cause
+wisdom to be displayed red if it drops and green if it rises.
+.si
+.lp OPTION=hilite_status: wisdom/updown/red/green
+.ei
+You can adjust the display of the following status fields:
+.TS S
+center;
+c c c.
+.\"TABLE_START
+title strength dexterity
+constitution intelligence wisdom
+charisma alignment score
+carrying-capacity gold power
+power-max experience-level armor-class
+HD time hunger
+hitpoints hitpoints-max dungeon-level
+experience condition
+.\"TABLE_END Do not delete this line.
+.TE
+.lp ""
+Allowed colors are black, red, green, brown, blue, magenta, cyan, gray,
+orange, lightgreen, yellow, lightblue, lightmagenta, lightcyan, and white.
+.lp ""
+Allowed attributes are bold, inverse, normal.
+Note that the platform used may interpret the attributes any way it
+wants.
+.lp ""
+Behaviours can occur based on percentage thresholds, updown, or absolute values.
+The in-game options menu can help you determine the correct syntax for a
+config file.
+.lp ""
+The whole feature can be disable by setting option {\itstatuscolors} off.
+.pg
+.hn 2
Modifying NetHack Symbols
.pg
NetHack can load entire symbol sets from the symbol file.
%.au
\author{Original version - Eric S. Raymond\\
(Edited and expanded for 3.6 by Michael Allison, Mike Stephenson)}
-\date{May 31, 2015}
+\date{June 1, 2015}
\maketitle
\item[\ib{sortpack}]
Sort the pack contents by type when displaying inventory (default on).
%.lp
-\item[\ib{standout}]
-Boldface monsters and ``{\tt --More--}'' (default off).
-%.lp
\item[\ib{sparkle}]
Display a sparkly effect when a monster (including yourself) is hit by an
attack to which it is resistant (default on).
%.lp
+\item[\ib{standout}]
+Boldface monsters and ``{\tt --More--}'' (default off).
+%.lp
+\item[\ib{statuscolors}]
+Enable coloring of status fields (default off).
+See ``{\it Configuring Status Hilites\/}'' for further information.
+%.lp
\item[\ib{suppress\_alert}]
This option may be set to a NetHack version level to suppress
alert notification messages about feature changes for that
You can have multiple MENUCOLOR entries in your config file,
and the last MENUCOLOR-line in your config file that matches
a menu line will be used for the line.
-%.pg
%.lp
%.hn 2
The pattern should be a regular expression.
%.lp
+%.hn 2
+\subsection*{Configuring Status Hilites}
+
+%.pg
+Your copy of NetHack may have been compiled with support for {\it Status Hilites}.
+If so, you can customize your game display by setting thresholds to
+change the color or appearance of fields in the status display.
+
+For example, the following line in your config file will cause
+the hitpoints field to display in the color red if your hitpoints
+drop to or below a threshold of 30%:
+\begin{verbatim}
+ OPTION=hilite_status: hitpoints/30%/red/normal
+\end{verbatim}
+%.pg
+For another example, the following line in your config file will cause
+wisdom to be displayed red if it drops and green if it rises.
+\begin{verbatim}
+ OPTION=hilite_status: wisdom/updown/red/green
+\end{verbatim}
+You can adjust the display of the following status fields:
+%.sd
+\begin{center}
+\begin{tabular}{lll}
+%TABLE_START
+title & strength & dexterity\\
+constitution & intelligence & wisdom\\
+charisma & alignment & score\\
+carrying-capacity & gold & power\\
+power-max & experience-level & armor-class\\
+HD & time & hunger\\
+hitpoints & hitpoints-max & dungeon-level\\
+experience & condition\\
+%TABLE_END Do not delete this line.
+\end{tabular}
+\end{center}
+%.ed
+
+%.lp ""
+Allowed behaviors are {\it updown}, {\it percentage}, {\it absolute}, {\it brown},
+{\it blue}, {\it magenta}, {\it cyan}, {\it gray}, {\it orange},
+{\it lightgreen}, {\it yellow}, {\it lightblue}, {\it lightmagenta},
+{\it lightcyan}, and {\it white}.
+
+%.lp ""
+Allowed colors are {\it black}, {\it red}, {\it green}, {\it brown},
+{\it blue}, {\it magenta}, {\it cyan}, {\it gray}, {\it orange},
+{\it lightgreen}, {\it yellow}, {\it lightblue}, {\it lightmagenta},
+{\it lightcyan}, and {\it white}.
+
+%.lp ""
+Behaviours can occur based on percentage thresholds, updown, or absolute values.
+The in-game options menu can help you determine the correct syntax for a
+config file.
+
+%.lp ""
+The whole feature can be disable by setting option {\it statuscolors} off.%.lp
+
%.hn 2
\subsection*{Modifying NetHack Symbols}
Helge Hafting & Mike Engber & Warren Cheung\\
Irina Rempt-Drijfhout & Mike Gallop & Warwick Allison\\
Izchak Miller & Mike Passaretti & Yitzhak Sapir
---Guidebook.mn--
-Adam Aronow J. Ali Harlow Mike Stephenson
-Alex Kompel Janet Walz Mikko Juola
-Andreas Dorn Janne Salmijarvi Norm Meluch
-Andy Church Jean-Christophe Collet Olaf Seibert
-Andy Swanson Jeff Bailey Pasi Kallinen
-Ari Huttunen Jochen Erwied Pat Rankin
-Barton House John Kallen Paul Winner
-Benson I. Margulies John Rupley Pierre Martineau
-Bill Dyer John S. Bien Ralf Brown
-Boudewijn Waijers Johnny Lee Ray Chason
-Bruce Cox Jon W{tte Richard Addison
-Bruce Holloway Jonathan Handler Richard Beigel
-Bruce Mewborne Joshua Delahunty Richard P. Hughey
-Carl Schelin Keizo Yamamoto Rob Menke
-Chris Russo Ken Arnold Robin Bandy
-David Cohrs Ken Arromdee Robin Johnson
-David Damerell Ken Lorber Roderick Schertler
-David Gentzel Ken Washikita Roland McGrath
-David Hairston Kevin Darcy Ron Van Iwaarden
-Dean Luick Kevin Hugo Ronnen Miller
-Del Lamb Kevin Sitze Ross Brown
-Derek S. Ray Kevin Smolkowski Sascha Wostmann
-Deron Meranda Kevin Sweet Scott Bigham
-Dion Nicolaas Lars Huttar Scott R. Turner
-Dylan O'Donnell Leon Arnott Sean Hunt
-Eric Backus M. Drew Streib Stephen Spackman
-Eric Hendrickson Malcolm Ryan Stefan Thielscher
-Eric R. Smith Mark Gooderum Stephen White
-Eric S. Raymond Mark Modrall Steve Creps
-Erik Andersen Marvin Bressler Steve Linhart
-Frederick Roeber Matthew Day Steve VanDevender
-Gil Neiger Merlyn LeRoy Teemu Suikki
-Greg Laskin Michael Allison Tim Lennan
-Greg Olson Michael Feir Timo Hakulinen
-Gregg Wonderly Michael Hamel Tom Almy
-Hao-yang Wang Michael Sokolov Tom West
-Helge Hafting Mike Engber Warren Cheung
-Irina Rempt-Drijfhout Mike Gallop Warwick Allison
-Izchak Miller Mike Passaretti Yitzhak Sapir
%TABLE_END Do not delete this line.
\end{tabular}
\end{center}
projects / nethack / commitdiff