# 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.

Contents

1 Settings

1.1 WIZARDS
1.2 EXPLORERS
1.3 SHELLERS
1.4 GENERICUSERS
1.5 CHECK_PLNAME
1.6 MAXPLAYERS
1.7 SUPPORT
1.8 RECOVER
1.9 SEDUCE
1.10 CHECK_SAVE_UID
1.11 PERSMAX
1.12 ENTRYMAX
1.13 POINTSMIN
1.14 PERS_IS_UID
1.15 DEBUGFILES
1.16 DUMPLOGFILE
1.17 BONES_POOLS

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