Setup Files

Voxels Are Separated By 0x01. Empty voxels will not have the above after the 0x01

Here are the lists of known objects with their script ids and object ids: Object Ids

Actors: Objects that are given scripts to follow, typically involving multiple states. These will have a 2-byte Object Id and a 2-byte Script Id.

Timed: Objects that perform follow a script, but are limited on how long their use is. These will have a 2-byte Object Id and a 2-byte Script Id.

Script: Objects that cause another object or set of objects to perform actions.

Radius: Objects that trigger when Banjo-Kazooie enter their radius. These will have a 1-byte Object Id and a 2-byte Associated Id (used for flag ids, warp ids, etc)

Sprites: 2D Objects that will face the camera at all times (aka Billboarding). Sprites contain information about their id, RGB values, their scale, whether they are mirrored or not, their position and which “frame”. The sprite id has no offset in it's declaration. However while loading the sprite asset an offset of 0x572 is added on top of the id.

The 12 bytes contain this information in the following parts:

The first 4 bytes contain the object id, RGB, scale and whether the sprite is mirrored or not: The next 6 bytes are 3 s16's to describe the position (XYZ) The last 2 bytes mainly define the frame

Example(s) for the music notes on the shelve in Nabnuts house in autumn:

Bytes in level setup: 0x16 0x40 0x00 0xB4 0x01 0x20 0x01 0x9D 0xFE 0x9B 0x4A 0xF0

First 4 bytes are 0x16 0x40 0x00 0xB4 in hex or 00010110 01000000 00000000 10110100 in binary

• 0x164 = object id = Music Note (0x6D6 with offset)
• 0b0 = padding
• 0b000 = RGB red
• 0b000 = RGB green
• 0b000 = RGB blue
• 0b00101101 = scale
• 0b0 = is mirrored
• 0b0 = padding

Next 6 bytes are the position:

• 0x0120 = X = 288
• 0x019D = Y = 413
• 0xFE9B = Z = -357

Last 2 bytes are 0x4A 0xF0 in hex or 01001010 11110000 in binary

• 0b01001 = frame
• 0b010111100 = padding
• 0b0 = isModelProp → This is false for all “Sprite structures”
• 0b0 = isActorProp → This is false for all “Simple Object structures”

Bytes in level setup: 0x16 0x40 0x00 0xB6 0x01 0x7E 0x01 0x9D 0xFE 0xD8 0x21 0x10

First 4 bytes are 0x16 0x40 0x00 0xB6 in hex or 00010110 01000000 00000000 10110110 in binary

• 0x164 = object id = Music Note
• 0b0 = padding
• 0b000 = RGB red
• 0b000 = RGB green
• 0b000 = RGB blue
• 0b00101101 = scale
• 0b1 = is mirrored
• 0b0 = padding

Next 6 bytes are the position:

• 0x017E = X = 382
• 0x019D = Y = 413
• 0xFED8 = Z = -296

Last 2 bytes are 0x21 0x10 in hex or 00100001 00010000 in binary

• 0b001000 = frame
• 0b01000100 = padding
• 0b0 = isModelProp → This is false for all “Sprite structures”
• 0b0 = isActorProp → This is false for all “Simple Object structures”

Bytes in level setup: 0x16 0x40 0x00 0xB4 0x01 0xD7 0x01 0x9D 0xFF 0x15 0x1D 0xD0

First 4 bytes are 0x16 0x40 0x00 0xB4 in hex or 00010110 01000000 00000000 10110100 in binary

• 0x164 = object id = Music Note
• 0b0 = padding
• 0b000 = RGB red
• 0b000 = RGB green
• 0b000 = RGB blue
• 0b00101101 = scale
• 0b0 = is mirrored
• 0b0 = padding

Next 6 bytes are the position:

• 0x01D7 = X = 471
• 0x019D = Y = 413
• 0xFF15 = Z = -235

Last 2 bytes are 0x1D 0xD0 in hex or 00011101 11010000 in binary

• 0b000111 = frame
• 0b01110100 = padding
• 0b0 = isModelProp → This is false for all “Sprite structures”
• 0b0 = isActorProp → This is false for all “Simple Object structures”

Models: Objects that have a model ID associated with it which are placed in the map. The Model ID has no offset in it's declaration. However while loading the model asset an offset of 0x2D1 is added to the id.

The 12 bytes contain this information in the following parts:

The first 12 bits are the model id padded with 4 bits to create 2 byte. The next 6 bytes are 3 s16's to describe the position (XYZ) The last 2 bytes mainly define the scale of the model

Example(s) for the dust bins next to banjos house in Spiral Mountain:

Bytes in level setup: 0x01, 0xC4, 0x01, 0x2B, 0x13, 0x02, 0xFE, 0x30, 0x1A, 0xE9, 0x32, 0xD2

First 2 bytes are 0x01 0xC4 in hex or 00000001 11000100 in binary

• 0x1C = model id = Dust bin (0x2ED with offset)
• 0b0100 = padding

Next 2 bytes are pitch and roll which are used for the rotation of the model:

• 0x01 = Pitch
• 0x2B = Roll

Next 6 bytes are the position:

• 0x1302 = X = 4866
• 0xFE30 = Y = -464
• 0x1AE9 = Z = 6889

The last 2 bytes contain the scale and padding bits:

• 0x32 = scale (50)
• 0b110100 = padding
• 0b1 = isModelProp ⇒ This is true for all “Model structures”
• 0b0 = isActorProp ⇒ This is false for all “Simple Object structures”

Bytes in level setup: 0x01, 0xC4, 0x41, 0x00, 0x12, 0x81, 0xFE, 0x11, 0x1A, 0x3A, 0x32, 0x52

First 2 bytes are 0x01 0xC4 in hex or 00000001 11000100 in binary

• 0x1C = model id = Dust bin (0x2ED with offset)
• 0b0100 = padding

Next 2 bytes are pitch and roll which are used for the rotation of the model:

• 0x41 = Pitch
• 0x00 = Roll

Next 6 bytes are the position:

• 0x1281 = X = 4737
• 0xFE11 = Y = -495
• 0x1A3A = Z = 6714

The last 2 bytes contain the scale and padding bits:

• 0x32 = scale (50)
• 0b010100 = padding
• 0b1 = isModelProp ⇒ This is true for all “Model structures”
• 0b0 = isActorProp ⇒ This is false for all “Simple Object structures”

Bytes in level setup: 0x01, 0xC4, 0x00, 0x01, 0x12, 0x3A, 0xFE, 0x0E, 0x1A, 0xF0, 0x32, 0xD2

First 2 bytes are 0x01 0xC4 in hex or 00000001 11000100 in binary

• 0x1C = model id = Dust bin (0x2ED with offset)
• 0b0100 = padding

Next 2 bytes are pitch and roll which are used for the rotation of the model:

• 0x00 = Pitch
• 0x01 = Roll

Next 6 bytes are the position:

• 0x123A = X = 4666
• 0xFE0E = Y = -498
• 0x1AF0 = Z = 6896

The last 2 bytes contain the scale and padding bits:

• 0x32 = scale (50)
• 0b110100 = padding
• 0b1 = isModelProp ⇒ This is true for all “Model structures”
• 0b0 = isActorProp ⇒ This is false for all “Simple Object structures”