Difference between revisions of "Building Subfile"

From SC4D Encyclopaedia
Jump to navigation Jump to search
sc4e>CasperVg
m (Building File moved to Building Subfile: cons)
sc4e>CasperVg
(Building Subfile, decoded by RippleJet)
Line 1: Line 1:
−
{{MTS2}}
+
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''' file within [[Savegame]] files.
+
<h1>Structure</h1>
 +
<pre>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  (**
 +
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  (*
 +
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 (***
  
−
==Specification==
 
−
<pre>
 
−
DWORD - Length of entry chunk
 
  
−
--- Repeating entry chunk:
+
*)
−
32 Bytes
+
Structure of SGPROP (SaveGame Properties):
−
DWORD - GroupID of building
 
−
DWORD - TypeID of building
 
−
DWORD - Instance ID of building
 
−
DWORD - Instance ID of building
 
−
34 Bytes
 
−
---
 
−
</pre>
 
  
−
This holds until offset 48916. The format switches to 32 bytes before the Dword E1EBDB69 in the tested city file.
+
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)
  
 +
 +
**)
 +
Apperance 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)
 +
 +
 +
 +
***)
 +
Scaffolding Height
 +
Depending on the height of the finished building, it 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, I've e.g. found the following values:
 +
 +
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.</pre>
 +
 +
'''Savegame Properties (SGProps)'''
 +
<pre>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.</pre>
  
 
[[Category:Modding]]
 
[[Category:Modding]]
 
[[Category:MTS2]]
 
[[Category:MTS2]]
 
[[Category:Savegame/Subfiles]]
 
[[Category:Savegame/Subfiles]]

Revision as of 12:37, 28 September 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

Structure

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  (**
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  (*
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 (***


*)
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)


**)
Apperance 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)



***)
Scaffolding Height
Depending on the height of the finished building, it 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, I've e.g. found the following values:

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.
Retrieved from "https://wiki.sc4devotion.com/index.php?title=Building_Subfile&oldid=22723"