Scrapeboard
So, you think you can skateboard, but can you scrapeboard, you slime bag? Scrapeboard is an arcade game played on a real skateboard deck and metal floor pads. Do you have the moves to skate through a gauntlet of goons all the way to Tony Hawk?
Wiki
This README file is for setting up and using the code repository. For more general information on how to operate or build Scrapeboard, see the wiki.
Controller
The standard controller is a custom platform combined with a modified skatedeck, seen in the above GIF. It can be built using the instructions in the builder's manual and attached to an Arduino. Custom interfaces can be created using an Arduino or Raspberry Pi.
There is also keyboard support built-in. It is meant for testing, but the game can be played with it.
Construction of the platform controller can for the most part be automated with a CNC machine. Files for CNC are available in the cnc folder. See the CNC Platform page of the wiki for instructions on how to use the files.
Software
See the software chapter of the Builder's Manual for more detailed instructions
Dependencies
The following are instructions on using a system terminal for installation. Another option is to download and install Python and Pygame manually, then use a Git client like Tortoise to install this repository.
pip install pygame
Once you have Python and Pygame installed, run the following to download Scrapeboard and PGFW
git clone --recursive https://open.shampoo.ooo/scrape/scrapeboard
If you have an Arduino connected with the circuit and program prepared, run this to start the game. If the Arduino is not prepared yet, see below.
python OPEN-GAME
If you are using a Raspberry Pi, run this instead. The Pi should have a circuit installed to its GPIO pins. See below for details.
python OPEN-GAME --pi
To run the game in keyboard mode anytime, use the following
python OPEN-GAME --no-serial
Serial
See the electronics chapter of the Builder's Manual for more detailed instructions
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.
Raspberry Pi
Raspberry Pi GPIO input is also supported. See the Raspberry Pi chapter of the manual for how to install Scrapeboard on a Raspberry Pi. Once the circuit is in place, the game will be able to detect GPIO input. Run with the --pi flag to activate Raspberry Pi mode.
./OPEN-GAME --pi
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
Zkey is a shortcut for reset (F8also resets). - The
Akey 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:
python 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 commercial use, under the zlib license. Art, sound, text, and schematic assets are released under CC BY 4.0. Scrapeboard code and assets can be used in other projects. Scrapeboard is free to build and can even be used commercially. Use of the assets requires attribution is given to Scrapeboard for the original assets. If the source is distributed, the zlib license must be included as the license for the original code. The full license is in LICENSE.txt.
PGFW is included under its zlib license.
Website
scrape at nugget.fun
