Basic usage

Content

• Working with the mod list
• Mod info panel
• Using categories
• Mod state filters
• Mod Dependencies

---

Working with the mod list

Mod list functions

• Left click on a row to select a mod.
• Left click on a group header (1) to select all mods from a specific groups ("Enable grouping" checkbox (6) must be enabled)
• Select multiple mods by holding SHIFT/CTRL + left click.
• Left click on a column header to sort mods by a specific column.
• Right click on a mod to open the mod context menu (3).
• Right click on a column header (2) to show/hide different columns.
• Right click on a column header (2) and select "Filtering" to apply specific filters.
• Quick search a mod by using the text filter (4).
• Use the mod state filters (5) to quickly find all mods with a specific mod state ("Show state filters" checkbox (6) must be enabled).

Context menu

The context menu (3) may show different options, depending on the type of mod (local/Workshop) and on how many mods are selected (single/multiple).

Mod list columns

While most columns are pretty self explanatory, others may require some additional explanation.

• Name
  This is the name of mod as reported from the Steam workshop. For local mods, the "title" from the .XComMod file is used.
  The name can be changed by double-clicking. To restore the original mod name, clear all text and press enter.

• Author
  This is the name of the mod author as reported from the Steam workshop. For local mods, author name is set to "Unknown".

• Category
  Each mod can me assigned to a user definable category. See Using categories.

• ID
  The ID corresponds to the file name of the .XComMod file that is located in the mod folder.

• Workshop ID
  This is the unique identifier from the Steam workshop.

• State

  • Not installed: A mod is flagged as "Not installed" when the mod folder no longer exists, or when the XComMod file is missing.
  • Not loaded: A mod is flagged as "Not loaded" when the mods installation folder is no longer located in one of the configured mod directories (Option->Settings).
  • Missing dependency: A mod will indicate a "Missing dependency", when not all required mods are enabled or installed. See Mod-Dependencies.
  • Conflicted: A pair of mods are flagged as "Conflicted", when the class overrides are likely to cause issues.
  • Duplicate: A pair of mods are flagged as "Duplicate", when the IDs of those mods are identical, because those are supposed to be unique.
  • Duplicate (primary), Duplicate (disabled): See Handling duplicates.
  • New: Mods are flagged as "New", when they were added during the last mod import/update process.
    The "New" flag for all mods will be removed after AML has been restarted.
    The "New" flag for a single mod will be removed when it is selected.

• Source
  Indicates if the mod was downloaded from the Workshop (located in the workshop mod folder) or if it was manually added to one of the user defined local mod folders.

• Order

• Size
  For Steam mods, AML will preferably use the size that is reported from the Workshop. For local mods, the size of the mod folder including all sub-folders is used.

• Has backups

• Hidden
  A mod will be automatically hidden, when it is no longer available and the mod state was set to wither "Not installed" or "Not loaded".

  • Mods can manually be (un-)hidden using the mod lists context menu.
  • Hidden mods can be shown by activating "Options -> Show hidden mods".
  • This is a purely cosmetic feature, it does not change if or how mods are loaded.

• Tags

• Path
  The directory where the mod is located.

• Date created
  Represents the point in time, the mod was added to the Steam Workshop. For local mods, it is determined by the creation date/time of the mod folder.

• Date added
  Represents the point in time, the user subscribed to the mod on the Steam Workshop. For local mods, it is set to the time when the mod was detected/added by AML.

• Last update Represents the point in time, the mod was last updated according to the Steam Workshop. For local mods, it is determined by the date and time the mod directory was last written to.

• Browser link URL that opens the mods Workshop page in the default browser. Format is https://steamcommunity.com/sharedfiles/filedetails/?id=00000000, where 00000000 is the mods Workshop ID.

• Steam link URL that opens the mods Workshop page in the Steam application. Format is steam://url/CommunityFilePage/00000000, where 00000000 is the mods Workshop ID.

Mod info panel

The mod info panel on the bottom of the screen displays information about the currently selected mod. The different tab pages are explained below.

Info

Shows some basic information about the mod. You can edit the description by just typing into the text box. This can be useful to make some personal notes with respect to this mod.

• Save - Save any changes you made to the description
• Undo - Revert all changes that were made after saving the last time
• You can restore the original description by clearing/deleting all text and then updating the mod.

Readme

Contains additional information if the author of the mod provided any.

Inspect

Contains a compact overview of all available mod information and some internally used mod attributes. Most of the relevant mod information is available/accessible through the mod list and the other mod info panel tabs, so there is rarely a reason to look at this.

Config

-> See Mod configuration

Changelog

The change log tab displays the mods version/update history that is also display on the Steam Workshop page of the mod.

Dependencies

-> See Dependencies

Using categories

[TODO]

Mod state filters (v1.4)

You can easily filter mods by their current state (duplicate, new, conflict etc) by clicking the desired control from the state filter bar.

• You can select multiple filters at once.
• Hovering over a filter control will show a tool-tip description.
• The number in braces displays the number of mods that are matching the respective filter.
• The filtering can be combined with the text filter.
• Note that "hidden mods" are not displayed.

Mod Dependencies (v1.4)

The "Dependencies" tab from the mod overview panel shows all dependent mods and required mods for the current selection.

• The Required mods list shows all mods that the currently selected mod depends on.
• The Dependent mods list shows all mods that depend on the currently selected mod.
• You can choose to ignore specific dependencies by checking the "Ignored" checkbox.
• You can double click on a mod, to select the respective mod in the mod-list.
• You can directly enable/disabled dependencies by clicking the check-box.
• You can choose to either view the real dependency or the primary duplicate (only if the "duplicate mod id workaround" is enabled in the Settings).

-> Continue with Advanced