BCSV

From Deep Sea Knowledge
Revision as of 13:54, 29 March 2020 by RedDucks (talk | contribs) (Clarification on field data)
Jump to navigation Jump to search

BCSV, known as Binary CSV, stores information relating to general content in a compact CSV format

General

All information in this document is from Animal Crossing: New Horizons

BCSV files contain a header which defines the number of entries, the size of each entry block, and the fields each entry has, followed by a number of entries with context-specific data

Header

The header contains

Offset Size Description
0x00 0x4 Entry count
0x04 0x4 Entry size
0x08 0x2 Field count
0x0A 0x2 Always 0x0101
0x0C 0x4 VSCB Magic
0x10 0x2 Always 0x1027
0x12 0xA Padding
0x1C 0x8*Field count Fields

Fields

The fields are defined in the header as 2 sections; a data identifier and the relative offset in each entry

Offset Size Description
0x00 0x4 Data identifier
0x04 0x4 Offset

The data identifier determines what type of data the offset is pointing to. The meaning behind each identifier seems to rely on the context of the files content, generally, with only a small number of identifiers being reused in multiple files. In AC:NH there is a total 2048 unique identifiers, with only 191 being reused in multiple files. For a list of all identifiers in AC:NH and the files they are used in, see here https://pastebin.com/KnbnD1r8

Entries

Entries always begin with their offset relative to the file start, and then contain the blocks data. Nearly every file seems to contain a field with type `0x54607054`, which is always a unique int16 for each entry, though the location of this field is not always the same

Offset Size Description
0x00 0x4 Offset relative to file start
0x04 Entry data