Burnout Wiki

AttribSys Vault: Difference between revisions

Page Discussion

AttribSys Vault (view source)

Revision as of 06:31, 22 March 2024

831 bytes added ,  1 month ago
Added breakdown and replaced Node with AttribEntry.
VisualWikitext
m (Even more rewording)
(Added breakdown and replaced Node with AttribEntry.)
 
(12 intermediate revisions by the same user not shown)
Line 1:
{{ParadiseResourceTypeInfobox
| name = AttribSysVault
| resourcenames = BurnoutGlobalData<br />CameraVault<br />Engine name, e.g. C5_EN<br />postfxvault<br />surfacelist<br />*_AttribSys<br /><sup><small>*Vehicle ID, e.g. PUSMC01</small></sup><br />WorldVault
| id = 0x1C
| category = Generic
| memdist = Main Memory only
| editor = Vehicles only<br />Use [https://github.com/burninrubber0/Bundle-Manager/releases/latest Bundle Manager]
|}}▼
 
AttribSys vault resources act as a database which holds attributes for vehicles, engines, surfaces and more. They are split into the vault, which holds information needed to access the data, and the bin, which holds the actual attribute data. Vaults work with the [[AttribSys schema]] found in the executable.
 
Line 5 ⟶ 14:
==== 32-bit ====
{| class="wikitable"
|-▼
! Offset !! Length !! Type !! Name !! Description !! Comments
|-
Line 19 ⟶ 27:
==== 64-bit ====
{| class="wikitable"
|-▼
! Offset !! Length !! Type !! Name !! Description !! Comments
|-
Line 26 ⟶ 33:
| 0x8 || 0x4 || uint32_t || muVltSizeInBytes || ||
|-
| 0xC || 0x4 || || || paddingPadding ||
|-
| 0x10 || 0x8 || uint8_t* || mpau8BinData || ||
|-
| 0x18 || 0x4 || uint32_t || muBinSizeInBytes || ||
|}
 
== Common substructures ==
=== Attrib::Node::anon_union_0Array ===▼
{| class="wikitable"▼
! Offset !! Length !! Type !! Name !! Description !! Comments▼
▲|-
| 0x0 || 0x2 || uint16_t || mAlloc || Number of entries allocated ||
▲|-
| 0x2 || 0x2 || uint16_t || mCount || Number of entries used ||
|-▼
| 0x4 || 0x2 || uint16_t || mSize || The length of each entry ||
|-▼
| 0x6 || 0x2 || uint16_t || mEncodedTypePad || Padding ||
|-}▼
 
=== Attrib::RefSpec ===
{| class="wikitable"
! Offset !! Length !! Type !! Name !! Description !! Comments
|-▼
| 0x0 || 0x8 || [[Attribute hash|Key]] || mClassKey || ||
|-▼
| 0x8 || 0x8 || [[Attribute hash|Key]] || mCollectionKey || ||
|-▼
| 0x10 || 0x4 || Collection* || mCollectionPtr || || Always nullptr in resource
|-▼
| 0x14 || 0x4 || void* || mPtr || Padding || ▼
|}
 
= Vault =
[[File:PUSMC01 AttribSys Breakdown.svg|thumb|A breakdown diagram of the Cavalry's vault.]]
The vault is a set of structures with [[#Attrib::Vault::ChunkBlock | ChunkBlocks]] which are read sequentially. In Burnout Paradise, these are:▼
 
▲The vault is a set of structures with [[#Attrib::Vault::ChunkBlock | ChunkBlocks]] which are read sequentially. In Burnout Paradise, these are:
* '''Vers''': The version
* '''DepN''': The dependency node
Line 44 ⟶ 80:
=== Attrib::Vault::ChunkBlock ===
{| class="wikitable"
▲|-
! Offset !! Length !! Type !! Name !! Description !! Comments
|-
Line 55 ⟶ 90:
=== Attrib::Vault::VersionNode ===
{| class="wikitable"
▲|-
! Offset !! Length !! Type !! Name !! Description !! Comments
|-
| 0x0 || 0x8 || [[#Attrib::Vault::ChunkBlock | ChunkBlock]] || super_ChunkBlock || Base class ||
|-
| 0x8 || 0x8 || uint64_t || mVersion || Version hash ||
Line 66 ⟶ 100:
=== Attrib::Vault::DependencyNode ===
{| class="wikitable"
▲|-
! Offset !! Length !! Type !! Name !! Description !! Comments
|-
| 0x0 || 0x8 || [[#Attrib::Vault::ChunkBlock | ChunkBlock]] || super_ChunkBlock || Base class ||
|-
| 0x8 || 0x8 || [[Attribute hash | HashInt]] || mCount || Number of dependencies ||
|}
 
This structure is immediately followed by the [[Attribute hash | hashes]] of the dependency strings, then the offsets of the strings relative to the start of the first string, then the strings themselves.
 
== Start node ==
{| class="wikitable"
▲|-
! Offset !! Length !! Type !! Name !! Description !! Comments
|-
| 0x0 || 0x8 || [[#Attrib::Vault::ChunkBlock | ChunkBlock]] || super_ChunkBlock || Base class ||
|-
| ??? || || || || ||
Line 90 ⟶ 122:
== Data node ==
{| class="wikitable"
▲|-
! Offset !! Length !! Type !! Name !! Description !! Comments
|-
| 0x0 || 0x8 || [[#Attrib::Vault::ChunkBlock | ChunkBlock]] || super_ChunkBlock || Base class ||
|}
 
This is followed by several [[#Attrib::CollectionLoadData | collections]].
 
This node is not read directly. Pointers in other nodes read the data that lies in this node.
Line 102 ⟶ 133:
=== Attrib::CollectionLoadData ===
{| class="wikitable"
▲|-
! Offset !! Length !! Type !! Name !! Description !! Comments
|-
| 0x0 || 0x8 || [[Attribute hash | Key]] || mKey || ||
|-
| 0x8 || 0x8 || [[Attribute hash | Key]] || mClass || ||
|-
| 0x10 || 0x8 || [[Attribute hash | Key]] || mParent || ||
|-
| 0x18 || 0x4 || uint32_t || mTableReserve || Amount allocated for entries ||
Line 123 ⟶ 153:
| 0x28 || 0x4 || void* || mLayout || || Always nullptr in resource
|-
| 0x2C || 0x4 || || || paddingPadding ||
|}
 
This is always followed by the types, then the entries (which are [[#Attrib::Node CollectionLoadData::AttribEntry| nodesentries]]).
 
=== Attrib::NodeCollectionLoadData::AttribEntry ===
{| class="wikitable"
▲|-
! Offset !! Length !! Type !! Name !! Description !! Comments
|-
| 0x0 || 0x8 || [[Attribute hash | Key]] || mKey || ||
|-
| 0x8 || 0x4 || [[#Attrib::Node::anon_union_0 | anon_union_0]]void* || field_1mData || || Just a pointer
|-
| 0xC || 0x2 || uint16_t || mTypeIndexmType || ||
|-
| 0xE || 0x1 || uint8_t || mMaxmNodeFlags || ||
|-
| 0xF || 0x1 || uint8_t || mFlagsmEntryFlags || ||
▲|}
 
▲=== Attrib::Node::anon_union_0 ===
▲{| class="wikitable"
▲|-
▲! Length !! Type !! Name !! Description !! Comments
|-
▲| 0x4 || void* || mPtr || ||
|-
| 0x4 || Array* || mArray || ||
|-
| 0x4 || uintptr_t || mValue || ||
|-
| 0x4|| uintptr_t || mOffset || ||
|}
 
Line 161 ⟶ 176:
=== Attrib::Vault::ExportNode ===
{| class="wikitable"
|-
! Offset !! Length !! Type !! Name !! Description !! Comments
|-
| 0x0 || 0x8 || [[#Attrib::Vault::ChunkBlock | ChunkBlock]] || super_ChunkBlock || Base class ||
|-
| 0x8 || 0x8 || [[Attribute hash | HashInt]] || mCount || Number of dependenciesexports ||
|}
 
Followed by [[#Attrib::Vault::ExportEntry | export entries]] of an amount defined by <code>mCount</code>.
 
=== Attrib::Vault::ExportEntry ===
{| class="wikitable"
|-
! Offset !! Length !! Type !! Name !! Description !! Comments
|-
| 0x0 || 0x8 || [[Attribute hash | ExportID]] || mID || ||
|-
| 0x8 || 0x8 || [[Attribute hash | TypeID]] || mType || ||
|-
| 0x10 || 0x4 || uint32_t || mDataBytes || Size of the data node entry ||
Line 188 ⟶ 201:
=== Attrib::Vault::PointerNode ===
{| class="wikitable"
|-
! Offset !! Length !! Type !! Name !! Description !! Comments
|-
| 0x0 || 0x8 || [[#Attrib::Vault::ChunkBlock | ChunkBlock]] || super_ChunkBlock || Base class ||
|}
 
Followed by several [[#Attrib::PtrRef | PtrRefs]].
 
=== Attrib::PtrRef ===
{| class="wikitable"
|-
! Offset !! Length !! Type !! Name !! Description !! Comments
|-
Line 207 ⟶ 218:
| 0x6 || 0x2 || uint16_t || mIndex || Which dependency the value is relative to || 0 is normally the vault<br />1 is normally the bin
|-
| 0x8 || 0x8 || [[#Attrib::PtrRef::anon_union_0 | anon_union_0]] || field_3 || Value ||
|}
 
=== Attrib::PtrRef::anon_union_0 ===
{| class="wikitable"
|-
! Length !! Type !! Name !! Description !! Comments
|-
| 0x8 || [[Attribute hash | ExportID]] || mExportID || ||
|-
| 0x8 || [[Attribute hash | HashInt]] || mOffset || ||
|}
 
=== EPtrRefType ===
Information from Need for Speed ProStreet (RU PS2).
Information from [https://github.com/NFSTools/VaultLib/blob/master/VaultLib.Core/DataInterfaces/IPtrRef.cs VaultLib].
 
{| class="wikitable"
Line 243 ⟶ 253:
The rest of the data in the bin is not associated to a chunk and is instead pointed to by the vault.
 
=== String exports ===
{| class="wikitable"
|-
! Offset !! Length !! Type !! Name !! Description !! Comments
|-
| 0x0 || 0x8 || [[#Attrib::Vault::ChunkBlock | ChunkBlock]] || super_ChunkBlock || Base class ||
|}
 
Retrieved from "https://burnout.wiki/wiki/Special:MobileDiff/9202...9667"