Setup Files [Hack64 Wiki]

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
======== Setup Files ========

===== Overall File Structure =====

^ Address ^ Value/Syntax ^ Description ^
| 0x00 | 01 01 | Possibly File Start? |
| | | Voxel Count |
| | | Objects |
| | | Cameras |
| | | Lighting |
| -0x01 | 00 | Possibly File End? |

===== Voxel Count Structure =====

^ Address ^ Value/Syntax ^ Description ^
| 0x00 | <color red>XX XX XX XX</color> | Negative X Voxel Count |
| 0x04 | <color orange>YY YY YY YY</color> | Negative Y Voxel Count |
| 0x08 | <color yellow>ZZ ZZ ZZ ZZ</color> | Negative Z Voxel Count |
| 0x0C | <color green>XX XX XX XX</color> | Positive X Voxel Count |
| 0x10 | <color lightgreen>YY YY YY YY</color> | Positive Y Voxel Count |
| 0x14 | <color cyan>ZZ ZZ ZZ ZZ</color> | Positive Z Voxel Count |


===== Objects Structure =====


==== Voxel Structure ====
^ Address ^ Value/Syntax ^ Description ^
| 0x00 | 03 0A | Indicates The Start Of A Voxel With Objects |
| 0x02 | <color red>NN</color> | Number Of Complex Objects (Objects With 20 Bytes) |
| 0x03 | 0B | Indicates Start Of Complex Object List |
| | | Complex Object List |
| +0x01 | 08 | End Of Complex Object List |
| +0x02 | <color lightblue>NN</color> | Number Of Simple Object List (Objects With 12 Bytes) |
| +0x03 | 09 | If Number Of Simple Objects > 0, Indicates Start Of Simple Object List |
| | | Simple Object List |

''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: [[banjo_kazooie:object_ids]]

==== Known Complex Object Structures ====

=== Actor Structure ===
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.
^ Address ^ Value/Syntax ^ Description ^
| 0x00 | <color red>XX XX</color> | X Position |
| 0x02 | <color orange>YY YY</color> | Y Position |
| 0x04 | <color yellow>ZZ ZZ</color> | Z Position |
| 0x06 | <color green>SS SS</color> | Script Id |
| 0x08 | <color lightgreen>OO OO</color> | Object Id |
| 0x0A | <color gray>UU</color> | Unknown Byte |
| 0x0B | <color gray>UU</color> | Unknown Byte |
| 0x0C | <color cyan>RR</color> | Rotation >> 1 (Y Axis) |
| 0x0D | <color gray>UU</color> | Unknown Byte |
| 0x0E | <color lightblue>SS SS</color> | Size |
| 0x10 | <color violet>CCC</color> <color brown>NNN</color> | Nodes (C=Current, N=Next) |
| 0x13 | 40 | End Of Object Indicator |

=== Timed Structure ===
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.
^ Address ^ Value/Syntax ^ Description ^
| 0x00 | <color red>XX XX</color> | X Position |
| 0x02 | <color orange>YY YY</color> | Y Position |
| 0x04 | <color yellow>ZZ ZZ</color> | Z Position |
| 0x06 | <color green>SS SS</color> | Script Id |
| 0x08 | <color lightgreen>OO OO</color> | Object Id |
| 0x0A | <color gray>UU</color> | Unknown Byte |
| 0x0B | <color gray>UU</color> | Unknown Byte |
| 0x0C | <color cyan>TT</color> | Timer |
| 0x0D | <color gray>UU</color> | Unknown Byte |
| 0x0E | <color lightblue>SS SS</color> | Size |
| 0x10 | <color violet>CCC</color> <color brown>NNN</color> | Nodes (C=Current, N=Next) |
| 0x13 | 40 | End Of Object Indicator |

=== Script Structure ===
Script: Objects that cause another object or set of objects to perform actions.
^ Address ^ Value/Syntax ^ Description ^
| 0x00 | <color red>XX XX</color> | X Position |
| 0x02 | <color orange>YY YY</color> | Y Position |
| 0x04 | <color yellow>ZZ ZZ</color> | Z Position |
| 0x06 | <color green>SS SS</color> | Script Id |
| 0x08 | <color lightgreen>OO OO</color> | Object Id |
| 0x0A | <color gray>UU</color> | Unknown Byte |
| 0x0B | <color gray>UU</color> | Unknown Byte |
| 0x0C | <color gray>UU</color> | Unknown Byte |
| 0x0D | <color gray>UU</color> | Unknown Byte |
| 0x0E | <color gray>UU</color> | Unknown Byte |
| 0x0F | <color gray>UU</color> | Unknown Byte |
| 0x10 | <color cyan>CCC</color> <color lightblue>NNN</color> | Nodes (C=Current, N=Next) |
| 0x13 | 40 | End Of Object Indicator |

