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
-
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 -versionWhat 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 -
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.enabledWhat you should see
The setting
chat.plugins.enabledappears; 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.
-
Install the plugin from source
What to do
Open the Command Palette (
Ctrl+Shift+PorCmd+Shift+P), run the plugin installation command, and enter the universal-modder repository URL.Command
Command Palette:
Command Chat: Install Plugin From SourceRepository URL:
Command https://github.com/rehan-remade/universal-modderWhat 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.enabledis active and reload VS Code. -
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.jsonconfigures the fal HTTP server athttps://mcp.fal.ai/mcpusingBearer ${env:FAL_KEY}.Command
Windows terminal:
Command setx FAL_KEY your_keymacOS 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_KEYso the editor process inherits the variable. You can use the plugin without a fal key; asset generation will be skipped. -
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 spritesWhat you should see
The agent starts with
skills/mod-any-game/SKILL.md, searches the knowledge base, runs recon on the game and engine, createsMODLOG.mdin 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, andffmpeg -versionreturn valid versions. - Verify that
chat.plugins.enabledis active in your VS Code settings. - Check that
.vscode/mcp.jsonconnects tohttps://mcp.fal.ai/mcpwhenFAL_KEYis present. - In GitHub Copilot Chat, describe your mod and verify that
MODLOG.mdis 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.