playdate-arduboy

A collection of ported games + a drop in replacement library for Arduboy2 / ArduboyPlaytune / ArduboyTones for playdate

Project maintained by joyrider3774 Hosted on GitHub Pages — Theme by mattgraham

Arduboy Playdate Ports

A collection of ported games + a drop in replacement library for Arduboy2 / ArduboyPlaytune / ArduboyTones

Initial Port was done by Eric Lewis, additional fixes done by joyrider3774, game porters are listed in the games section

Games

Game
Download		 Screenshot Author Porter License Link
ArduGolf game brow1067. joyrider3774 MPL-2.0 Community
Arduminer game Bergasms Eric Lewis No License Community
Arduventure game TEAM A.R.G. joyrider3774 MIT Community
Ardynia game Matt Greer joyrider3774 MIT Community
Bangi game Ignacio Vina joyrider3774 Apache-2.0 license Community
Begemmed game TEAM A.R.G. Eric Lewis MIT Community
Blob Attack game TEAM A.R.G. Eric Lewis MIT Community
Bone Shakers game James Howard Eric Lewis GPL-3.0 Community
Bubble Pop game TEAM A.R.G. Eric Lewis MIT Github
Candlelight game Matthew Bryan Matheus Nícolas Unknown Community
CastleBoy game jlauener Eric Lewis MIT Community
Catacombs game James Howard,
Abeno Studio		 Eric Lewis MIT Community
Crates game compycore Eric Lewis MIT Community
Dark and Under game Garage Collective joyrider3774 BSD 3-Clause Community
Dice of Fate game TEAM A.R.G. Eric Lewis MIT Community
Dino game Ashteroide Eric Lewis Apache-2.0 license Community
Do You
Remember Love		 game CoBinee joyrider3774 Unknown Github
Epic Crates Of
Mass Desctruction		 game TEAM A.R.G. joyrider3774 MIT Github
Escaper Droid game TEAM A.R.G. Eric Lewis MIT Github
Evasion game Obono joyrider3774 MIT Community
Fast game Byron Holldorf
Filmote (Tinyfont)		 Matheus Nícolas BSD 3-Clause Community
Fire Panic game Vampirics
Filmote		 joyrider3774 BSD 3-Clause Community
Hollow Seeker game Obono joyrider3774 MIT Community
Hopper game Obono joyrider3774 MIT Community
Jet Pac game TheArduinoGuy Eric Lewis Unknown Community
LodeRunner game Press Play On Tape
Filmote		 joyrider3774 BSD 3-Clause Community
MayQ game CoBinee joyrider3774 Unknown Github
Mystic Balloon game TEAM A.R.G. Eric Lewis MIT Community
Petit of the dead game CoBinee joyrider3774 Unknown Github
Pocket Fighter game Wang Renxin Eric Lewis CC BY-NC-SA Community
Randocity game Paul Wasson joyrider3774 MIT Community
Reverse Mermaid
Hockey		 game TEAM A.R.G. Eric Lewis MIT Community
Reversi game Obono joyrider3774 MIT Community
SanSan game Chamekan joyrider3774 Unknown Community
SFZ game CoBinee joyrider3774 Unknown Github
Shadow Runner game TEAM A.R.G. Eric Lewis MIT Community
Sirene game TEAM A.R.G. joyrider3774 MIT Community
Stellar Impact game Gnargle joyrider3774 MIT Community
Tackle Box game Matt Greer joyrider3774 MIT
(code only)		 Community
Train Dodge game Crait Eric Lewis Unknown Community
Trials of Astarok game Vampirics,
Filmote,
Gibs
Pharap		 joyrider3774 BSD 3-Clause Community
Trolly Fish game TEAM A.R.G. joyrider3774 MIT Community
Umeroose game CoBinee joyrider3774 Unknown Github
Virus LQP-79 game TEAM A.R.G. Eric Lewis MIT Community
Waternet game joyrider3774 joyrider3774 MIT Community

Instructions

Prerequisites

Before building, make sure you have:

  1. Playdate SDK installed
    • macOS: install via the Playdate website. The SDK path is auto-detected from ~/.Playdate/config.
    • Linux/Windows: set the PLAYDATE_SDK_PATH environment variable pointing to your SDK folder (e.g. export PLAYDATE_SDK_PATH=/path/to/PlaydateSDK).
  2. CMake 3.19+ 
    cmake --version
  3. playdate-cpp submodule initialized. From the repository root: 
    git submodule update --init

Building

All commands are run from the repository root (not in a games folder).

1. Create the build directory

mkdir build
cd build

2. Configure with CMake

macOS (SDK path is auto-detected):

cmake ..

Linux / Windows (set SDK path explicitly if not set already):

PLAYDATE_SDK_PATH=/path/to/PlaydateSDK cmake ..

3. Build

only a single game for example the Fast game

cmake --build . --target Fast

Or build all games in the repository:

cmake --build . --config Release

4. Locate the output

After a successful build, the .pdx bundle is placed inside the game folder:

for example:

Fast/Fast.pdx/

5. Running on the Playdate Simulator

Open the Playdate Simulator, then drag and drop a game for example Fast/Fast.pdx onto it — or use File → Open and select the Fast.pdx folder.

6. Running on a physical Playdate

  1. Connect your Playdate via USB.
  2. In the Playdate Simulator, go to Device → Upload Game to Device and select Fast/Fast.pdx.

Alternatively, use the Playdate web interface at device.play.date to sideload the .pdx directly.

7. Troubleshooting

Problem Solution
cmake .. fails with “SDK not found” Set PLAYDATE_SDK_PATH explicitly (see step 2)
git submodule errors Run git submodule update --init from the repo root
Build errors in playdate-cpp Make sure the submodule was fully initialized; re-run git submodule update --init --recursive
.pdx not appearing Check that the build completed without errors; the output goes to [Game]/[Game].pdx/

Licenses