LVB

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 zone in the level.

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

Offset	Type	Description
0x0	u32	Zone ID Actors load when entering the specified zone and unload when leaving it.
0x4	float[3]	Position The origin point of the zone.
0x10	float[3]	Scale The size of the zone. Note that these represent the apothem in each direction.
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	Environment This controls the environment for the zone. Example: MysteriousForest These environments are defined in romfs/region_common/kodama/environment.kar

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.
0xC	???	Unkown Unknown. 4 bytes long, possibly a float.

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 first byte determines a property of the level: 0=Default, 1=Cannot use items, 2=Equipment is hidden until used, 3=Overworld camera follow, 4=Special for end cutscene transitions.

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.