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 f68fb897c5 raspberry pi gpio input test script 2022-11-04 17:49:08 -04:00
lib framebuffer flag for launcher script, permanent quit for when running as systemd service, wip reduce resolution to 800x450 2022-11-01 17:56:59 -04:00
local/TonyTaunts added taunts to title screen 2020-10-30 15:29:35 -04:00
resource optimize score drawing 2022-11-03 22:47:01 -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 adjust platform and boss health hud for smaller resolution, add donation button to web site 2022-11-01 20:26:12 -04:00
.gitignore subscribe an email address directly using the Mailman API 2022-10-24 23:04:52 -04:00
.gitmodules fixing submodule url to pgfw 2022-10-25 14:22:41 -04:00
LICENSE.txt updated readme, added license 2022-10-25 13:56:58 -04:00
NS.py raspberry pi gpio input test script 2022-11-04 17:49:08 -04:00
OPEN-GAME framebuffer flag for launcher script, permanent quit for when running as systemd service, wip reduce resolution to 800x450 2022-11-01 17:56:59 -04:00
README.md mention about the work in progress instructable in the README 2022-11-02 19:29:58 -04:00
config toggle-able tony shirt glow effect 2022-11-02 23:46:48 -04:00
config.backup new pad colors; website updates 2022-01-27 15:10:02 -05:00
gpio_test.py raspberry pi gpio input test script 2022-11-04 17:49:08 -04: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?

Controller

The controller must be provided by the user, whether it's a standard Scrapeboard mat and board, a custom interface 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.

We are working on an Instructable with details on how to create a standard Scrapeboard mat, board, and circuit! For now, feel free to set up the software and experiment with your own Makey Makey or Arduino interface.

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. Python and Pygame can be installed on any operating system, including Windows, OS X, and Linux.

Installing Python will usually install Python's package manager PIP as well. PIP can be used to install Pygame by running the following from your terminal (for example, PowerShell on Windows)

pip install pygame

Once you have Python and Pygame installed, run the following to download Scrapeboard and PGFW

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

If you have an Arduino prepared, run this to start the game

./OPEN-GAME

Otherwise run the game in keyboard mode like this

./OPEN-GAME --no-serial

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

Contact

Email us at scrape (at) nugget (dot) fun

Donations

Send us a donation through Ko-fi!

Donate at Ko-fi