AI-powered level generation for Geometry Dash 2.2074. Generate complete levels directly in the editor using Gemini, Claude, or ChatGPT. Now with rate limiting and experimental features!
- Install - Download from Geode mod browser
- Get API Key - Visit ai.google.dev (free)
- Enter Key - Click lock icon in AI popup
- Generate - Describe your level and go!
While choosing an API to use, note that cheaper models will not handle the mod as well and will fail far more often. Though Gemini is free, Claude and ChatGPT are Highly recommended.
- Visit ai.google.dev
- Click "Get API Key"
- Copy key (starts with
AIza...) - Free: 15 requests/minute
- Visit console.anthropic.com
- Create account + add payment
- Generate key (starts with
sk-ant...) - Cost: ~$0.001-0.02 per generation
- Visit platform.openai.com
- Create account + add payment
- Generate key (starts with
sk...) - Cost: ~$0.001-0.03 per generation
- Open level editor
- Click AI button (top-left, gold)
- Click lock icon to enter API key
- Type prompt:
"Medium difficulty platforming" - Click Generate
Easy: "Simple platforming with basic jumps"
Medium: "Balanced ship section with portals"
Hard: "Challenging wave corridor"
Extreme: "Extreme demon timing section"
With Experimental:
- "Medium level with red blocks and yellow spikes"
- "Hard section with objects in groups 1 and 2"
- "Easy level with blue background and grass ground"
Settings → Mods → Editor AI:
- AI Provider - gemini / claude / openai
- Model - Choose from 9 models
- Difficulty - easy / medium / hard / extreme
- Style - modern / retro / minimalist / decorated
- Length - short / medium / long / xl / xxl
- Max Objects - 10 to 1,000,000
- Enable Rate Limiting - ON (recommended)
- Minimum Seconds Between Requests - 3 (default)
- Enable Experimental Features - Master toggle
- AI Color Control - HEX color assignment
- AI Group IDs - Group ID management
- Toggle Triggers - Toggle trigger creation
- Level Background/Ground - Background/ground control
Gemini:
gemini-2.5-flash- Fast (default)gemini-2.5-pro- High qualitygemini-2.5-flash-lite- Cheap
Claude:
claude-4-5-sonnet- Balancedclaude-4-5-haiku- Fastclaude-4.5-opus- Best quality
ChatGPT:
gpt-5.2- Latestgpt-5-mini- Balancedgpt-5-nano- Cheap
- ✅ Direct API integration (no server needed)
- ✅ 3 AI providers, 9 models total
- ✅ Secure local key storage
- ✅ Rate limiting to prevent token waste
- ✅ Experimental color/group/trigger features
- ✅ Lock icon for key management
- ✅ Generate up to 1M objects
- ✅ All gamemodes supported
- ✅ Customizable difficulty/style/length
Add Key:
- Click AI button in editor
- Click lock icon (bottom-left)
- Paste your API key
- Click Save
Change/Delete:
- Click lock icon again
- Choose "Change" or "Delete"
Your key is stored locally and never transmitted except to your chosen AI provider.
Rate limiting prevents you from:
- Accidentally spamming the API
- Wasting tokens/money on rapid clicks
- Hitting provider rate limits
Default: 3 second cooldown between requests
Configurable: 1-60 seconds
Can be disabled if you need rapid testing
When enabled, AI can set colors on objects:
{
"type": "block_black_gradient_square",
"x": 100,
"y": 30,
"color": "#FF0000" // Red
}AI can assign objects to groups for triggers:
{
"type": "spike_black_gradient_spike",
"x": 200,
"y": 0,
"groups": [1, 5, 10]
}Toggle triggers can be created, but customization is not yet available:
{
"type": "toggle_trigger", // ID: 1049
"x": 300,
"y": 100
// Note: target_group, activate_group, and touch_triggered
// are not yet functional due to Geode binding limitations
}Ground/background setting is planned but not yet available:
{
// These are parsed but not applied yet
// Waiting for Geode to expose LevelSettingsObject API
"ground_type": 5, // 1-15 (planned)
"background_type": 10 // 1-30 (planned)
}Note: These features are experimental. Color control and group IDs work fully, but toggle triggers and level settings are limited by current Geode bindings. We'll expand these as the SDK improves. Report issues on GitHub!
"Please wait X seconds before generating"
- Rate limiting is active
- Wait for cooldown or disable in settings
"API Key Required"
- Click lock icon and enter your API key
"API Error: 401/403"
- Invalid key - check it's correct for the selected provider
"API Error: 429"
- Rate limit hit - wait a minute or enable rate limiting
Objects underground
- This is rare - regenerate or manually adjust
No AI button
- Restart GD
- Check mod is enabled in Geode
Experimental features not working
- Ensure "Enable Experimental Features" is ON
- Enable specific feature toggles
- Check console for errors
- Some features may be incomplete
- Start with Gemini (free!)
- Enable rate limiting to save money
- Try experimental features for more control
- Save your level before generating
- Try different models - each has strengths
- Be specific in prompts
- Use "Clear level" toggle wisely
- Check console for detailed logs
Want to help improve Editor AI? Check out CONTRIBUTING.md for guidelines on:
- Reporting bugs
- Suggesting features
- Submitting pull requests
- Code standards
We especially need help with:
- UI improvements
- Advanced object features
- Testing experimental features
- Documentation
- API keys stored locally only
- Keys never logged (masked in logs)
- Requests go directly to your chosen provider
- No telemetry or tracking
- Rate limiting data stored locally
Developer: Entity12208
Framework: Geode SDK
AI Providers: Google, Anthropic, OpenAI
Contributors: See CONTRIBUTING.md
- GitHub: github.com/Entity12208/EditorAI
- Geode: geode-sdk.org
- Discord: discord.gg/geometrydash
Generate levels with AI in seconds! 🚀
This was partially created with AI. Feel free to report bugs!