Playground - Revision history

Umbire the Phantom: follow-up

2024-12-04T19:24:14Z

follow-up

Precious: Forgor this

2024-12-04T19:10:43Z

Forgor this

Precious: About the paths scheme in Unix-based systems

2024-12-04T19:08:42Z

About the paths scheme in Unix-based systems

Netzhack: Defined playground more narrowly, distinct from "hackdir". More to do.

2022-06-28T23:05:44Z

Defined playground more narrowly, distinct from "hackdir". More to do.

LarryFluckiger: Added the playground location for Windows.

2022-01-13T18:29:52Z

Added the playground location for Windows.

Tartley at 16:54, 16 March 2019

2019-03-16T16:54:16Z

Srg: Add path for Homebrew on MacOS

2017-12-07T01:21:51Z

Add path for Homebrew on MacOS

Someone Else 37: Added location of the playground on Mac OSX (at least, on my system).

2017-02-11T05:44:24Z

Added location of the playground on Mac OSX (at least, on my system).

76.121.93.40 at 04:22, 1 March 2015

2015-03-01T04:22:42Z

80.109.124.74: update openSUSE for Vulture

2011-04-24T18:17:56Z

update openSUSE for Vulture

@@ Line 1: / Line 1: @@
-The '''playground''' is the name of the folder/directory where NetHack can write files.
+The '''playground''' is the name of the folder or 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.
@@ Line 22: / Line 22: @@
 On Windows, it may be located at <tt>%LocalAppData%\NetHack\<u>VERSION</u></tt>, such as <tt>%LocalAppData%\NetHack\3.6</tt>.
-= Paths =
+==Paths==
-NetHack uses various system paths to store gameplay data, in Unix-based systems you can check your default directories with the <tt>--showpaths</tt> option as described in NetHack's manual. Apart from the system configuration file users can modify the directories NetHack uses. The main paths that players may want to change are the following:
+* '''NETHACKDIR''' is the main directory for game files, and the playground as described  it is the '''playground'''.
 * '''LEVELDIR''' is the path where level files for in-progress games are stored in.
 * '''SAVEDIR''' is the path where saved games are kept.
@@ Line 35: / Line 33: @@
 * '''LOCKDIR''' is the path where file synchronization locks are stored.
-Changing these environment variables may be useful for [[#Save_scumming|save scumming]] with limited machine access, or to adjust the playground along with editing your [[#Config_file|config file]].
+Changing these environment variables may be useful for [[save scumming]] with limited machine access, or to adjust the playground along with editing [[config file]]. Note that if you decide to change these environment variables, e.g. in your <tt>~/.bash_profile</tt>, the directories you specify must exist and be writable&mdash;''NetHack'' will not create them for you.
-Note that if you decide to change these environment variables, in say your <tt>~/.bash_profile</tt>, the directories you specify must exist and be writable as NetHack will not create them for you.
+{{nethack-367}}

@@ Line 26: / Line 26: @@
 = Paths =
-NetHack uses various system paths to store gameplay data, in Unix you can check your default directories with the <tt>--showpaths</tt> option as described in NetHack's manual. Apart from the system configuration file users can modify the directories NetHack uses. The main paths that players may want to change are the following:
+NetHack uses various system paths to store gameplay data, in Unix-based systems you can check your default directories with the <tt>--showpaths</tt> option as described in NetHack's manual. Apart from the system configuration file users can modify the directories NetHack uses. The main paths that players may want to change are the following:
 * '''NETHACKDIR''' is the main directory for game files; it is the '''playground'''.

← Older revision		Revision as of 19:08, 4 December 2024
Line 23:		Line 23:
	On Windows, it may be located at <tt>%LocalAppData%\NetHack\<u>VERSION</u></tt>, such as <tt>%LocalAppData%\NetHack\3.6</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]]
		+
		+	= Paths =
		+
		+	NetHack uses various system paths to store gameplay data, in Unix you can check your default directories with the <tt>--showpaths</tt> option as described in NetHack's manual. Apart from the system configuration file users can modify the directories NetHack uses. The main paths that players may want to change are the following:
		+
		+	* '''NETHACKDIR''' is the main directory for game files; it is the '''playground'''.
		+	* '''LEVELDIR''' is the path where level files for in-progress games are stored in.
		+	* '''SAVEDIR''' is the path where saved games are kept.
		+	* '''BONESDIR''' is the path where [[#Bones\|bones]] files are kept.
		+	* '''SCOREDIR''' is the path for your [[#Score\|score]] files.
		+	* '''LOCKDIR''' is the path where file synchronization locks are stored.
		+
		+	Changing these environment variables may be useful for [[#Save_scumming\|save scumming]] with limited machine access, or to adjust the playground along with editing your [[#Config_file\|config file]].
		+	Note that if you decide to change these environment variables, in say your <tt>~/.bash_profile</tt>, the directories you specify must exist and be writable as NetHack will not create them for you.

← Older revision		Revision as of 23:05, 28 June 2022
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>

← Older revision		Revision as of 18:29, 13 January 2022
Line 12:		Line 12:

	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 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]]

@@ Line 5: / Line 5: @@
 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]].

@@ Line 11: / Line 11: @@
 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>
 [[Category:Annotations]]

← Older revision		Revision as of 05:44, 11 February 2017
Line 10:		Line 10:

	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>
	[[Category:Annotations]]		[[Category:Annotations]]

← Older revision		Revision as of 04:22, 1 March 2015
Line 8:		Line 8:

	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]].
		+
		+	On FreeBSD it can also be located at <tt>/usr/local/share/nethack</tt>
	[[Category:Annotations]]		[[Category:Annotations]]