SCUMM/Technical Reference/Room resources
SCUMM V1
A room resource is located as the first chunk in a LFL File.
Header
The room resource starts with a 28 bytes header containing the following information:
Location | Format | Data |
---|---|---|
0x00 | UInt16LE | Size of the room resource chunk |
0x02 | ??? | Unknown |
0x04 | UInt16LE | Room width in tiles |
0x06 | UInt16LE | Room height in tiles |
0x08 | ??? | Unknown (Always 0 on NES) |
0x0a | UInt16LE | Offset to gfx nametable location (NES) |
0x0c | UInt16LE | Offset to gfx attrtable location (NES) |
0x0e | UInt16LE | Offset to mask flag value location |
0x10 | ??? | Unknown (On NES both these values are equal) |
0x12 | ??? | Unknown |
0x14 | UInt8 | Number of objects in room |
0x15 | UInt8 | Offset to number of boxes location |
0x16 | UInt8 | Number of sounds in room (Always 0 on NES) |
0x17 | UInt8 | Number of scripts in room |
0x18 | UInt16LE | Offset to exit script location |
0x1a | UInt16LE | Offset to entry script location |
All offsets are relative to the start of the chunk.
Note: Because of the following constraints:
- Offset to box number location is an UInt8, thus must be in the first 255 bytes of the chunk
- The header takes 28 bytes
- The size of object images and object content offsets are 4 bytes per object
The total number of objects per room must be less than 57:
(256 - 28) / 4 = 57
Data
Object image offsets
From byte 0x1c starts the offsets to object images:
Location | Format | Data |
---|---|---|
0x1c | UInt16LE | Offset to object 1 image location |
0x1e | UInt16LE | Offset to object 2 image location |
... | UInt16LE | Repeated objNum times |
Object content offsets
From there, there is the list of offsets to each object content:
Location | Format | Data |
---|---|---|
0x1c + objNum * 2 | UInt16LE | Offset to object 1 content location |
0x1e + objNum * 2 | UInt16LE | Offset to object 2 content location |
... | UInt16LE | Repeated objNum times |
Number of boxes
The boxes number in the room is located at the boxes number offset specified in the header.
Location | Format | Data |
---|---|---|
Offset to number of boxes | UInt8 | Number of boxes in room |
Note: Some LFL files have unknown data between the last object content offset and the boxes number offset location. For most file however, both data are contiguous.
Boxes
2 bytes after the offset to number of boxes starts the payload for the boxes. Each box takes 8 bytes described as follow:
Relative location | Format | Data |
---|---|---|
0x00 | UInt8 | uy |
0x01 | UInt8 | ly |
0x02 | UInt8 | ulx |
0x03 | UInt8 | urx |
0x04 | UInt8 | llx |
0x05 | UInt8 | lrx |
0x06 | UInt8 | mask |
0x07 | UInt8 | flags |
Box matrix
Immediately following the last box payload is the box matrix.
There are boxNum * boxNum
number of them read as UInt8.
Object content
Each object have the following structure starting from its matching object content offset:
Relative location | Format | Data |
---|---|---|
0x00 | UInt8 | Size of the object content chunk |
0x02 | ??? | Unknown (Always 0 on NES) |
0x03 | ??? | Unknown (Always 0 on NES) |
0x04 | UInt16LE | The object number id |
0x06 | ?? | Unknown (Always 0 on NES) |
0x07 | UInt8 | X position of object |
0x08 | UInt8 | Y position of object + Object parent state |
0x09 | UInt8 | Object width in tiles |
0x0a | UInt8 | Object parent |
0x0b | UInt8 | Walk to X position |
0x0c | UInt8 | Walk to Y position |
0x0d | UInt8 | Actor facing direction + Object height in tiles |
0x0e | UInt8 | Offset to object name |
The object name starts at specified offset. Each character is added to the buffer until a 0x00 value is found.