h2

Unified Haskell Heroes repository 🌍

Quick start

Also see: Platform remarks.

First, install Git, Git LFS and Haskell Stack

Then:

git clone https://github.com/tempname11/h2
cd h2
git submodule init

git submodule update
# this might take some time (and disk space), since one of the submodules is a binary asset LFS repository.

./hhcli stack-native build
# this WILL take a fair amount of time. Stack will typically download and install GHC and all the dependencies at this point.

Preparing the assets

mkdir .production-assets
mkdir .production-assets/Cursors
ln -s ../h3-assets/Sounds .production-assets/Sounds
ln -s ../pkg/heroes/glsl .production-assets/glsl
./hhclix prepare-assets
./hhcli run-tool compile-essentials
./hhcli run-tool compile-cursors

Native version

You will need SDL2, SDL_mixer 2.0 with mp3 support, and SDL_image 2.0 installed on your system.

./hhcli run-native

Here's what you'll hopefully see:

Web version

./hhcli run-web

Note 1: this will install and boot GHCJS, which takes a long time (1+ hours). Note 2: this will currently produce a broken build, because of a GHCJS bug. This problem has been described already, see a kind of hacky solution her and here. The 8.2+ version of GHCJS seems to have this bug fixed already, but I haven't been able to make it work with stack yet.

./hhcli prepare-web
./hhcli run-web

This will run a simple HTTP server on port 8000. You can test the build at http://localhost:8000/exe

Platform remarks

The instructions have been written and tested on Mac OS, but should hopefully be somewhat reproducible on Windows and Linux. All of the dependencies are cross-platform.

Mac OS

Homebrew works for all of the dependencies. Most are straight-forward.

Currently, on Mojave, you need to install SDL2 from HEAD:

brew install sdl2 --HEAD

Windows

Here be dragons. Be the first and tell about your experience!

Linux

See above.