P2Garage Library

Playstation 2 Homebrew for Humans

What It Is

This is a framework for creating interactive media on the Playstation 2.

What This Is Not

P2Garage is NOT a game engine. This library does a lot to simplify building PS2 software. It has a lot of useful abstractions, makes graphics nice and provides a Lua scripting interface. to Playstation 2 hardware. The library does not have strong opinions on how to build a game. There are still lots of problems to solve.

How To Use

This framework is built on PS2SDK, a community SDK that can be installed from here.. The Makefiles in this project assume Docker is installed and will use a docker image to compile everything. Building without Docker is supported, but not supported as a first-class way of compiling the project.

Running make dist will compile the code and assemble some key assets. The p2g.elf file in the /dist folder can be executed on a PS2 using a homebrew launcher such as wLaunchELF or ps2link. It can also be run in the PCSX2 emulator.

When p2g.elf is run, it initializes the Playstation 2 and calls the file in script/main.lua. This Lua file should be the entrypoint to your game/app/etc. Replace the default one with something. For an example of how I manage a repository for a game using this framework, see this repo.

Current Status

Contributors