/gdx-controllerutils

Controller Utilities for libGDX

Primary LanguageJavaApache License 2.0Apache-2.0

gdx-controllerutils

Utilities for using controllers with libGDX.

ℹ️ Note The enhanced drop-in replacements for the official gdx-controllers extension are not needed any more. All features are included in gdx-controllers v2, usable with gdx 1.9.11+. If you still need to use an older gdx version, refer to v2.2.1

Compile and publish local Maven Central

Subprojects

All subprojects are technically independant, you can use only one of them in your project. They are bundled in a single Github project because all have something to do with Game Controller Input and libGDX.

core-scene2d

Key and button supporting Stage with focusable Actors for Scene2d. This is also usable in games without Game Controller support.

Documentation

core-mapping

Support configurable mappings for game controllers in your projects.

Documentation

Demos and examples

core-scene2d is shown with sources in raeleus' Shadow Walker UI demo.

All subprojects are used in my game Falling Lightblocks Web/Android/iOS/FireTV. Take a look at the sources.

Installation

This project is published to the Sonatype Maven repository. You can integrate the lib into your project by just adding the dependencies to your build.gradle file.

Define the version of this API right after the gdxVersion:

gdxVersion = '1.9.11' //or another gdx version you use
cuversion = '2.3.0' // or 1.0.1 if you are on gdx <= 1.9.10

Then add the needed dependencies to your project. You will find the artifact ids on the subproject's wiki sites.

Building from source

To build from source, clone or download this repository, then open it in Android Studio. Perform the following command to compile and upload the library in your local repository:

gradlew clean publish -PLOCAL=true

See build.gradle file for current version to use in your dependencies.

News & Community

You can get help on the libgdx discord.

License

The project is licensed under the Apache 2 License, meaning you can use it free of charge, without strings attached in commercial and non-commercial projects. We love to get (non-mandatory) credit in case you release a game or app using this project!