Krotox Engine › Docs › Start Here › Welcome & Setup

What is Krotox Engine?

What Krotox is, what is inside it, who it is for, what you need to know first, and how these docs are organised.

Krotox Engine is a 2D game engine written from scratch in C++17. You build your game in a desktop editor for Windows or macOS, write gameplay in C#, and export to Android with one click.

If you have used Unity or Godot for 2D, the ideas will feel familiar: scenes, entities with components, a visual editor, and scripts. The difference is that Krotox does one thing, 2D, and does it with a small, fast runtime built on Vulkan 1.3.

Krotox is at version 1.0.0. These docs describe the 2D workflow as it exists today. Menu names and small details can change between builds.

What is inside

PieceWhat it isWhat it means for you
EditorA dockable desktop app (Windows, macOS)Where you build scenes, tweak values and press Play
RendererVulkan 1.3 2D batcherDraws thousands of sprites, tiles and text quickly, with low battery use on phones
ECSEnTT entity-component systemEvery object is an entity with components you add or remove
PhysicsBox2D 3.xRigidbodies, colliders, joints and collision callbacks
ScriptingMono C#You write gameplay in C#. Changes hot-reload on desktop
AudiominiaudioSound playback in the engine
TextMSDF text renderingText that stays sharp at any size on any phone screen
Android exportNDK, Gradle, Full-AOT MonoOne click turns your project into a signed APK or AAB

Who Krotox is for

What you need to know first

You do not need to know C++ or Vulkan. You write C# scripts, and the engine does the rest. It helps to know:

If you have never programmed, learn the basics of C# first, then come back. The first project tutorial assumes you can read a short script.


How a game gets made in Krotox

  1. Create a project in the Project Hub.
  2. Import art and sound by putting files in your project's Assets folder.
  3. Build a scene by adding entities and attaching components in the editor.
  4. Add behaviour by writing C# scripts and attaching them to entities.
  5. Press Play to test inside the editor, with touch and device-size emulation.
  6. Build and Run on an Android phone from Build Settings, then export a release APK or AAB.

How these docs are organised

Ready? Continue to Install Krotox & system requirements.