Godot Play Game Services
Godot 4.2+ plugin for integration of the latest version of Google Play Game Services SDK.
Forewords
The whole project started as a collaboration with Rafa Laguna, and this plugin is the updated version of the old one for Godot 3.5+.
With Godot 4.2+, the way android plugins work has changed, so I had to update this plugin to match the new requirements. Now there’s only one editor plugin (this one), instead of having two separate plugins like before, one android plugin and one godot plugin.
How to use the plugin
Using the plugin requires downloading the repository, and generating the sources. I’m working to provide a more user-friendly way of using the plugin, but for now I’m afraid this is the only way of using it.
Downloading the plugin
To download the plugin you can use git to clone it, or just download the repository in a zip file from Github.
Building the plugin
In a terminal window, navigate to the project’s root directory and run the following command:
./gradlew assemble
The output files can be found in plugin/demo/addons. The plugin itself, that you can copy to your project to use, is in the plugin/demo/addons/GodotPlayGameServices, just copy the whole GodotPlayGameServices folder into the addons folder of your Godot project and activate the plugin in Project -> Project Settings... -> Plugins
Testing the plugin
You can also use the included Godot demo project to test the built Android plugin.
- Open the demo in Godot (4.2 or higher)
- Navigate to
Project->Project Settings...->Plugins, and ensure the plugin is enabled - Install the Godot Android build template by clicking on
Project->Install Android Build Template... - Connect an Android device to your machine and run the demo on it
- Follow the steps on Configuring the plugin
Configuring the plugin
Before configuring the plugin, you have to create a Google developer account, which involves a one time payment to google, and then you must create a game. The explanation on how to do all of these is out of the scope of this documentation. Please refer to Google for those steps.
Once that’s done, you will need to create some achievements and leaderboards in your game, which will generate some IDs. You will need those IDs later in your game, but for the plugin, the one that’s important is the Game ID, which can be found in your game configuration, in the Google Dev Console:
In order to make the configuration easier, the plugin adds a new dock to the bottom panel of your Godot editor, where you can add the Game ID. Once you click on the submit button, the configuration will be saved and loaded every time you reopen the editor.
⚠️ Beware of not changing the Game Id and submitting by mistake, since that will break the integration with Google Game Services.
Export configuration
To be able to use the plugin, you need to use a custom gradle build. The steps to do so, are explained with detail in the Godot Documentation.
An additional configuration has to be made in order to connect with Google Game Services. In the Google App, you have to configure an Android OAuth client. Google describes the steps here, but at some point you have to introduce the package name of your game, as well as the SHA-1 of your signing key. Both things need to be introduced also in the Godot Export configuration for Android:
Technical Documentation
You can find the technical documentation of the kotlin code in the Github Pages of the repository.
You can find Google’s technical documentation of the SDK here.
