explaingit

ext5demon/donut-spider

Analysis updated 2026-05-18

0CAudience · generalComplexity · 4/5LicenseSetup · hard

TLDR

A pre-alpha runner that plays certain GameMaker-engine games on a modified PlayStation 3 console.

Mindmap

mindmap
  root((repo))
    What it does
      Runs GameMaker bytecode on PS3
      Supports WAD 17 games
      Logs session diagnostics
    Tech stack
      C
      CMake
      PSL1GHT toolchain
    Use cases
      Play GameMaker games on PS3
      Test builds on desktop
      Report bugs via session logs
    Audience
      PS3 homebrew enthusiasts
      Retro game hobbyists
    Requirements
      Modified PS3 (CFW/HEN)
      User-supplied game files

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Play a supported GameMaker-engine game on a modified PlayStation 3.

USE CASE 2

Test parser or virtual machine changes on a desktop build before deploying to PS3 hardware.

USE CASE 3

Build the PS3 package yourself from source using the PSL1GHT toolchain.

USE CASE 4

Review session logs to diagnose crashes or missing game features.

What is it built with?

CCMakePSL1GHT

How does it compare?

ext5demon/donut-spiderac000/find-flvacc4github/kdenlive-omnifade
Stars00
LanguageCCC
Last pushed2013-04-05
MaintenanceDormant
Setup difficultyhardmoderatemoderate
Complexity4/52/52/5
Audiencegeneraldevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires a modified PS3 (CFW or HEN) and the user's own legally owned game files, source builds need the PSL1GHT PS3 dev toolchain.

Source code is free to use and modify under the Mozilla Public License 2.0, which requires sharing changes to the licensed files.

In plain English

Donut Spider is an experimental piece of software that lets certain GameMaker-engine games run on a PlayStation 3 console, even though those games were never officially released for that hardware. GameMaker is a tool developers use to build 2D games, and this project acts as a runner that reads the game's compiled bytecode and plays it back on the PS3. The current build specifically targets a version of that bytecode format called WAD 17 and is designed to work within the PS3's limited memory. The README is upfront that this is pre-alpha test software. It is playable in some cases but is described as not accurate or stable enough to be considered finished, and it warns users to back up their game saves before trying it. Importantly, the project does not include any actual games, game files, or extracted commercial assets. Users must supply their own legally obtained copy of a supported game, including its main data file and a texture bundle specific to the PS3 build. Installing it requires a PS3 that has been modified to run custom software, known as CFW or HEN. Once installed, the program lets you browse to a game file using the console's controller and launch it. Every session writes a detailed log to the console's hard drive, recording things like the selected game, memory usage over time, and why the session ended, which helps with reporting bugs. Known problems listed in the README include broken transparency in some captured graphics, frame rate drops during intense scenes, and incomplete support for some games or specific game features even within the supported WAD version. Building the project from source requires a specific PS3 development toolchain, CMake, and Python, and there is also a desktop build option for testing changes without needing PS3 hardware. The project builds on two earlier open-source projects, Butterscotch4PS3 and Butterscotch, and its source code is released under the Mozilla Public License 2.0.

Copy-paste prompts

Prompt 1
Explain what WAD 17 support means and why this runner is limited to it.
Prompt 2
Walk me through setting up the PSL1GHT toolchain to build this project for PS3.
Prompt 3
Help me set up a desktop build of this project so I can test changes without PS3 hardware.
Prompt 4
Show me what information I should include when reporting a bug against this project.

Frequently asked questions

What is donut-spider?

A pre-alpha runner that plays certain GameMaker-engine games on a modified PlayStation 3 console.

What language is donut-spider written in?

Mainly C. The stack also includes C, CMake, PSL1GHT.

What license does donut-spider use?

Source code is free to use and modify under the Mozilla Public License 2.0, which requires sharing changes to the licensed files.

How hard is donut-spider to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is donut-spider for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.