Skip to content
Chris edited this page Sep 13, 2026 · 51 revisions

Amethyst Mod Manager Wiki

A mod manager for Linux.

GitHub | Nexus | Releases | Report an issue | Ko-Fi


New here? Start here

  1. Install Amethyst - AppImage, Flatpak or AUR.
  2. Install your first mod - from a zip, the Downloads tab, or straight from Nexus.
  3. Deploy - move the modded files into the game, then launch it however you normally do.

Contents

Getting started

Page What's in it
FAQ Why Data_core exists, hardlinks vs symlinks, folder casing, which games get added, "my mod won't work".
Installing Installing, updating and uninstalling Amethyst itself, plus pre-release builds.

Managing mods

Page What's in it
Installing a mod The four ways to install a mod, and how to remove one.
Mod Files Tab Disable files, change what counts as top level, preview images and text, pack/unpack BSA/BA2.
Updating a Mod Update checks, the version picker, and Quick Update.
Installing a collection Nexus collections for premium and free users, updating, and recovering from a crash mid-install.
Creating and uploading a collection Creating and uploading Nexus collections
Mods not working Pointers on how to diagnose problematic mods
Profile Specific Saves Keeping saves per profile - the Bethesda option and the custom path option.
Grouping Mods Using the mod grouping feature

Load order and conflicts

Page What's in it
Understanding Conflicts Loose file vs BSA/BA2 conflicts, what each flag means, the Show Conflicts window.
Using Separators Grouping the modlist, separator locks, custom deployment paths.
Profile Groups How to group profile together
Root folder building Getting files into the game's root folder instead of the mod folder.

Deploying and playing

Page What's in it
Deploy and Restore What deploy and restore actually do, best practices, runtime generated files, script extenders.
Case Alias Symlinks (Faster Loading) Explains how Bethesda games can be made to load faster under Proton
CLI Mode Deploy and restore from a terminal or a Steam shortcut - handy for Gaming Mode.

Guides

Page What's in it
Installing VNV and TTW Guide to installing VNV or TTW using the in app wizard

Tools and advanced

Page What's in it
Using external applications The wizard menu: Pandora, BodySlide, PGPatcher, TTW and friends.
Adding a custom game Every option in the custom game editor, with worked examples.
The nif viewer Using the nif viewer to preview mesh files
Exporting a profile Export a profile as a file others can import, or as a short share code.

Reference

Page What's in it
Keybinds Every keyboard shortcut.
Launch Options Env vars and command line arguments
Known Issues A list of issues or missing features that I'm aware of.

Supported games

Game Notes Game Notes
7 Days to Die Mount & Blade II: Bannerlord
Abiotic Factor My Summer Car
Baldur's Gate 3 NieR: Automata
Blade and Sorcery No Man's Sky
Bloons TD6 Oblivion
Clair Obscur: Expedition 33 Oblivion Remastered
Crash Bandicoot 4 Pacific Drive
Cyberpunk 2077 Palworld
Daggerfall Unity Native Linux build Payday 2
Darktide Peak
Devil May Cry 5 Planet Zoo
Dragon Age Origins Pragmata
Dragons Dogma 2 Pseudoregalia
DragonSword: Awakening R.E.P.O
Dyson Sphere Program Ready Or Not
Elden Ring Red Dead Redemption 2
Elden Ring Nightreign Resident Evil 2, 3, 4, 7, Village, Requiem
Enderal Normal and SE Rimworld
Fallout 3 Normal and GOTY Risk of Rain 2
Fallout 4 Normal and VR RuneScape: Dragonwilds
Fallout 76 Schedule 1
Fallout New California (GOG) Skyrim Normal, SE and VR
Fallout New Vegas Slay The Spire 2
FF VII Rebirth Slime Rancher
FF VII Remake Intergrade Spyro Reignited Trilogy
FF XII: The Zodiac Age Stalker 2
Gothic 1 Remake Stardew Valley
Green Hell Starfield
Grounded 1 and 2 StarRupture
Halo: Campaign Evolved Stellar Blade
Hogwarts Legacy Street Fighter 6
Hollow Knight: Silksong Subnautica
ICARUS Subnautica 2
Infection Free Zone Subnautica: Below Zero
Inscryption Supermarket Simulator
Jagged Alliance 3 SW: Jedi Fallen Order
Kingdom Come: Deliverance 1 and 2 Tainted Grail: The Fall of Avalon
Kingdom Hearts 3 TCG Card Shop Simulator
Lethal Company The Blood of Dawnwalker
Marvel Rivals The First Berserker: Khazan
MechWarrior 5: Mercenaries The Last Caretaker
Mewgenics The Sims 4
Monster Hunter Rise The Witcher 3
Monster Hunter Wilds Valheim
Monster Hunter World Windrose
Morrowind Normal and OpenMW X4: Foundations

Building from source

Amethyst uses the Meson build system.

Build requirements: git, meson, ninja, Python 3.12 or newer, a Rust toolchain (cargo), and a C toolchain (cc, usually GCC or Clang)

Runtime requirements (install via your distro or pip): PySide6, requests, py7zr, Pillow, lz4, zstandard, websocket-client, keyring, msgpack, bsdiff4

A native 7-Zip binary (7zz/7z) on your PATH is strongly recommended, extraction is much faster than the py7zr fallback.

git clone https://github.com/ChrisDKN/Amethyst-Mod-Manager.git
cd Amethyst-Mod-Manager
native/amethyst_filegraph/build.sh
meson setup builddir
meson install -C builddir

The filegraph extension is required for both source runs and installed packages. The build script compiles the locked Rust crate in release mode and writes src/amethyst_filegraph.abi3.so, which Meson then installs with the Python sources. Rerun it after updating anything under native/amethyst_filegraph/.

If the host does not provide cc, the script can use the KDE 6.9 Flatpak SDK (org.kde.Sdk//6.9) when it is installed and Cargo is managed by rustup.

Then launch amethyst-mod-manager (GUI) or amethyst-mod-manager-cli.

For distro packagers: build the filegraph extension for the target architecture first. The usual meson setup builddir --prefix=/usr and DESTDIR=pkg meson install -C builddir then work as expected, and meson test -C builddir validates the AppStream metainfo.

Optional: LOOT plugin sorting

Plugin sorting uses the libloot Python module. The app runs fine without it; plugin sorting is just disabled. To build it you need Rust (cargo) and a C toolchain:

git clone --branch 0.29.6 https://github.com/loot/libloot.git
cd libloot/python
pip install maturin
maturin build --release
pip install ../target/wheels/libloot-*.whl

Something wrong or missing?

  • Bugs and game requests: open an issue. Include as much detail as you can - for game requests, describe how modding works for that game.

Clone this wiki locally