Skip to main content

Godot Integration

This page guides you through the process of downloading, importing, and configuring the Yodo1 MAS SDK for Godot.

Prerequisites​

To integrate the Yodo1 MAS SDK on Godot, you need to meet the following requirements:

  • Minimum API Level 23 or above
  • Target API Level 33 or above
  • compileSdkVersion 33 or above
  • Android Gradle plugin version 7.4.2 or above
  • Gradle 7.5.1 or above
  • If you use ProGuard, please refer to the documentation

Plugin Installation​

  1. Configure, install, and enable the "Android Custom Template"

  2. Add the following files in res://android/Plugins folder:

    • GodotYodo1Mas.1.0.1.release.aar
    • GodotYodo1Mas.gdap

    You can download these files from Github.

Configure Build Settings​

Update build.gradle​

  1. Open the build.gradle file in res://android/build

  2. Add the following maven repositories:

repositories {
    maven { url "https://artifact.bytedance.com/repository/pangle" }
    maven { url "https://android-sdk.is.com" }
    maven { url "https://dl-maven-android.mintegral.com/repository/mbridge_android_sdk_oversea" }
    maven { url "https://artifactory.bidmachine.io/bidmachine" }
    maven { url "https://ysonetwork.s3.eu-west-3.amazonaws.com/sdk/android" }
    maven { url "https://artifacts.applovin.com/android/beta/" }
}

dependencies {
    implementation 'com.yodo1.mas:full:4.14.2'
}
  1. Enable multidex in your defaultConfig:
android {
    defaultConfig {
        multiDexEnabled true
    }
}

Update AndroidManifest.xml​

Add your AdMob ID to your app's AndroidManifest.xml file. You can find your AdMob ID under the "details" of your app on the MAS Dashboard.

<manifest>
    <application>
        <!-- Sample AdMob ID: ca-app-pub-3940256099942544~123456789 -->
        <meta-data
            android:name="com.google.android.gms.ads.APPLICATION_ID"
            android:value="YOUR_ADMOB_APP_ID"/>
    </application>
</manifest>

Update gradle.properties​

Add the following property to your gradle.properties file:

android.enableDexingArtifactTransform=false

Configure the SDK​

  1. Copy the yodo1mas.gd script and use it in your project. It is a helper script that allows you to easily use the Yodo1 MAS SDK. Github 1.1 - Attach the script to any node and enter the App Key, you can find the App Key in MAS Dashboard in the "Management" > "Games" section.

    Godot Configuration
    Godot Configuration

  2. Initialize the Privacy frameworks, this is already added in the Yodo1mas.gd script.

    Privacy Frameworks Setup
    Privacy Frameworks Setup

  3. Initialize the SDK. This is already added in the yodo1mas.gd script.

    Initialize SDK
    Initialize SDK