mediation
Skill648 starsChanged 3 months agoMITView on GitHub
Create and maintain mediation network plugins (e.g., AppLovin, Vungle, Meta, IronSource) across Godot, C#, Android, and iOS.
In this repository5 other files it gives its agents.
- AGENTS.mdAGENTS.md
- doc-masterSkill
- parity-checkerSkill
- release-managerSkill
- syncSkill
The file
Show its rules and text
We split this skill into the rules it gives an agent
21 rules. About 0 are common, 7 are distinctive, and 14 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈7
Distinctive · estimate
This author's own choices. Worth a look.
14
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 44
Add the setting to project_settings_service.gd:
- Very specific: line 50
Create <NetworkName>.gd inside platforms/godot_editor/addons/admob/gdscript/src/mediation/extras/<network_name>/:
- Very specific: line 52
Use type-safe := operators.
- Very specific: line 54
Add a setup and usage example in Main.gd inside _setup_mediation_adapters().
- Very specific: line 57
Create <NetworkName>.cs in platforms/godot_editor/addons/admob/csharp/src/Mediation/Extras/<NetworkName>/:
- Very specific: line 59
Use PascalCase for method names, bridging to the snake_case GDScript plugin calls.
- Very specific: line 60
Add a setup and usage example in MainCSharpExample.cs inside SetupMediationAdapters().
- Very specific: line 66
Register Module: Add include ':src:mediation:<network_name>' to platforms/android/settings.gradle.
- Very specific: line 67
Build Configuration: Create build.gradle pulling dependencies from the GDScript config.
- Very specific: line 68
AndroidManifest: Create src/main/AndroidManifest.xml registering your org.godotengine.plugin.v2.PoingGodotAdMob<NetworkName> metadata.
- Very specific: line 71
Create config/poing_godot_admob_<network_name>.gd declaring your dependency coordinates (e.g., "com.google.ads.mediation:applovin:x.y.z.w").
- Very specific: line 80
Create config/poing-godot-admob-<network_name>.gdip under platforms/ios/src/mediation/<network_name>/config/ declaring SPM package rules.
- Very specific: line 82
Create an identical copy under platforms/godot_editor/ios/plugins/ using the admob_packages array format.
- Very specific: line 91
Create a new Markdown documentation file <network_name>.md under docs/mediate/integrate_partner_networks/:
- Distinctive: line 92
Document the supported integrations (bidding/waterfall) and ad formats.
- Distinctive: line 102
Verify module compilation by running:
- Distinctive: line 108
Verify Swift Package Manager dependency resolution:
- Very specific: line 126
Optional singletons (
is_required := false): When a mediation plugin (like AppLovin) is disabled in Project Settings, the GDScript wrapper … - Distinctive: line 132
No Browser Usage: Do NOT launch browser subagents to research versions or view documentation.
- Distinctive: line 133
Consult Official Documentation: Before integrating any new mediation network, read the official Google AdMob mediation documentation for …
- Distinctive: line 137
Never Commit: Do not commit code or create branches unless explicitly instructed by the user.
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Mediation Network Development & Maintenance Guide
This guide outlines the architecture and step-by-step instructions for adding or maintaining AdMob mediation adapters (e.g., Meta, IronSource, Vungle, AppLovin) within the Godot AdMob Editor Plugin.
🏗️ Architecture Overview
Mediation integration consists of native Android/iOS libraries, GDScript/C# interface wrappers, and editor export configurations:
┌────────────────────────────────┐
│ Game Project │
└───────────────┬────────────────┘
│ (API Calls)
▼
┌─────────────────────────────────────────────────────────────┐
│ Godot Addon │
│ - AppLovin.gd (GDScript Wrapper) │
│ - AppLovin.cs (C# Parity Wrapper) │
│ - project_settings_service.gd (registers settings) │
│ - export_plugins (copies AARs/XCFrameworks) │
└──────────────────────┬──────────────────────────────┬───────┘
│ (JNI / Android Bridge) │ (Objective-C++ / iOS Bridge)
▼ ▼
┌──────────────────────────────┐ ┌──────────────────────────────┐
│ Android Library │ │ iOS Framework │
│ - PoingGodotAdMobAppLovin.kt │ │ - PoingGodotAdMobAppLovin.mm │
│ - play-services-ads-applovin │ │ - AppLovinAdapterTarget │
│ - AppLovin SDK (AAR) │ │ - AppLovin SDK (XCFramework) │
└──────────────────────────────┘ └──────────────────────────────┘🛠️ Step-by-Step Implementation Guide
1. Editor Settings Registration
Add the setting to project_settings_service.gd:
SettingDefinition.new(ANDROID_MEDIATION_PREFIX + "network_name", TYPE_BOOL, false)2. Public GDScript API Wrapper
Create <NetworkName>.gd inside platforms/godot_editor/addons/admob/gdscript/src/mediation/extras/<network_name>/:
- Must inherit
MobileSingletonPlugin. - Use type-safe
:=operators. - Register under class name
<NetworkName>. - Add a setup and usage example in Main.gd inside
_setup_mediation_adapters().
3. C# Wrapper Parity
Create <NetworkName>.cs in platforms/godot_editor/addons/admob/csharp/src/Mediation/Extras/<NetworkName>/:
- Match 1:1 API parity with the GDScript wrapper.
- Use
PascalCasefor method names, bridging to thesnake_caseGDScript plugin calls. - Add a setup and usage example in MainCSharpExample.cs inside
SetupMediationAdapters().
4. Android Native Implementation
- Register Module: Add
include ':src:mediation:<network_name>'toplatforms/android/settings.gradle. - Build Configuration: Create
build.gradlepulling dependencies from the GDScript config. - AndroidManifest: Create
src/main/AndroidManifest.xmlregistering yourorg.godotengine.plugin.v2.PoingGodotAdMob<NetworkName>metadata. - Kotlin Plugin Class: Implement
PoingGodotAdMob<NetworkName>(godot: Godot?)inheritingGodotPluginand exposing methods annotated with@UsedByGodot. - Addon Export configuration:
- Create
config/poing_godot_admob_<network_name>.gddeclaring your dependency coordinates (e.g.,"com.google.ads.mediation:applovin:x.y.z.w"). - Register the library name in export_plugin.gd (Android) arrays
KNOWN_LIBSandMEDIATION_LIBS.
- Create
5. iOS Native Implementation
- SCons Configuration: Modify SConstruct to add the new platform option to
pluginand include the path to your.xcframeworkdependencies inFRAMEWORKPATH. - iOS GDIP Config:
- Create
config/poing-godot-admob-<network_name>.gdipunderplatforms/ios/src/mediation/<network_name>/config/declaring SPM package rules. - Crucial SPM Tip: Swift Package Manager uses Semantic Versioning (
major.minor.patch). For 4-component mediation versions (e.g.,13.6.3.0), multiply the patch component by 100 (e.g., use13.6.300). - Create an identical copy under
platforms/godot_editor/ios/plugins/using theadmob_packagesarray format.
- Create
- Objective-C++ Wrapper:
- Implement
PoingGodotAdMob<NetworkName>.h&.mmreferencing<NetworkNameSDK/NetworkNameSDK.h>. - Implement
PoingGodotAdMob<NetworkName>Module.h&.mmto register the plugin singleton with the engine during initialization.
- Implement
6. Create Documentation Page
Create a new Markdown documentation file <network_name>.md under docs/mediate/integrate_partner_networks/:
- Document the supported integrations (bidding/waterfall) and ad formats.
- Detail SDK imports for both Android and iOS.
- Describe how to enable the plugin in both Project Settings and Export Presets.
- Provide GDScript and C# code snippets for GDPR, CCPA, and any custom SDK configuration methods (such as audio controls).
🧪 Validation & Compilation
Android
Verify module compilation by running:
./gradlew buildiOS Swift Packages
Verify Swift Package Manager dependency resolution:
swift package resolveiOS compilation
Compile the static library using SCons:
scons plugin=<network_name> arch=arm64 target=debugFull Addon Rebuild
Generate and package all binaries into the editor addon directory using the main build script:
./scripts/build_local.sh all <godot_version>Logging & Diagnostics
- Optional singletons (
is_required := false): When a mediation plugin (like AppLovin) is disabled in Project Settings, the GDScript wrapper usespush_warningrather thanprinterr. - Logcat visibility: In mobile builds (Android/iOS) without a debugger attached, Godot's
push_warningis not outputted to standard console streams, meaning it will not appear inadb logcatlogs. To force-print missing singleton messages to logcat, you must temporarily setis_required := truein the adapter wrapper initialization (which usesprinterr).
🚫 Constraints & Security
- No Browser Usage: Do NOT launch browser subagents to research versions or view documentation. Always use terminal-based commands (such as
curl,git ls-remote, or the nativeread_url_contenttool) to inspect packages, repositories, or documentation pages. - Consult Official Documentation: Before integrating any new mediation network, read the official Google AdMob mediation documentation for Android & iOS to ensure version compatibility. The URLs follow this pattern (replace
<network_name>with the target mediation name in lowercase, e.g.,vungle,bidmachine):- Android:
https://developers.google.com/admob/android/mediation/<network_name> - iOS:
https://developers.google.com/admob/ios/mediation/<network_name>
- Android:
- Dependency Coordinates: Consult the dependency version tables in the official guides to retrieve the correct adapter coordinate (e.g.,
com.google.ads.mediation:<network_name>:<version>). - Never Commit: Do not commit code or create branches unless explicitly instructed by the user.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

