This file has been dedicated to the public domain, to the extent possible under applicable law, via CC0. See http://creativecommons.org/publicdomain/zero/1.0/ for more information. This file is offered as-is, without any warranty. ======================================================================== HOW TO RUN If you have downloaded a version of the game designated for a particular system, simply run the executable. To run the source code, you will need Python 3.6 or later <https://www.python.org>. You will also need the dependencies listed in requirements.txt, which you can install automatically by using the following command: python3 -m pip install -r requirements.txt Once you have installed the dependencies, you can start the game by running "hexoshi.py". On most systems, this should be done by double-clicking on it; if you are shown a dialog asking you if you want to display or run the file, choose to run it. There are some command-line options that can be passed. Run the game in a terminal with the "-h" command-line option for more information. NOTES FOR GIT REPO USERS The Hexoshi Git repository excludes some automatically generated files, so if you are running Hexoshi directly from the Git repository (rather than a release archive), there are a couple extra steps to keep in mind. Hexoshi uses gettext for translations. Building gettext files can be done with the included build.py script in data/locale (requires msgfmt): cd data/locale ./build.py cd ../.. For startup efficiency, Hexoshi generates map files on first startup and attempts to save them to Hexoshi's data directory (either the directory passed via Hexoshi's -d argument, or the "data" directory in the same location as hexoshi.py by default). If packaging Hexoshi for distribution, these files should be pre-generated. You can do so easily with the following command: ./hexoshi.py -mq The -m option forces map generation, and the -q option causes the game to quit immediately after opening. Alternatively, simply running the game normally before distributing should work as long as no pre-existing map files already exist. SPECIAL CONTROLS You can exit the game by pressing the middle mouse button. This is a workaround for a rare bug in SDL 1.2 which can lock up the keyboard controls.