A D.I.Y. open source arcade game where you use a real skateboard to do combos on four metal pads https://scrape.nugget.fun
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
frank 3080f650d4 fix link to electronics section 3 hours ago
kicad combine kicad projects into single board, update builder manual supplies 3 hours ago
lib builder's manual 1 month ago
resource add kicad pcb project files and readme 2 days ago
serial change Arduino pins to 2, 3, 4, 5, remove old serial code, update builder's manual 2 days ago
www combine kicad projects into single board, update builder manual supplies 3 hours ago
.gitignore combine kicad projects into single board, update builder manual supplies 3 hours ago
.gitmodules update PGFW repo url 2 days ago
LICENSE.txt change Arduino pins to 2, 3, 4, 5, remove old serial code, update builder's manual 2 days ago
NS.py change rpi pins 3 hours ago
OPEN-GAME optionally set SDL video driver to KMS, set GPIO thread to daemon mode 2 months ago
README.md fix link to electronics section 3 hours ago
Scrapeboard_Builder's_Manual.md change rpi pins 3 hours ago
config yellow pad 4 weeks ago
gpio.py change rpi pins 3 hours ago
index.php energy 5 years ago

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 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. Custom interfaces can also 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.

The hardware requirement for serial mode is an Arduino or Arduino-equivalent device that can run the serial program. Raspberry Pi mode is similar to serial mode, but it uses the Python GPIO library to get input directly from the Raspberry Pi pins. 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.

See Scrapeboard Builder's Manual for detailed instructions on how to build a complete system from scratch using an Arduino or Raspberry Pi!

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 connected with the circuit and program prepared, run this to start the game. If the Arduino is not prepared yet, see below.

./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.

./OPEN-GAME --pi

To run the game in keyboard mode anytime, use 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.

Refer to Scrapeboard Builder's Manual for how to build the circuit.

Raspberry Pi

Raspberry Pi GPIO input is also supported. Refer to Scrapeboard Builder's Manual for how to build the circuit. 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 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 for any use, including modifying it and even selling the modification, and the modifications would not need to be released as open source. Use of the assets requires attribution is given to Scrapeboard for the original assets, and if the 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, Arduino and Raspberry Pi all have their own licenses, but they are not distributed with this project.

See LICENSE.txt

Contact

More information is available at the website. Email us at scrape (at) nugget (dot) fun.

Donations

Send us a donation through Ko-fi!

Donate at Ko-fi