Table of Contents

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

ulong

Properties

CeilingPaintRotations

Gets/sets the rotation of the ceiling paint of each level (🔓)

public FloorRotationGridSection? CeilingPaintRotations { get; set; }

Property Value

FloorRotationGridSection

CeilingPaints

Gets/sets the ceiling paint of each level (🔓)

public FloorIdGridSection? CeilingPaints { get; set; }

Property Value

FloorIdGridSection

CeilingRotations

Gets/sets the rotation of the ceiling of each level (🔓)

public FloorRotationGridSection? CeilingRotations { get; set; }

Property Value

FloorRotationGridSection

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

FloorIdGridSection

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

FloorFeaturesSection

FloorKeys

Gets/sets the floor keys the floor id grids refer to (🔓)

public FloorKeysSection? FloorKeys { get; set; }

Property Value

FloorKeysSection

FloorRotations

Gets/sets the rotation of the floor pattern of each level (🔓)

public FloorRotationGridSection? FloorRotations { get; set; }

Property Value

FloorRotationGridSection

Floors

Gets/sets the floor pattern of each level (🔓)

public FloorIdGridSection? Floors { get; set; }

Property Value

FloorIdGridSection

LegacyFencePoints

Gets/sets the points with fence and ceiling rail keys of older world files (🔓)

public LegacyFencePointsSection? LegacyFencePoints { get; set; }

Property Value

LegacyFencePointsSection

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

LegacyWallGraphSection

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

LotInfoSection

LotObjects

Gets/sets the objects stored with the architecture (🔓)

public LotObjectsSection? LotObjects { get; set; }

Property Value

LotObjectsSection

LotSize

Gets/sets the lot's dimensions (🔓)

public LotSizeSection? LotSize { get; set; }

Property Value

LotSizeSection

ModularPieces

Gets/sets the modular pieces (🔓)

public ModularPiecesSection? ModularPieces { get; set; }

Property Value

ModularPiecesSection

ObjectFallbacks

Gets/sets the objects the game falls back to placing when others are unavailable (🔓)

public ObjectFallbacksSection? ObjectFallbacks { get; set; }

Property Value

ObjectFallbacksSection

ObjectTileBounds

Gets/sets the tiles each object covers (🔓)

public ObjectTileBoundsSection? ObjectTileBounds { get; set; }

Property Value

ObjectTileBoundsSection

PendingPlacement

Gets/sets the pending placement (🔓)

public PendingPlacementSection? PendingPlacement { get; set; }

Property Value

PendingPlacementSection

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

PlexGroupsSection

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

PlexesSection

PondBottoms

Gets/sets the pond bottom pattern (🔓)

public FloorIdGridSection? PondBottoms { get; set; }

Property Value

FloorIdGridSection

Ponds

Gets/sets the ponds (🔓)

public PondsSection? Ponds { get; set; }

Property Value

PondsSection

PoolSurfaces

Gets/sets the pool surface pattern of each level (🔓)

public FloorIdGridSection? PoolSurfaces { get; set; }

Property Value

FloorIdGridSection

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

uint

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

uint

ResourceManifest

Gets/sets the keys of the catalog resources the other sections reference (🔓)

public ResourceManifestSection? ResourceManifest { get; set; }

Property Value

ResourceManifestSection

Revision

Gets/sets the lot's revision counter (🔓)

public RevisionSection? Revision { get; set; }

Property Value

RevisionSection

Roofs

Gets/sets the roofs (🔓)

public RoofsSection? Roofs { get; set; }

Property Value

RoofsSection

SecondaryFloorRotations

Gets/sets the rotation of the second floor layer of each level (🔓)

public FloorRotationGridSection? SecondaryFloorRotations { get; set; }

Property Value

FloorRotationGridSection

SecondaryFloors

Gets/sets the second floor layer of each level (🔓)

public FloorIdGridSection? SecondaryFloors { get; set; }

Property Value

FloorIdGridSection

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

IReadOnlyList<LotArchitectureSection>

Stairs

Gets/sets the stairs and ladders (🔓)

public StairsSection? Stairs { get; set; }

Property Value

StairsSection

TerrainFloorRotations

Gets/sets the rotation of the floor pattern painted on the terrain (🔓)

public FloorRotationGridSection? TerrainFloorRotations { get; set; }

Property Value

FloorRotationGridSection

TerrainFloors

Gets/sets the floor pattern painted on the terrain (🔓)

public FloorIdGridSection? TerrainFloors { get; set; }

Property Value

FloorIdGridSection

TerrainHeights

Gets/sets the terrain heights (🔓)

public TerrainHeightsSection? TerrainHeights { get; set; }

Property Value

TerrainHeightsSection

TerrainPaint

Gets/sets the terrain paint layers (🔓)

public TerrainPaintSection? TerrainPaint { get; set; }

Property Value

TerrainPaintSection

UndecodedRecords

Gets the records that were not decoded into sections, which Encode() writes back unchanged

public Collection<RecordBundleRecord> UndecodedRecords { get; }

Property Value

Collection<RecordBundleRecord>

Unknown7B33C1F5

Gets/sets the section of unknown purpose of type Unknown7B33C1F5 (🔓)

public Unknown7B33C1F5Section? Unknown7B33C1F5 { get; set; }

Property Value

Unknown7B33C1F5Section

UnknownC9106475

Gets/sets the section of unknown purpose of type UnknownC9106475 (🔓)

public UnknownC9106475Section? UnknownC9106475 { get; set; }

Property Value

UnknownC9106475Section

Venue

Gets/sets the lot's venue (🔓)

public VenueSection? Venue { get; set; }

Property Value

VenueSection

VertexGraphs

Gets/sets the graphs of vertices and edges whose version decides the layout of WallEdges (🔓)

public VertexGraphsSection? VertexGraphs { get; set; }

Property Value

VertexGraphsSection

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

WallBlocksSection

WallEdges

Gets/sets the wall patterns and products along wall edges (🔓)

public WallEdgesSection? WallEdges { get; set; }

Property Value

WallEdgesSection

Weather

Gets/sets the lot's seasonal weather interpolation value (🔓)

public WeatherSection? Weather { get; set; }

Property Value

WeatherSection

Methods

Decode(RecordBundle)

Decodes the architecture of a lot from a record bundle

public static LotArchitecture Decode(RecordBundle bundle)

Parameters

bundle RecordBundle

Returns

LotArchitecture

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

bundleData ReadOnlyMemory<byte>

Returns

LotArchitecture

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

ReadOnlyMemory<byte>

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

IReadOnlyList<ResourceKey>

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

RecordBundle

Exceptions

InvalidOperationException

A section cannot be encoded as it is, or a section and an undecoded record have the same key