=== Radius Structure ===
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)
^ Address ^ Value/Syntax ^ Description ^
| 0x00 | <color red>XX XX</color> | X Position |
| 0x02 | <color orange>YY YY</color> | Y Position |
| 0x04 | <color yellow>ZZ ZZ</color> | Z Position |
| 0x06 | <color green>RR</color> | Radius >> 1 |
| 0x07 | <color lightgreen>OO</color> | Object Id |
| 0x08 | <color cyan>AA AA</color> | Associated Id (For Stuff Like Flags) |
| 0x0A | <color gray>UU</color> | Unknown Byte |
| 0x0B | <color gray>UU</color> | Unknown Byte |
| 0x0C | <color gray>UU</color> | Unknown Byte |
| 0x0D | <color gray>UU</color> | Unknown Byte |
| 0x0E | <color gray>UU</color> | Unknown Byte |
| 0x0F | <color gray>UU</color> | Unknown Byte |
| 0x10 | <color lightblue>CCC</color> <color violet>NNN</color> | Nodes (C=Current, N=Next) |
| 0x13 | 40 | End Of Object Indicator |

==== Known Simple Object Structures ====

=== Sprite Structure ===
Sprites: 2D Objects that will face the camera at all times (aka Billboarding).
^ Address ^ Value/Syntax ^ Description ^
| 0x00 | <color red>OO OO</color> | Object Id |
| 0x02 | <color orange>SS SS</color> | Size |
| 0x04 | <color yellow>XX XX</color> | X Position |
| 0x06 | <color green>YY YY</color> | Y Position |
| 0x08 | <color lightgreen>ZZ ZZ</color> | Z Position |
| 0x0A | <color gray>UU</color> | Unknown Byte |
| 0x0B | <color gray>UU</color> | Unknown Byte |

=== Static Structure ===
Static: Objects that do not change unless given accompanied by a script object.
^ Address ^ Value/Syntax ^ Description ^
| 0x00 | <color red>OO OO</color> | Object Id |
| 0x02 | <color orange>RR</color> | Rotation (Y Axis) |
| 0x03 | <color yellow>RR</color> | Rotation (XZ Axis) |
| 0x04 | <color green>XX XX</color> | X Position |
| 0x06 | <color lightgreen>YY YY</color> | Y Position |
| 0x08 | <color cyan>ZZ ZZ</color> | Z Position |
| 0x0A | <color lightblue>SS</color> | Size |
| 0x0B | <color gray>UU</color> | Unknown Byte |

===== Camera Structure =====

^ Address ^ Value/Syntax ^ Description ^
| 0x00 | 00 03 | Camera Section Start |
| 0x02 | | List Of Cameras |

==== Known Camera Structures ====

=== Camera Type 0 Structure ===
^ Address ^ Value/Syntax ^ Description ^
| 0x00 | 01 | Start Of Camera |
| 0x01 | <color red>II II</color> | Camera Id |
| 0x03 | 02 | Unknown |
| 0x04 | 00 | Camera End |

=== Camera Type 1 Structure ===
^ Address ^ Value/Syntax ^ Description ^
| 0x00 | 01 | Start Of Camera |
| 0x01 | <color red>II II</color> | Camera Id |
| 0x03 | 02 | Unknown |
| 0x04 | 01 | Camera Type |
| 0x05 | 01 | Indicates Section One |
| 0x06 | <color orange>XX XX XX XX</color> | X Position (Float) |
| 0x0A | <color yellow>YY YY YY YY</color> | Y Position (Float) |
| 0x0E | <color green>ZZ ZZ ZZ ZZ</color> | Z Position (Float) |
| 0x12 | 02 | Indicates Section Two |
| 0x13 | <color lightgreen>HH HH HH HH</color> | Horizontal Speed (Float) |
| 0x17 | <color cyan>VV VV VV VV</color> | Vertical Speed (Float) |
| 0x1B | 03 | Indicates Section Three |
| 0x1C | <color lightblue>RR RR RR RR</color> | Rotation (Float) |
| 0x20 | <color blue>AA AA AA AA</color> | Acceleration (Float) |
| 0x24 | 04 | Indicates Section Four |
| 0x25 | <color magenta>PP PP PP PP</color> | Pitch (Float) |
| 0x29 | <color violet>YY YY YY YY</color> | Yaw (Float) |
| 0x2D | <color purple>RR RR RR RR</color> | Roll (Float) |
| 0x31 | 05 | Indicates Section Five |
| 0x32 | <color gray>UU UU UU UU</color> | Unknown (Float) |
| 0x36 | 00 | Camera End |

