venus/OBJECTS.md
2025-03-18 17:08:43 -05:00

43 lines
1.3 KiB
Markdown

# Object format
Objects are stored for each mod. Each object consists of a custom binary diff-style format(where numbers are little-endian unless otherwise noted):
```
0x0B7D1FF0: Magic number
0x00000000: 32-bit version. By convention, unofficial object formats should have the left-most(commonly referred to as the 31st bit) set.
0x0000000000000007: 64-bit number of entries
0x000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000: Padding
0xCF83E1357EEFB8BDF1542850D66D8007D620E4050B5715DC83F4A921D36CE9CE47D0D13C5D85F2B0FF8318D2877EEC2F63B931BD47417A81A538327AF927DA3E: SHA512 hash of object with hash replaced with this hash(the SHA512 hash of an empty string)
(entries)
```
Each entry is in the format:
```
0x0000000000000007: 64-bit size of path in bytes
0x0000000000000008: Number of diffs
0x00: Type of change: 0=Removal of file(no diffs), 1=Modification or addition
(path as a UTF-8 encoded string using UNIX conventions such as a forward slash / as a separator)
(diffs)
```
Each diff is in the format:
```
0x00: Type of change: 0=Removal(no body), 1=Insertion, 2=Replacement
0x00000000000000: Padding
0x0000000000000000: Start of change (relative to original file)
0x0000000000000010: Length of change
(body)
```
Known versions:
|32-bit value|Name|
|-----|-----|
|0x00000000|Official venus version 0.1(this doc)|