mirror of
https://github.com/Heretek-AI/GDevelop-BYOK.git
synced 2026-06-29 21:53:23 -04:00
main
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
- Go to Releases of this repo
- Download the patched GDevelop for your platform
- 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 |
| 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.
Description
Languages
JavaScript
97.2%
Shell
2.4%
HTML
0.2%
C++
0.2%