Mod Filter - bcssov/IronyModManager GitHub Wiki

The Filter Mods search box allows you to quickly find mods by name, ID, or advanced criteria.
Filtering supports partial matching, logical operators, negation, and field-specific queries.

This system is powerful and flexible, allowing both simple searches and complex filters.

Filtering is available in the Installed Mods panel:
Installed Mods


Basic Filtering

Typing any text will show all mods whose name or remote ID contains the search term.

Examples:

  • star → matches “Star Wars Mod”, “Starlane Improvements”
  • 1234 → matches mods with remote ID containing 1234

Matching is partial and case-insensitive.


Logical Operators

AND Operator

Use && to combine multiple filters:

my mod && source:steam

OR Operator

Use || to match either condition:

my mod || another mod

NOT Operator (Negation)

Use -- before a term or field:

--my mod
source:--local

Negation works on all supported fields.


Field Filters

You can filter mods using structured keywords:

Achievements

achievements:yes
achievements:no
achievements:true
achievements:false

Selected (in the current collection)

selected:yes
selected:no

Source

source:steam
source:paradox
source:local

Supports OR syntax:

source:steam||paradox

Version

Matches version fields declared in descriptors:

version:2.0
version:3.2.1
version:2.0||3.0

(Partial matching applies.)


Combined Examples

Match a specific mod from Steam that supports achievements:

my mod && achievements:yes && source:steam && selected:no && version:2.0

OR operator example:

my mod || another mod && source:steam||paradox

Negation example:

--my mod && source:--local

Summary

Filtering in Irony allows:

  • Partial name or ID searches
  • Combining multiple criteria
  • Logical AND / OR
  • Negation
  • Filtering by achievements support
  • Filtering by selection state
  • Filtering by source (steam / paradox / local)
  • Filtering by version

This system makes managing large mod lists fast and efficient.