Sysconf

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

The system-wide configuration file, sysconf, is a plain text-file, usually in the same directory as NetHack binary, and it allows the system admin to change some settings compiled into the game. Only available if NetHack was compiled with SYSCF.

sysconf can also be used to set defaults for config options.

File format is the same as the options file.

Settings

WIZARDS

Which users can use debug mode (aka wizard mode; accessed via '-D' command line flag or OPTIONS=playmode:debug in the runtime options config file). A value of * allows anyone to enter debugging mode.

WIZARDS=root games

EXPLORERS

Which users can use explore mode (aka discover mode; accessed via '-X' command line flag or OPTIONS=playmode:explore in runtime options file or via #exploremode command during normal play). Same syntax as WIZARDS.

EXPLORERS=*

SHELLERS

Users allowed to use the '!' (shell escape) and '^Z' (suspend process) commands to temporarily leave the game and enter a shell process. Uses the same syntax as the WIZARDS and EXPLORERS options.

GENERICUSERS

If the user name is found in this list, prompt for username instead. Uses the same syntax as the WIZARDS option above. A public server should probably disable this.

GENERICUSERS=play player game games nethack nethacker

CHECK_PLNAME

Use the player name for matching WIZARDS, EXPLORERS and SHELLERS, instead of the user's login name.

CHECK_PLNAME=1

MAXPLAYERS

Limit the number of simultaneous games. Valid values are 0-25. Commenting this out or setting the value to 0 constructs lock files with UID and playername, so each user may have one game at a time, but number of different players is not limited.

MAXPLAYERS=10

SUPPORT

If not null, added to string "To get local support, " in the support information help.

SUPPORT=call Izchak at extension 42.

RECOVER

If not null, displayed at the end of a panic-save sequence.

RECOVER=Run the recover program.

SEDUCE

Make succubi and incubi to use nymphs' charm behavior rather than their own seduce behavior.

SEDUCE=0

CHECK_SAVE_UID

Disable savefile UID checking.

CHECK_SAVE_UID=0

PERSMAX

High score file: maximum entries for one person.

PERSMAX=10

ENTRYMAX

High score file: maximum number of entries.

ENTRYMAX=100

POINTSMIN

High score file: minimum points to get an entry.

POINTSMIN=1

PERS_IS_UID

High score file: Determine identity of "person" with name (0) or numeric (1) user id.

PERS_IS_UID=1

DEBUGFILES

Show debugging information originating from these source files. Use '*' for all, or list source files separated by spaces. Only available if game has been compiled with DEBUG, and can be overridden via DEBUGFILES environment variable.

DEBUGFILES=*

DUMPLOGFILE

Save end of game dump log to this file. Only available if NetHack was compiled with DUMPLOG. Allows following placeholders:

%%	literal '%'
%v	version (eg. "3.6.1-0")
%u	game UID
%t	game start time, UNIX timestamp format
%T	current time, UNIX timestamp format
%d	game start time, YYYYMMDDhhmmss format
%D	current time, YYYYMMDDhhmmss format
%n	player name
%N	first character of player name

DUMPLOGFILE=/tmp/nethack.%n.%d.log

BONES_POOLS

Number of bones file pools. The pool you belong to is determined at game start. You will load and save bones only from that pool. Generally useful for public servers only. Changing this might make existing bones inaccessible. Disabled by setting to 0, or commenting out.

BONES_POOLS=10

This page may need to be updated for the current version of NetHack.

It may contain text specific to NetHack 3.6.1. Information on this page may be out of date.

Editors: After reviewing this page and making necessary edits, please change the {{nethack-361}} tag to the current version's tag or {{noversion}} as appropriate.