SKYPLUG(1) General Commands Manual SKYPLUG(1)

skyplug — inspect and toggle Skyrim Special Edition plugins on Linux

skyplug [--game-dir dir] [--prefix dir] [--appid appid] command [args]

skyplug reads and edits the Plugins.txt load order of a Skyrim Special Edition install running under Proton or Wine, Steam's or GOG's, without a mod manager. It scans the game's Data directory for .esp, .esm and .esl files, cross-references them with Plugins.txt and Skyrim.ccc, and reports what the engine will actually load.

It can also read .ess save files directly, to show which characters exist, which saves belong to each, and which plugins were active when a save was made.

Only two kinds of plugin load regardless of Plugins.txt:

  • the base game and DLC masters: Skyrim.esm, Update.esm, Dawnguard.esm, HearthFires.esm and Dragonborn.esm;
  • Creation Club content listed in Skyrim.ccc.

Every other plugin, including mod .esm files and .esp files carrying the master flag, loads only when it is prefixed with ‘*’ in Plugins.txt. The master flag in a plugin's header only affects where it loads: masters load ahead of regular plugins.

The load order skyplug shows is an approximation: base game masters in their fixed order, then Creation Club content in Skyrim.ccc order, then active masters, then active regular plugins, each group in Plugins.txt order. The engine additionally sorts masters by their dependencies, which skyplug does not parse.

List every plugin in Data, plus any listed in Plugins.txt that no longer exist, each with a status marker:

