0. Start Here¶
You have never done this before and want to know what's involved. This page is the map. The other guides fill in the details.
Stuck on something specific to your setup? Ask on the Discord.
What you do¶
The agent writes the code. You tell it what you want, it writes and builds, and you test the result by playing. Your job:
- decide what you want
- describe it and describe problems clearly
- playtest, because the agent can't see or feel a game
- keep the project organized so you can recover when something goes wrong
The core loop: install the games, open an agent, give it an example project, say what you want. That turns into a long series of problems to fix with the agent. Expect it.
Pick your path¶
| I want to... | Read | Rough idea |
|---|---|---|
| Put one game's gameplay inside another (Minecraft in Skyrim, Skate 3 in GTA) | Passthrough mods | Both games run at once and talk to each other |
| Rebuild a game's engine so it runs on its own | Rust rewrites | Bigger job. Reads your game files at runtime |
| Play what others made | #share-your-projects on the Discord | Use the project's own install instructions |
Start with a passthrough mod if you're unsure. You see something working sooner. If you can't tell which kind of project your idea is, Guide 11 sorts the seven common routes.
Three pages worth reading first¶
These answer the questions people ask most:
- Which loaders and script extenders exist — decides whether your game idea is even realistic.
- A full passthrough walkthrough — the whole process end to end, with the prompts.
- Posting your project — what a finished project needs before others can use it.
The steps, in order¶
- Pick your games. Check that they're single-player or offline, and that you own them.
- Search for existing work first. Look for mod loaders, existing mods, or decomp projects for your games. Skipping this is the most common way to waste an evening.
- Set up an AI agent on your PC. See guide 1. Costs and model choice are there.
- Install the games and make sure they run normally.
- Open the agent in a new, empty project folder and use a starter prompt from guide 2 or 3.
- Playtest and report back. Describe what happened, paste logs.
- Keep notes so a fresh chat can pick up where the old one left off. See guide 4.
- Share it as a GitHub repo, with no game files in it. See guide 6.
Honest expectations¶
- Time: a task can take anywhere from a few minutes to many hours, depending on the model and how hard you make it think. An Elden Ring + Spider-Man mashup took about 3-4 hours of back-and-forth to get working, and the result was jank but playable. Treat that as one data point, not a typical runtime.
- Cost: agents use paid plans or API credits, and plans have usage limits. See guide 1 for what to actually spend.
- Coding knowledge: you don't need it to start, but a little helps. You can always ask the agent to explain what it did.
- Rough edges: early projects are experimental. Back up your saves.
- Some things won't work. Online games with anti-cheat are off the table. See guide 6.
If you only do one thing first¶
Don't start with the game you wish you could mod. Start with a game you already own that has a good loader, and get something small working end to end. That teaches you the loop: recon, one working slice, playtest, commit, repeat.
A finished thing that does almost nothing teaches you more than an ambitious thing you abandon on day two.
Before you start: checklist¶
- I own the games and they're installed
- They are single-player or offline
- The host game has a mod loader or script extender
- I've picked an AI agent rather than a chat website
- I created a folder for this project
- I know I'll playtest myself
- I've read the rules in guide 6
Spot a mistake? Edit this page on GitLab · Open an issue · Part of AI Game Modding Guides