-
Notifications
You must be signed in to change notification settings - Fork 52
FAQ
This page answers common questions about load order, conflict solver behavior, mod metadata, Linux/macOS issues, updates, and troubleshooting.
Irony uses the same load order as the Paradox Launcher v2.
Changes you make in Irony are applied directly to the game’s mod registry in a launcher-compatible format.
Not yet. Multi-select drag-and-drop is planned.
You can track the feature request here:
https://github.com/bcssov/IronyModManager/issues/12
You don't need to do anything manually.
- If you rerun the Conflict Solver, Irony will automatically clean outdated patch entries.
- You can also temporarily disable or delete the patch mod inside the Collection Mods panel.
Only Stellaris has full conflict solver support.
- HOI4 supports Analysis Only mode
- All other supported games use merging only
See the Supported Games page for details.
Some definitions are extremely complex.
You can configure an external merge tool in Options → External Editor (e.g., WinMerge, KDiff, VS Code) and use:
Right-click → External Merge
The external tool will open the virtual definition and allow full editing.
Invalid definitions are detected using CWTools.
They usually indicate malformed syntax or unsupported structures in a mod.
You can:
- Inspect errors in the Invalid folder inside Conflict Solver
- Provide custom overrides via Custom Patches
- Fix your own mods directly
If you believe Irony incorrectly flagged something, you can report it.
Yes. Inside the file, add one of the following comments on a line by itself:
### Dear Irony please fallback to simple parser
or
### Irony this is a placeholder file please ignore it
or specify placeholder IDs:
### Irony these are placeholder objects please ignore them: id1,id2
These prevent the definition from being used in conflict evaluation.
Some distros do not set XDG_DATA_HOME.
Irony depends on this path to locate Paradox game directories.
Setting this variable or launching the game once usually resolves the problem.
Possible causes:
- Avalonia UI bugs on certain distros
- Wayland incompatibility
- Tooltips causing UI deadlocks
You can fix this by editing appSettings.json:
"Tooltips": { "Disable": true }
Or enable Wayland support:
"LinuxOptions": { "DisplayServer": "wayland" }
Ensure xwayland is installed if using X11 fallback.
The recommended download is IronyModManager-osx-x64-app.tar.gz. Extract it using a method that preserves Unix executable permissions, then open IronyModManager.app from Finder. The bundle is an unsigned, unnotarized convenience bundle—not a native installer—so macOS may require its normal approval flow for downloaded unsigned software. The 1.28 bundle has been verified to launch from Finder on macOS 11.
The portable fallback is osx-x64.zip. Extract it, open Terminal in the extracted directory, and run:
chmod +x IronyModManager
./IronyModManager
Irony still checks for updates on macOS, but installation is manual. When an update is available, select Open Release Page, download the preferred macOS build, and replace the existing copy. Irony does not run the downloaded updater helper on macOS.
For older launch troubleshooting, see issue #119.
macOS has a very low ulimit (256), limiting how many file handles Irony can use.
Workaround:
- Copy
appSettings.json→appSettings.override.json - Set
"UseFileStreams": trueunder"OSXOptions" - Open Terminal → run:
ulimit -n 200000 - Launch Irony via Terminal:
./IronyModManager
You must repeat step 3 for each Terminal session unless you make the limit permanent.
Most commonly caused by:
- Antivirus blocking Irony
- Incomplete downloads
- System-level restrictions
Digitally signed binaries would prevent false positives, but code signing is expensive.
On macOS, automatic update installation is intentionally unavailable; use Open Release Page and replace the application manually.
Install the Microsoft Visual C++ 2017 Redistributable:
- x86: https://aka.ms/vs/16/release/vc_redist.x86.exe
- x64: https://aka.ms/vs/16/release/vc_redist.x64.exe
No. Irony is a mod manager and conflict solver only.
It cannot upload or publish Workshop mods.
Options:
- Merge → Compress
- Merge → Basic
- Duplicate a collection → Export → Whole Collection → re-import later
This ensures all mods exist locally in their exact state.
Fix options:
- Install xwayland
- Change
"DisplayServer"to"wayland"or"auto"inappSettings.json
Some distros (e.g., Arch) offer community packages like irony-mod-manager-bin,
but they are not officially maintained.
Report issues to the package maintainers, not Irony.
The FAQ covers common questions about load order, conflicts, metadata, Linux/macOS issues, updates, and mod management behavior.
If something is not covered here, check GitHub Discussions or open a new issue.