Skip to content

plaimi/bweakfwu

master
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
doc
 
 
src
 
 
 
 
 
 
 
 
 
 
 
 
 
 
About bweakfwu
===============
bweakfwu is a crossover between Pong and Breakout with retro (shit) graphics. 
It features local two-player.

The controls are up/down arrow for moving the right paddle, and left arrow for
launching its ball. For the right paddle, use 'u'/'j' for moving the paddle,
and 'k' for launching the ball. Space pauses the game. We do not have control
remapping support yet, but you can change it in src/bweakfwu/Handle.hs.

For a more detailed explanation of features see the design document in 
doc/design.txt. For an explanation of how these features are implemented see 
the Haddock-generated documentation.


Dependencies
============

The only library that is required is gloss >= 1.8.0.

The game is built using ghc.

Cabal is optional, but it makes building and installing a lot easier.


Installing and Running
======================

NOTE: This repository is for developers. If you are a regular user, you should
refer to <https://secure.plaimi.net/games/bweakfwu/>.

Build instructions for developers
---------------------------------

# Configure cabal, making sure you have the dependencies, etc
$ cabal configure
# Build the game, puts a binary in ./dist/build/bweakfwu/
$ cabal build
# Make the documentation, puts html in ./dist/doc/htm/bweakfwu/bweakfwu/
# You can view the documentation for the latest git commit online as well, at:
#   <https://secure.plaimi.net/games/bweakfwu/doc/frames.html>
$ cabal haddock --executables --hyperlink-source

To install the game use

$ cabal install

This will add the binary "bweakfwu" to your cabal binaries.


Licensing and Legalese
=======================

bweakfwu is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

bweakfwu is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with bweakfwu.  If not, see <http://www.gnu.org/licenses/>.


Contributing To the Project
===========================

If you want to report a bug, use <https://secure.plaimi.net/bugs>. Bug reports 
may also be enhancements, i.e. feature requests.

If you want to otherwise discuss the game use
<https://secure.plaimi.net/mailing.php>.

If you want to contribute code, upload a patch to the corresponding bug on 
Bugzilla -- or, if there is none, send it to the mailing list linked above.
Make sure you update doc/design.txt in your patch!

/* vim: set textwidth=78 et spell formatoptions=actw2 autoindent: */