A modern C# library for working with Relic Entertainment's .sga archive format. This project provides support for reading and writing SGA archives used in games built using the Essence engine.
open-compote is an open-source project aimed at providing mod tools developers and experienced modders with robust and easy to use tools for working with .sga archives. Whether you're developing mods, analysing game data, or building mod tools, this library offers a simple API for archive manipulation.
Note
Current Status: Very early-stage development. Only SGA V2 is implemented, If you want support for additional versions early, you can contribute with issues, feature requests, or pull requests. Community contributions are welcome. And if you really want something what you can actually use now see link in Acknowledgments.
| Version | Games | Status | Documentation |
|---|---|---|---|
| V2 | Impossible Creatures, Warhammer 40,000: Dawn of war |
 Supported |
SGA-V2.md |
| V3 | The Outfit |  Planned |
|
| V4 | Company of Heroes 1 | Planned |
SGA-V4.md |
| V5 | Warhammer 40,000: Dawn of War 2 | Planned |
SGA-V5.md |
| V6 | Can be created using Company of Heroes 2 archive.exe. | Planned |
|
| V7 | Company of Heroes 2 | Planned |
SGA-V7.md |
| V9 | Warhammer 40,000: Dawn of War 3 | Planned |
|
| V10 | Age of Empires 4, Company of Heroes 3 |
Planned |
- Type-safe API — Full C# integration with comprehensive type definitions
- Forward-looking — Comprehensive schema documentation for planned versions (V4, V5, V7)
- Well-documented — Detailed format specifications and examples
- Modular architecture — Clean separation between parsers and core functionality
For comprehensive documentation, API reference, and detailed schema specifications, visit our documentation page.
The project is organised as a .NET solution with the following components:
- OpenCompote.SGA — Core library for working with SGA Archives.
- OpenCompote.Cli — Currently only for testing. Command-line tools for simple manipulation with SGA archives.
- tests — Unit tests.
Some resources that were useful while researching and implementing this project.
- MAK Relic-Tool – Similar project to this, but made in Python and on top of SGAs it also supports UCS and Chunky files.
- dow_utils – Dawn of War modding tutorials, file extension overview, and tools.
Not affiliated with Relic Entertainment, Sega, or THQ Nordic. All rights belong to their respective parties.