Class LotArchitecture
- Namespace
- LlamaLogic.Architecture
- Assembly
- LlamaLogic.Architecture.dll
Represents the architecture of a lot: its walls, floors, roofs, stairs, terrain and the rest of its build, as typed sections (🔓)
public sealed class LotArchitecture
- Inheritance
-
LotArchitecture
- Inherited Members
Remarks
The game stores a lot's architecture as a RecordBundle in three places: the WorldLotArchitecture resources of world files, the architecture data of each lot in a save game (see ZoneArchitecture) and tray blueprints (see Blueprint). Each record of the bundle is one section, keyed by its LotArchitectureSectionType, group 0 and instance 1.
Many sections can only be read with the lot's dimensions, which the LotSize section gives, so the bundle, not the section, is the unit of decoding. Records Decode(RecordBundle) cannot turn into sections are kept, unchanged, in UndecodedRecords: those of types this library does not know, those with another group or instance, those with a version (of the section or of an element of it) or a floor feature layer type this library does not support, and those that need dimensions an older LotSize section does not give (the game itself discards those).
Encode() writes the sections in the layout of their versions, so decoding and encoding the architecture of any lot the game wrote reproduces it byte for byte.
Where the documentation of the sections speaks of the lots, sections or entries examined, it means the 2,919 lot architectures examined while developing this library, at the game's patch level as of October 2026: those of the lots of the game's installed world files (of which twelve base-game worlds had been replaced by a community lot-replacement mod), the 179 lots of the Maxis originals of those twelve worlds, the lots of four save games and 73 tray blueprints.
Fields
SectionInstance
Gets the instance of the record of every section
public const ulong SectionInstance = 1
Field Value
Properties
CeilingPaintRotations
Gets/sets the rotation of the ceiling paint of each level (🔓)
public FloorRotationGridSection? CeilingPaintRotations { get; set; }
Property Value
CeilingPaints
Gets/sets the ceiling paint of each level (🔓)
public FloorIdGridSection? CeilingPaints { get; set; }
Property Value
CeilingRotations
Gets/sets the rotation of the ceiling of each level (🔓)
public FloorRotationGridSection? CeilingRotations { get; set; }
Property Value
Remarks
It is paired with Ceilings, whose role in-game tests and the game's code show.
Ceilings
Gets/sets the ceiling of each level (🔓)
public FloorIdGridSection? Ceilings { get; set; }
Property Value
Remarks
In-game tests show that building a room fills this grid at the level above the room over exactly the room's tiles, and that painting the ceiling changes only CeilingPaints; the game's code assigns the grid to the room on the level below.
FloorFeatures
Gets/sets the floor feature layers (🔓)
public FloorFeaturesSection? FloorFeatures { get; set; }
Property Value
FloorKeys
Gets/sets the floor keys the floor id grids refer to (🔓)
public FloorKeysSection? FloorKeys { get; set; }
Property Value
FloorRotations
Gets/sets the rotation of the floor pattern of each level (🔓)
public FloorRotationGridSection? FloorRotations { get; set; }
Property Value
Floors
Gets/sets the floor pattern of each level (🔓)
public FloorIdGridSection? Floors { get; set; }
Property Value
LegacyFencePoints
Gets/sets the points with fence and ceiling rail keys of older world files (🔓)
public LegacyFencePointsSection? LegacyFencePoints { get; set; }
Property Value
Remarks
The name reflects the catalog key types the data holds; the section appears only in older world files.
LegacyWallGraph
Gets/sets the graph of edges with wall pattern and product keys of older world files (🔓)
public LegacyWallGraphSection? LegacyWallGraph { get; set; }
Property Value
Remarks
The name reflects the catalog key types the data holds; the section appears only in older world files.
LotInfo
Gets/sets the lot's levels, style and creators (🔓)
public LotInfoSection? LotInfo { get; set; }
Property Value
LotObjects
Gets/sets the objects stored with the architecture (🔓)
public LotObjectsSection? LotObjects { get; set; }
Property Value
LotSize
Gets/sets the lot's dimensions (🔓)
public LotSizeSection? LotSize { get; set; }
Property Value
ModularPieces
Gets/sets the modular pieces (🔓)
public ModularPiecesSection? ModularPieces { get; set; }
Property Value
ObjectFallbacks
Gets/sets the objects the game falls back to placing when others are unavailable (🔓)
public ObjectFallbacksSection? ObjectFallbacks { get; set; }
Property Value
ObjectTileBounds
Gets/sets the tiles each object covers (🔓)
public ObjectTileBoundsSection? ObjectTileBounds { get; set; }
Property Value
PendingPlacement
Gets/sets the pending placement (🔓)
public PendingPlacementSection? PendingPlacement { get; set; }
Property Value
Remarks
When its state is 1, the game centers a footprint of the stored width, depth and rotation on the lot and builds a placement operation with the lot's BlueprintInstance.
PlexGroups
Gets/sets the groups of values the Plexes section refers to by id (🔓)
public PlexGroupsSection? PlexGroups { get; set; }
Property Value
Remarks
That the values are block ids is a hypothesis.
Plexes
Gets/sets the plexes (units) of the lot (🔓)
public PlexesSection? Plexes { get; set; }
Property Value
PondBottoms
Gets/sets the pond bottom pattern (🔓)
public FloorIdGridSection? PondBottoms { get; set; }
Property Value
Ponds
Gets/sets the ponds (🔓)
public PondsSection? Ponds { get; set; }
Property Value
PoolSurfaces
Gets/sets the pool surface pattern of each level (🔓)
public FloorIdGridSection? PoolSurfaces { get; set; }
Property Value
Remarks
In-game tests show that building a pool fills this grid over exactly the pool's tiles at the level above the pool's block; the game's code assigns the grid to the room on the level below.
Reserved1
Gets/sets the first reserved header value of the record bundle, which no code in the game's simulation library reads (other parts of the game were not examined)
public uint Reserved1 { get; set; }
Property Value
Reserved2
Gets/sets the second reserved header value of the record bundle, which no code in the game's simulation library reads (other parts of the game were not examined)
public uint Reserved2 { get; set; }
Property Value
ResourceManifest
Gets/sets the keys of the catalog resources the other sections reference (🔓)
public ResourceManifestSection? ResourceManifest { get; set; }
Property Value
Revision
Gets/sets the lot's revision counter (🔓)
public RevisionSection? Revision { get; set; }
Property Value
Roofs
Gets/sets the roofs (🔓)
public RoofsSection? Roofs { get; set; }
Property Value
SecondaryFloorRotations
Gets/sets the rotation of the second floor layer of each level (🔓)
public FloorRotationGridSection? SecondaryFloorRotations { get; set; }
Property Value
SecondaryFloors
Gets/sets the second floor layer of each level (🔓)
public FloorIdGridSection? SecondaryFloors { get; set; }
Property Value
Remarks
In-game tests show that building a room or a platform fills this grid over its tiles with the lot's default floor key, and that painting a floor or a platform's top changes only Floors; the grid's role is unknown.
Sections
Gets the decoded sections, in ascending order of type
public IReadOnlyList<LotArchitectureSection> Sections { get; }
Property Value
Stairs
Gets/sets the stairs and ladders (🔓)
public StairsSection? Stairs { get; set; }
Property Value
TerrainFloorRotations
Gets/sets the rotation of the floor pattern painted on the terrain (🔓)
public FloorRotationGridSection? TerrainFloorRotations { get; set; }
Property Value
TerrainFloors
Gets/sets the floor pattern painted on the terrain (🔓)
public FloorIdGridSection? TerrainFloors { get; set; }
Property Value
TerrainHeights
Gets/sets the terrain heights (🔓)
public TerrainHeightsSection? TerrainHeights { get; set; }
Property Value
TerrainPaint
Gets/sets the terrain paint layers (🔓)
public TerrainPaintSection? TerrainPaint { get; set; }
Property Value
UndecodedRecords
Gets the records that were not decoded into sections, which Encode() writes back unchanged
public Collection<RecordBundleRecord> UndecodedRecords { get; }
Property Value
Unknown7B33C1F5
Gets/sets the section of unknown purpose of type Unknown7B33C1F5 (🔓)
public Unknown7B33C1F5Section? Unknown7B33C1F5 { get; set; }
Property Value
UnknownC9106475
Gets/sets the section of unknown purpose of type UnknownC9106475 (🔓)
public UnknownC9106475Section? UnknownC9106475 { get; set; }
Property Value
Venue
Gets/sets the lot's venue (🔓)
public VenueSection? Venue { get; set; }
Property Value
VertexGraphs
Gets/sets the graphs of vertices and edges whose version decides the layout of WallEdges (🔓)
public VertexGraphsSection? VertexGraphs { get; set; }
Property Value
Remarks
The game reads only the section's version; what the graphs describe is not established. Sims 4 Studio calls this section WallCutout.
WallBlocks
Gets/sets the blocks: rooms, wall lines, fences, pools and fountains (🔓)
public WallBlocksSection? WallBlocks { get; set; }
Property Value
WallEdges
Gets/sets the wall patterns and products along wall edges (🔓)
public WallEdgesSection? WallEdges { get; set; }
Property Value
Weather
Gets/sets the lot's seasonal weather interpolation value (🔓)
public WeatherSection? Weather { get; set; }
Property Value
Methods
Decode(RecordBundle)
Decodes the architecture of a lot from a record bundle
public static LotArchitecture Decode(RecordBundle bundle)
Parameters
bundleRecordBundle
Returns
Exceptions
- InvalidDataException
One of the bundle's sections is not well-formed
Decode(ReadOnlyMemory<byte>)
Decodes the architecture of a lot from the content of a record bundle
public static LotArchitecture Decode(ReadOnlyMemory<byte> bundleData)
Parameters
bundleDataReadOnlyMemory<byte>
Returns
Exceptions
- InvalidDataException
The data is not a well-formed record bundle, or one of its sections is not well-formed
Encode()
Encodes the architecture as the content of a record bundle
public ReadOnlyMemory<byte> Encode()
Returns
Exceptions
- InvalidOperationException
A section cannot be encoded as it is, or a section and an undecoded record have the same key
GetManifestKeys()
Gets the keys the sections reference, in the order the game's saver would collect them into the ResourceManifest
public IReadOnlyList<ResourceKey> GetManifestKeys()
Returns
Remarks
The game builds the manifest by recording every key it writes while saving the sections that precede the manifest, in its fixed save order, skipping repeats. This method does the same with the current sections, so assigning the result to a new ResourceManifestSection keeps the manifest consistent after edits. No code in the game's simulation library reads the manifest back (other parts of the game were not examined). For 2,907 of 2,912 lots in the game's world files, save games and tray blueprints examined, the result equals the stored manifest; the exceptions are lots of older world files whose blocks hold inline keys, which the current game no longer writes, and one saved lot whose stored manifest lacks two keys its sections reference.
Exceptions
- InvalidOperationException
A section cannot be encoded as it is
ToRecordBundle()
Creates a record bundle holding the architecture
public RecordBundle ToRecordBundle()
Returns
Exceptions
- InvalidOperationException
A section cannot be encoded as it is, or a section and an undecoded record have the same key