Skip to content
A breakout game in Haskell using SDL and FRP, with Wiimote and Kinect support.
Branch: master
Clone or download
Latest commit 4b17935 Oct 18, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
data
docs
screenshots
src Adds 5 levels where blocks have different lives. Closes #36. Nov 3, 2017
.gitignore
.travis.yml
CHANGELOG Includes new changes (v0.1.5.4) Nov 2, 2017
LICENSE
README.md
Setup.hs
hands-on.md Fixes typo Oct 18, 2018
haskanoid.cabal
stack.yaml added stack.yaml Oct 22, 2017

README.md

Version on Hackage Flattr this git repo

This is a Haskell breakout game implemented using the Functional Reactive Programming library Yampa.

Haskanoid Video

The game has been created for educational purposes, but tries to feature a substantial amount of the complexity often found in real arcade games. In particular:
  • SDL 1.2 graphics and sound.

  • Multiple input devices (keyboard, mouse, Wiimote infrared, Kinect).

  • Differentiated subsystems for physics/collisions, input, rendering/multimedia, logic, etc.

A version of this game using SDL2 has been made available by Keera Studios for free on Google Play for Android. There is a bug that makes the app not close or save the game when you exit it. I know how to solve it, I just haven't found the time to push that change. Please, report other bugs of that Android app here. You can follow the progress of the port for Android on facebook and twitter.

Haskanoid on Android

We would like to call on Haskell programmers, game developers and anyone with an interest in Functional Reactive Programming and/or Game Programming to review the code, ask for clarification when the code is not clear enough, and help us improve the game, and the state of FRP/Yampa programming as well.

This game was used to present a Declarative Game Programming tutorial at PPDP 14 (see http://keera.co.uk/blog/2014/09/24/game-programming-videos-code/ for details). Slides are linked from that website.

Installation

The game is available on hackage. All the media resources are included with the distribution (see LICENCE for redistribution terms). You can install it with*:

$ cabal update
$ cabal sandbox init
$ cabal install haskanoid
$ ./.cabal-sandbox/bin/haskanoid

If you want to explore the code and possibly make changes, do the following:

$ cabal update
$ cabal unpack haskanoid            # or git clone http://github.com/ivanperez-keera/haskanoid
$ cd haskanoid-*                    # Game resources are here
$ cabal sandbox init
$ cabal install
$ ./dist/build/haskanoid/haskanoid

To play it with the wiimote, you need to run the program with the special arguments +RTS -V0. See http://github.com/ivanperez-keera/hcwiid for an explanation.

*Additional notes:

  • Users of GHC 7.8 need to run additional steps. See issue #2 for instructions.

  • MacOSX users (or anyone without a wiimote) might want to disable wiimote and kinect support. You can do so with the cabal flags wiimote and kinect, by running cabal install --flags="-kinect -wiimote".

  • To use of the above installation instructions (with disabled wiimote and kinect support, see bullet point above) you need the following packages:

    On debian/ubuntu, you can install them with:

    $ sudo apt-get install ghc cabal-install
    $ sudo apt-get install libsdl1.2-dev libsdl-mixer1.2-dev libsdl-image1.2-dev libsdl-ttf2.0-dev
    
  • To enable wiimote and kinect support you also need the following packages:

    • CWiid (wiimote)
    • freenect (kinect)

    On debian/ubuntu, you can install them with, respectively:

    $ sudo apt-get install libcwiid-dev
    $ sudo apt-get install freenect
    

Documentation

To try and make things as clear as possible, the code includes a much haddock documentation and comments as we could reasonably fit. You can compile those with:

$ cabal unpack haskanoid     ## Or git clone this-repo
$ cd haskanoid-*
$ cabal sandbox init
$ cabal install --only-dependencies
$ cabal configure && cabal haddock --executables --internal

Related projects

Hands-on

In the hands-on file you find ideas to improve haskanoid while focussing on (game) programming related areas that you might want to dive in deeper. The areas are: functional (reactive) programming, performance, human-computer interaction and input/output, and game design.

Educators

If you find this game attractive and would like to use it to teach functional programming or other subjects, we'd be very happy to know about it. We can provide extra material that you can show to students (videos, screenshots, etc.).

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.