GDevelop BYOK — Automated Patched Builds

Automatically patches GDevelop on every new release to:

  • BYOK (Bring Your Own Key) AI support — use OpenAI, Anthropic, Ollama, OpenRouter, or any OpenAI-compatible endpoint instead of GDevelop's built-in AI
  • Unlock all premium features — remove watermark/logo, unlimited cloud projects, multiplayer, leaderboard customization, and more
  • Remove export branding — disable the GDevelop splash screen & watermark without a subscription

How it works

New GDevelop Release → GitHub Actions triggers → Clone repo at tag → Apply patches → Build all platforms → Publish artifacts

Three subsystems work together:

Component What it does
Patches (patch/) Modifies GDevelop source to unlock premium capabilities and route AI to local proxy
AI Proxy (proxy/) Local server that implements GDevelop's Generation API, but uses your LLM keys
CI/CD (.github/workflows/) Watches for new releases, runs the full patch→build→publish pipeline

Quick Start

Option A: Download pre-built patched release

  1. Go to Releases of this repo
  2. Download the patched GDevelop for your platform
  3. Optionally run the AI proxy for BYOK (see below)

Option B: Run the AI Proxy locally

cd proxy
npm install
cp .env.example .env
# Edit .env with your API keys
npm start

The proxy runs on http://localhost:11400 and translates GDevelop's AI API calls into requests to your configured LLM provider.

Option C: Build yourself

# The CI pipeline does this automatically, but you can run it locally:
gh workflow run build-patched.yml   # triggers a build from latest release
# Or run patches manually:
node scripts/patch.js --repo ../GDevelop --release v5.6.269

Supported AI Providers

Provider Backend
OpenAI GPT-4o, GPT-4-turbo, o1, o3, etc.
Anthropic Claude Opus, Sonnet, Haiku
Google Gemini 2.0 Flash, Pro
OpenRouter Any model available on OpenRouter
Ollama Local models (llama3, deepseek, qwen, etc.)
OpenAI-compatible Any endpoint that speaks the OpenAI chat/completions API

Premium Features Unlocked

  • Remove GDevelop logo & watermark from exports
  • Unlimited cloud projects
  • Unlimited leaderboards (with full theme customization)
  • Unlimited multiplayer lobbies
  • Extended version history
  • No nag screen
  • Unlimited desktop/mobile builds per day
  • Advanced analytics
  • Collaboration features

Patches Applied

File(s) Change
Usage.js hasValidSubscriptionPlan() → always returns true
Usage.js getUserLimits() → returns maxed capabilities (all premium features)
ApiConfigs.js GDevelopGenerationApi.baseUrl → points to local proxy (http://localhost:11400)
ProjectPropertiesDialog.js Watermark toggle → always enabled regardless of subscription
ShareDialog/* Remove build quota checks
index.html (GDJS) Remove forced watermark/splash screen defaults

Architecture

┌─────────────────────────────────────────────────┐
│  GitHub Actions (.github/workflows/build.yml)   │
│  ┌───────────────────────────────────────────┐  │
│  │  1. Watch releases (schedule + webhook)   │  │
│  │  2. Clone 4ian/GDevelop at release tag    │  │
│  │  3. Run patch.js → modify source          │  │
│  │  4. Build macOS/Linux/Windows             │  │
│  │  5. Upload artifacts to GitHub Releases   │  │
│  └───────────────────────────────────────────┘  │
└─────────────────────────────────────────────────┘

┌──────────────────────────────────────────────────┐
│  AI Proxy (proxy/) — runs on user's machine      │
│  ┌────────────────────────────────────────────┐  │
│  │  Express server on localhost:11400         │  │
│  │  Implements /ai-request endpoints          │  │
│  │  Routes to OpenAI/Anthropic/Ollama/...     │  │
│  │  Returns GDevelop-format responses         │  │
│  └────────────────────────────────────────────┘  │
└──────────────────────────────────────────────────┘

Limitations

  • Cloud services that require GDevelop's backend (gd.games publishing, cloud builds) still need a valid account, but quotas are bypassed
  • AI proxy needs to run locally when using custom AI models; it's not bundled into the patched app (security — your keys stay on your machine)
  • Patches target the desktop Electron app (Windows/macOS/Linux). The web app at editor.gdevelop.io cannot be patched this way

Disclaimer

GDevelop is MIT-licensed and this project exercises the right to modify and redistribute it. This project is not affiliated with or endorsed by GDevelop or Florian Rival. Use at your own risk.

S
Description
No description provided
Readme 123 KiB
Languages
JavaScript 97.2%
Shell 2.4%
HTML 0.2%
C++ 0.2%