Configuration

The build files are largely static and shared across all GMP plugins. Any plugin-specific build customization is handled through the following configuration files:

.
├── addon/
│   └── ?.gradle.kts                   # Any extra Gradle configuration (configured in
│                                      # common/config/config.properties) for the plugin goes here
│
├── common/
│   ├── local.properties               # Local machine config (gitignored)
│   │
│   ├── config/
│   │   ├── config.properties          # Common plugin configuration
│   │   └── mediation.properties       # Ad mediation configuration
│   │
│   └── gradle/
│       └── libs.versions.toml         # Android dependencies and versions
│
└── ios/
    └── config/
        └── config.properties          # iOS configuration

Common Configuration

The common/config/config.properties file contains core plugin settings:

# Plugin identification
pluginNodeName=...                # Name of the plugin node in Godot
pluginModuleName=...              # Module name for native code
pluginVersion=1.0                 # Plugin version

# Godot configuration
godotVersion=4.6                  # Target Godot version
godotReleaseType=stable           # Release type: stable, dev6, beta3, rc1, etc.

# Extra properties configured in the following format
extra.anotherProperty=property value

# Extra gradle configuration files in the following format
gradle.another=another.gradle.kts

Key Properties: - pluginNodeName - The name of the main plugin node used in Godot - pluginVersion - Semantic version for releases - godotVersion - Must match your target Godot version - godotReleaseType - Determines which Godot binary to download

Mediation Configuration

The common/config/mediation.properties file defines ad mediation adapters:

# Example mediation adapter configuration
applovin.dependencies=com.google.ads.mediation:applovin:13.4.0.1
applovin.mavenRepo=
applovin.spmPackage=googleads/swift-package-manager-google-mobile-ads/GoogleMobileAdsMediationAppLovin
applovin.spmVersion=13.4.0.0
applovin.skAdNetworkIds=...

Each adapter has: - dependencies - Android Maven dependencies - mavenRepo - Custom Maven repository URL (if needed) - spmPackage - iOS Swift Package Manager repository path - spmVersion - iOS SPM package version - skAdNetworkIds - iOS SKAdNetwork identifiers

Gradle Configuration

The common/gradle/libs.versions.toml defines dependency versions:

[versions]
android-plugin = "8.5.0"
kotlin = "1.9.0"
...

[libraries]
...

[plugins]
android-library = { id = "com.android.library", version.ref = "android-plugin" }
kotlin-android = { id = "org.jetbrains.kotlin.android", version.ref = "kotlin" }

Local Configuration

Create common/local.properties to configure machine-specific paths. This file is gitignored and must be created locally.

Android SDK Location

# Windows
sdk.dir=C\:\\Users\\YourUsername\\AppData\\Local\\Android\\Sdk

# macOS/Linux
sdk.dir=/Users/YourUsername/Library/Android/sdk

# Linux (alternate)
sdk.dir=/usr/lib/android-sdk

Godot Directory (iOS — optional)

By default, the iOS build scripts download and use the Godot source from ios/godot/ inside the project. If you want to use a Godot source tree located elsewhere on your machine (e.g. to share it across multiple plugin projects), set godot.dir in local.properties:

# Use a shared Godot source directory outside the project
godot.dir=/path/to/your/shared/godot

When godot.dir is not set, the build uses the ios/godot/ directory. The path supports ~ and environment variable expansion.

Godot Android Library (AAR — optional)

By default, the Godot Android AAR libary file is expected to be placed inside android/libs/ directory inside the project. If you want to use a location elsewhere on your machine (e.g. to share it across multiple plugin projects), set lib.dir in local.properties:

# Use a shared Godot AAR library directory outside the project
lib.dir=/path/to/your/shared/aar

When lib.dir is not set, the build uses the android/libs/ directory. The path supports ~ and environment variable expansion.

iOS Configuration

The ios/config/config.properties file contains iOS-specific settings:

# iOS deployment target
platform_version=14.3

# iOS system framework dependencies
frameworks=Foundation.framework,...

# Embedded iOS external framework dependencies
embedded_frameworks=res://ios/framework/*.xcframework,...

# Linker flags
flags=-ObjC,-Wl,...

# SPM dependencies (format: https://github.com/owner/repo.git|version|PackageName)
dependencies=https://github.com/googleads/swift-package-manager-google-mobile-ads.git|12.14.0|GoogleMobileAds