KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agent #developer-tools #codex #typescript #cli #deepseek-harness #claude-code #ai-agents #mcp #rust

Punity

★ 487 Open GitHub ↗

A tiny game engine in C.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Punity

A tiny game engine with zero dependencies in C that I made for myself to make tiny games. It's great for game jams. It is also my kōhai course in simplicity and a tribute to my senpai and friend [rxi](https://twitter.com/x_rxi).

- Single file: `punity.h` all ready for you to start working. (maybe also grab `build.bat` when you're at it)
- Approx. 6000 lines of C code.
- No dependencies.
- Produces a single executable with all resources baked to it.
- Images in PNG, JPG, PSD, TGA, GIF, BMP, HDR, PIC, PNM when used with `stb_image`. (see **Integration** below)
- Sounds in OGG when used with `stb_vorbis`. (see **Integration** below)
- Drawing bitmaps, texts and standard primitives all in software, this is *feature*, shut up!
- Deferred drawing through draw lists.
- Sounds, fonts and bitmap API available.
- Built in GIF recorder (outputs `record.gif` file).
- Example included (see `example-platformer.c`).
- Experimental integration with SDL2 (build with `build sdl`, see `lib/punity-sdl.c`).

## Speed

On an average machine, a game [33 grams](https://martincohen.itch.io/33-grams) utilizing previous version of Punity runs in 240x240 at ~20μs per frame (equivalent of ~50000 FPS). On [GCW Zero](http://www.gcw-zero.com/specifications), the same game in 320x240 runs between 0.7ms to 2ms per frame (equivalent of ~500-1500 FPS).

## Limitations

- Perfect for use with 320x240 resolution. No one will ever need more, anyway.
- Perfect for simple pixel art with only 255 colors (0 reserved for transparency)!
- No need to worry about 8 bits of transparency, because you just get one!
- Optionaly limited to 30 frames per second that gives you them retro feels!
- Windows is supported directly, other platforms (*nix, Mac OS X, Android, Dingus, etc.) via SDL-2 (see [lib/punity-sdl.c](./lib/punity-sdl.c))

## Goals

- **Ready-to-go instant package.** No tedious external dependencies or fussing around with linkers: download, code and build from a single package.
- **Simplicity and minimalism.** Rather go for limitations than complexities.
- **Portability** Only get absolute minimum from the platform (window, input and drawing/audio buffers).
- **Optional additional features.** Plug & play addons for additional asset file formats, platforms or even scripting.
- **No arbitrary limitations.** All the limitations in the system have their reasons (performance, API simplicity). You might be writing a retro game, but the devices today have a lot of memory and computational power to use.
- **One file.** Even though it's supposed to be a ready-to-go package, the essence is in a single file that you can grab and use.

One of the most important parts of Punity is that it's made to be changed and edited as you need. That way the code can be really simple only giving you basic features and doesn't need to worry about customizations and abstractions.

# Documentation

Please, see the [documentation in Wiki](https://github.com/martincohen/Punity/wiki).

## Files

- `lib/stb_image.h` - Optional library to load images.
- `lib/stb_vorbis.c` - Optional library to load ogg audio files.
- `lib/gifw.h` - Optional library to record and save GIFs.
- `build.bat` - MSVC and MinGW build batch file.
- `main.c` - Minimal template for jump-start game development.
- `main.rc` - Part of the template.
- `punity.h` - Punity's header/implementation file.

In case you use MinGW, then you'll also need these:

- `mingw/_mingw_unicode.h` & `mingw/dsound.h` - Provided for your convenience to be able to build with default MinGW installation. This file is taken from MinGW-W64 project.

# Contributors

- [@d7samurai](https://twitter.com/d7samurai)
- [@x_rxi](https://twitter.com/x_rxi)

# Thank you

To everyone who gives Punity it a try, plus these awesome guys:
 
 - [@j_vanrijn](https://twitter.com/J_vanRijn) for his tall support 24/7.
 - [@cmuratori](https://twitter.com/cmuratori) for handmadehero.org
 - [@nothings](https://twitter.com/nothings) for [stb](https://github.com/nothings/stb).

Punity

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README