{"id":13528884,"url":"https://github.com/libgdx/gdx-controllers","last_synced_at":"2025-05-07T17:47:59.118Z","repository":{"id":37987654,"uuid":"293561025","full_name":"libgdx/gdx-controllers","owner":"libgdx","description":"A libGDX cross platform game controllers extension","archived":false,"fork":false,"pushed_at":"2023-12-13T10:11:53.000Z","size":1191,"stargazers_count":74,"open_issues_count":7,"forks_count":14,"subscribers_count":15,"default_branch":"master","last_synced_at":"2025-03-31T12:38:38.512Z","etag":null,"topics":["android","gamecontroller-framework","gamepad","gamepad-library","ios","java","libgdx","linux","macosx","windows"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/libgdx.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2020-09-07T15:10:39.000Z","updated_at":"2025-03-08T20:00:36.000Z","dependencies_parsed_at":"2022-09-06T00:52:36.643Z","dependency_job_id":"3a168f6d-921b-4637-8142-d5b72431713e","html_url":"https://github.com/libgdx/gdx-controllers","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/libgdx%2Fgdx-controllers","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/libgdx%2Fgdx-controllers/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/libgdx%2Fgdx-controllers/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/libgdx%2Fgdx-controllers/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/libgdx","download_url":"https://codeload.github.com/libgdx/gdx-controllers/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252930439,"owners_count":21827052,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","gamecontroller-framework","gamepad","gamepad-library","ios","java","libgdx","linux","macosx","windows"],"created_at":"2024-08-01T07:00:27.253Z","updated_at":"2025-05-07T17:47:59.092Z","avatar_url":"https://github.com/libgdx.png","language":"Java","funding_links":[],"categories":["Resources"],"sub_categories":["Controllers"],"readme":"# 🎮️ Game Controller Extension for libGDX, Version 2\n\nUse game controllers with ease in your libGDX games.\n\n[📖️ Documentation](https://github.com/libgdx/gdx-controllers/wiki) - [🎁️ Feature overview](https://github.com/libgdx/gdx-controllers/wiki/Features) - [Compatibility](https://github.com/libgdx/gdx-controllers/wiki/Compatibility)\n\n[🚀️ Migration guide from v1](https://github.com/libgdx/gdx-controllers/wiki/Migrate-from-v1)\n\n## 💾️ Installation\n\nThe recommended way to use gdx-controllers is via dependency management with Gradle or Maven. Artifacts are available in\n[Snapshot Repository](https://oss.sonatype.org/content/repositories/snapshots/com/badlogicgames/gdx-controllers/) and Maven Central.\n\n[![Sonatype Nexus (Releases)](https://img.shields.io/nexus/r/com.badlogicgames.gdx-controllers/gdx-controllers-core?nexusVersion=2\u0026server=https%3A%2F%2Foss.sonatype.org\u0026label=release)](https://search.maven.org/artifact/com.badlogicgames.gdx-controllers/gdx-controllers-core)\n[![Sonatype Nexus (Snapshots)](https://img.shields.io/nexus/s/com.badlogicgames.gdx-controllers/gdx-controllers-core?server=https%3A%2F%2Foss.sonatype.org\u0026label=snapshot)](https://oss.sonatype.org/#nexus-search;gav~com.badlogicgames.gdx-controllers~gdx-controllers-core)\n\n*project-root/build.gradle:*\n\n    ext {\n        gdxControllersVersion = '2.0.1' // see badges above for latest versions\n    }\n\nAdd the following dependencies:\n\n#### core:\n```\nimplementation \"com.badlogicgames.gdx-controllers:gdx-controllers-core:$gdxControllersVersion\"\n```\n#### desktop:\n```\nimplementation \"com.badlogicgames.gdx-controllers:gdx-controllers-desktop:$gdxControllersVersion\"\n```\n\nThis will automatically fetch the [underlying SDL-based natives and Java wrappers](https://github.com/libgdx/Jamepad).\nIf you want to use a newer version, add the dependency yourself:\n\n    implementation(\"com.badlogicgames.jamepad:jamepad:$jamepadVersion\") {\n\t    exclude group: 'com.badlogicgames.gdx', module: 'gdx-jnigen-loader'\n    }\n\nMake sure to check the [compatibility doc](https://github.com/libgdx/gdx-controllers/wiki/Compatibility) when doing so.\n\n#### android:\n```\nimplementation \"com.badlogicgames.gdx-controllers:gdx-controllers-android:$gdxControllersVersion\"\n```\nProguard setting:\n```\n-keep class com.badlogic.gdx.controllers.android.AndroidControllers { *; }\n```\n\n#### ios:\n```\nimplementation \"com.badlogicgames.gdx-controllers:gdx-controllers-ios:$gdxControllersVersion\"\n```\n`robovml.xml` needs the following lines added to `forceLinkClasses` and `frameworks`:\n```\n\u003cpattern\u003ecom.badlogic.gdx.controllers.IosControllerManager\u003c/pattern\u003e \n....\n\t\u003cframework\u003eGameController\u003c/framework\u003e\n```\nIf you forget to explicitly link the framework, no game controller will show up.\n\n#### html:\n```\nimplementation \"com.badlogicgames.gdx-controllers:gdx-controllers-core:$gdxControllersVersion:sources\"\nimplementation \"com.badlogicgames.gdx-controllers:gdx-controllers-gwt:$gdxControllersVersion:sources\"\n```\nYou also need to add the following file to your GdxDefinition.gwt.xml in your html project:\n```\n\u003cinherits name=\"com.badlogic.gdx.controllers\" /\u003e\n\u003cinherits name=\"com.badlogic.gdx.controllers.controllers-gwt\"/\u003e\n```\n\n### Building from source\nTo 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:\n\n    gradlew clean uploadArchives -PLOCAL=true\n    \nSee `build.gradle` file for current version to use in your dependencies.\n\n## 🤝️ News \u0026 Community\n\nYou can get help on the [libgdx discord](https://discord.gg/6pgDK9F).\n\n## License\n\nThe 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!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flibgdx%2Fgdx-controllers","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flibgdx%2Fgdx-controllers","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flibgdx%2Fgdx-controllers/lists"}