Skip to content

Options

bcssov edited this page Sep 21, 2026 · 15 revisions

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. Application Controls Outside the Options Panel

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

The Options panel is divided into four categories:

  • Application Options
  • Game Options
  • Conflict Solver
  • Update Options

The panel adapts to constrained or high-scaling displays and can be scrolled when all settings do not fit at once. Each category is described below.


4. Application Options

Notification Position

Controls where Irony displays in-app notifications.

External Editor

Configures the third-party merge/diff tool used by the Conflict Solver.

Editor Executable

Path to the external editor binary (for example, winmerge.exe or code.exe).

Editor Args

Arguments passed when launching the external editor.

Working examples may be shared here:

https://github.com/bcssov/IronyModManager/discussions/176


5. 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 / User 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

Changing the Data / User Directory or Custom Mod Directory triggers a controlled rescan. If the current game was placed in a protected state because a configured source became unavailable, Irony validates the replacement before allowing modifying operations again.

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.

Mod Merge Options

Mod Template

Naming format for individually compressed-merge mods. It must include {Name} and {Merged}.

Collection Template

Naming format for merged collections. It must include {Name} and {Merged}.


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. 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.

Check for Updates

Runs an update check immediately. When a release is available, this category shows its version information, changelog, and the actions supported on the current platform.

Download and Install / Open Release Page

On Windows and Linux, Download and Install begins the existing update process when a new version is available.

On macOS, automatic installation is disabled. Open Release Page opens the official GitHub Releases page so you can download and replace either the recommended .app bundle or portable build manually.


8. Understanding the Update Process

When update checking is enabled, Irony checks the feed at startup. You can also run a check manually from Update Options:

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

When an update is found, Update Options displays the available version, release information/changelog, and the actions supported on the current platform. Windows and Linux can use the existing download/install flow; macOS provides Open Release Page for manual replacement.

Download Behavior

Update packages are stored in:

%AppData%/Mario/IronyModManager-Updates

On Windows and Linux, downloaded files are signature-verified and installed according to the installation type. On macOS, update checking remains available, but Irony does not download or execute the updater helper.


9. 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 Linux: executable permissions restored (chmod +x)

2. Installer Installation

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

3. macOS Manual Update

  • Irony checks the existing update feed and displays release information
  • Open Release Page opens the official GitHub Releases page
  • Download the latest macOS bundle or portable fallback and replace the existing copy manually
  • No downloaded updater helper is executed

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.

Clone this wiki locally