Difference between revisions of "Options (dNetHack)"

From NetHackWiki
Jump to navigation Jump to search
(Add paranoid_swim)
(Unupcomingify 3.23.0 options)
 
Line 4: Line 4:
 
=New options=
 
=New options=
 
==block_forget_map==
 
==block_forget_map==
{{upcoming|dNetHack|In 3.23.0, this option will be added.}}
 
 
Disables amnesia map forgetting. Boolean option, defaults to FALSE. Can be set in game.
 
Disables amnesia map forgetting. Boolean option, defaults to FALSE. Can be set in game.
  
 
==classic_colors==
 
==classic_colors==
{{upcoming|dNetHack|In 3.23.0, this option will be added.}}
 
 
Enables using traditional curses colours (ignoring the player's terminal configuration). Only available for curses. Boolean option, defaults to TRUE. Cannot be set in game.
 
Enables using traditional curses colours (ignoring the player's terminal configuration). Only available for curses. Boolean option, defaults to TRUE. Cannot be set in game.
  
Line 26: Line 24:
  
 
==MONSTERTEMPLATE==
 
==MONSTERTEMPLATE==
{{upcoming|dNetHack|In 3.23.0, the bug that makes setting MONSTERTEMPLATE for cordyceps and spore zombies not work is fixed.}}
 
 
 
Allows changing background colour, foreground colour, and symbol for a monster template, for example, to (almost) replicate the defaults:
 
Allows changing background colour, foreground colour, and symbol for a monster template, for example, to (almost) replicate the defaults:
 
  MONSTERTEMPLATE=zombified:bg:green
 
  MONSTERTEMPLATE=zombified:bg:green
Line 37: Line 33:
 
  MONSTERTEMPLATE=dream:bg:green
 
  MONSTERTEMPLATE=dream:bg:green
 
  MONSTERTEMPLATE=moly:bg:green
 
  MONSTERTEMPLATE=moly:bg:green
  # These do not work due to a bug (cordyceps and spore zombie are not handled by parse_monster_template)
+
  MONSTERTEMPLATE=spore:bg:green
#MONSTERTEMPLATE=spore:bg:green
+
  MONSTERTEMPLATE=cordyceps:bg:green
  #MONSTERTEMPLATE=cordyceps:bg:green
+
  MONSTERTEMPLATE=cordyceps:sym:F
  #MONSTERTEMPLATE=cordyceps:sym:F
 
  
 
You cannot use this to unset a default template symbol, unless you disable default_template_hilite.
 
You cannot use this to unset a default template symbol, unless you disable default_template_hilite.
Line 47: Line 42:
  
 
==paranoid_swim==
 
==paranoid_swim==
{{upcoming|dNetHack|In 3.23.0, this option will be added.}}
 
  
 
Require using a 'm' (#moveonly) prefix in order to move into water, lava, 3D water or air, if that would harm you, your inventory, or your steed. Boolean option, defaults to TRUE. Can be set in game.
 
Require using a 'm' (#moveonly) prefix in order to move into water, lava, 3D water or air, if that would harm you, your inventory, or your steed. Boolean option, defaults to TRUE. Can be set in game.
  
 
==RESETCOLOR==
 
==RESETCOLOR==
{{upcoming|dNetHack|In 3.23.0, this option will be added.}}
 
  
 
Allows changing the colours that the terminal is reset to after ending the game to RGB values. Only available for curses. Syntax is the same as [[#SETCOLOR|SETCOLOR]].
 
Allows changing the colours that the terminal is reset to after ending the game to RGB values. Only available for curses. Syntax is the same as [[#SETCOLOR|SETCOLOR]].
Line 59: Line 52:
  
 
==SETCOLOR==
 
==SETCOLOR==
{{upcoming|dNetHack|In 3.23.0, this option will be added.}}
 
  
 
Allows changing the definitions of colours to RGB values. Only available for curses.
 
Allows changing the definitions of colours to RGB values. Only available for curses.
Line 70: Line 62:
  
 
==statuseffects==
 
==statuseffects==
{{upcoming|dNetHack|In 3.23.0, this option will be added.}}
 
  
 
Specifies which status effects should be shown in the status line. Can be set to one or more status effects separated by spaces, which can each be negated by prefixing them with !. The special value "all" will enable all status effects (or disable all status effects when negated). Changes are applied left-to-right, starting with the default value. Defaults to all. Can be set in game.
 
Specifies which status effects should be shown in the status line. Can be set to one or more status effects separated by spaces, which can each be negated by prefixing them with !. The special value "all" will enable all status effects (or disable all status effects when negated). Changes are applied left-to-right, starting with the default value. Defaults to all. Can be set in game.
Line 85: Line 76:
  
 
==statuslines==
 
==statuslines==
{{upcoming|dNetHack|In 3.23.0, statuslines will work for curses as well as TTY. It will also default to 4 and accept any value greater than 2 (curses with !classic_status has either 3 or 4 statuslines).}}
 
  
Specifies the amount of status lines (2 or 3, defaults to 3). Only available for TTY. Can be set in game.
+
Specifies the amount of status lines (2, 3, or 4 (higher values are accepted but treated as 4), defaults to 4). Can be set in game.
 
{{stub}}
 
{{stub}}
 
[[Category:dNetHack]]
 
[[Category:dNetHack]]

Latest revision as of 19:59, 16 May 2024

As a variant of NetHack 3.4.3, dNetHack options include most available options from NetHack 3.4.3 and 3.4.3-NAO alongside several new ones.

New options

block_forget_map

Disables amnesia map forgetting. Boolean option, defaults to FALSE. Can be set in game.

classic_colors

Enables using traditional curses colours (ignoring the player's terminal configuration). Only available for curses. Boolean option, defaults to TRUE. Cannot be set in game.

Some terminals may require manually configuring RESETCOLOR to reset colours to the correct values.

default_template_hilite

Enables default hilites for monster templates. Boolean option, defaults to TRUE. Cannot be set in game.

delay_length

Sets the length of delays when rendering animation (none, short, or normal). Defaults to normal. Can be set in game.

dnethack_dungeon_colors

Enables colouring of walls and floors on certain levels. Boolean option, defaults to TRUE. Can be set in game.

dnethack_start_text

Enables extra dNetHack-specific hints on starting or restoring a game. Boolean option, defaults to TRUE. Cannot be set in game.

MONSTERTEMPLATE

Allows changing background colour, foreground colour, and symbol for a monster template, for example, to (almost) replicate the defaults:

MONSTERTEMPLATE=zombified:bg:green
MONSTERTEMPLATE=skelified:bg:green
MONSTERTEMPLATE=crystalfied:bg:green
MONSTERTEMPLATE=tomb:fg:gray
MONSTERTEMPLATE=tomb:sym:`
MONSTERTEMPLATE=yellow:bg:green
MONSTERTEMPLATE=dream:bg:green
MONSTERTEMPLATE=moly:bg:green
MONSTERTEMPLATE=spore:bg:green
MONSTERTEMPLATE=cordyceps:bg:green
MONSTERTEMPLATE=cordyceps:sym:F

You cannot use this to unset a default template symbol, unless you disable default_template_hilite.

Available colours: black, red, green, brown, blue, magenta, cyan, gray, orange, lightgreen, yellow, lightblue, lightmagenta, lightcyan, white.

paranoid_swim

Require using a 'm' (#moveonly) prefix in order to move into water, lava, 3D water or air, if that would harm you, your inventory, or your steed. Boolean option, defaults to TRUE. Can be set in game.

RESETCOLOR

Allows changing the colours that the terminal is reset to after ending the game to RGB values. Only available for curses. Syntax is the same as SETCOLOR.

This is only required for certain terminals for which curses cannot obtain the original colour values for the 8 bright colours.

SETCOLOR

Allows changing the definitions of colours to RGB values. Only available for curses.

Example:

RESETCOLOR=lightblue:#00FF99
SETCOLOR=magenta:255 0 180

Available colours: black, red, green, brown, blue, magenta, cyan, gray, orange, lightgreen, yellow, lightblue, lightmagenta, lightcyan, white. Either "light" or "bright" is accepted for the lighter versions of each colour.

statuseffects

Specifies which status effects should be shown in the status line. Can be set to one or more status effects separated by spaces, which can each be negated by prefixing them with !. The special value "all" will enable all status effects (or disable all status effects when negated). Changes are applied left-to-right, starting with the default value. Defaults to all. Can be set in game.

Available status effects (case-insensitive): all, Stone, Slime, Sufct, Ill, FoodPois, Blind, Stun, Conf, Hallu, Panic, Stmblng, Stggrng, Babble, Scream, Faint, Held, UHold, Lycn, Invl, Lev, Fly, Ride, TimeStop, Lust, DeadMagc, Miso, Catapsi, DimLock.

Examples:

# Disable all status effects except Stone
OPTION=statuseffects:!all stone
# Enable all status effects except DeadMagc, Miso, Catapsi, and DimLock
OPTION=statuseffects:!deadmagc !miso !catapsi !dimlock
# Disable all status effects, then enable them. Since changes are applied left-to-right, this does nothing.
OPTION=statuseffects:!all all

statuslines

Specifies the amount of status lines (2, 3, or 4 (higher values are accepted but treated as 4), defaults to 4). Can be set in game.

This page is a stub. Should you wish to do so, you can contribute by expanding this page.