characterobject.dbss

Binary layout, byte coverage, field semantics, and validation evidence for the intrinsic BSD characterobject decoder.

Investigation status

Status	Value
Coverage	100%
Iteration	4
Review state	BSD migration reconciled
Last reviewed	2026-07-30
Captures examined	8,155,260-byte installed capture; 5,118 rows; normalized SHA-256 `804ba9018b1fc4adb5b0c1c1f11621fef76fe81177e2102f416421ff14b55533`
Decoder	`packages/scraper/src/tables/characterobject.dbss.ts`
Remaining blockers	None

See Decoder methodology for the confidence scale and evidence rules.

characterobjectoffset.dbss

Open the independently decoded pointer directory used as migration and row-boundary falsification evidence.

Field ledger

Field/path	Offset and width	Representation	Claimed meaning	Physical confidence	Representation confidence	Semantic confidence	Evidence	Status
`rows`	table header count plus variable rows	array retained in physical order; count omitted	object rows	Certain	Certain	Certain	The intrinsic union consumes all 5,118 rows to exact EOF and matches the transformed physical-order snapshot	Closed
`objectKey`, `typeCode`, derived kind/flags, `layoutFlag`	row prefix, three `u16`	physical words retained; `typeCode` also split without consuming it twice	identity and layout selection	Certain	Certain	High for selection; Unknown for all high-bit meanings	Every captured kind follows one intrinsic union branch	Closed
all counted asset/string envelopes	`u32` byte/code-unit length, zero `u32` flag, payload	lengths and flags consumed; strings retained	primary, secondary, configuration, action, icon, material, description, and screenshot strings	Certain	Certain	High for named string roles	Every envelope advances the sequential cursor exactly	Closed
`body` union	after `primaryAssetPath`	type-2, compact, and type-0 branches composed with BSD `union`	conditional object body	Certain	Certain	High	All captured rows select a branch without consulting the offset directory	Closed
type-2 fixed block	556 bytes	named projections retained; padding consumed declaratively	furniture/cultivation properties	Certain	Certain	High for named projections	Fixed-length validation plus complete snapshot equality	Closed
type-2 strings/trailer	variable strings plus 48 bytes	strings and repair item retained; constants and reserved bytes omitted	interaction, icon, and repair item	Certain	Certain	High	Intrinsic lengths, fixed trailer width, and terminal sentinel	Closed
compact body before suffix	counted secondary asset, 350-byte block, 16 reserved, version token	fixed-property bytes and assets retained; reserved bytes omitted	compact structure family	Certain	Certain	High for family/assets; Unknown inside raw block	Exact grammar for all captured compact rows	Closed
type-0 geometry header	after two counted strings	version byte and physical counts retained	collision layout controls	Certain	Certain	High	All 935 rows obey the version and count grammar	Closed
type-0 collision geometry	count-derived	triangle counts retained; 140-byte triangle records consumed as padding	collision mesh organization	Certain	Certain	High	Nested counts advance to the next intrinsic field in every type-0 row	Closed
type-0 common-property span	333 bytes after collision geometry	consumed and omitted	neutral common object-property block	Certain	Certain	Unknown	Fixed width and following counted material path establish both boundaries	Closed neutral
`materialPreviewPath`	counted ASCII after common properties	string retained; following 16-byte span consumed	material preview asset	Certain	Certain	High	Exact reference-output equality and intrinsic next-field boundary	Closed
`propertiesAndAssets` union	after material preview	common-suffix and numeric-housing branches composed with BSD `union`	post-geometry profile	Certain	Certain	High	`"10"` selects the common suffix; every other captured row consumes the numeric-housing layout exactly	Closed
common-suffix `versionToken`	counted ASCII	exact token `"10"` retained	physical format token	Certain	Certain	High for format selection	Token validation makes the branch reject non-common-suffix rows	Closed
common suffix reserved/sentinel spans	within the fixed 234-byte suffix	consumed and omitted	framing and reserved capacity	Certain	Certain	Neutral	Exact fixed-length consumption and sentinel validation	Closed
common suffix `transformMatrixA`, `transformMatrixB`	suffix `+16..+143`, 32 `f32`	matrices retained	ordinal serializer transform slots	Certain	Certain	High for transform representation; Neutral for individual roles	Exact reference equality across compact, type-0, and named-structure rows	Closed
common suffix `usesHousingGeometryProfile`	suffix `+148`, strict Boolean	Boolean retained	housing-geometry versus compact profile	Certain	Certain	High	Always false on compact bodies and true on type-0/named housing	Closed
common suffix `armorMaterialCode`	suffix `+149`, `u8` in `{4,6,7}`	code retained	historical `ArmorMaterial`	Certain	Certain	High	Exact reference equality and archived `Object_Table.ArmorMaterial` name	Closed
common suffix neutral controls	suffix `+150`, `+151`, `+210`, and `+218`	consumed and intentionally omitted	unknown variant/tuning controls	Certain	Certain	Unknown	Physical positions are stable; private enum and arithmetic roles remain unproved	Closed neutral
numeric-housing descriptions	one counted ASCII and two counted UTF-16LE strings	strings retained in source order	historical `Desc_Area`, `Desc_Feature1`, and `Desc_Feature2`	Certain	Certain	High	Archived column matches across 774 overlapping keys	Closed
numeric-housing base	next 162 bytes	consumed and omitted	neutral base-object state	Certain	Certain	Unknown	Fixed width plus the following counted screenshot slots establish the boundary	Closed neutral
numeric-housing `screenshotPaths[0..3]`	four counted ASCII slots	empty or `.dds` paths retained	historical `HouseScreenShotPath_1..4`	Certain	Certain	High	All 774 overlapping archived rows match all four slots exactly	Closed
numeric-housing trailer	final 24 bytes	consumed and omitted	neutral row-local trailer	Certain	Certain	Unknown	Fixed width closes every numeric-housing branch at the next physical row	Closed neutral

Active assumptions

Findings

ID	Finding	Evidence	Schema/documentation impact	Status
F-01	Offset-sorted legacy JSON can be restored to physical order without making offsets a production dependency.	Reference rows and offset entries have matching identities; sorting by recorded byte offset reconstructs all 5,118 physical rows.	The transformed snapshot is the oracle, while production reads only `characterobject.dbss`.	Closed
F-02	Type-2 output needs only the established projections, not an overlapping raw copy.	The BSD fixed-length branch consumes all 556 bytes and the transformed snapshot intentionally removes the diagnostic raw field.	Padding is consumed declaratively and the destination output stays compact.	Closed
F-03	Every housing/type-0 body has an intrinsic counted geometry prefix.	All 935 installed rows consume 1–4 layers, 1–17 meshes, and 4–36 triangles per mesh without overrun.	Counted BSD arrays replace companion-bounded geometry parsing.	Closed
F-04	The post-geometry region has exactly two sequential variants after a shared 333-byte property block, material asset, and 16-byte span.	One intrinsic union consumes all 935 rows exactly: 75 common-suffix rows and 860 numeric-housing rows, with no leftovers.	The new decoder uses a BSD union and no schema-returning type-code switch.	Closed
F-05	The 234-byte common suffix is shared by compact, type-0, and named housing structures.	Every retained field matches the reference decoder; the profile Boolean separates compact from geometry bodies.	One fixed-length BSD schema is reused across both body families.	Closed
F-06	Archived housing text and screenshot columns corroborate the numeric branch without becoming a runtime dependency.	Across 774 overlapping keys, area and all screenshot slots match exactly; feature text mostly matches and shows expected localization evolution.	The semantic names remain while unrelated controls use neutral omitted representations.	Closed