Create Game Plugin

Create Game Plugin

Anvil Organizer supports 35+ games out of the box. If your game is not listed, you can create your own game plugin — no coding required.

Quick Start

1. Click the puzzle icon in the toolbar (or File → Game Plugin → Create)
2. Fill in the required fields
3. Click Create — done!

The plugin is saved to ~/.anvil-organizer/plugins/games/ and automatically loaded on next startup.

Required Fields

Field	Description	Example
Game Name	Full name of the game	Kingdom Come Deliverance II
Short Name	Unique identifier (auto-generated)	KingdomComeII
Game Binary	The game's .exe file	KingdomCome.exe
Steam ID	Steam App ID (how to find it)	379430
Data Path	Where mods go relative to the game folder	(see below)

Data Path

The Data Path tells Anvil where mods are installed relative to the game directory:

Value	Meaning	Used by
(empty)	Mods go into the game root folder	Cyberpunk 2077, Witcher 3
Data	Mods go into a Data/ subfolder	Skyrim, Fallout 4, Starfield
Mods	Mods go into a Mods/ subfolder	Some Unity games
Paks/~mods	Custom subfolder	Crimson Desert, Unreal games

If unsure, check where other users install mods for your game (Nexus Mods guides, PCGamingWiki).

Optional Fields

Field	Description	Example
Documents Path	Windows documents folder (inside Proton prefix)	drive_c/users/steamuser/Documents/My Games/Skyrim
Saves Path	Savegame folder (inside Proton prefix)	drive_c/users/steamuser/Documents/My Games/Skyrim/Saves
Save Extension	File extension for savegames	save, sav
Nexus Game ID	Numeric ID on Nexus Mods (for API queries)	1704

💡 The Documents and Saves paths are relative to the Proton prefix folder, not your Linux home directory.

Finding Your Steam ID

Anvil uses the Steam ID to automatically locate your game installation folder.

Method 1 — Steam Store URL

Open the game in the Steam Store (browser or client). The ID is in the URL:

https://store.steampowered.com/app/489830/The_Elder_Scrolls_V_Skyrim/
                                    ^^^^^^
                                    Steam ID = 489830

Method 2 — SteamDB

Go to steamdb.info and search for your game. The App ID is shown on the results page.

Method 3 — Steam Library

1. Right-click the game in your Steam Library
2. Select Properties
3. Go to the Updates tab
4. The App ID is shown at the top

Adding Frameworks

If your game uses frameworks (Script Extender, BepInEx, ASI Loader, etc.):

1. Click Add in the frameworks table
2. Fill in the columns:

Column	Description	Example
Name	Framework display name	Cyber Engine Tweaks
Target	Install folder relative to game dir	bin/x64
Nexus ID	Mod ID on Nexus Mods	107
Detect	File path to check if installed	bin/x64/plugins/cyber_engine_tweaks.asi
Pattern	File pattern for archive detection	*.asi

Anvil will automatically detect installed frameworks and show them in the Frameworks panel.

Editing Existing Plugins

To modify an already loaded game plugin:

1. Go to File → Game Plugin → Edit (or puzzle icon dropdown → Edit)
2. Change paths, add/remove frameworks, update cover image
3. Click Save

Changes are saved to JSON and take effect immediately.

Cover Image

You can assign a cover image to your game plugin:

1. Click Select Image in the plugin creator
2. Choose a PNG or JPG file (recommended: 600×900 or similar portrait ratio)
3. The image is copied to Anvil's assets folder

Example: Adding a New Game

Let's add Crimson Desert as an example:

Field	Value
Game Name	Crimson Desert
Short Name	CrimsonDesert
Game Binary	bin64/CrimsonDesert.exe
Steam ID	3321460
Data Path	Paks/~mods

No frameworks needed. Click Create, restart Anvil, and Crimson Desert appears in your instance manager.

---

← Back to Anvil Organizer · Installation →