enabled in Plugins.txt
present in Data but not enabled
listed in Plugins.txt but missing from Data
base game/DLC master, always loaded
Creation Club content, always loaded
plugin
Enable plugin by setting its ‘*’ prefix in Plugins.txt, adding it to the end of the file if it is not listed yet.
plugin
Disable plugin by removing its ‘*’ prefix. A plugin not listed in Plugins.txt is left alone.
Open the interactive editor; see EDITOR.
Print the resolved Data, Plugins.txt, Skyrim.ccc and saves paths, then exit. Useful for checking that auto-detection found the right install.
List every character across all saves, with the number of saves each has and details of the most recent one.
character
List every save belonging to character.
save
List the plugins that were active when save was made, each marked against the current setup with the same markers as list.
[plugin [--filter text [--check]]]
Without plugin, list the plugins in the load order that have armour records, with how many. With one, list its armours: name, editor ID, the slots it covers, and the models it is worn as (for a female character, the human races), as the load order wears it: the last plugin that changes an armature decides, so a plugin that refits vanilla armours shows the refitted models. An armour a plugin only changes is marked with the plugin that adds it. --filter keeps armours whose name or editor ID contains text. --check also reads each armour's models and flags with an exclamation mark any the game won't draw: a skinned model records which slot each skin partition belongs to, and the game only draws a partition whose slot is among the slots of the armature wearing it, so moving an armour to another slot in its plugin without moving its model makes it invisible. preview --armour warns about the same.
model [-o | --out file [--views list [--size pixels [--body [--with model [--elevation degrees [--zoom factor [--transparent [--no-pose]]]]]]]]]
Draw model with its textures and write a PNG with the views side by side, and print where each texture came from (the loose file or archive the game uses, what it hides, or that it is missing). model is a game path such as meshes/armor/iron/f/cuirass_1.nif, or a .nif file on disk. This is a software preview for checking shape, texture mapping and colours, not the game's renderer: no normal, specular or glow maps and no skin or hair tint. Skyrim LE models are refused.
list
Comma-separated views: front, three-quarter, right, back, left, or an angle in degrees. The default is front, three-quarter, right and back.
pixels
Width and height of each view; the default is 480.
Also draw the installed female body, hands and feet, for scale.
model
Draw another model as well; can be repeated.
text
Draw an armour by name or editor ID, as the load order wears it; can be repeated. Use - as the model to draw only armours.
degrees
Camera height above the horizon; the default is 6.
factor
1 fits the whole model; larger zooms in.
Use a transparent background.
Draw skinned models as they are stored. By default they are posed on the game's female skeleton, as the game does: each vertex moves by the bones it is weighted to, so a model made on a skeleton that differs from the game's (a few mods' are shifted by a couple of units) comes out where it does in game, next to the pieces made on the right one.
[--install]
Print this manual page to standard output. With --install, write it to ../share/man/man1/skyplug.1 relative to the directory holding the skyplug binary instead, and print the path written.

plugin may be the exact filename, the filename in a different case, or the name without its extension. character matches a player name exactly or by case-insensitive substring. save matches a save's filename with or without .ess, or an unambiguous substring of it. An ambiguous match fails and lists the candidates.

dir
Use the Skyrim Special Edition install in dir (the directory containing SkyrimSE.exe) instead of searching the Steam libraries. The Proton prefix is looked up in the Steam library that contains dir; for a game outside a Steam library, give its prefix with --prefix. A directory holding a goggame-*.info file is GOG's build, whose per-user folders are named Skyrim Special Edition GOG.
dir
Read Plugins.txt and the saves from the Wine prefix dir (the directory holding drive_c) instead of the Steam library's Proton prefix, as for GOG's build run under umu or Wine. The Windows user inside it is ‘steamuser’ when that exists, as under Proton and umu, else the Unix user.
appid
Steam AppID used to locate the game and its Proton prefix. Defaults to 489830, Skyrim Special Edition.
, --help
Print a short usage summary.
, --version
Print the version.

Used for --game-dir when it isn't given.
Used for --prefix when it isn't given.

edit has two tabs, and , switched with tab.

In both tabs:

, k, up, down
move the selection
, G
jump to the top or bottom
switch tab
save plugin changes and quit
, esc
quit, asking again first if there are unsaved changes

In the Plugins tab:

, enter
toggle the selected plugin
filter by substring as you type; enter keeps the filter, esc restores the previous one
cycle the sort order: load order, name, type, enabled

Toggles are held in memory and marked with a trailing ‘*’ until saved with s. Always-loaded and missing plugins cannot be toggled.

In the Saves tab, which goes from characters to their saves to a save's plugins:

, right, enter
open the selected character or save
, left, backspace
go back up a level
go back up a level, or quit at the top

A save's plugins are marked against the current setup, including unsaved toggles, so you can enable what a save needs in the Plugins tab and check it in the Saves tab before saving.

Paths are shown relative to the Steam library holding the game, lib, and to the Proton user directory inside it, user, which is lib/steamapps/compatdata/489830/pfx/drive_c/users/steamuser for the default AppID. With --prefix, user is the user directory in that prefix instead, and for GOG's build the per-user folders are named Skyrim Special Edition GOG. paths prints the resolved ones.

lib/steamapps/common/Skyrim Special Edition/Data/
Installed plugins.
lib/steamapps/common/Skyrim Special Edition/Skyrim.ccc
Creation Club plugins the engine always loads.
user/AppData/Local/Skyrim Special Edition/Plugins.txt
The load order. skyplug writes Plugins.txt.bak beside it before every change.
user/Documents/My Games/Skyrim Special Edition/Saves/
Save files.
~/.local/share/Steam, ~/.steam/steam, ~/.steam/root
Steam installs searched for libraryfolders.vdf, along with the Flatpak install under ~/.var/app/com.valvesoftware.Steam.

The skyplug utility exits 0 on success, and >0 if an error occurs.

List the plugins that are installed but switched off:

$ skyplug list | grep '^\[ \]'

Enable a plugin by name, ignoring case and extension:

$ skyplug enable "paarthurnax dilemma"
enabled Paarthurnax Dilemma.esp

Before loading an old save, find which of its mods are missing or disabled:

$ skyplug characters
$ skyplug saves tessta
$ skyplug save-plugins Quicksave0 | grep -v '\[x\]'

Use Skyrim VR, or an install the Steam search does not find:

$ skyplug --appid 611670 list
$ skyplug --game-dir "/mnt/games/Skyrim Special Edition" paths

Use GOG's build, run under umu with its own prefix:

$ export SKYPLUG_GAME_DIR="/games/gog/Skyrim Special Edition"
$ export SKYPLUG_PREFIX=/games/gog/prefixes/skyrim-se
$ skyplug list

Install this page after ‘cargo install skyplug’, or read it without installing:

$ skyplug man --install
$ skyplug man | man -l -

man(1)

Divan Visagie <me@divanv.com>

October 24, 2026 Ubuntu