Executable Usage Guide

Executable Usage Guide

How to download, install, and run the standalone IcarusPetEditor.exe — no Python required.

Download

  1. Go to the Releases page
  2. Download the latest IcarusPetEditor-vX.X.X-win64.zip
  3. Extract the ZIP — you'll get a single IcarusPetEditor.exe (~10 MB)

No installation needed. Place the .exe anywhere you like.

First Launch

⚠️ Before editing: Store your mounts, pets, and farm animals at the station in-game before opening the editor. Only creatures stored at the station appear in the Mounts.json file — animals currently following you or active in the world are not included.

  1. Double-click IcarusPetEditor.exe
  2. The editor auto-detects your Icarus save files at: %LOCALAPPDATA%\Icarus\Saved\PlayerData\{YourSteamID}\Mounts.json
  3. If multiple Steam IDs are found, a picker dialog lets you choose which one
  4. If auto-detection fails, use 📂 Open JSON… to browse manually

Usage

The editor works identically to the source version — see the GUI Guide for full details on each tab.

Quick Overview

Tab What You Can Edit
Overview Name, gender, lineage, vital stats, species swap
Genetics 7 genetic stats (Vigor, Fitness, Physique, etc.)
Talents Full talent tree with rank spinboxes
Advanced Raw UE4 properties (expert mode)

Saving

  • 💾 Save — Overwrites the current file (creates a .bak backup first)
  • 💾 Save As… — Save to a new file
  • ↩ Restore Backup — One-click restore from the .bak file

About Dialog

Help → About shows the current version, project info, and links.

Verifying the Version

From the command line:

IcarusPetEditor.exe --version

This prints the version string and exits — useful for verifying the download.

Troubleshooting

"Windows protected your PC" (SmartScreen)

Since the .exe is not code-signed, Windows SmartScreen may show a warning on first launch:

  1. Click "More info"
  2. Click "Run anyway"

This is normal for unsigned executables and only happens once.

"Mounts.json not found"

  • Make sure Icarus is installed and you've played at least one session with tamed animals
  • Animals must be stored at the station (not following you in the world)
  • Try 📂 Open JSON… and navigate to: C:\Users\YOU\AppData\Local\Icarus\Saved\PlayerData\ Look for folders named with your Steam ID

Antivirus False Positives

PyInstaller-built executables are occasionally flagged by antivirus software. This is a known PyInstaller issue. The source code is fully open for review.

Exe Won't Start / Crashes Immediately

  1. Try running from Command Prompt to see error messages: cmd cd path\to\IcarusPetEditor.exe IcarusPetEditor.exe
  2. Make sure you're on Windows 10 or 11 (64-bit)
  3. Check that the exe isn't being blocked by antivirus

Updating

When a new version is released:

  1. Download the new ZIP from Releases
  2. Replace the old .exe with the new one
  3. Your save files are untouched — they live in your Icarus save directory

See also: GUI Guide · Species & Types · Talent & Genetics Data

Back to Docs