git404hub

what is thepowdertoy fr?

libretro/thepowdertoy — explained in plain English

Analysis updated 2026-07-19 · repo last pushed 2026-07-13

8C++Audience · generalComplexity · 3/5ActiveSetup · moderate

tl;dr

A physics sandbox game where you draw substances on screen and watch them interact, now adapted to run inside RetroArch and other LibRetro-compatible frontends.

vibe map

mindmap
  root((repo))
    What it does
      Physics sandbox
      Draw and simulate
      Lua scripting API
    Where it runs
      LibRetro frontend
      RetroArch
      Classic emulator UIs
    Use cases
      Visualize physics
      Build in-game circuits
      Creative sandbox play
    Audience
      Students
      Tinkerers
      Casual players
    Tech stack
      C++
      CMake
      Lua scripting

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 make with this?

VIBE 1

Visualize physics concepts like heat, gravity, and air pressure by drawing materials on a canvas.

VIBE 2

Build working electronic circuits or even a simple CPU inside the game world.

VIBE 3

Create and detonate elaborate bombs and watch the simulation handle explosions.

VIBE 4

Automate gameplay or create plugins using the built-in Lua scripting API.

what's the stack?

C++CMakeLua

how it stacks up fr

libretro/thepowdertoyteam-resurgent/flycast-xtycho/pearpc
Stars888
LanguageC++C++C++
Last pushed2026-07-132026-07-022011-05-31
MaintenanceActiveActiveDormant
Setup difficultymoderatehardhard
Complexity3/54/54/5
Audiencegeneraldevelopergeneral

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

how do i run it?

Difficulty · moderate time til it works · 30min

Requires compiling C++ with CMake and having a LibRetro frontend like RetroArch installed to actually run the core.

The explanation does not mention a license, license terms are unknown.

in plain english

The Powder Toy is a free physics sandbox game where you draw substances on screen and watch how they interact. You can simulate explosions, build a nuclear power plant, design electronic circuits, create realistic landscapes, or just blow things up. This repo brings that game into the LibRetro ecosystem, which means it can run inside frontends like RetroArch, alongside classic console emulators and other retro-style applications. You pick elements like building materials, liquids, gases, or electronics, and draw them onto the canvas. The game then simulates how those substances behave, modeling air pressure, heat, gravity, and countless reactions between materials. You can pause to plan, take screenshots, save your creations as stamps, and browse or play community-uploaded saves. This would appeal to anyone who likes tinkering or creative sandbox games. A student could use it to visualize physics concepts, a hobbyist could build a working in-game CPU, and a casual player might just enjoy constructing elaborate bombs and watching them go off. The game also includes a Lua scripting API for automating tasks or creating plugins. The project is built in C++ and compiled using cmake. The controls are extensive, covering brush shapes, copy-paste, undo-redo, debug overlays, and various simulation toggles for gravity and air. Beyond the build instructions and credits, the README does not go into detail about what LibRetro-specific features are supported or what tradeoffs the port makes compared to the standalone version.

prompts (copy fr)

prompt 1
Help me build the LibRetro port of The Powder Toy using CMake on my machine, including any steps needed to load the compiled core in RetroArch.
prompt 2
Write a Lua script for The Powder Toy that spawns a specific pattern of materials and triggers a reaction, then explain how to load it as a plugin.
prompt 3
Walk me through building a basic electronic circuit in The Powder Toy, step by step, so I can understand how in-game wiring and logic gates work.
prompt 4
Explain how the air pressure and heat simulation works in The Powder Toy and give me a list of material combinations that produce interesting reactions.

Frequently asked questions

what is thepowdertoy fr?

A physics sandbox game where you draw substances on screen and watch them interact, now adapted to run inside RetroArch and other LibRetro-compatible frontends.

What language is thepowdertoy written in?

Mainly C++. The stack also includes C++, CMake, Lua.

Is thepowdertoy actively maintained?

Active — commit in last 30 days (last push 2026-07-13).

What license does thepowdertoy use?

The explanation does not mention a license, license terms are unknown.

How hard is thepowdertoy to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is thepowdertoy for?

Mainly general.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.