🧸 Tiny Game Engine

🎮 Tiny is a lightweight, cross-platform game engine powered by Lua — perfect for small games, game jams, and rapid prototyping.

Breakout created with Tiny Game Engine

✨ Features

🖥️ & 🌐 Multiplatform – Runs on desktop and web
✍️ Lua scripting – Simple, flexible, and fast
🔄 Hot reload – Instantly see your code changes
🪶 Lightweight – No bloat, just the essentials for small games

🚀 Getting Started

Create your first game with just a few lines of Lua:

function _draw()
    -- draw a rectangle at {x: 10, y: 10} with the size {width: 100, height: 50} 
    shape.rectf(10, 10, 100, 50)
end

➡️ Read the Getting Started Guide to set up the engine and start creating!

⌨️ CLI Commands

tiny-cli create <name>    # Create new game
tiny-cli run              # Run game
tiny-cli debug            # Run with debugger
tiny-cli serve            # Dev server with hot reload
tiny-cli export           # Export for web
tiny-cli palette          # Generate color palettes
tiny-cli sfx              # Sound effect editor
tiny-cli add              # Add resources to project

📦 Download

Get the latest version from the Releases Page.

📚 Documentation

Full documentation is available on the Tiny website, including:

Engine setup
Lua API reference
Examples and tutorials

🗣️ A behind-the-scenes presentation was given at DroidKaigi 2024 – Tokyo:

📽️ Watch the session on YouTube
📑 View the slides

🎮 Games Made With Tiny

Want to create games like these? Dive into the docs and start building:

🤝 Contributing

We welcome contributions!

Fork the repository
Create your feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

📄 License

🧸 Tiny is open-source software licensed under the MIT License.

Use it freely in personal, jam, or commercial projects.

🛠️ Tech Overview

| Core | Scripting | Platforms | License | |----------------|-----------|------------------|---------| | Kotlin Multiplatform | Lua | Desktop, Web | MIT |

Tiny

Install / Use

README