Archive format from the late 1990s.
Overview ACE archives start with a main header (magic **ACE** at offset 7) followed by file headers with CRC-32. Compression uses LZ77, blocked and stored modes, with optional solid mode and multi-volume sets.
Where it is used Software and media distribution around 1998-2005. History Created by Marcel Lemke (e-merge GmbH) in 1998. Status today Legacy; a path-traversal flaw in the old UNACEV2 library led many tools to drop support in 2019. Structures read by the implementation Offsets are in bytes from the start of the buffer named in each heading. Field names are taken from the implementation and are not an official specification. Fixed-width integers are shown as u/i (unsigned/signed) followed by bit width and byte order.
AceArchiveModule.Mount buffer h.Body · AceArchiveModule.cs Offset Size Type Field Notes 0x3 8 u64 LE – 0x3 4 u32 LE –
FileHeader.ParseFile buffer b · AceArchiveModule.cs Offset Size Type Field Notes i 8 u64 LE Packed i 4 u32 LE Packed i 4 u32 LE Odified i + 4 4 u32 LE Size i + 4 4 u32 LE Attributes i + 8 8 u64 LE Size i + 12 1 u8 Ethod i + 18 2 u16 LE Name Length
FileHeader.ReadHeader buffer body · AceArchiveModule.cs Offset Size Type Field Notes 0x0 1 u8 – 0x1 2 u16 LE –
FileHeader.ReadHeader buffer head · AceArchiveModule.cs Offset Size Type Field Notes 0x0 2 u16 LE – 0x2 2 u16 LE Size
FileHeader.Carve buffer h.Body · AceCarver.cs Offset Size Type Field Notes 0x3 8 u64 LE Add Size 0x3 4 u32 LE Add Size
FileHeader.Carve buffer m · AceCarver.cs Offset Size Type Field Notes 0xB 1 u8 Creator Version 0xC 1 u8 Host Os 0xD 1 u8 Volume 0xE 4 u32 LE Archive Date at 2 u16 LE Comment Length
FileHeader.ParseFile buffer b · AceCarver.cs Offset Size Type Field Notes i 8 u64 LE Packed i 4 u32 LE Packed i 4 u32 LE Odified i + 4 4 u32 LE Size i + 4 4 u32 LE Attributes i + 8 8 u64 LE Size i + 8 4 u32 LE Crc i + 12 1 u8 Ethod i + 13 1 u8 Quality i + 18 2 u16 LE Name Length
struct.LooksLikeDamagedHeader buffer head · AceCarver.cs Offset Size Type Field Notes 0x2 2 u16 LE Size 0x4 1 u8 – 0x5 2 u16 LE Flags
struct.ReadHeader buffer body · AceCarver.cs Offset Size Type Field Notes 0x0 1 u8 – 0x1 2 u16 LE –
struct.ReadHeader buffer head · AceCarver.cs Offset Size Type Field Notes 0x0 2 u16 LE – 0x2 2 u16 LE Size
ChunkEnd.TranslateExe buffer buffer · AceDecoder.cs Offset Size Type Field Notes i + 1 4 u32 LE Rel32 i + 1 2 u16 LE Rel16
Constants General AceCarver Name Value Type Notes TypeMain 0, TypeFile32 = 1, TypeRecovery32 = 2, TypeFile64 = 3, TypeRecovery64A = 4, TypeRecover… int FlagAddSize 0x0001, FlagComment = 0x0002, Flag64Bit = 0x0004 int MainFlagSfx 0x0200, MainFlagMultiVolume = 0x0800, MainFlagAdvert = 0x1000, MainFlagRecovery = 0x200… int FileFlagNtSecurity 0x0400, FileFlagContinuedFromPrevious = 0x1000, FileFlagContinuesInNext = 0x2000, FileF… int FlagSolid 0x8000 int AttributeDirectory 0x10 int
General struct Name Value Type Notes Lz77 0, Lz77Delta = 1, Lz77Exe = 2, Sound8 = 3, Sound16 = 4, Sound32A = 5, Sound32B = 6, Pic… int
General AceHuffman Name Value Type Notes WidthWidthBits 3 int
General AceLz77 Name Value Type Notes TypeCode 260 + MaxDictionaryBits + 1 int NumMainCodes 260 + MaxDictionaryBits + 2 int NumLengthCodes 256 – 1 int DictionarySize 1 << MaxDictionaryBits int DictionaryMask DictionarySize – 1 int
General AceSound Name Value Type Notes RunLengthCodes 32 int TypeCode 256 + RunLengthCodes int NumCodes 256 + RunLengthCodes + 1 int ChannelCounts [1, 2, 3, 3] int[] UseChannels [[0, 0, 0, 0], [0, 1, 0, 1], [0, 1, 0, 2], [1, 0, 2, 0]] int[][] Quantizer BuildQuantizer() int[]
General AcePicture Name Value Type Notes Contexts 365 int DifBitWidth BuildDifBitWidth() int[] Quantizer BuildQuantizer(1) int[] Quantizer9 BuildQuantizer(9) int[] Quantizer81 BuildQuantizer(81) int[]
General AceDecoder Name Value Type Notes Piece 64 * 1024 int
General AceArchiveModule Name Value Type Notes TypeMain 0, TypeFile32 = 1, TypeFile64 = 3 int FlagAddSize 0x0001, FlagComment = 0x0002, Flag64Bit = 0x0004 int FileFlagContinuedFromPrevious 0x1000, FileFlagContinuesInNext = 0x2000, FileFlagPassword = 0x4000 int FlagSolid 0x8000 int AttributeDirectory 0x10 int
Implementation limits reader Class Name Value Notes AceCarver MaxEntries 100_000 AceCarver MaxCheckedOutput 1L << 30 AceBits MaxOverrunWords 2 AceHuffman MaxWidthWidth (1 << WidthWidthBits) – 1 AceLz77 MaxCodeWidth 11 AceLz77 MaxDictionaryBits 22 AceLz77 MaxDistanceAtLength2 255 AceLz77 MaxDistanceAtLength3 8191 AceSound MaxCodeWidth 10 AceArchiveModule MaxEntries 100_000 AceArchiveModule MaxSolidOutput 2L << 30 eager in-memory decode budget for a solid archive
ChunkEnd enum Name Value Piece (next) ModeSwitch (next) FileEnd (next)
Signatures and magic strings referenced Text Where Context **ACE** struct.IsMainHeader && h.Body.AsSpan(3, 7).SequenceEqual(“**ACE**”u8); **ACE** AceArchiveModule new Signature(7, “**ACE**”u8.ToArray(), Confidence.High, “ACE”), **ACE** FileHeader.IsMainHeader && h.Body.AsSpan(3, 7).SequenceEqual(“**ACE**”u8);
Structures and constants were extracted from: Carving/Plugins/Ace/AceCarver.cs, Carving/Plugins/Ace/AceDecoder.cs, Modules/FileSystems/AceArchiveModule.cs. Prose sections are a summary from public sources; verify details before relying on them.