Arcade game with custom open source hardware where you use a real skateboard to do combos on four metal pads https://scrape.nugget.fun
Go to file
ohsqueezy 2f9784498e added pgfw as a dependency and updated instructions 2022-10-25 14:16:29 -04:00
lib subscribe an email address directly using the Mailman API 2022-10-24 23:04:52 -04:00
local/TonyTaunts added taunts to title screen 2020-10-30 15:29:35 -04:00
resource subscribe an email address directly using the Mailman API 2022-10-24 23:04:52 -04:00
serial made level 1 easier; added calendar event; started tracking kit HTML; changed README to markdown 2022-06-24 15:49:05 -04:00
www subscribe an email address directly using the Mailman API 2022-10-24 23:04:52 -04:00
.gitignore subscribe an email address directly using the Mailman API 2022-10-24 23:04:52 -04:00
.gitmodules added pgfw as a dependency and updated instructions 2022-10-25 14:16:29 -04:00
LICENSE.txt updated readme, added license 2022-10-25 13:56:58 -04:00
NS.py made level 1 easier; added calendar event; started tracking kit HTML; changed README to markdown 2022-06-24 15:49:05 -04:00
OPEN-GAME started using level select object, added preview of animated alien 2022-01-29 17:58:06 -05:00
README.md added pgfw as a dependency and updated instructions 2022-10-25 14:16:29 -04:00
config made level 1 easier; added calendar event; started tracking kit HTML; changed README to markdown 2022-06-24 15:49:05 -04:00
config.backup new pad colors; website updates 2022-01-27 15:10:02 -05:00
hue_shift.py arm and animated sprites for all bosses 2022-03-07 18:57:32 -05:00
index.php energy 2018-07-25 22:02:44 -04:00
record_test.py attract mode work in progress 2020-10-18 18:50:48 -04:00
setup.py ic 2017-12-14 03:49:02 -05:00

README.md

Scrapeboard

demo

So, you think you can skateboard, but can you scrapeboard, you slime bag? Scrapeboard is a DDR inspired alt control game that uses a real skateboard deck instead of your feet. Do you have the moves to skate through a gauntlet of goons all the way to Tony Hawk?

Hardware

The hardware must be provided by the user, whether it's a standard Scrapeboard mat and board, a custom controller built by the user, or keyboard input. The hardware requirement for serial mode is an Arduino or Arduino-equivalent device that can run the serial program. For keyboard mode, no special hardware is required, although a gamepad or Makey Makey could be used to create a custom controller that sends key presses.

Software

The software requires Python, Pygame, and a custom Python game framework [PGFW][]. The Python version should be 3.9 or higher. The Pygame version should be 1.9.6 or higher. PGFW is a submodule of this repository, so it can be cloned simultaneously using the --recursive flag.

git clone --recursive https://git.nugget.fun/scrape/scrapeboard

To install python with pip:

pip install pygame

Once Python and Pygame are installed, you should be able to run either:

./OPEN-GAME

or

./OPEN-GAME --no-serial

to start the game in either full arcade mode or keyboard only mode. See below for more about serial input and keyboard input modes.

Serial

To run the game using the custom skateboard and metal pads, the Arduino attached to the pads must be plugged into USB, and the pyserial package must be installed on the computer.

If you have Python Package Installer, you can run this to install pyserial:

pip install pyserial

The Arduino must be loaded with the serial program and connected to USB. The game will try to detect the Arduino, but if that does not work, the device location of the Arduino can be specified in the config file.

If you don't have the board, pad and Arduino, you can test the game using keyboard-only mode.

Keys

For testing, there is keyboard input. To run in keyboard only mode use:

./OPEN-GAME --no-serial

The O, P, L, and ; keys simulate the dance pads and your fingers simulate the board

 ___ ___
|  O|  P|  <-- These keyboard keys correspond to the floor pads
|___|___|      O = top left pad, P = top right pad, L = bottom left pad, ; = bottom right pad
 |  L|  ;|
 |___|___|

Arrow keys also work

UP    = top left pad
RIGHT = top right pad
DOWN  = bottom left pad
LEFT  = bottom right pad

Other keys

  • The Z key is a shortcut for reset (F8 also resets).
  • The A key force resets the connected Arduino (or does nothing if no Arduino is connected).

Options

The full list of configurable values is in the config file. There are also command line flags that can override config values. Use the help flag to see the possible values:

./OPEN-GAME -h

The --minimize-load-time flag can be useful when testing because it sacrifices some effects to load the game quickly.

License

Original Scrapeboard code is released without restriction on copying, modifying, or selling, under the zlib license. Art, sound, text, and schematic assets are released under CC BY 4.0. This means users are free to use Scrapeboard in any context, including modding it and even selling mods or creating a closed source version. Use of the assets requires attribution is given to Scrapeboard for the original assets, and if source is distributed, the zlib license must be included as the license for the original code.

PGFW is included under its zlib license. Python, Pygame, and Arduino all have their own licenses, but they are not distributed with this project.

See LICENSE.txt