Repository navigation
Home
A mod manager for Linux.
GitHub | Nexus | Releases | Report an issue | Ko-Fi
- Install Amethyst - AppImage, Flatpak or AUR.
- Install your first mod - from a zip, the Downloads tab, or straight from Nexus.
- Deploy - move the modded files into the game, then launch it however you normally do.
| 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. |
| 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 |
| 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. |
| 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. |
| Page | What's in it |
|---|---|
| Installing VNV and TTW | Guide to installing VNV or TTW using the in app wizard |
| 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. |
| 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. |
| 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 |
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 builddirThe 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.
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- Bugs and game requests: open an issue. Include as much detail as you can - for game requests, describe how modding works for that game.
Getting started
Managing mods
- Installing a mod
- Mod Files Tab
- Updating a Mod
- Overwrite folders
- Mods not working
- Profile Specific Saves
- Grouping Mods
Profiles
Load order and conflicts
Deploying and playing
Collections
Guides
Tools and advanced
Reference