A Windows desktop savegame editor for Heroes of Might and Magic III and Heroes of Might and Magic II. For HoMM3 it supports the following versions/expansions:
- Base, AKA: Restoration of Erathia
- Armageddon's Blade
- Shadow of Death
- and Horn of the Abyss (HotA) (v1.8.1)
- Heroes Chronicles. Note that this is entirely speculative and extracted from the work of Erki Suurjaak on h3sed, and only works for a limited subset of entities (heroes and towns), as I do not own a copy of the game.
For HoMM2:
- Base, AKA: The Succession Wars
- The Price of Loyalty.
With Siniskalc you can edit Heroes (skills, armies, spells, artifacts), Towns (buildings, garrisons, spells), Players (resources, mines, dwellings) and more! See Features for an expanded list.
All the common savefile types used by the 2 titles are supported, for single player and hotseat sessions: .GM1, .GM*, .GX1, .GX*, .CGM etc.
Saves have been tested with Horn of The Abyss version 1.8.1, HoMM3 Complete and HoMM2 Complete from gog.com
Siniskalc lets you edit many of the entities in a HoMM2 and HoMM3 savegame. They are all modelled in an easy-to-navigate UI that tracks all the pending changes and allows undo/redoing.
The left-hand navigation tree shows the game, then one node per player, each with a Heroes, Towns, Mines and Dwellings group (where it applies), then Neutral (what nobody owns, including the heroes the game keeps out of play) and the Map. A non extensive list of entities extracted from the save files:
Game overview
- Map and game setup information read from the save (difficulty, game date, player control, and so on).
- Whose turn it is (hotseat games only).
Players
- Edit the seven resources: wood, mercury, ore, sulfur, crystal, gems and gold.
- Tavern heroes, and which obelisks each colour has visited.
- Banish countdown (how many turns before players that have lost their last castle are kicked from the game).
Heroes
- Primary skills (attack, defense, spell power, knowledge), with the bonus from equipped artifacts shown.
- Level, experience, class, gender, spell points, movement points, position on the map and facing.
- Secondary skills and skill levels (HotA skills included).
- Spell book, including the spells granted by artifacts.
- Army: creature type and count for each slot (seven in HoMM3, five in HoMM2).
- War machines (HoMM3): ballista, ammo cart, first aid tent and, in HotA, the cannon.
- Equipped artifacts and the backpack, with effect descriptions.
- Visited buildings.
Towns
- Faction, owner, position, mage guild level and spells, garrison creatures.
- Built and buildable structures, with their requirements.
- Creatures waiting in the dwellings, upgraded or not.
- Artifacts Merchant stock.
Map objects
- Mines, dwellings.
- HoMM3 adventure-map Black Market stock under Map > Merchants.
- Creature banks (Dragon Utopias, Cyclops Stockpiles, Dwarven Treasuries, Imp Caches, Medusa Stores and Naga Banks) under Map > Creature banks: rewards, guards, defeated state.
Editing
- Pending-changes list showing every byte-level change before saving, undo, and revert all.
- Recent files menu.
- Backup of the savegame before each save (on by default, numbered, see Settings).
- Advanced mode (Settings... > Tools > Advanced mode): a raw hex editor page for anything the editor does not model yet, and the Advanced menu to export the save bytes to a file and load them back, useful for diffing saves.
New to the editor? Read the user guide; it is also behind Help > User guide (F1).
See FUTURE_WORK.md for what is planned.
Download the latest zip from the Releases section of the repository, unzip it anywhere and run Siniskalc.exe.
Keep the shipped GameData folders beside the executable; they contain the entity definitions required at startup.
No installation needed, but it requires the .NET 8 Desktop Runtime (x64).
Always keep a backup of your savegames. This is a hobby tool that patches bytes of reverse-engineered file formats. While it does take precautions to avoid damaging your saves (for example by only patching the bytes that have changed, and keeping a backup of the save before each save), do not blindly trust it.
The original save file is not modified until you click Save; and the editor keeps a copy of the save file before it is replaced (same folder,
.bakextension; later saves add a counter:.bak1,.bak2, ... and never overwrite an earlier copy).
This can be turned off under Settings... > Saving > Back up on save.
Siniskalc makes modelling of additional in-game entities not yet known by the editor possible: standard game entities are supplied as JSON in GameData\Homm2 and GameData\Homm3. Keep these folders with the executable when distributing or moving it!
Definitions are loaded once at startup: after editing them, restart the editor to apply changes. Missing or invalid definitions stop startup, and the application will show an error identifying the file.
If you want to add entities, do note that you must know the matching byte codes. You should be able to use Siniskalc's built-in hex viewer to see them (example: Load a save file with an unknown creature on a hero, check the hex for the hero's army, figure out the code of the unknown creature, update the JSON file, restart the editor, reload the file).
See Standard game definitions for the architecture and boundaries. See Editing game definitions for file formats, version inheritance and adding a faction.
- Logs: the editor writes a daily log file,
siniskalc-<date>.log, to%LOCALAPPDATA%\Siniskalc\logs. Help > Show logs opens the folder. Settings... > Logging changes the folder and the level; choose Debug or Trace for more details. - Settings:
settings.jsonandserilog.json(logging configuration) are in%APPDATA%\Siniskalc. If the editor reports that one of them cannot be read at startup, it offers to back it up in the folder, with.badsuffix and write a fresh default. - Startup error naming a file in
GameData: the entity definitions are missing or invalid. Keep theGameDatafolders besideSiniskalc.exe, or restore the file named in the message. - The editor won't start at all: check that the .NET 8 Desktop Runtime (x64) is installed.
- My save won't load, or looks wrong: your save is not modified until you click Save, and a
.bakcopy is kept unless you've disabled backing up from settings. Create an issue on the repo, please attach the log file and, if you can, the savegame.
Players, map creators and tinkerers in general.
I am very fond of Heroes of Might and Magic III and II; III in particular is widely regarded as one of the greatest games of all time, and is still popular in its third decade, with fan-led groups still actively adding content.
I couldn't find an editor that supported all of the features I wanted, nor as a user, nor as a developer, so I wrote one.
Siniskalc offers features to make further development easier and to even allow edits beyond the scope of the tool, with an HEX view of the entire file and of modelled entities, and the ability to export and import the entire savegame as a binary file.
I would like to add support other games, and for Siniskalc to be easily extensible.
The editing model is layered: a save is split into chunks (heroes, players, castles, ...), each deserialised into an immutable model. Edits go through an edit session that records pending changes against the original bytes, and only those bytes are patched on save, so unknown parts of the file are left untouched.
See CLAUDE.md for the repo rules and docs/SINISKALC_ARCHITECTURE.md for how the view models, models and edit sessions fit together.
Requires the .NET 8 SDK on Windows.
dotnet build Siniskalc.sln
dotnet test Siniskalc.sln --artifacts-path .artifacts
For a comprehensive list of what's been built, check CHANGELOG.md, for how, check docs/SINISKALC_ARCHITECTURE.md, for what is known re: save formats etc. check docs/KNOWLEDGE_BASE.md. What is shared between the games and what is kept apart is in .claude/agents/game-reconciler.md.
If you need any feature, want to share feedback, report a bug, feel free to open an issue .
- Read list:
CLAUDE.mdhas the repo rules.docs/SINISKALC_ARCHITECTURE.mdshows how the projects, edit sessions, models and view models fit together. - Where to start:
docs/FUTURE_WORK.mdlists open work and the saves that would settle open questions. - Finding a new field in a savefile: see
docs/FUTURE_WORK.mdfor the saves that would settle open questions,docs/LOCATING_ENTITIES.mdfor how things are located, anddocs/KNOWLEDGE_BASE.mdfor what is already known. Record new findings there. - Test savegames: name and place them by
TestData/README.mdand add a row to the README of their folder. - Errors and logging: see
docs/ERROR_MODEL.mdanddocs/LOGGING.md(the logger, the levels,serilog.json). - Before opening a PR: run the whole suite (
dotnet test); if the editor is running and locks the build output, add--artifacts-path <another folder>. Note user-visible changes inCHANGELOG.md.
Write established facts in KNOWLEDGE_BASE.md.
- cysun/Heroes3Editor by Chengyu Sun, the original HoMM3 savegame editor in WPF, which inspired this project and showed how to unzip the savegame files. This project began as a fork to add additional fixes and features (initially hero movement, position, marker, level, spellpoints, combination artifacts and more), but has since been virtually entirely rewritten.
- shuvava/Heroes3Editor, a fork of the cysun project that added the Factory and Bulwark data.
- h3sed by Erki Suurjaak, a Python savegame editor (MIT). For the Hero locating regex, the offsets for combination artifacts, and anything to do with Heroes Chronicles.
- TacticDevGit for the sidebar navigation idea.
- SharpZipLib (MIT), of which a trimmed and patched copy is used for the GZip code.
- Editing heroes in memory on Heroes Community, and HoMM3: Hex editing issue on the GOG forum, for early savefile findings.
- HoMM3 Wiki for game information. The creature AI and Fight values come from its AI/Fight Value page, last fetched on 2026-10-09.
- Visual Studio Image Library (Visual Studio 2026 edition) for the menu and toolbar icons in
Siniskalc.Wpf/Resources/VS2026. These are © Microsoft and are not covered by this project's MIT license; they are used under the Microsoft Visual Studio Image Library license (see Third-party notices). And Exhumed for the original application icon. - Claude by Anthropic, for the hilarious app.icon and majority of the heavy lifting in the UI, parsing of towns/player data and writing tests.
Heroes of Might and Magic is a trademark of Ubisoft. This project is not affiliated with or endorsed by Ubisoft.
Released under the MIT License, with the exception of the Microsoft icons described below.
The icons in Siniskalc.Wpf/Resources/VS2026 come from the Microsoft Visual Studio 2026 Image Library and remain the property of Microsoft.
They are licensed under the Visual Studio Image Library EULA, not the MIT license.
They may only be used in applications developed with the Visual Studio family of products, and anyone redistributing this application, or the icons in it, must agree to terms that protect the images at least as much as that EULA.
If you fork this project, do not reuse the icons outside the terms of that license.