|
2 | 2 |
|
3 | 3 | AI-powered level generation for Geometry Dash. Describe your level in plain text and watch AI build it in the editor. |
4 | 4 |
|
5 | | -## Features |
6 | | - |
7 | | -- 🤖 **Multiple AI Providers** - Gemini (free), Claude, ChatGPT, or Ollama (local) |
8 | | -- 📦 **1000+ Objects** - Full GD object library with auto-updates |
9 | | -- 🎨 **Full Control** - Colors, groups, triggers, and advanced properties |
10 | | -- ⚡ **Fast & Stable** - Progressive creation with live progress |
11 | | -- 🔒 **Private** - Keys stored locally, no telemetry |
12 | | - |
13 | 5 | ## Quick Start |
14 | 6 |
|
15 | | -1. Install from Geode mod browser |
16 | | -2. Open editor → Click **AI** button (top-right) |
17 | | -3. **For Ollama**: Download from [ollama.com](https://ollama.com), run `ollama run llama2`, skip API key |
18 | | -4. **For Cloud AI**: Click lock icon → Enter API key from [ai.google.dev](https://ai.google.dev) (free) |
19 | | -5. Type prompt and generate! |
20 | | - |
21 | | -## Setup |
22 | | - |
23 | | -### Ollama (Recommended - FREE & Fast) |
24 | | -1. Download [ollama.com](https://ollama.com) |
25 | | -2. Run `ollama run llama2` |
26 | | -3. No API key needed |
27 | | -4. **Benefits**: Free, unlimited, private, offline |
28 | | - |
29 | | -### Cloud APIs |
30 | | -- **Gemini** - [ai.google.dev](https://ai.google.dev) - Free (15 req/min) |
31 | | -- **Claude** - [console.anthropic.com](https://console.anthropic.com) - Paid (~$0.001-0.02) |
32 | | -- **ChatGPT** - [platform.openai.com](https://platform.openai.com) - Paid (~$0.001-0.03) |
33 | | - |
34 | | -**Note**: Gemini is free but less capable. Claude and ChatGPT handle complex levels better. |
35 | | - |
36 | | -## Example Prompts |
37 | | - |
38 | | -``` |
39 | | -"Simple platforming section with basic jumps" |
40 | | -"Medium difficulty ship corridor with portals" |
41 | | -"Hard wave section with red blocks and yellow spikes" |
42 | | -"Extreme demon timing section with groups 1 and 2" |
43 | | -``` |
44 | | - |
45 | | -## Settings |
46 | | - |
47 | | -**Settings → Mods → Editor AI:** |
48 | | - |
49 | | -- **AI Provider** - gemini / claude / openai / ollama |
50 | | -- **Model** - Choose from 9+ models |
51 | | -- **Difficulty** - easy / medium / hard / extreme |
52 | | -- **Style** - modern / retro / minimalist / decorated |
53 | | -- **Length** - short / medium / long / xl / xxl |
54 | | -- **Max Objects** - 10 to 1,000,000 |
55 | | -- **Features** - Colors, groups, triggers (toggle in settings) |
56 | | -- **Rate Limiting** - Recommended ON (3s default) |
57 | | - |
58 | | -## ⚠️ Known Issues |
59 | | - |
60 | | -### Editor Collab Incompatibility |
61 | | -**`Editor Collab` mod is NOT compatible with Editor AI.** They break each other. You must: |
62 | | -- Disable Editor Collab before using Editor AI, OR |
63 | | -- Uninstall Editor Collab |
64 | | - |
65 | | -This is a known incompatibility and cannot be fixed without changes to both mods. |
66 | | - |
67 | | -## Troubleshooting |
68 | | - |
69 | | -**"API Key Required"** |
70 | | -- Click lock icon and enter key |
71 | | -- For Ollama: No key needed, ensure Ollama is running |
72 | | - |
73 | | -**Objects Not Appearing** |
74 | | -- Check max objects setting |
75 | | -- Try smaller generation first |
76 | | -- Verify level isn't locked |
77 | | - |
78 | | -**Slow Generation** |
79 | | -- Normal! Creates 20-50 objects/second |
80 | | -- Watch progress indicator |
81 | | -- Prevents crashes and ensures stability |
82 | | - |
83 | | -## Platform Support |
84 | | - |
85 | | -- ✅ Windows (Tested) |
86 | | -- ✅ macOS (Tested) |
87 | | -- ✅ Android (Tested) |
| 7 | +1. Download the [latest release](https://github.com/entity12208/editorai/releases/latest) |
| 8 | +2. Open the game and navigate to the Geode page |
| 9 | +3. Press the manual download button and select the file |
| 10 | +4. Set up the mod |
88 | 11 |
|
89 | | -## Links |
| 12 | +## AI Setup |
90 | 13 |
|
91 | | -- **GitHub**: [entity12208/EditorAI](https://github.com/entity12208/EditorAI) |
92 | | -- **Geode Docs**: [docs.geode-sdk.org](https://docs.geode-sdk.org) |
93 | | -- **Report Issues**: GitHub Issues or Geode Discord |
| 14 | +### Ollama |
| 15 | +1. Download and install [Ollama](https://ollama.com) |
| 16 | +2. Download the official model by running `ollama pull editorai:<model>`, where `model` can be either `deepseek` (more creative) or `qwen` (more powerful). Each is 5.2 GB. |
| 17 | +3. Ensure the setting `ollama model` is set to `editorai`. |
| 18 | +4. Change the other settings to your requirements. |
94 | 19 |
|
95 | | -## Credits |
| 20 | +### Gemini, Claude, ChatGPT |
96 | 21 |
|
97 | | -- **Developer**: entity12208 |
98 | | -- **Framework**: Geode SDK |
99 | | -- **AI Providers**: Google, Anthropic, OpenAI, Ollama |
| 22 | +1. Get your API key for [Gemini](https://aistudio.google.com/u/0/api-keys), [Claude](https://console.anthropic.com), or [ChatGPT](https://platform.openai.com/api-keys). |
| 23 | +2. Set the setting `Model` to your perfered model used by your provider |
| 24 | +3. Once in the UI, click the lock icon. |
| 25 | +4. Paste your API key into the box and save it. |
100 | 26 |
|
101 | | ---- |
| 27 | +## Usage |
102 | 28 |
|
103 | | -**Version**: 2.1.2 |
104 | | -**Game**: Geometry Dash 2.2074 |
105 | | -**Geode**: 4.10.0+ |
106 | | -**Status**: ✅ Stable |
| 29 | +1. Download and set up the mod. |
| 30 | +2. Open the editor of any level. |
| 31 | +3. Press the AI button located in the top right. |
| 32 | +4. Enable or disable `Clear Level`, and enter your prompt into the box. |
| 33 | +5. Click `Generate` and wait! |
0 commit comments