Almost Manual Mod Organizer (ammo)

Say "No!" to annoying bullshit, like:

• Advertisements.
• Auto-updates.
• Overreaching integrations (screenshots, saves, socials, tracking of tax deductions earned through donations).
• Account-required-before-use fuckery.
• Uncensored BDSM hentai in the in-app news feed even though you've turned off adult content twice.
• GUIs (and other bloat).

Ammo is purely a mod manager. This means it is concerned with exactly one problem, and it solves it really fucking well:

As a Linux gamer,

I want easy, safe, and transparent mod management,

so that I never have to reinstall the game or verify files, and can audit how mods are installed.

Ammo's interface is an interactive shell designed to make you feel 27% cooler while modding (especially when you're installing the sword that one-shots God). Under the hood, it hooks mods up to a game by adding symlinks to the game directory which point at mod files.

Ammo is forever free from annoying bullshit (a decision by yours truly that required a whopping 100 IQ).

Supported Games

• Enderal
• Enderal Special Edition
• Fallout 4
• Fallout New Vegas
• Oblivion
• Oblivion Remastered
• Sims 4
• Skyrim
• Skyrim Special Edition
• Skyrim VR
• Starfield

Features

• install mods from ~/Downloads
• activate/deactivate mods/plugins
• reorder mods/plugins
• rename mods/downloads
• delete mods/plugins/downloads
• autosort plugins by mod order
• supports FOMOD configuration
• file conflict detection

Dependencies

• Python 3.12 or later
• Steam from Flatpak or official repos.
• p7z from official repos.
• pipx from official repos.

Installation

git clone https://github.com/cyberrumor/ammo
cd ammo
pipx install . --force

Usage

usage: ammo [-h] [--downloads PATH] [--conf PATH] [--mods PATH] [--title TITLE]

Almost Manual Mod Organizer

options:
  -h, --help        show this help message and exit
  --downloads PATH  directory containing installable archives
  --conf PATH       directory containing configs for managed games
  --mods PATH       directory containing mods for this session
  --title TITLE     manage a detected game with TITLE (skip game selection menu)

Help

............................................................................................
activate_mod      : <index>             : Enabled mods will be loaded by game.
                  :                     : - `activate_mod 0`
                  :                     : - `activate_mod all`
............................................................................................
activate_plugin   : <index>             : Enabled plugins will be loaded by the game.
                  :                     : - `activate_plugin 0`
                  :                     : - `activate_plugin all`
............................................................................................
collisions        : <index>             : Show file conflicts for a mod. Mods prefixed with
                  :                     : asterisks have file conflicts. Mods prefixed with
                  :                     : x install no files.
                  :                     : - `collisions 0`
............................................................................................
commit            :                     : Apply pending changes.
............................................................................................
configure         : <index>             : Configure a fomod.
                  :                     : - `configure 0`
............................................................................................
deactivate_mod    : <index>             : Diabled mods will not be loaded by game.
                  :                     : - `deactivate_mod 0`
                  :                     : - `deactivate_mod all`
............................................................................................
deactivate_plugin : <index>             : Disabled plugins will not be loaded by game.
                  :                     : - `deactivate_plugin 0`
                  :                     : - `deactivate_plugin all`
............................................................................................
delete_download   : <index>             : Removes specified download from the filesystem.
                  :                     : - `delete_download 0`
                  :                     : - `delete_download all`
............................................................................................
delete_mod        : <index>             : Removes specified mod from the filesystem.
                  :                     : - `delete_mod 0`
                  :                     : - `delete_mod all`
............................................................................................
delete_plugin     : <index>             : Removes specified plugin from the filesystem.
                  :                     : - `delete_plugin 0`
                  :                     : - `delete_plugin all`
............................................................................................
exit              :                     : Quit.
............................................................................................
find              : [<keyword> ... ]    : Show only components with any keyword. Execute
                  :                     : without args to show all.
                  :                     : - `find`
                  :                     : - `find keyword1`
                  :                     : - `find keyword1 keyword2`
............................................................................................
help              :                     : Show this menu.
............................................................................................
install           : <index>             : Extract and manage an archive from ~/Downloads.
                  :                     : - `install 0`
                  :                     : - `install all`
............................................................................................
log               :                     : Show debug log history.
............................................................................................
move_mod          : <index> <new_index> : Larger numbers win file conflicts.
                  :                     : - `move_mod 0 1`
............................................................................................
move_plugin       : <index> <new_index> : Larger numbers win record conflicts.
                  :                     : - `move_plugin 0 1`
............................................................................................
refresh           :                     : Abandon pending changes.
............................................................................................
rename_download   : <index> <name>      : Names may contain alphanumerics and underscores.
                  :                     : - `rename_download 0 some_text`
............................................................................................
rename_mod        : <index> <name>      : Names may contain alphanumerics and underscores.
                  :                     : - `rename_mod 0 some_text`
............................................................................................
sort              :                     : Arrange plugins by mod order.
............................................................................................
tools             :                     : Manage tools.
............................................................................................

License

GNU General Public License v2, with the exception of some of the mock mods used for testing, which are subject to their packaged license (if it exists), which also contains credits.