=== Camera Type 2 Structure ===
^ Address ^ Value/Syntax ^ Description ^
| 0x00 | 01 | Start Of Camera |
| 0x01 | <color red>II II</color> | Camera Id |
| 0x03 | 02 | Unknown |
| 0x04 | 01 | Camera Type |
| 0x05 | 01 | Indicates Section One |
| 0x06 | <color orange>XX XX XX XX</color> | X Position (Float) |
| 0x0A | <color yellow>YY YY YY YY</color> | Y Position (Float) |
| 0x0E | <color green>ZZ ZZ ZZ ZZ</color> | Z Position (Float) |
| 0x12 | 02 | Indicates Section Two |
| 0x13 | <color lightgreen>PP PP PP PP</color> | Pitch (Float) |
| 0x17 | <color cyan>YY YY YY YY</color> | Yaw (Float) |
| 0x1B | <color lightblue>RR RR RR RR</color> | Roll (Float) |
| 0x1F | 00 | Camera End |

=== Camera Type 3 Structure ===
^ Address ^ Value/Syntax ^ Description ^
| 0x00 | 01 | Start Of Camera |
| 0x01 | <color red>II II</color> | Camera Id |
| 0x03 | 02 | Unknown |
| 0x04 | 01 | Camera Type |
| 0x05 | 01 | Indicates Section One |
| 0x06 | <color orange>XX XX XX XX</color> | X Position (Float) |
| 0x0A | <color yellow>YY YY YY YY</color> | Y Position (Float) |
| 0x0E | <color green>ZZ ZZ ZZ ZZ</color> | Z Position (Float) |
| 0x12 | 02 | Indicates Section Two |
| 0x13 | <color lightgreen>HH HH HH HH</color> | Horizontal Speed (Float) |
| 0x17 | <color cyan>VV VV VV VV</color> | Vertical Speed (Float) |
| 0x1B | 03 | Indicates Section Three |
| 0x1C | <color lightblue>RR RR RR RR</color> | Rotation (Float) |
| 0x20 | <color magenta>AA AA AA AA</color> | Acceleration (Float) |
| 0x24 | 04 | Indicates Section Four |
| 0x25 | <color violet>PP PP PP PP</color> | Pitch (Float) |
| 0x29 | <color purple>YY YY YY YY</color> | Yaw (Float) |
| 0x2D | <color brown>RR RR RR RR</color> | Roll (Float) |
| 0x31 | 05 | Indicates Section Five |
| 0x32 | <color gray>UU UU UU UU</color> | Unknown (Float) |
| 0x36 | 06 | Indicates Section Six |
| 0x37 | <color pink>CC CC CC CC</color> | Close Distance (Float) |
| 0x3B | <color maroon>FF FF FF FF</color> | Far Distance (Float) |
| 0x3F | 00 | Camera End |

=== Camera Type 4 Structure ===
^ Address ^ Value/Syntax ^ Description ^
| 0x00 | 01 | Start Of Camera |
| 0x01 | <color red>II II</color> | Camera Id |
| 0x03 | 02 | Unknown |
| 0x04 | 01 | Camera Type |
| 0x05 | 01 | Indicates Section One |
| 0x06 | <color orange>UU UU UU UU</color> | Unknown (Float) |
| 0x0A | 00 | Camera End |

===== Lighting Structure =====

^ Address ^ Value/Syntax ^ Description ^
| 0x00 | 00 04 | Start Of Lighting Section |
| 0x02 | | List Of Lightings |
| -0x01 | | End Of Lighting Section |

==== Lighting Structure ====

^ Address ^ Value/Syntax ^ Description ^
| 0x00 | 01 | Section One Header |
| 0x01 | 02 | Section Two Header |
| 0x02 | <color pink>XX XX XX XX</color> | X Position (Float) |
| 0x06 | <color lightgreen>YY YY YY YY</color> | Y Position (Float) |
| 0x0A | <color cyan>ZZ ZZ ZZ ZZ</color> | Z Position (Float) |
| 0x0E | 03 | Section Three Header |
| 0x0F | <color gray>UU UU UU UU</color> | Unknown (Float) |
| 0x13 | <color gray>UU UU UU UU</color> | Unknown (Float) |
| 0x17 | 04 | Section Four Header |
| 0x18 | 00 00 00 <color red>RR</color> | Red |
| 0x1C | 00 00 00 <color green>GG</color> | Green |
| 0x20 | 00 00 00 <color blue>BB</color> | Blue |
User Tools

Site Tools

Page Tools
