Skip to content
Universal Modder Guides

install / claude-code

How to use Universal Modder in Claude Code

Quick answer

Install universal-modder with two commands inside Claude Code, then describe a small mod you want to make for a game you own. The plugin is free; using Claude Code requires a paid Claude subscription or Claude Console API billing, and fal asset generation is a separate paid service.

Prerequisites

  • A game you legally own, within the usage boundary below.
  • A paid Claude subscription or a Claude Console account with API billing.
  • Git for Windows if you are following the Windows installation steps.
  • Python 3.10+ and ffmpeg; uv is recommended.
  • A separate mod working folder, such as C:\mods.
  • A fal account and API key if you want generated sprites, models or audio.
  • Blender if you need to render 3D models into sprites.

Steps: how to use Universal Modder with Claude Code

  1. Start Claude Code in your mod folder

    What to do

    Open a terminal in your mod working folder. If Claude Code is installed, check its version and launch it.

    Command

    Command
    claude --version
    claude

    What you should see

    The version command returns a version number. On your first launch, choose a theme and sign-in method, complete the browser authorization, then confirm that you trust the folder to reach Claude Code’s message input.

    If something goes wrong

    If Claude Code is installed but has a setup problem, run its diagnostic command:

    Command
    claude doctor

    If you have not installed Claude Code yet, use the installer for your operating system, then close and reopen the terminal.

    Windows:

    Command
    irm https://claude.ai/install.ps1 | iex

    macOS or Linux:

    Command
    curl -fsSL https://claude.ai/install.sh | bash
  2. Prepare the modding tools

    What to do

    Install Python, uv and ffmpeg. The commands below are the Windows setup from the guide; Blender is only needed for 3D-to-sprite rendering.

    Command

    Windows terminal:

    Command
    winget install Python.Python.3.12
    winget install astral-sh.uv
    winget install Gyan.FFmpeg

    For 3D-to-sprite rendering:

    Command
    winget install BlenderFoundation.Blender

    What you should see

    Open a new terminal and check that the tools report their versions:

    Command
    python --version
    uv --version
    ffmpeg -version

    If something goes wrong

    After installing the tools, restart the terminal before running the version checks again.

  3. Add the marketplace and install the plugin

    What to do

    Enter these two commands inside Claude Code. Add the marketplace first, then install universal-modder; when asked for the installation scope, choose User to make it available across folders.

    Command

    Command
    /plugin marketplace add rehan-remade/universal-modder
    Command
    /plugin install universal-modder@universal-modder

    What you should see

    Claude Code shows the plugin installation message. The project’s plugin manifest names the plugin universal-modder.

    If something goes wrong

    If Claude Code asks you to reload the plugin components, run:

    Command
    /reload-plugins
  4. Add a fal key for generated assets

    What to do

    If you want the agent to generate sprites, models or audio, create an account at fal, add funds and create a key on the API keys page. Replace the placeholder below with your own key.

    You can use the plugin without a fal key; fal-generated assets require the key and paid service usage.

    Command

    Windows terminal:

    Command
    setx FAL_KEY your_key

    For a shell export, set the key in the terminal where you will run Claude Code:

    Command
    export FAL_KEY=...

    What you should see

    fal displays the new key once, so save it when you create it. On Windows, open a new terminal after setting the key; for the shell export, continue in the terminal where you set it, then start Claude Code from your mod folder.

    If something goes wrong

    Putting FAL_KEY=your_key in the project’s .env lets um read the key there. Claude Code’s fal MCP server reads the environment variable, so a key stored only in .env does not configure that connection.

  5. Give the agent one small mod to build

    What to do

    Inside Claude Code, invoke the main skill and describe your game and the change you want. Keep the first task small, state what a working result should do, and say whether you want a showcase video.

    Command

    Command
    /universal-modder:mod-any-game

    What you should see

    The agent asks for project details and creates MODLOG.md in the working folder. Its workflow starts with the knowledge base and game reconnaissance, chooses a route, backs up saves, reads the actual code, and builds a working change before testing it in the game.

    If something goes wrong

    If you return to the project in a later session, use the same working folder and ask the agent to read MODLOG.md and continue.

    The agent asks before controlling your mouse and keyboard, installing loaders, changing the registry or publishing. It will not bypass anti-cheat, DRM or game ownership checks.

Verify it worked

  • Confirm that claude --version returns a version number.
  • Confirm that python --version, uv --version and ffmpeg -version report the installed tools.
  • Read the plugin installation message and reload components if Claude Code requests it.
  • Start the main skill and check for its project questions and MODLOG.md.
  • Test the resulting mod in the actual game yourself.

FAQ

How do I install universal-modder in Claude Code?

Add the project’s marketplace, then run the plugin install command shown above inside Claude Code. Choose the User scope when prompted, and reload components if Claude Code requests it.

Can I use the plugin without a fal API key?

Yes. The plugin can still be used, but fal-generated sprites, models and sounds require an API key and paid service usage.

Do I need a paid Claude subscription?

You need a paid Claude subscription or a Claude Console account with API billing enabled. The universal-modder plugin is free; fal-generated assets have a separate cost.

What should I do if Claude Code shows plugin command not found?

If running slash commands fails after installation, first execute /reload-plugins to refresh active registries. If issues persist, verify that your Claude Code CLI version is up to date and re-run the marketplace registration with User scope.

How do I troubleshoot permissions when Claude Code edits game files?

Claude Code runs in your local directory and requires write access to the targeted mod folder. Ensure your game folder is not set to read-only in Windows Properties, and launch your shell with standard user permissions in your designated mod workspace.