Skip to content

Mod Filter

bcssov edited this page Sep 21, 2026 · 11 revisions

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.

Use the Advanced Filter button beside the search box to construct common filters visually. It provides fields for Name / Alias / Remote ID, Source, Selected, Achievements, and version inclusion or exclusion. Applying it writes an ordinary query into the same search box; you can still edit that text directly to use the full syntax documented below.

Filtering and Advanced Filter are shared by the Installed Mods and Collection Mods panels:


Basic Filtering

Typing any text will show all mods whose canonical name, user-defined display alias, or remote ID contains the search term. Aliases are local display preferences; they do not rename the mod or change its collection identity.

Examples:

  • star → matches “Star Wars Mod”, “Starlane Improvements”, or an alias containing “star”
  • 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.

Clone this wiki locally