🦀 Playdate API and build tools in Rust

This project allows you to create games for the Playdate handheld gaming system in Rust lang.

Modular build system
- build-support libraries
- pre-configured bindgen with extra codegen
- cargo-playdate - one-button solution to build, package and run programs
Modular low- & high- level API
- with examples
All the parts of API are accumulated in One Crate (git)
UI components
- crank-indicator (port from lua version)

Welcome to discussions and issues for any questions and suggestions. Take a look at videos or do something great.

Prerequisites

Follow the instructions for:

Compatibility

Minimal supported versions of Playdate SDK is 2.4.0 because of breaking changes in 2.4.0.
Latest version of SDK is 2.4.0.

Usage

Run example:

cargo run -p=cargo-playdate -- run -p=playdate-controls --example=buttons

Install cargo-playdate and build & run another example:

cargo install cargo-playdate
cargo playdate run -p=playdate-sound --example=sp-simple
cargo playdate run -p=playdate-sound --example=sp-simple --device

Demo

Early development demonstrations of the building process: bin and sim screencasts originally posted on dev-forum.

Modularity

Thanks to the modular structure of the system, you can use all or only the parts of the system you need.

Create a Game

Add playdate crate as dependencies to your project

Or/and API-components

Install cargo-playdate to build your project

Create an API-extension

Add playdate-sys to dependencies
Write neat code
Build & test using cargo, cargo-playdate or anything else.

Here is example of simple API-extension.

Please follow the instructions of playdate-sys.

Create your bindings

Use playdate-bindgen in your build-script

Create your build-system

Use build-support crates

There is all needed to find SDK and arm-gnu toolchain on user's system, build flags, configurations, formats including pdxinfo, etc.

This software is not sponsored or supported by Panic.

paulyoung / playdate