Skip to content

mangband/mangband

Repository files navigation

BUILDING
--------

 mangband and mangclient use a generic autotools build process.
 See the INSTALL file for more information.

 Basically, just run `./configure; make; make install`.

 If you're building from the git repository, you'll have to generate
 the `./configure` script first, by running `./autogen.sh`.

 Please note, that mangclient can be compiled with several
 different display frontends, which may or may not conflict
 with each other. In addition, we support some weird configurations
 and build options. Please run `./configure --help` to see
 the full list of available features.

 For additional hints regarding your specific platform (Windows,
 OSX), please see the developer Wiki:

	https://github.com/mangband/mangband/wiki

RUNNING
-------

 Both mangband and mangclient binaries rely on "lib dir" - a directory
 with all the game data.

 First, they'll look for the ANGBAND_PATH environment variable,
 then they'll try the PKGDATADIR constant, then the directories
 specified in config files (.mangrc and mangband.cfg).

 ANGBAND_PATH can be used to select any directory in this manner:

	ANGBAND_PATH=./lib ./mangband
	ANGBAND_PATH=./lib ./mangclient

 Config file directives are "LibDir" in "$HOME/.mangrc" (for client)
 and "EDIT_DIR", "DATA_DIR", "SAVE_DIR", "BONE_DIR", "HELP_DIR" in
 "mangband.cfg" (for server). Those overwrite any other paths.

 PKGDATADIR is set during the `./configure` step, and defaults to
 something system-specific like "/usr/local/games/mangband". To
 adjust it, the --datadir option can be used:

	./configure --datadir=$PWD/lib