1. Home
  2. Godot Integration for Android (old)

Godot Integration for Android (old)

You may use the Yodo1 MAS plugin with Godot Engine 3.2.3 or higher.

When you integrate the SDK, you import its library file into your project so you may use the file’s functions. Integrating the MAS SDK into your mobile app project gives you access to MAS fully managed monetization solution. This solution taps into multiple ad mediation platforms, selecting the one best suited for your game’s monetization through high quality ad networks that serve in-app ads.

Before you can start monetizing your app, you’ll need to integrate the MAS SDK.

Integrating the SDK

First, you need to download this file. It consists of three folders:

  • yodo1mas-plugin-android. Android plugin.
  • yodo1mas-plugin-ios. iOs plugin.
  • demo. Godot project, will work on iOs and android platforms.

Setup new project

  1. Configure, install, and enable the “Android Custom Template” for your project by following the official documentation;
  2. Copy folder plugins from the Yodo1Godot_release_files_1.. archive to your Godot project. You have to add them in the path res://android. This plugins folder contains two files GodotYodo1Mas.gdapand GodotYodo1Mas.***.aar.
[config]

name="GodotYodo1Mas"
binary_type="local"
binary="GodotYodo1Mas.1.0.0.release.aar"

[dependencies]

remote=["com.yodo1.mas:standard:4.1.0"]
  1. Copy the yodo1mas.gd file from the release archive and paste it into your Godot project.
  2. Copy files AndroidManifest.xmlconfig.gradle, and build.gradle and place them in the path res://android.
  3. Add your AdMob App ID
    • Add your AdMob App ID to your app’s res//android/build/AndroidManifest.xml file by adding the tag.
    • You can find your App ID in the MAS dashboard.
    • Please replace android:value with your own AdMob App ID
  1. Under Project -> Export -> Android -> Options ->
    • Custom Template: check Use Custom Build
    • Plugins: check Godot Yodo1 Mas (this plugin)
    • Permissions: check permissions for Access Network State and Internet
  1. Use Android label with attribute tools:replace. Example:
 <application tools:replace="android:label" android:label="GodotYodo1Mas"
  1. Each system has a different version of Gradle installed. Please make sure to match the Grade version with the Gradle plugin version according to the table bellow.
Plugin VersionRequired Gradle Version
1.0.0 – 1.1.32.2.1 – 2.3
1.2.0 – 1.3.12.2.1 – 2.9
1.5.02.2.1 – 2.13
2.0.0 – 2.1.22.10 – 2.13
2.1.3 – 2.2.32.14.1 – 3.5
2.3.0+3.3+
3.0.0+4.1+
3.1.0+4.4+
3.2.0 – 3.2.14.6+
3.3.0 – 3.3.34.10.1+
3.4.0 – 3.4.35.1.1+
3.5.0 – 3.5.45.4.1+
3.6.0 – 3.6.45.6.4+
4.0.0+6.1.1+
4.1.0+6.5+
4.2.0+6.7.1+
  1. Check the build.gradle file. You need to add repositories and activate multiDexEnabled.
maven { url "https://dl.bintray.com/ironsource-mobile/android-sdk" }
maven { url "https://dl.bintray.com/ironsource-mobile/android-adapters" }
maven { url "https://dl.bintray.com/yodo1/MAS-Android" }
maven { url "https://dl.bintray.com/yodo1/android-sdk" }
	multiDexEnabled true
  1. You can export your Android project. An APK will be created automatically.

NOTE: Everytime you install a new version of the Android Build Template, you need to repeat this step, because it overrides the existing AndroidManifest.xml file.

Compiling the Plugin (Optional)

Compiling the plugin by yourself, is fairly easy.

  1. Clone this repository.
  2. Check for the desired version.
  3. Download the AAR library for Android plugin from the official Godot website.
  4. Copy the downloaded AAR file into the yodo1mas-plugin-android/godot-lib.release/ directory and rename it to godot-lib.release.aar.
  5. Use the command line and go to the yodo1mas-plugin-android/ directory.
  6. Run gradlew build.

You can also make a build using the Android Studio.

If all goes well, you’ll find the .aar files at yodo1mas-plugin-android/godotadmob/build/outputs/aar/.

Godot Manual

Set App Ids-

Create a Yodo1Mas node and add app ids in the yodo1mas script. You can find your App IDs in the MAS dashboard. 

Updated on June 11, 2021

Was this article helpful?