Difference between revisions of "Playground"

From NetHackWiki
Jump to navigation Jump to search
(Added location of the playground on Mac OSX (at least, on my system).)
(Defined playground more narrowly, distinct from "hackdir". More to do.)
 
(3 intermediate revisions by 3 users not shown)
Line 1: Line 1:
The '''playground''' is the name of the folder/directory that contains NetHack's data files. The data includes dungeon descriptions, rumours ([[rumor.tru]] and [[rumor.fal]]), save files, temporary files during gameplay, the [[logfile]], and the [[record file|high scores list]].
+
The '''playground''' is the name of the folder/directory where NetHack can write files.
 +
 
 +
Like many programs, NetHack has executable and data files which do not change after installation; configuration files which can be adjusted by a user or administrator; and data files which change as the program runs.
 +
 
 +
On some systems, such as older Windows versions, or when NetHack is installed in a single user's home directory, all of these files may be in the same place.
 +
 
 +
More typically, however, especially on multi-user systems, the unchanging files are installed in one place – under <tt>/usr</tt> on [[Unix]], or under <tt>\Program Files\</tt> on Windows – and the variable files are kept under a directory where users have write access, such as <tt>/var</tt> on Unix or <tt>\AppData\</tt> on Windows. In this case, '''playground''' refers to the directory containing NetHack's variable files; a distinct directory with the executable and data files is called '''[[hackdir]]''' in some NetHack documents.
 +
 
 +
The data includes dungeon descriptions, rumours ([[rumor.tru]] and [[rumor.fal]]), save files, temporary files during gameplay, the [[logfile]], and the [[record file|high scores list]].
  
 
The default playground on Linux is <tt>/usr/games/lib/nethackdir/</tt>
 
The default playground on Linux is <tt>/usr/games/lib/nethackdir/</tt>
Line 5: Line 13:
 
The default playground on FreeBSD is <tt>/usr/local/lib/nethack/</tt>
 
The default playground on FreeBSD is <tt>/usr/local/lib/nethack/</tt>
  
In Debian Lenny the playground is <tt>/var/games/nethack</tt>
+
In Debian (Lenny) and Ubuntu (Cosmic) the playground is <tt>/var/games/nethack</tt>
  
 
On openSUSE, the playgrounds are located at <tt>/var/games/nethack</tt> and <tt>/usr/share/games/vulture-*</tt> for the various [[Vulture]].
 
On openSUSE, the playgrounds are located at <tt>/var/games/nethack</tt> and <tt>/usr/share/games/vulture-*</tt> for the various [[Vulture]].
Line 11: Line 19:
 
On FreeBSD it can also be located at <tt>/usr/local/share/nethack</tt>
 
On FreeBSD it can also be located at <tt>/usr/local/share/nethack</tt>
  
On Mac OS X, it may be located at <tt>/Library/NetHack/nethackdir</tt>
+
On Mac OS, it may be located at <tt>/Library/NetHack/nethackdir</tt> or, if installed via Homebrew, <tt>/usr/local/Cellar/nethack/<em><u>VERSION</u></em>/libexec/save</tt>
 +
 
 +
On Windows, it may be located at <tt>%LocalAppData%\NetHack\<u>VERSION</u></tt>, such as <tt>%LocalAppData%\NetHack\3.6</tt>.
 
[[Category:Annotations]]
 
[[Category:Annotations]]

Latest revision as of 23:05, 28 June 2022

The playground is the name of the folder/directory where NetHack can write files.

Like many programs, NetHack has executable and data files which do not change after installation; configuration files which can be adjusted by a user or administrator; and data files which change as the program runs.

On some systems, such as older Windows versions, or when NetHack is installed in a single user's home directory, all of these files may be in the same place.

More typically, however, especially on multi-user systems, the unchanging files are installed in one place – under /usr on Unix, or under \Program Files\ on Windows – and the variable files are kept under a directory where users have write access, such as /var on Unix or \AppData\ on Windows. In this case, playground refers to the directory containing NetHack's variable files; a distinct directory with the executable and data files is called hackdir in some NetHack documents.

The data includes dungeon descriptions, rumours (rumor.tru and rumor.fal), save files, temporary files during gameplay, the logfile, and the high scores list.

The default playground on Linux is /usr/games/lib/nethackdir/

The default playground on FreeBSD is /usr/local/lib/nethack/

In Debian (Lenny) and Ubuntu (Cosmic) the playground is /var/games/nethack

On openSUSE, the playgrounds are located at /var/games/nethack and /usr/share/games/vulture-* for the various Vulture.

On FreeBSD it can also be located at /usr/local/share/nethack

On Mac OS, it may be located at /Library/NetHack/nethackdir or, if installed via Homebrew, /usr/local/Cellar/nethack/VERSION/libexec/save

On Windows, it may be located at %LocalAppData%\NetHack\VERSION, such as %LocalAppData%\NetHack\3.6.