Difference between revisions of "Building Subfile"
Jump to navigation
Jump to search
sc4e>CasperVg (clarity, layout) |
sc4e>Whatevermind m (Layout and cleanup, pulled some comments out of pre's, etc.) |
||
| Line 1: | Line 1: | ||
This page pertains to the format of the '''Building Subfile''' within the [[Savegame]] files. This file has [[Type ID]] ''A9BD882D''. It can be viewed using the [[SC4 Savegame Explorer]], but not edited. This particular subfile was decoded by {{people|RippleJet}} | This page pertains to the format of the '''Building Subfile''' within the [[Savegame]] files. This file has [[Type ID]] ''A9BD882D''. It can be viewed using the [[SC4 Savegame Explorer]], but not edited. This particular subfile was decoded by {{people|RippleJet}} | ||
| − | + | ||
| − | == Description == | + | ==Description== |
| − | This subfile contains data about all the buildings in the city. | + | This subfile contains data about all of the buildings in the city. |
| − | == Structure == | + | |
| − | <pre>DWORD Size | + | ==Structure== |
| + | The structure of the Building Subfile follows the format below. Somebody should clarify which part of this repeats for each building. | ||
| + | |||
| + | <pre> | ||
| + | DWORD Size | ||
DWORD CRC | DWORD CRC | ||
DWORD Memory | DWORD Memory | ||
| Line 33: | Line 37: | ||
FLOAT32 Max Z Coordinate | FLOAT32 Max Z Coordinate | ||
BYTE Orientation | BYTE Orientation | ||
| − | FLOAT32 Scaffolding Height (Appendix 3)</pre> | + | FLOAT32 Scaffolding Height (Appendix 3) |
| + | </pre> | ||
| − | === Appendix 1: Structure of SGPROP (SaveGame Properties) === | + | ===Appendix 1: Structure of SGPROP (SaveGame Properties)=== |
| − | <pre>DWORD | + | <pre> |
| − | DWORD Property Name Value | + | DWORD Property Name Value |
| + | DWORD Property Name Value (doubled for some unknown reason) | ||
DWORD 0x00000000 | DWORD 0x00000000 | ||
| − | BYTE Data Type | + | BYTE Data Type: 01=UInt8, 02=UInt16, 03=UInt32, 07=SInt32, 08=SInt64, 09=Float32, 0B=Boolean, 0C=String |
| − | BYTE KeyType | + | BYTE KeyType: 0x00 = 0 reps, 0x80 = more than 0 reps |
WORD 0x0000 | WORD 0x0000 | ||
DWORD Rep Count (this one appears only if KeyType = 0x80) | DWORD Rep Count (this one appears only if KeyType = 0x80) | ||
| − | DATA Property Value (repeated Rep Count times, type according to Data Type)</pre> | + | DATA Property Value (repeated Rep Count times, type according to Data Type) |
| + | </pre> | ||
| − | === Appendix 2: Appearance Flag (offset 0x0013) === | + | ===Appendix 2: Appearance Flag (offset 0x0013)=== |
| − | <pre> | + | <pre> |
| − | + | 0x01 (00000001b) - Building that appears in the game (if this is off, the building has been deleted) | |
| − | + | 0x02 (00000010b) - ? (unused) | |
| − | + | 0x04 (00000100b) - ? (always on) | |
| − | + | 0x08 (00001000b) - Flora (not used for buildings) | |
| + | 0x40 (01000000b) - Burnt (probably not used for buildings, as if they burn, they become replaced by a burnt prop) | ||
| + | </pre> | ||
| − | === Appendix 3: Scaffolding Height === | + | ===Appendix 3: Scaffolding Height=== |
| − | + | Depending on the height of the finished building, the scaffolding height is divided into a number of (let's call it F) fractions. During construction, if the building is growable (or LotConfigPropertyDoConstruction = True), the scaffolding will jump up in steps equal to 1/F of the final height. | |
| − | During construction, if the building is growable (or LotConfigPropertyDoConstruction = True), | ||
| − | the scaffolding will jump up in steps equal to 1/F of the final height. | ||
| − | |||
| − | |||
| − | |||
| + | The height of the current scaffolding is given in this field. Checking several buildings under construction of different heights, the following values have been found: | ||
| + | <pre> | ||
1/2, 1/3, 2/3, 3/5, 4/5, 2/7, 4/7, 4/9, 8/17, 7/20 | 1/2, 1/3, 2/3, 3/5, 4/5, 2/7, 4/7, 4/9, 8/17, 7/20 | ||
| + | </pre> | ||
| − | Once the scaffolding enters the height of the final building, this field will get a value of 1.00 | + | Once the scaffolding enters the height of the final building, this field will get a value of 1.00. A finished building always has a value of 1.00 in this field. |
| − | A finished building always has a value of 1.00 in this field. | ||
| − | == Savegame Properties (SGProps) == | + | ==Savegame Properties (SGProps)== |
| − | <pre>0x899AFBAD - Custom Name | + | <pre> |
| + | 0x899AFBAD - Custom Name | ||
Type: String | Type: String | ||
Rep Count = String Length | Rep Count = String Length | ||
| Line 154: | Line 161: | ||
For some reason this is usually not accurate though, compared to the building property Police Station, Total Dispatches, e.g: | For some reason this is usually not accurate though, compared to the building property Police Station, Total Dispatches, e.g: | ||
| − | Station | + | Station |
| − | Total | + | Total |
| − | SGPROP | + | SGPROP |
| − | plopped: | + | plopped: |
| − | Dispatches | + | Dispatches |
| − | + | Dispatches | |
| − | Police Kiosk | + | Police Kiosk |
| − | 0 | + | 0 |
| − | 1 | + | 1 |
| − | Small Police Station | + | Small Police Station |
| − | 2 | + | 2 |
| − | 1 | + | 1 |
| − | Large Police Station | + | Large Police Station |
| − | 4 | + | 4 |
| − | 3 | + | 3 |
| − | DeLuxe Police Station | + | DeLuxe Police Station |
| − | 6 | + | 6 |
| − | 7 | + | 7 |
| − | Modd Squad Safety | + | Modd Squad Safety |
| − | 20 | + | 20 |
| − | 21 | + | 21 |
Thus, I cannot guarantee what this property is showing. | Thus, I cannot guarantee what this property is showing. | ||
| Line 192: | Line 199: | ||
For some reason this is usually not accurate though, compared to the building property Fire Station, Total Dispatches, e.g: | For some reason this is usually not accurate though, compared to the building property Fire Station, Total Dispatches, e.g: | ||
| − | Station | + | Station |
| − | Total | + | Total |
| − | SGPROP | + | SGPROP |
| − | plopped: | + | plopped: |
| − | Dispatches | + | Dispatches |
| − | + | Dispatches | |
| − | Small Fire Station | + | Small Fire Station |
| − | 1 | + | 1 |
| − | 1 | + | 1 |
| − | Large Fire Station | + | Large Fire Station |
| − | 2 | + | 2 |
| − | 2 | + | 2 |
| − | Fire Landing Strip | + | Fire Landing Strip |
| − | 2 | + | 2 |
| − | 4 | + | 4 |
| − | Modd Squad Safety | + | Modd Squad Safety |
| − | 20 | + | 20 |
| − | 21 | + | 21 |
Thus, I cannot guarantee what this property is showing. | Thus, I cannot guarantee what this property is showing. | ||
| Line 229: | Line 236: | ||
0x0000003F - DeLuxe Police Station | 0x0000003F - DeLuxe Police Station | ||
0x000FFFFF - Modd Squad Safety | 0x000FFFFF - Modd Squad Safety | ||
| + | |||
0x69B425DE - Fire Station - Unknown property | 0x69B425DE - Fire Station - Unknown property | ||
| Line 237: | Line 245: | ||
0x00000003 - Fire Landing Strip | 0x00000003 - Fire Landing Strip | ||
0x000FFFFF - Modd Squad Safety | 0x000FFFFF - Modd Squad Safety | ||
| + | |||
0x8A70A0B9 - Crimes and Arrests | 0x8A70A0B9 - Crimes and Arrests | ||
| Line 271: | Line 280: | ||
Rep Count: 0 | Rep Count: 0 | ||
Values seen: always False (never True) | Values seen: always False (never True) | ||
| − | This is rare, but has been found in the | + | This is rare, but has been found in the Prop subfile, the Flora subfile and the Building subfile |
| − | + | </pre> | |
| − | NOTE: | + | NOTE: Just like ordinary police and fire stations, the Modd Squad Safety did not get the property 0xEA54D284 (Budget Panel Identification). Thus, I do not currently know in which order the budget fundings given in 0xEA54D287 are to be read. That property did get three reps, all at 100%, probably for police funding, jail funding and fire station funding. |
| − | Just like ordinary police and fire stations, the Modd Squad Safety did not get the property 0xEA54D284 (Budget Panel Identification). | ||
| − | Thus, I do not currently know in which order the budget fundings given in 0xEA54D287 are to be read. | ||
| − | That property did get three reps, all at 100%, probably for police funding, jail funding and fire station funding. | ||
Revision as of 18:15, 10 November 2012
This page pertains to the format of the Building Subfile within the Savegame files. This file has Type ID A9BD882D. It can be viewed using the SC4 Savegame Explorer, but not edited. This particular subfile was decoded by RippleJet
Contents
Description
This subfile contains data about all of the buildings in the city.
Structure
The structure of the Building Subfile follows the format below. Somebody should clarify which part of this repeats for each building.
DWORD Size
DWORD CRC
DWORD Memory
WORD Major Version? (only seen 0x0002)
WORD Minor Version? (only seen 0x0004)
WORD Zot Word (always 0x0000 for buildings)
BYTE Unknown (only seen 0x00)
BYTE Appearance Flag (Appendix 2)
DWORD 0x278128A0 (always the same)
BYTE Min Tract X Coordinate
BYTE Min Tract Z Coordinate
BYTE Max Tract X Coordinate
BYTE Max Tract Z Coordinate
WORD X Tract Size? (power of 2) (only seen 0x0002)
WORD Z Tract Size? (power of 2) (only seen 0x0002)
DWORD Count of Properties (can be several of them)
SGPROP SaveGame Properties, repeated Count times (Appendix 1)
BYTE Unknown (I think I've only seen 0x01)
DWORD Group ID (from the Prop Exemplar)
DWORD Type ID (from the Prop Exemplar)
DWORD Instance ID (from the Prop Exemplar)
DWORD Instance ID (the value given when the building appeared)
FLOAT32 Min X Coordinate
FLOAT32 Min Y Coordinate
FLOAT32 Min Z Coordinate
FLOAT32 Max X Coordinate
FLOAT32 Max Y Coordinate
FLOAT32 Max Z Coordinate
BYTE Orientation
FLOAT32 Scaffolding Height (Appendix 3)
Appendix 1: Structure of SGPROP (SaveGame Properties)
DWORD Property Name Value
DWORD Property Name Value (doubled for some unknown reason)
DWORD 0x00000000
BYTE Data Type: 01=UInt8, 02=UInt16, 03=UInt32, 07=SInt32, 08=SInt64, 09=Float32, 0B=Boolean, 0C=String
BYTE KeyType: 0x00 = 0 reps, 0x80 = more than 0 reps
WORD 0x0000
DWORD Rep Count (this one appears only if KeyType = 0x80)
DATA Property Value (repeated Rep Count times, type according to Data Type)
Appendix 2: Appearance Flag (offset 0x0013)
0x01 (00000001b) - Building that appears in the game (if this is off, the building has been deleted) 0x02 (00000010b) - ? (unused) 0x04 (00000100b) - ? (always on) 0x08 (00001000b) - Flora (not used for buildings) 0x40 (01000000b) - Burnt (probably not used for buildings, as if they burn, they become replaced by a burnt prop)
Appendix 3: Scaffolding Height
Depending on the height of the finished building, the scaffolding height is divided into a number of (let's call it F) fractions. During construction, if the building is growable (or LotConfigPropertyDoConstruction = True), the scaffolding will jump up in steps equal to 1/F of the final height.
The height of the current scaffolding is given in this field. Checking several buildings under construction of different heights, the following values have been found:
1/2, 1/3, 2/3, 3/5, 4/5, 2/7, 4/7, 4/9, 8/17, 7/20
Once the scaffolding enters the height of the final building, this field will get a value of 1.00. A finished building always has a value of 1.00 in this field.
Savegame Properties (SGProps)
0x899AFBAD - Custom Name Type: String Rep Count = String Length Contains the customized name given to a building in the game 0x08D9763D - Utility Usage Type: UInt32/SInt32 Rep Count = 0 UInt32 for Water Pumps SInt32 for Power Plants 0x00000000 for newly plopped facilities The actual amount of water and power produced (and used by the city). 0x2A58D350 - Actual Monthly Cost at full funding Type: SInt64 Rep Count = 0 Only for utility buildings, not for other civic buildings. Takes into account "Funding percentage to decay rate multiplier response curve". 0xEA54D284 - Budget Panel Identification Type: UInt32 Rep Count > 0 Normally a link to the Building Exemplar's IID 0x00000001 = Ambulance or School Bus 0xEA54D287 - Local Budget Funding in % Type: Float32 Rep Count > 0 Funding percentage of those items set in 0xEA54D284 0x0910BFCF - Accumulated Age Degradation Type: Float32 Rep Count = 0 0xE9244B2E - School Capacity (actual capacity, based on funding) Type: UInt32 Rep Count = 0 0x09220161 - School Usage (actual number of students) Type: UInt32 Rep Count = 0 0xFFFFFFFF if newly plopped 0x49244B21 - Hospital Capacity (actual capacity, based on funding) Type: UInt32 Rep Count = 0 0xC922015C - Hospital Usage (actual number of patients) Type: UInt32 Rep Count = 0 0xFFFFFFFF if newly plopped 0x292453C5 - School Grade? (between 0.00 and 1.00) 0x2A976C20 - School Grade? (between 0.00 and 1.00) Type: Float32 Rep Count = 0 One is probably the grade. What is the other one? 0x092453CB - Hospital Grade? (between 0.00 and 1.00) 0xAA976BE7 - Hospital Grade? (between 0.00 and 1.00) Type: Float32 Rep Count = 0 One is probably the grade. What is the other one? 0x48D71EE1 - Jail Usage (actual number of inmates) Type: UInt32 Rep Count = 0 0x00000000 if newly plopped For the Modd Squad Safety I had an inmate count of 19 in the query, but this property showed 20. 0x48D71ED7 - Police Station available(?) dispatches Type: UInt32 Rep Count = 0 For some reason this is usually not accurate though, compared to the building property Police Station, Total Dispatches, e.g: Station Total SGPROP plopped: Dispatches Dispatches Police Kiosk 0 1 Small Police Station 2 1 Large Police Station 4 3 DeLuxe Police Station 6 7 Modd Squad Safety 20 21 Thus, I cannot guarantee what this property is showing. However the values are the only ones that even somewhat match up to the total dispatches. 0x69B425DD - Fire Station available(?) dispatches Type: UInt32 Rep Count = 0 For some reason this is usually not accurate though, compared to the building property Fire Station, Total Dispatches, e.g: Station Total SGPROP plopped: Dispatches Dispatches Small Fire Station 1 1 Large Fire Station 2 2 Fire Landing Strip 2 4 Modd Squad Safety 20 21 Thus, I cannot guarantee what this property is showing. However the values are the only ones that even somewhat match up to the total dispatches. 0x48D71ED8 - Police Station - Unknown property Type: UInt32 Rep Count = 0 0x00000000 - Police Kiosk 0x00000003 - Small Police Station 0x0000000F - Large Police Station 0x0000003F - DeLuxe Police Station 0x000FFFFF - Modd Squad Safety 0x69B425DE - Fire Station - Unknown property Type: UInt32 Rep Count = 0 0x00000001 - Small Fire Station 0x00000003 - Large Fire Station 0x00000003 - Fire Landing Strip 0x000FFFFF - Modd Squad Safety 0x8A70A0B9 - Crimes and Arrests Type: UInt32 Rep Count = 4 Rep 1 = Number of Crimes this month (as reported by the query) Rep 2 = Number of Arrests this month (as reported by the query) Rep 3 = Number of Crimes the previous month Rep 4 = Number of Arrests the previous month 0xAC0B070E - Unknown - DeLuxe Police Station - Helicopter related? Type: UInt32 Rep Count = 0 0xEC0B0709 - Unknown - DeLuxe Police Station - Helicopter related? Type: UInt32 Rep Count = 0 0x0C0AFF3F - Unknown - Fire Landing Strip - Fire Plane related? Type: UInt32 Rep Count = 0 0xCC0AFDDB - Unknown - Fire Landing Strip - Fire Plane related? Type: UInt32 Rep Count = 0 0x69DBEBE1 - Unknown Data Type: Boolean Rep Count: 0 Values seen: always False (never True) This is rare, but has been found in the Prop subfile, the Flora subfile and the Building subfile
NOTE: Just like ordinary police and fire stations, the Modd Squad Safety did not get the property 0xEA54D284 (Budget Panel Identification). Thus, I do not currently know in which order the budget fundings given in 0xEA54D287 are to be read. That property did get three reps, all at 100%, probably for police funding, jail funding and fire station funding.
| ||||||||
