Skip to content
Universal Modder Guides

install / vscode

How to install the Universal Modder VS Code plugin

Quick answer

Install the universal-modder plugin in VS Code by enabling chat plugins and installing from the repository URL, then begin modding PC games in about five minutes. The plugin is free; using GitHub Copilot in VS Code requires a GitHub Copilot plan, and fal asset generation is a separate paid service.

Prerequisites

  • A single-player PC game you legally own, within the usage boundary below.
  • VS Code installed with GitHub Copilot Chat enabled.
  • Python 3.10+ and ffmpeg installed; uv is recommended.
  • A separate mod working folder on your system.
  • A fal account and API key if you want generated sprites, 3D models, or audio.
  • Blender if you need to render 3D models into game-ready sprites.

Steps: how to install Universal Modder in VS Code

  1. Check environment prerequisites

    What to do

    Open a terminal in your mod working folder. Check that Python, uv, and ffmpeg are installed and accessible on PATH.

    Command

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

    What you should see

    Each command outputs its installed version number.

    If something goes wrong

    If tools are missing on Windows, install them using winget and open a new terminal:

    Command
    winget install Python.Python.3.12
    winget install astral-sh.uv
    winget install Gyan.FFmpeg
  2. Enable chat plugins in VS Code settings

    What to do

    Open Settings (Ctrl+, on Windows/Linux, Cmd+, on macOS) and search for the chat plugins setting.

    Command

    Search setting:

    Command
    chat.plugins.enabled

    What you should see

    The setting chat.plugins.enabled appears; ensure it is checked or set to true.

    If something goes wrong

    If the setting does not appear, verify that VS Code and the GitHub Copilot Chat extension are updated to recent releases.

  3. Install the plugin from source

    What to do

    Open the Command Palette (Ctrl+Shift+P or Cmd+Shift+P), run the plugin installation command, and enter the universal-modder repository URL.

    Command

    Command Palette:

    Command
    Chat: Install Plugin From Source

    Repository URL:

    Command
    https://github.com/rehan-remade/universal-modder

    What you should see

    VS Code installs the plugin from the repository URL.

    If something goes wrong

    If the Command Palette cannot find the command, recheck that chat.plugins.enabled is active and reload VS Code.

  4. Configure the fal API key for MCP

    What to do

    If you want generated 2D sprites, textures, 3D models, or audio, set your fal API key in your environment. .vscode/mcp.json configures the fal HTTP server at https://mcp.fal.ai/mcp using Bearer ${env:FAL_KEY}.

    Command

    Windows terminal:

    Command
    setx FAL_KEY your_key

    macOS or Linux terminal:

    Command
    export FAL_KEY=...

    What you should see

    fal displays your API key once upon creation, so store it safely.

    If something goes wrong

    Restart VS Code after setting FAL_KEY so the editor process inherits the variable. You can use the plugin without a fal key; asset generation will be skipped.

  5. Prompt the agent in Copilot Chat

    What to do

    Open GitHub Copilot Chat in your mod working folder. The extension loads skills into .github/skills. Describe the game and the mod you want to create in natural language.

    Command

    Command
    Mod this game: add a new weapon with fal-generated sprites

    What you should see

    The agent starts with skills/mod-any-game/SKILL.md, searches the knowledge base, runs recon on the game and engine, creates MODLOG.md in your mod folder, and backs up saves.

    If something goes wrong

    The agent asks before driving mouse and keyboard input, installing loaders into game folders, changing the registry, or publishing. It explicitly refuses to bypass anti-cheat, DRM, or game ownership checks.

Verify it worked

  • Confirm that python --version, uv --version, and ffmpeg -version return valid versions.
  • Verify that chat.plugins.enabled is active in your VS Code settings.
  • Check that .vscode/mcp.json connects to https://mcp.fal.ai/mcp when FAL_KEY is present.
  • In GitHub Copilot Chat, describe your mod and verify that MODLOG.md is created in your working folder.
  • Test the resulting mod directly in the real game client yourself.

FAQ

How do I install the Universal Modder VS Code plugin?

Enable chat.plugins.enabled in your VS Code settings, run Chat: Install Plugin From Source from the Command Palette, and enter https://github.com/rehan-remade/universal-modder.

Can I use the VS Code plugin without a fal API key?

Yes. You can perform game reconnaissance, reverse engineering, save backups, and code editing without fal. An API key is only needed if you want fal to generate 2D sprites, 3D meshes, textures, or audio.

Do I need a paid subscription to use VS Code with Universal Modder?

The universal-modder plugin is free and open-source under the MIT license. Using Copilot Chat in VS Code requires an active GitHub Copilot subscription, and fal asset generation is a separate paid service.

What should I do if Chat: Install Plugin From Source does not appear?

Check that chat.plugins.enabled is set to true in your VS Code settings JSON. If the command palette still omits the option, verify that you are running the latest version of VS Code and GitHub Copilot Chat extension.

How do I verify that the VS Code MCP server is running?

Open the Output tab in VS Code and select the Copilot Chat or MCP server log channel from the dropdown. It should confirm that the universal-modder MCP configuration in .vscode/mcp.json has loaded without syntax or environment errors.