paladin-t / bitty

Home | Steam | Itch | Documents | About

An itty bitty game engine.

• About Bitty Engine
  • Why Bitty Engine?
  • Features
  • Technical specifications
• Glance
  • Code
  • Games
• Redistributing
• Getting Bitty Engine
• Compiling from source
  • Startup project
  • Windows
  • MacOS
  • Linux
  • Other platforms
• Community and contributing
• Documentation

About Bitty Engine

Bitty Engine is a cross-platform itty bitty Game Engine and open-source Framework. The full featured engine is programmable in Lua and integrated with built-in editors. It keeps the nature of both engine's productivity, and fantasy computer/console's ease to iterate. It boosts your commercial/non-commercial projects, prototypes, game jams, or just thought experiments.

Why Bitty Engine?

Bitty Engine has everything built-in for coding, graphics composing, etc; it has a full featured debugger for breakpoint, variable inspecting, stepping, and call-stack traversing; it offers a set of well-designed API with full documentation; it builds fast binaries with code and asset obfuscating, moreover its package size is small (around 10MB with empty project, other engine outputs more than 10 times bigger).

It is supposed to be your ultimate 2D game creating software.

Features

Bitty Engine offers a set of orthogonal features that makes game development comfortable and enjoyable.

• Resources API
  • Resources.load(...), Resources.unload(...)
  • Resources.wait(...), Resources.collect(...)
  • Etc.
• Graphics API
  • Shapes: plot(...), line(...), circ(...), ellipse(...), rect(...), tri(...)
  • Text: text(...), font(...), measure(...)
  • Texture: tex(...)
  • Sprite: spr(...)
  • Map: map(...)
  • clip(...), camera(...)
  • Etc.
• Input API
  • Gamepad
  • Keyboard
  • Mouse and touch
• Audio API
  • Supports MP3, OGG, WAV, FLAC, etc.
• Physics API
  • Space, Shape, Body, Arbiter, etc.
• Libraries
  • Algorithms, Archive, Bytes, Color, DateTime, Encoding, File, Filesystem, Image, Json, Math, Network, Platform, Web
• Application interfaces
  • Application, Canvas, Project, Debug

Technical specifications

• Display: configurable resolution
• Code: Lua, supports multiple source files
• Image: either true-color (PNG, JPG, BMP, TGA) or paletted, up to 1024x1024 pixels per file
• Palette: 256 colors with transparency support
• Sprite: up to 1024x1024 pixels per frame, up to 1024 frames per sprite
• Map: up to 4096x4096 tiles per page
• Font: supports Bitmap and TrueType
• Audio: 1 BGM channel, 4 SFX channels; supports MP3, OGG, WAV, FLAC, etc.
• Gamepad: 6 buttons for each pad (D-Pad + A/B), up to 2 players
• Keyboard and mouse: supported

Glance

Code

local obj = nil

function setup()
  obj = Resources.load('hero.spr')
  obj:play('move', true, true)
end

function update(delta)
  spr(obj, 208, 128, 64, 64)
end

See more in examples.

Games

Redistributing

Bitty Engine helps you to make standalone binaries for Windows, MacOS, Linux, and HTML (WebAssembly). It is redistributable for both non-commercial and commercial use without extra fee, your project is totally yours.

Everything is done with Bitty Engine (pro) by nothing more than a few mouse clicks.

Put an image at "../icon.png" relative to executable to customize the icon dynamically. Put an image at "../splash.png" as well to customize the splash, the image could be transparent.

Getting Bitty Engine

The pro version is available on Steam and Itch.

See version comparison.

Compiling from source

A C++14 capable compiler is required, any compiler came after 2014 should be ok. You need to get this repository and its submodules before build:

git clone https://github.com/paladin-t/bitty.git
cd bitty
git submodule init
git submodule update

Startup project

Once you have setup and built a binary, it loads from "../data" or "../data.bit" automatically as startup project. Otherwise it shows a programmable workspace.

Windows

Dependencies: Visual Studio (with C++ development tools installed).

MacOS

Dependencies: Xcode.

Linux

Dependencies: CMake, GCC.

Other platforms

Community and contributing

• Discord
• GitHub Discussions
• Issues
• Pull Requests

Documentation

• Reference Manual
• Operations
• Keycodes
• Formats
• Changelog