Installation Instructions

From Hero of Allacrost

Revision as of 17:41, 10 June 2008 by ElonNarai (Talk | contribs)
Jump to: navigation, search

This page explains how to install the game Hero of Allacrost. The installation process is dependent on which operating system your computer is using.




Install Hero of Allacrost from ports collection:

cd /usr/ports/games/allacrost
make install clean





To use the Debian package, please perform the following steps.

  1. Add one of the following entries in your /etc/apt/sources.list, depending on which version of Debian you are running:
    • Debian Etch (stable):
      deb etch-backports main
    • Debian Lenny/Sid (testing/unstable):
      deb unstable main
  2. The repository is signed, and packages can be checked using this gpg key. To enable the verification, you can simply run this command:
    wget -O - | sudo apt-key add -
  3. Finally, execute the following command. After the installation is complete, you can start the game by typing allacrost at the command line.
    apt-get update && apt-get install allacrost-demo


Download the OS X version of our latest build from our Sourceforge page. Unzip the file and mount the dmg. Drag the .app bundle to your Applications directory. Unmount the dmg, and double-click on Allacrost to play.


Download the Windows version of our latest build from our Sourceforge page. It should unzip into a folder called Allacrost. Go into the folder and double-click Allacrost.exe to play.

Alternatively, you can download the Allacrost auto-installer.

Building and Installing from Source

Installing from source means you will have to compile the game yourself. But first, you'll need the Allacrost code. Either get the tarball from our Sourceforge page, or check it out from our Subversion Repository.

GNU/Linux and OS X

Inside a terminal, execute the following commands from inside the allacrost/ directory:

autoreconf -i
./configure && make
sudo make install

Note that "make install" is optional, and you must run it as root, or use sudo. You can run allacrost from within the source allacrost/ directory by running "./allacrost".


Visual Studio (VS) 2005

Load the Allacrost VS Project file, Allacrost.vcproj. It is in the root directory of the source archive.

Download develop package from, and add them to proper include and lib directories in vs2005.

At last, you have to copy all dll files to your project directory. (you can find those in allacrost windows demo directory, download from sourceforge)

This does not include the map editor, you have to install QT (kind of windows programming framework) for compiling that. Currently we're using QT 4.3.

For step by step instructions look here:

MinGW (from Linux)

These are instructions for cross-compiling Allacrost for Windows from Linux. This requires svn 1340 or later. Earlier svn versions, as well as latest stable (0.2.1), have minor incompatibilities, and mingw has at least one bug that needs to be worked around. You will need mingw installed on a Linux machine. In Debian or Ubuntu, this is as simple as "aptitude install mingw32".

Download the Allacrost dependencies from Unzip this file into your home directory. Now change to the root directory of your Allacrost source archive (ie ~/svn/allacrost/demo/). Execute the following:

cp ~/allacrost-win32-depends/Makefiles/allacrost-Makefile ./Makefile
touch Makefile

If you unzipped the file into a directory other than ~, you will need to modify the LDFLAGS and INCLUDES directories in the Makefile appropriately. If, due to future changes to the allacrost project, this Makefile no longer works, you can find instructions for recreating it in ~/allacrost-win32-depends/HOWTO.

Personal tools