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

• Games that had licenses on their repo's as well as a readme.md are included in each games subdirectory
• ArduboyTones, ArduboyPlaytune and Arduboy2 licences and readme's can be found in Licenses Directory