Burnout Wiki

Vehicle List/Burnout Paradise: Difference between revisions

Page Discussion

Vehicle List/Burnout Paradise (view source)

Revision as of 04:41, 15 March 2024

4,321 bytes added ,  2 months ago
m
Update flags again
VisualWikitext
(Add reference to Bundle Manager)
m (Update flags again)
 
(22 intermediate revisions by 3 users not shown)
Line 1:
{{ParadiseResourceTypeInfobox
The VehicleList contains the all the relevant information for vehicles in Burnout Paradise. The information is stored in \VEHICLES\VEHICLELIST.BUNDLE and can be edited with [https://github.com/burninrubber0/Bundle-Manager/releases Bundle Manager]
| name = VehicleList
| example = [[File:Paradise VehicleList Example.png|frameless|300px]]<br />A VehicleList shown in Bundle Manager.
| resourcenames = B5VehicleList
| id = 0x10005
| category = Game-specific<br />(Burnout Paradise)
| memdist = Main Memory only
| editor = Yes<br />Use [https://github.com/burninrubber0/Bundle-Manager/releases/latest Bundle Manager]
}}
 
{{subpage|Previous versions|text=Description of the Vehicle List changes since the first version of the game.}}
{{subpage|Development|text=Description of the Vehicle List changes during development of the game.}}
 
The Vehicle List resource contains most high-level information on vehicles in ''[[Burnout Paradise]]'', such as their ID, junkyard stats, sound IDs and more. It is stored in VEHICLES/VEHICLELIST.BUNDLE.
== Version 1.0 ==
 
= Junkyard stats =
=== VehicleListResource ===
All junkyard stats are controlled via the Vehicle List's GUI stat fields.
 
=== Speed/boost ===
Speed stats are based on vehicles' top speeds when not boosting; similarly, boost stats are based on the top speeds while using boost. Both use the same system for calculating stats. While the numbers are liable to vary, they are generally accurate to Paradise Cars.
 
{| class="wikitable"
! Stat !! Top speed
! Offset !! Size !! Type !! Name !! Description !! More Information !! Comments
|-
| 1 || <121 mph<br/>(<195 km/h)
|-
| 2 || 121-132 mph<br/>(195-212 km/h)
|-
| 3 || 133-144 mph<br/>(214-232 km/h)
|-
| 4 || 145-155 mph<br/>(233-249 km/h)
|-
| 5 || 156-167 mph<br/>(251-269 km/h)
|-
| 6 || 168-178 mph<br/>(270-286 km/h)
|-
| 7 || 179-187 mph<br/>(288-301 km/h)
|-
| 8 || 188-194 mph<br/>(303-312 km/h)
| 0x0 || 0x4 || uint32_t || muNumVehicles || No. vehicles || ||
|-
| 9 || 195-198 mph<br/>(314-319 km/h)
| 0x4 || 0x4 || VehicleListEntry * || mpEntries || Vehicles offset || VehicleListEntry format ||
|-
| 10 || >198 mph<br/>(>319 km/h)
| 0x8 || 0x8 || uint64_t || mu16BytePad || padding || ||
|}
 
=== VehicleListEntryStrength ===
Unlike the Speed and Boost stats, the Strength stat is not based on any vehicle attribute(s). Instead, it is used as the determining value for how many times a vehicle has to wreck to lose a Marked Man or Road Rage event. It has no bearing on the actual strength of the vehicle in crashes or takedowns and appears to have been chosen arbitrarily by Criterion.
 
{| class="wikitable"
! Stat !! Crashes to lose event
! Offset !! Size !! Type !! Name !! Description !! More Information !! Comments
|-
| 1 || 2 crashes
| 0x0 || 0x8 || CgsID || mId || Vehicle ID || Decodes to CarID e.g. XASBSCB1 || Use encdec.rb or BurnoutHasher to decode
|-
| 2 || 2 crashes
| 0x8 || 0x8 || CgsID || mParentId || Parent vehicle ID || Decodes to CarID e.g. PASBSC01 || Use encdec.rb or BurnoutHasher to decode
|-
| 3 || 3 crashes
| 0x10 || 0x20 || char[32] || mDefaultWheelName || Wheel name || ||
|-
| 4 || 4 crashes
| 0x30 || 0x40 || char[64] || macVehicleName || Vehicle name || ||
|-
| 5 || 4 crashes
| 0x70 || 0x20 || char[32] || macManufacturerName || Manufacturer name || ||
|-
| 6 || 4 crashes
| 0x90 || 0xC || VehicleListEntryGamePlayData || mGamePlayData || || GamePlayData Format ||
|-
| 7 || 4 crashes
| 0x9C || 0x4 || || || padding || ||
|-
| 8 || 5 crashes
| 0xA0 || 0x8 || AttribSysCollectionKey || mAttribCollectionKey || burnoutcarasset ID || burnoutcarasset collection name || lookup8 encoded in AttribSys
|-
| 9 || 5 crashes
| 0xA8 || 0x40 || VehicleListEntryAudioData || mAudioData || || AudioData Format ||
|-
| 10 || 5 crashes
| 0xE8 || 0x1 || uint8_t || muCarType || Boost Type || 0 = Speed ||
|}
 
= Structures =
=== BrnResource::VehicleListResource ===
==== 32-bit ====
{| class="wikitable"
! Offset !! Length !! Type !! Name !! Description !! Comments
|-
| 0x0 || 0x4 || uint32_t || muNumVehicles || Number || 1 =of Aggressionvehicles ||
|-
| 0x4 || 0x4 || |[[#BrnResource::VehicleListEntry| VehicleListEntry]]* || mpEntries || 2 = StuntVehicles ||
|-
| 0x8 || 0x8 || uint64_t || mu16BytePad || Padding ||
| 0xE9 || 0x1 || uint8_t || muLiveryType || Finish Type || 00 = Primary finish (primary vehicle) || E_LIVERY_DEFAULT in ELiveryType
|}
 
==== 64-bit ====
{| class="wikitable"
! Offset !! Length !! Type !! Name !! Description !! Comments
|-
| 0x0 || 0x8 || [[#BrnResource::VehicleListEntry|VehicleListEntry]]* || mpEntries || Vehicles ||
| || || || || || 01 = Secondary finish || E_LIVERY_COLOUR in ELiveryType
|-
| 0x8 || 0x4 || uint32_t || muNumVehicles || Number of vehicles ||
| || || || || || 02 = Primary finish (Burning Route vehicle) || E_LIVERY_PATTERN in ELiveryType
|-
| 0xC || 0x4 || uint32_t || mu16BytePad || Padding || 03 = Platinum finish || E_LIVERY_SILVER in ELiveryType
|}
 
=== BrnResource::VehicleListEntry ===
{| class="wikitable"
! Offset !! Length !! Type !! Name !! Description !! Comments
|-
| 0x0 || 0x8 || [[CgsID]] || mId || Vehicle ID || 04Decodes =to Gold finish ||car E_LIVERY_GOLDID, ine.g., ELiveryTypeXASBSCB1
|-
| 0xEA0x8 || 0x10x8 || uint8_t [[CgsID]]|| muTopSpeedNormalmParentId || MaxParent Speedvehicle ID || ControlledDecodes by AttribSys ||to Defaultcar range:ID, 137-180e.g., (dec)PASBSC01
|-
| 0x10 || 0x20 || char[32] || mDefaultWheelName || Wheel name ||
| 0xEB || 0x1 || uint8_t || muTopSpeedBoost || Max Boost Speed || Controlled by AttribSys || Default range: 160-200 (dec)
|-
| 0xEC0x30 || 0x10x40 || uint8_tchar[64] || muTopSpeedNormalGUIStatmacVehicleName || SpeedVehicle Rating || Speed Stat Tablename ||
|-
| 0xED0x70 || 0x10x20 || uint8_tchar[32] || muTopSpeedBoostGUIStatmacManufacturerName || BoostManufacturer Rating || Speed Stat Tablename ||
|-
| 0x90 || 0xC || [[#BrnResource::VehicleListEntryGamePlayData|VehicleListEntryGamePlayData]] || mGamePlayData || ||
| 0xEE || 0x1 || uint8_t || muColourIndex || Default Color || Type 00/01/02 range: 00-18 || Info is for colors listed in PlayerCarColours file
|-
| 0x9C || 0x4 || || || || Type 03 range: 00-01Padding ||
|-
| 0xA0 || 0x8 || [[#CgsAttribSys::AttribSysCollectionKey|AttribSysCollectionKey]] || mAttribCollectionKey || burnoutcarasset collection name (gamedb ID) || lookup8 encoded in vehicle AttribSys
| 0xEF || 0x1 || uint8_t || muPaletteIndex || Default Color Type || 00 = Gloss || Info is for types listed in PlayerCarColours file
|-
| 0xA8 || 0x40 || [[#BrnResource::VehicleListEntryAudioData|VehicleListEntryAudioData]] || mAudioData || ||
| || || || || || 01 = Metallic ||
|-
| 0xE8 || 0x10 || ? || ? || Plane-related? || 02 = Pearlescent ||Always null
|-
| 0xF8 || 0x4 || uint32_t || ? || Junkyard category || By default, only WIP secondary finishes have no category. Primary finishes with no category disappear from the Junkyard. See [[#Category|category]]
| || || || || || 03 = Gold/Platinum ||
|-
| 0xFC || 0x1 || uint8_t || muCarType || Vehicle and boost type || High nibble is vehicle type, low nibble is boost type. Switchable boost is set by the vehicle flags but will default to the type selected here. See [[#Vehicle type|vehicle type]] and [[#BrnResource::ECarType|ECarType]]
|-
| 0xFD || 0x1 || uint8_t || muLiveryType || Finish type || See [[#BrnResource::VehicleListEntry::ELiveryType|ELiveryType]]
|-
| 0xFE || 0x1 || uint8_t || muTopSpeedNormal || MaxSpeed from AttribSys ||
|-
| 0xFF || 0x1 || uint8_t || muTopSpeedBoost || MaxBoostSpeed from AttribSys ||
|-
| 0x100 || 0x1 || uint8_t || muTopSpeedNormalGUIStat || Junkyard speed stat ||
|-
| 0x101 || 0x1 || uint8_t || muTopSpeedBoostGUIStat || Junkyard boost stat ||
|-
| 0x102 || 0x1 || uint8_t || muColourIndex || Default color index ||
|-
| 0x103 || 0x1 || uint8_t || muPaletteIndex || Default color type index ||
|-
| 0x104 || 0x4 || || || Padding ||
|}
 
=== BrnResource::VehicleListEntryGamePlayData ===
=== GamePlayData ===
{| class="wikitable"
! Offset !! Length !! Type !! Name !! Description !! Comments
|-
| 0x0 || 0x4 || float32_t || mfDamageLimit || Damage limit || Always 1
|-
| 0x4 || 0x4 || uint32_t || mxFlags || Vehicle flags || See [[#BrnResource::VehicleListEntryGamePlayData::EFlags|flags]]
|-
| 0x8 || 0x1 || uint8_t || Length || Boost bar length ||
|-
| 0x9 || 0x1 || uint8_t || ? || Rank required for unlock || See [[#Rank|rank]]
|-
| 0xA || 0x1 || uint8_t || Capacity || Boost capacity || The default (0) matches 5
|-
| 0xB || 0x1 || uint8_t || ? || Junkyard strength stat ||
|}
 
=== BrnResource::VehicleListEntryAudioData ===
{| class="wikitable"
! Offset !! SizeLength !! Type !! Name !! Description !! More Information !! Comments
|-
| 0x0 || 0x40x8 || float32_t[[CgsID]] || mfDamageLimitmExhaustName || DamageExhaust LimitCgsID || AlwaysDecodes 1to ||engine ID, e.g., DRAG_EX
|-
| 0x8 || 0x8 || [[#CgsAttribSys::AttribSysCollectionKey|AttribSysCollectionKey]] || mExhaustEntityKey || Exhaust ID || Exhaust vehicleengine collection name (gamedb ID). lookup8 encoded in AttribSys. Used under SoundExhaustAsset and ExhaustEntityKey
| 0x4 || 0x4 || uint32_t || mxFlags || 0x00000001 (Bit 0) = IsRaceVehicle || Selectability ||
|-
| 0x10 || 0x8 || [[#CgsAttribSys::AttribSysCollectionKey|AttribSysCollectionKey]] || mEngineEntityKey || Engine ID || Engine vehicleengine collection name (gamedb ID). lookup8 encoded in AttribSys. Used under SoundEngineAsset and EngineEntityKey
| || || || || 0x00000002 (Bit 1) = IsTrafficVehicle? || Always 0 ||
|-
| 0x18 || 0x8 || [[CgsID]]|| mEngineName || 0x00000004Engine (BitCgsID 2)|| =Decodes CanCheckTraffic?to ||engine AlwaysID, 0 ||e.g., DRAG_ENG
|-
| 0x20 || 0x4 || Name || mRivalUnlockName || 0x00000008Class (Bitunlock 3) = CanBeChecked?stream || AlwaysSee 0[[#Class unlock stream||class unlock stream]]
|-
| 0x24 || 0x4 || || || 0x00000010 (Bit 4) = IsTrailer || Padding ||
|-
| 0x28 || 0x8 || [[#CgsAttribSys::AttribSysCollectionKey|AttribSysCollectionKey]] || mWonCarVoiceOverKey || Car shutdown streams || languagestreamconfiguration collection name in BURNOUTGLOBALDATA. Contains 8 CgsSoundPlaybackHashes to identify CAR_SHUTDOWN streams
| || || || || 0x00000020 (Bit 5) = CanTowTrailer || ArticCabs have this set ||
|-
| 0x30 || 0x8 || [[#CgsAttribSys::AttribSysCollectionKey|AttribSysCollectionKey]] || mRivalReleasedVoiceOverKey || Car released streams || languagestreamconfiguration collection name in BURNOUTGLOBALDATA. Contains 8 CgsSoundPlaybackHashes to identify CAR_RELEASED streams
| || || || || 0x00000040 (Bit 6) = CanBePainted || Color changeability ||
|-
| 0x80x38 || 0x10x4 || uint8_tuint32_t || LengthmuiAIMusicLoopContentSpec || BoostAI Lengthmusic stream || 00See =[[#AI Nonemusic stream|| DefaultAI valuesmusic listed.stream]]
|-
| 0x3C || 0x1 || uint8_t || muiAIExhaustIndex || AI Engine Stream || 03See =[[#AI Aggressionengine stream||AI engine stream]]
|-
| 0x3D || 0x1 || uint8_t || muiAIExhaustIndex2ndPick || AI Engine Stream 2 || 04See =[[#AI Speedengine stream||AI engine stream]]
|-
| 0x3E || 0x1 || uint8_t || muiAIExhaustIndex3rdPick || AI Engine Stream 3 || 07See =[[#AI Stuntengine stream||AI engine stream]]
|-
| 0x90x3F || 0x1 || uint8_t || || Rank required || 00 = Learner's PermitPadding ||
|}
 
=== CgsAttribSys::AttribSysCollectionKey ===
{| class="wikitable"
! Offset !! Length !! Type !! Name !! Description !! Comments
|-
| 0x0 || 0x8 || int64_t || miAssetGuid || || 01 = D Class License ||
|}
 
= Enumerations =
=== Category ===
{| class="wikitable"
! Name !! Value !! Comments
|-
| ? || 0x1 || Paradise Cars
| || || || || || 02 = C Class License ||
|-
| ? || 0x2 || Paradise Bikes
| || || || || || 03 = B Class License ||
|-
| ? || 0x4 || Online Cars
| || || || || || 04 = A Class License ||
|-
| ? || 0x8 || Toy || || || 05 = Burnout License || Vehicles
|-
| ? || 0x10 || Legendary Cars
| 0xA || 0x1 || uint8_t || Capacity || Boost Capacity || "00 = Default (matches 05) Traffic cars use different values"
|-
| 0xB? || 0x10x20 || uint8_tBoost || || Strength Rating || ||Special Cars
|-
| ? || 0x40 || Cop Cars
|-
| ? || 0x80 || Big Surf Island Cars
|}
 
=== AudioDataVehicle type ===
{| class="wikitable"
! Name !! Value !! Comments
|-
| ? || 0 || Car
|-
| ? || 1 || Bike
|-
| ? || 2 || Plane
|}
 
=== BrnResource::ECarType ===
{| class="wikitable"
! Offset !! Size !! Type !! Name !! Description !! More InformationValue !! Comments
|-
| E_CARTYPE_DANGER || 0 || Speed
| 0x0 || 0x8 || CgsID || mExhaustName || Exhaust CgsID || Decodes to engine ID e.g. DRAG_EX || Use encdec.rb or BurnoutHasher to decode
|-
| E_CARTYPE_AGGRESSION || 1 || Aggression
| 0x8 || 0x8 || AttribSysCollectionKey || mExhaustEntityKey || Exhaust ID || Exhaust vehicleengine collection name || lookup8 encoded in AttribSys. Used under SoundExhaustAsset and ExhaustEntityKey.
|-
| E_CARTYPE_STUNTS || 2 || Stunt
| 0x10 || 0x8 || AttribSysCollectionKey || mEngineEntityKey || Engine ID || Engine vehicleengine collection name || lookup8 encoded in AttribSys. Used under SoundEngineAsset and EngineEntityKey.
|-
| ? || 3 || None
| 0x18 || 0x8 || CgsID || mEngineName || Engine CgsID || Decodes to engine ID e.g. DRAG_ENG || Use encdec.rb or BurnoutHasher to decode
|-
| ? || 4 || Locked
| 0x20 || 0x4 || Name || mRivalUnlockName || Class Unlock Stream Hash || BFA57004 = SuperClassUnlock ||
|-
| E_CARTYPE_INVALID || 5 ||
| || || || || || EF6F3448 = MuscleClassUnlock ||
|-
| E_CARTYPE_COUNT || 5 ||
| || || || || || D9917B81 = F1ClassUnlock ||
|}
 
=== BrnResource::VehicleListEntry::ELiveryType ===
{| class="wikitable"
! Name !! Value !! Comments
|-
| E_LIVERY_DEFAULT || 0 || Primary finish (primary vehicle)
| || || || || || C9D8E2A3 = TunerClassUnlock ||
|-
| E_LIVERY_COLOUR || 1 || Secondary finish
| || || || || || 655484B3 = HotRodClassUnlock ||
|-
| E_LIVERY_PATTERN || 2 || Primary finish (Burning Route vehicle)
| || || || || || E99AE3EB = RivalGen ||
|-
| E_LIVERY_SILVER || 3 || Platinum finish
| 0x24 || 0x4 || || || padding || ||
|-
| E_LIVERY_GOLD || 4 || Gold finish
| 0x28 || 0x8 || AttribSysCollectionKey || mWonCarVoiceOverKey || Car Shutdown Streams || languagestreamconfiguration collection name in BURNOUTGLOBALDATA || Contains 8 CgsSoundPlaybackHashes to identify CAR_SHUTDOWN streams.
|-
| ? || 5 || Community finish (excluding Tiger GT/Tempesta Dream)
| 0x30 || 0x8 || AttribSysCollectionKey || mRivalReleasedVoiceOverKey || Car Released Streams || languagestreamconfiguration collection name in BURNOUTGLOBALDATA || Contains 8 CgsSoundPlaybackHashes to identify CAR_RELEASED streams.
|}
 
=== BrnResource::VehicleListEntryGamePlayData::EFlags ===
{| class="wikitable"
! Name !! Value !! Comments
|-
| E_FLAG_IS_RACE_VEHICLE || 0x1 || Used to differentiate between player and traffic cars.<br>Allows selecting this vehicle in the junkyard
| 0x38 || 0x4 || uint32_t || muiAIMusicLoopContentSpec || AI Music Stream Hash Name hash of full gamedb path" || 9D3C81A9 = AI_Muscle_music1 ||
|-
| E_FLAG_CAN_CHECK_TRAFFIC || 0x2 || Can check traffic.<br>Always 0
| || || || || || A7AE72CB = AI_Truck_music1 ||
|-
| E_FLAG_CAN_BE_CHECKED || 0x4 || Can be checked like traffic.<br>Always 0
| || || || || || 4B944D28 = AI_Tuner_muisc1 ||
|-
| E_FLAG_IS_TRAILER || 0x8 || Is a trailer.<br>Trailers have this set
| || || || || || 09235CD9 = AI_Sedan_music1 ||
|-
| E_FLAG_CAN_TOW_TRAILER || 0x10 || Is an articulated cab that can tow a trailer.<br>ArticCabs have this set
| || || || || || E9901A8A = AI_Exotic_music1 ||
|-
| E_FLAG_CAN_BE_PAINTED? || 0x20 || Allows the vehicle to be painted
| || || || || || DD342AB1 = AI_Super_muisc1 ||
|-
| ? || 0x40 || Unknown. Always 1
| 0x3C || 0x1 || uint8_t || muiAIExhaustIndex || AI Engine Stream || 01 = AIROD_EX 02 = AI_CIVIC_EX 03 = AI_GT_ENG 04 = AI_MUST_EX 05 = AI_F1_EX" ||
|-
| ? || 0x80 || Is the first car within a certain speed range
| 0x3D || 0x1 || uint8_t || muiAIExhaustIndex2ndPick || AI Engine Stream 2 || ||
|-
| ? || 0x100 || Has switchable boost
| 0x3E || 0x1 || uint8_t || muiAIExhaustIndex3rdPick || AI Engine Stream 3 || ||
|-
| 0x3F? || 0x10x200 || Unknown. || || padding || ||Always 0
|-
| ? || 0x400 || Versioning. Always 0
|-
| ? || 0x800 || Is WIP/dev
|-
| ? || 0x1000 || Is from 1.0. Used on Paradise Cars
|-
| ? || 0x2000 || Is from 1.3. Used on Online Cars/Community Cars
|-
| ? || 0x4000 || Is from 1.4. Used on Paradise Bikes
|-
| ? || 0x8000 || Is from 1.5
|-
| ? || 0x10000 || Is from 1.6
|-
| ? || 0x20000 || Is from 1.7. Used on Toys/Legendary Cars/Boost Specials
|-
| ? || 0x40000 || Is from 1.8. Used on Cop Cars
|-
| ? || 0x80000 || Is from 1.9. Used on Island Cars
|}
 
=== SpeedStatsRank ===
{| class="wikitable"
! Name !! Value !! Comments
|-
| ? || 0 || Learner's Permit
|-
| ? || 1 || D Class License
|-
| ? || 2 || C Class License
|-
| ? || 3 || B Class License
|-
| ? || 4 || A Class License
|-
| ? || 5 || Burnout License
|}
 
=== AI engine stream ===
From <code>BrnSound::Vehicles::KAPC_DEBUG_AI_EXHAUST_NAME</code>.
{| class="wikitable"
! Name !! Value !! Comments
! || 1 || 2 || 3 || 4 || 5 || 6 || 7 || 8 || 9 || 10
|-
| AIROD_EX || 1 ||
|-
| AI_CIVIC_EX || 2 ||
|-
| AI_GT_ENG || 3 ||
|-
| AI_MUST_EX || 4 ||
|-
| AI_F1_EX || 5 ||
|-
| AI_BIKE_EX || 6 ||
|}
 
= Streams =
=== Class unlock stream ===
{| class="wikitable"
! Name !! Hash !! Comments
|-
| SuperClassUnlock || 0xBFA57004 ||
|-
| MuscleClassUnlock || 0xEF6F3448 ||
|-
| F1ClassUnlock || 0xD9917B81 ||
|-
| TunerClassUnlock || 0xC9D8E2A3 ||
|-
| HotRodClassUnlock || 0x655484B3 ||
|-
| RivalGen || 0xE99AE3EB ||
|}
 
=== AI music stream ===
{| class="wikitable"
! Name !! Hash !! Comments
|-
| AI_Muscle_music1 || 0x9D3C81A9 ||
|-
| AI_Truck_music1 || 0xA7AE72CB ||
|-
| AI_Tuner_muisc1 || 0x4B944D28 ||
|-
| AI_Sedan_music1 || 0x09235CD9 ||
|-
| AI_Exotic_music1 || 0xE9901A8A ||
| Speed || &lt;140 || 140-144 || 145-149 || 150-154 || 155-159 || 160-164 || 165-169 || 170-174 || 175-179 || ≥180
|-
| AI_Super_muisc1 || 0xDD342AB1 ||
| Boost || &lt;160 || 160-164 || 165-169 || 170-174 || 175-179 || 180-184 || 185-189 || 190-194 || 195-199 || ≥200
|}
Retrieved from "https://burnout.wiki/wiki/Special:MobileDiff/6284...9629"