How to Create a Melty Mashup With an AI Agent
You do not write the mod yourself — an AI coding agent does. Your job is to pick two games you own, hand Melty’s generated instructions to the agent, describe the mashup you want, and test the result. Here is the full process, step by step.
Before you start
- Windows PC with the official Melty app installed.
- Both games installed with legitimate copies — owning games does not grant redistribution rights, so what you publish is your responsibility.
- An AI coding agent (Claude Code, Codex, or similar) with access to a local project folder.
The five steps
Step 1: Prepare your games and workspace
Install the official Melty desktop app on Windows, then install both games you plan to combine. You need legitimate copies and any required launchers logged in. Have an AI coding agent ready in a project workspace with local file access — Melty names Claude Code and Codex as destinations, but any capable coding agent works.
Step 2: Select your game pair in Melty
In Melty’s Create screen, under My games, pick the two installed games and choose Mash with AI — a different action from the single-game Mod with AI option. Double-check the game names in the generated instructions, since button thumbnails may not match the highlighted cards.
Step 3: Copy the instructions into your agent
Use Send instructions to coding agent and paste the text into your agent session. Review it before submitting: it typically includes the game names, detected install directories, and a publishing request. If you only want a local experiment, explicitly remove the publishing request and tell the agent not to publish. Keep the platform setup text rather than replacing everything.
Step 4: Write a specific gameplay brief
Name which game provides the world, which mechanic you want from the other, and what a successful first test looks like. Answer the agent’s follow-ups about controls, camera, character, UI, and mechanics. A good brief asks the agent to explain feasibility before editing files, keep the first test small, and stop and explain any blocker instead of guessing.
Step 5: Test locally, then decide on publishing
Launch via the procedure your agent provides and check the interaction from your brief. If it fails, report what you did, the expected behavior, and the actual result, then re-test the same action. A mashup becomes visible in My mashups when published, but a release only goes live after Melty sees it running on your PC and it passes an audit — uploading is not instant approval.
Writing a brief that gets a working mashup
The single biggest difference between a broken build and a fun one is the brief. A strong brief answers three questions up front: which game is the world, which mechanic is imported, and what does “working” look like in the first five minutes. For a Skyrim-meets-Minecraft style mashup, for example: the world is Skyrim, the mechanic is block placing and crafting, and success is chopping a tree in Whiterun and placing the wood as blocks.
Ask the agent to explain feasibility before touching files, keep the first test small, and stop with an explanation when something blocks it. Vague briefs produce vague builds.
Milestones: what is done and what is not
- Copied instructions are not a finished build — the agent still has to write and wire the mod.
- A passing local test is not compatibility with every player’s PC.
- A submitted release is not a live one — Melty audits releases after seeing the mashup run on your machine.
Common pitfalls
- Trusting the Create screen thumbnails instead of the generated game names.
- Leaving the auto-generated publishing request in when you only wanted a local experiment.
- Copying a tutorial’s demo prompt verbatim — those usually depend on an earlier conversation and are not a guaranteed recipe.
- Skipping the review of files and description before publishing; you are responsible for releases your agent makes.
New to Melty entirely? Start with what Melty is and how it works, then check whether Melty is safe to install.