LVB is a custom format used to store level data in Link's Awakening. This includes things such as the rooms IDs, a list of tagPlayerStart actors, and more. This format is still in the process of being reverse engineered and so this page is currently incomplete.

Note that many properties in these files define measurements in 3D space (X, Y, Z). X is horizontal across the screen, Y is perpendicular to the ground (the axis on which gravity acts), and Z is vertical across the screen.

Format

LVB files are in a FixedHash format

Entries

There are 8 entries in most LVB files.

Node Section

This is a FixedHashed child. Not yet understood.

Area Section

This is a FixedHashed child. Not yet understood.

Zone Section

This is a FixedHashed child. It contains an entry for each room where a room is defined by the camera bounds. As such, this likely defines the actual properties of each room. These all seem to be consistent with the exception being Field, which contains several entries and different room IDs. It appears to define each region instead.

The music strings are padded with null bytes to fit 32 bytes.

Offset Type Description
0x0 u32 Room ID Actors load when entering the specified room and unload when leaving it. Generally this should be consistent across all actors in the file, since each room has its own file.
0x3C String BGM Defines which background music to play. Example: BGM_CAVE
0x5C String SE_AMB Defines which sound effect ambience to play. Example: SE_AMB_DUNGEON1_BG
0x7C String GROUP_AMB Defines which group ambience to play. Example: GROUP_AMB_DUNGEON1
0xB0 String ROOM TYPE? Unknown what this means. Example: DungeonSmall

tagPlayerStart Section

This is a FixedHashed child. There is an entry for every tagPlayerStart actor, with the entry name being the room.

Offset Type Description
0x0 float[3] Co-ordinates as [X, Y, Z]. One in-game "tile" is 1.5 units.

The co-ordinate system spans entire maps and is not specific to each room. [0, 0, 0] is the very top left corner of the map, at the elevation of the main floor plane of the map.

Each room is 10x8 tiles, so they span 15 units along the X axis and 12 along the Z axis.

staticObject Section

This is a FixedHashed child. Not yet understood.

Condition Section

Not yet understood.

Config Section

Holds 7 bytes of data that define properties of the level. The last 5 bytes always seem to be x00\x00\x00\x00\xff. Only the first 2 bytes ever seem to change. The second byte is a flag for determining if companions like BowWow will load

Version Section

Holds 3 bytes of data, which seem to always be 0x100182. Given the name, it's probably just a version marker and has no functional purpose.