Options - bcssov/IronyModManager GitHub Wiki

The Options panel contains all global and game-specific settings for Irony Mod Manager.
These settings control language, themes, game paths, editor integration, update behavior, and advanced conflict solver options.

1. General Options

Language

Selects the application UI language.

Themes

Choose between available visual themes for the Irony UI.

Game

Changes the currently active game.
All game-specific settings below apply only to the selected game.

Actions

Provides quick access to useful tools:

  • Open DLC Manager
  • Open Irony Wiki
  • Open Irony Logs Directory
  • Open Selected Game’s error.log

2. DLC Manager

Allows enabling or disabling DLCs for the selected game.

After adjusting DLC checkboxes, press Close to apply.

3. Options Screen Overview

pptions-screen

The options screen is divided into several categories:

  • Game Options
  • External Editor Options
  • Conflict Solver Options
  • Mod Merge Options
  • Update Options

Each section is described below.

4. Game Options

Configure All

Automatically detects game paths and settings when you select the root installation folder.

Irony attempts to determine:

  1. Game executable
  2. Game data directory (e.g. Documents/Paradox Interactive/Stellaris)
  3. Launch arguments

Note: Irony does not require selecting the exact root folder.
If you select a deeper folder (e.g. .../Stellaris/common), Irony walks upward until it finds a valid game structure.

Game Executable

Path to the file Irony should launch when “Launch Game” is pressed.

Game Args

Additional command-line arguments to pass to the game executable.

Data Directory

Location where the game stores:

  • settings
  • save files
  • mods
  • launcher data

Example (Stellaris):
Documents/Paradox Interactive/Stellaris

Custom Mod Directory

Adds an extra folder from which Irony will load mods.
If enabled, this folder also becomes the location for:

  • merged mods
  • patch mods

Refresh Descriptors Before Playing

Before launching the game, Irony:

  • deletes existing mod descriptors
  • regenerates them cleanly

Useful for stale or partially written .mod files.

Close After Launching Game

If enabled, Irony closes automatically after launching the game.
If disabled, it remains open.

5. External Editor Options

Used in the Conflict Solver to open the virtual definition in a third-party merge/diff tool.

Editor Executable

Path to the external editor binary (e.g. winmerge.exe, code.exe).

Editor Args

Arguments passed when launching the external editor.

Working examples may be shared here:
https://github.com/bcssov/IronyModManager/discussions/176

6. Conflict Solver Options

Allowed Languages

Enable/disable parsing of specific localization languages.

Disabling unused languages (e.g. German, Spanish) improves performance.

New Diff Viewer Colors

Customize colors used in the new diff viewer.

(Does not affect the legacy merge viewer.)

7. Mod Merge Options

Mod Template

Naming format for individually compressed-merge mods.
Must include:

  • {Name}
  • {Merged}

Collection Template

Naming format for merged collections.
Must include:

  • {Name}
  • {Merged}

8. Update Options

Check for Updates at Startup

Automatically checks Irony's update feed each time the application starts.

Update to Prerelease Versions

If enabled, Irony may update to:

  • alpha
  • beta
  • rc
  • stable

If disabled, only stable releases are used.

Download and Install

Begins the update process when a new version is available.

9. Understanding the Update Process

On first run, Irony displays:

update_check

If allowed, Irony checks the feed:

https://bcssov.github.io/IronyModManager/appcast.xml

Which lists available releases.

When updates are found:

updates_available

Download Behavior

Update packages are stored in:

%AppData%/Mario/IronyModManager-Updates

Files are signature-verified and then installed depending on installation type.

10. Installation Types

1. Portable Installation

  • Zip is unpacked
  • Console updater is launched
  • Irony closes
  • Updater copies new files into the install directory
  • Irony restarts
  • On macOS/Linux: executable permissions restored (chmod +x)

2. Installer Installation

  • Zip is unpacked
  • Setup installer is launched
  • Update applies via installer UI

Update files remain for ~3 days before automatic cleanup.

Summary

The Options screen centralizes all configuration for paths, editor tools, updates, conflict solver behavior, and merge templates.
Most users configure it once; advanced users may fine-tune tools and parsing behavior to suit their workflow.