Lightweight 2D game engine enables creation of simple games with modular plugins for scaling, object management, audio, shaders, and physics. Offers tools like Scene Editor and Debug Menu.
A 2D game engine based on Compose Multiplatform
This repository contains the source code of the Kotlin Multiplatform library and its plugins / tooling, as well as the Kubriko Showcase application that demonstrates the engine's capabilities.
[!IMPORTANT]
Kubriko is in early stages of development. The API might change and bugs can be present. The documentation and the tutorials are not yet finalized.
Kubriko aims to offer a lightweight, scalable, and easy-to-use solution for creating simple 2D games for Android, Desktop (Windows, Linux, macOS), iOS and Web. It achieves this goal by exposing a Composable function that can easily be embedded into Kotlin Multiplatform projects.
The engine is highly modular, because its core functionality can be extended in a granular fashion using different plugins. These plugins cover most needs of simple games; from viewport scaling and object management, through persistence, input handling, and audio playback, all the way to shaders and physics simulation. Kubriko also offers a number of tools, such as a Scene Editor and a Debug Menu, that can be useful during development.
The tech stack is easy to extend by creating custom plugins, and the low-level integration makes it possible to communicate with platform API-s in a straightforward way.
[!NOTE] The Kotlin/Wasm export functionality of Compose Multiplatform is currently in alpha. This also applies to the Web version of games created with Kubriko. Check out this page for a complete list of limitations.
Clone this repository and run the app module for the supported targets (Android, Desktop, iOS, Web) to check out what the engine is capable of.
You can find the pre-built applications following these links:
[!NOTE] Some of the links above might not be available / up to date, so the best way to try Kubriko Showcase is to build the project yourself.
Follow the links below to get started with the first steps of integrating the library, to read the full documentation, to watch step by step videos on how to approach specific types problems, or to join our Discord server where you can discuss more advanced topics with the community, or promote your own creations.
Another way to learn about Kubriko is to explore this repository and understand how the various examples are implemented.
And the best way, of course, is having fun while creating your very own games!
Besides hosting the engine's source code, this repository also serves as the documentation for its feature set. Each top-level folder / module has its own Readme file that contains general information about the relevant piece of functionality:
For more details, read the KDoc comments for the classes and functions that are exposed in the public API.
Expand the sections below to see the complete list of all Kubriko dependencies hosted on MavenCentral.
io.github.pandulapeter.kubriko:engineThe latest version is:
ProGuard / R8 only run on the JVM targets; iOS and Web are optimized by their own compilers. Kubriko adds no requirements of its own — for the JVM targets the Showcase's rule files (linked below, with explanatory comments) double as the reference.
Displaying the Kubriko logo in games created with the engine, or just mentioning Kubriko somewhere in the credits is highly appreciated! Also, if you create anything with Kubriko that you're proud of, don't hesitate to reach out to me via email or Discord!
Kubriko is my pet project, that I'm developing in my free time. If you found it useful, I'm happy to accept donations through the following means:
Thank you in advance!
Any help in making Kubriko a better engine is very welcome!
This library is published under the Mozilla Public License Version 2.0, which can be found here. You are free to use the Kubriko engine to develop your own proprietary games at no cost and without attribution.
However, if you create derivative works (such as forks or competing engines), these must be open source and include a link back to this repository.
examplesio.github.pandulapeter.kubriko:plugin-audio-playbackio.github.pandulapeter.kubriko:plugin-collisionio.github.pandulapeter.kubriko:plugin-keyboard-inputio.github.pandulapeter.kubriko:plugin-particlesio.github.pandulapeter.kubriko:plugin-persistenceio.github.pandulapeter.kubriko:plugin-physicsio.github.pandulapeter.kubriko:plugin-pointer-inputio.github.pandulapeter.kubriko:plugin-serializationio.github.pandulapeter.kubriko:plugin-shadersio.github.pandulapeter.kubriko:plugin-spritesio.github.pandulapeter.kubriko:tool-debug-menuio.github.pandulapeter.kubriko:tool-debug-menu-apiio.github.pandulapeter.kubriko:tool-debug-menu-noopio.github.pandulapeter.kubriko:tool-loggerio.github.pandulapeter.kubriko:tool-scene-editorio.github.pandulapeter.kubriko:tool-scene-editor-apiio.github.pandulapeter.kubriko:tool-scene-editor-noopio.github.pandulapeter.kubriko:tool-ui-components| Platform | Tool | What you need to add |
|---|
| Android | R8 | Nothing - see app/android/proguard-rules.pro |
| Desktop | ProGuard | Copy from app/desktop/proguard-rules.pro |
| iOS | Kotlin/Native | Nothing - handled by the compiler |
| Web | Kotlin/Wasm | Nothing - handled by the compiler |
Surfaced from shared tags and platforms — no rankings paid for.