Kotlin utilities for LibGDX applications.
About the project
KTX was designed to be modular from day one: in fact, some of these libraries are just a single Kotlin file. After all,
you might not want or need all modules in your application. When possible, the extensions do not depend on the standard
Kotlin library - and even if they do, it is marked as a
provided dependency. You can choose the Kotlin version that suits
you best and it will not be overridden by your build system.
Current KTX modules:
- actors: general
Scene2Dutilities for stages, actors, actions and event listeners.
ApplicationListenerabstract implementations and other general LibGDX application utilities.
- assets: resources management utilities.
- async: coroutines context based on LibGDX threading model.
Box2Dphysics engine utilities.
- collections: extensions for LibGDX custom collections. Based on Kotlin standard library utilities.
- freetype: FreeType font loading utilities.
- freetype-async: FreeType font loading utilities for the async module.
- i18n: some simple extensions that make LibGDX internationalization API less verbose, safer and easier to use.
- inject: unsettlingly simple dependency injection with nearly zero runtime overhead and no reflection trickery.
- log: minimal runtime overhead cross-platform logging using inlined blocks.
- math: operator overloads for LibGDX math API and general math utilities.
- scene2d: type-safe Kotlin builders for
- style: enhances
SkinAPI with type-safe builders of official Scene2D widget styles. Replace your JSON skin file today!
- vis: type-safe Kotlin builders for
VisUI. An alternative to the scene2d module.
- vis-style: enhances
SkinAPI with type-safe builders of
VisUIwidget styles. An extension of style module.
Note that most guides and examples assume that the reader is at least a bit familiar with the LibGDX API.
Afraid to use some third-party code? Browse through the sources, run the test suites. While certainly not perfect, we try to keep to keep the public API clean and every features fully unit tested. Reported code coverage may not be so impressive though, as the coverage tools are currently unable to calculate coverage of inlined methods. And there are plenty of these in some modules.
KTX libraries are currently almost out of beta. While tested and stable enough, we want to give them a little bit more time
and get some user feedback before a stable release. All versions are available through Maven Central and
here. You can also use the preview snapshot releases from
All libraries follow the same naming schema - this is an example Gradle dependency:
$module with the name of required KTX library.
$ktxVersion usually matches LibGDX version it was
compiled against - although it might end with
-b1 (if it is a beta release) or
-SNAPSHOT (if you are using
the snapshots). For example, the first official beta release with the current group ID was compiled against LibGDX
1.9.6 and its version was
1.9.6-b2. You can browse through our releases
Note that even snapshots should be more or less stable, as libraries are not pushed to Maven Central unless they pass the extensive tests.
Each module contains a
README.md file with a list of all features or a guide with a few code snippets. Browse through
the directories in root folder to find out more about each library. GitHub releases also contain archives with generated
Dokka documentation for each module.
If you want to help, read the contribution guideline and browse through the issues to see what's currently to do. Don't be afraid to create issues just to ask a question or make a request for any kind of improvements. Before creating any pull requests, be aware that the code is dedicated to public domain.