User Tools
Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision | ||
|
sm64:level_commands [2016/06/05 03:59] david [28: Transport Mario] |
— (current) | ||
|---|---|---|---|
| Line 1: | Line 1: | ||
| - | ======== Level Commands ======== | ||
| - | The level commands define the top-level control of the game. They are used to load levels, textures, collision data, objects, warps, etc. and determine how everything is connected. The first byte of the level command is the command type and the second byte is the length of the command in bytes. | ||
| - | |||
| - | ''[<color darkred>CC</color>] [<color darkgreen>LL</color>] ...'' | ||
| - | |||
| - | | <color darkred>C</color> | Command type (full list below) | | ||
| - | | <color darkgreen>L</color> | Length of command in bytes (including <color darkred>CC</color> and <color darkgreen>LL</color>) | | ||
| - | ===== Level Layout Commands ===== | ||
| - | ==== 00: Load Raw Data and Jump ==== | ||
| - | Loads raw data to RAM segment and jumps to segment offset. Used for loading level scripts and then jumping to an offset in them | ||
| - | |||
| - | ''00 10 00 [<color darkred>XX</color>] [<color darkgreen>YY YY YY YY</color>] [<color darkblue>ZZ ZZ ZZ ZZ</color>] [<color purple>AA AA AA AA</color>]'' | ||
| - | |||
| - | | <color darkred>X</color> | RAM segment number | | ||
| - | | <color darkgreen>Y</color> | ROM address start | | ||
| - | | <color darkblue>Z</color> | ROM address end | | ||
| - | | <color purple>A</color> | Segment offset of jump target | | ||
| - | |||
| - | ---- | ||
| - | |||
| - | ==== 01: Load Raw Data and Jump ==== | ||
| - | |||
| - | Load raw data to RAM segment and jump to segment offset. The only difference between this command and 0x00 is a call to 0x80278498 | ||
| - | |||
| - | ''01 10 00 [<color darkred>XX</color>] [<color darkgreen>YY YY YY YY</color>] [<color darkblue>ZZ ZZ ZZ ZZ</color>] [<color purple>AA AA AA AA</color>]'' | ||
| - | |||
| - | | <color darkred>X</color> | RAM segment number | | ||
| - | | <color darkgreen>Y</color> | ROM address start | | ||
| - | | <color darkblue>Z</color> | ROM address end | | ||
| - | | <color purple>A</color> | Segment offset of jump target | | ||
| - | |||
| - | ---- | ||
| - | |||
| - | ==== 02: End Level Data ==== | ||
| - | End of level layout data. Typically followed by null padding. | ||
| - | |||
| - | ''02 04 00 00'' | ||
| - | |||
| - | ---- | ||
| - | |||
| - | ==== 03: Delay Frames ==== | ||
| - | Set flag to 0, delay X frames, set flag to 1. Sets s16 flag (8038BE20) to 0 before delay and 1 after. Does not increment level script pointer until after delay. | ||
| - | |||
| - | ''03 04 [<color darkred>XX XX</color>]'' | ||
| - | |||
| - | | <color darkred>X</color> | number of delay frames | | ||
| - | |||
| - | ---- | ||
| - | |||
| - | ==== 04: Delay Frames 2 ==== | ||
| - | Set flag to -1, delay X frames, set flag to 1. | ||
| - | Identical to 0x03, except for flag set at start: | ||
| - | sets s16 flag (8038BE20) to -1 before delay and 1 after. | ||
| - | Does not increment level pointer until after delay. | ||
| - | |||
| - | ''04 04 [<color darkred>XX XX</color>]'' | ||
| - | |||
| - | | <color darkred>X</color> | number of delay frames | | ||
| - | |||
| - | ---- | ||
| - | |||
| - | ==== 05: Jump to Address ==== | ||
| - | Jump to level script at segmented address. | ||
| - | |||
| - | ''05 08 00 00 [<color darkred>XX XX XX XX</color>]'' | ||
| - | |||
| - | | <color darkred>X</color> | segmented address of jump | | ||
| - | |||
| - | ---- | ||
| - | |||
| - | ==== 06: Push Stack ==== | ||
| - | Push script stack and jump to level script at segmented address. | ||
| - | Similar to 05, but also pushes current place on script stack so it can be popped later. | ||
| - | |||
| - | ''06 08 00 00 [<color darkred>XX XX XX XX</color>]'' | ||
| - | |||
| - | | <color darkred>X</color> | segmented address of jump | | ||
| - | |||
| - | ---- | ||
| - | |||
| - | ==== 07: Pop Stack ==== | ||
| - | Pop script stack, returns to where previous 06 or 0C pushed from. | ||
| - | |||
| - | ''07 04 00 00'' | ||
| - | |||
| - | ---- | ||
| - | |||
| - | ==== 08: Push Stack + 16 ==== | ||
| - | Push script stack and 16-bit value on stack. | ||
| - | This command is never used in any of the level scripts. | ||
| - | |||
| - | ''08 04 [<color darkred>XX XX</color>]'' | ||
| - | |||
| - | | <color darkred>X</color> | 16 bit value pushed on script stack after current address | | ||
| - | |||
| - | ---- | ||
| - | |||
| - | ==== 09: Pop Stack + 16 ==== | ||
| - | Pops script stack and param (possibly from previous 08 or 0A). | ||
| - | This command is never used in any of the level scripts. | ||
| - | |||
| - | ''09 04 00 00'' | ||
| - | |||
| - | ---- | ||
| - | |||
| - | ==== 0A: Push Script + 0x00 ==== | ||
| - | |||
| - | Pushes next level command on script stack and param 0x00000000. | ||
| - | This command is only used once in main level scripts. | ||
| - | |||
| - | ''0A 04 00 00'' | ||
| - | |||
| - | ---- | ||
| - | |||
| - | ==== 0B: Conditional Pop ==== | ||
| - | If result of operation is true, pop stack. | ||
| - | This command is only used once in main level scripts. | ||
| - | |||
| - | ''0B 08 [<color darkred>XX</color>] 00 [<color darkgreen>YY YY YY YY</color>]'' | ||
| - | |||
| - | | <color darkred>X</color> | operation, a0 to 8037E1A0 (unsigned 8) | | ||
| - | | <color darkgreen>Y</color> | argument, a1 to 8037E1A0 (signed 32) | | ||
| - | |||
| - | ^ Operations ^^ | ||
| - | | 0 | script_accum & argument | | ||
| - | | 1 | !(script_accum & argument) | | ||
| - | | 2 | script_accum == argument | | ||
| - | | 3 | script_accum != argument | | ||
| - | | 4 | script_accum < argument | | ||
| - | | 5 | script_accum <= argument | | ||
| - | | 6 | script_accum > argument | | ||
| - | | 7 | script_accum >= argument | | ||
| - | |||
| - | ---- | ||
| - | |||
| - | ==== 0C: Conditional Jump ==== | ||
| - | If result of operation is true, jumps to segmented address. | ||
| - | |||
| - | ''0C 0C [<color darkred>XX</color>] 00 [<color darkgreen>YY YY YY YY</color>] [<color darkblue>ZZ ZZ ZZ ZZ</color>]'' | ||
| - | |||
| - | | <color darkred>X</color> | operation, a0 to 8037E1A0 (unsigned 8). See [[#0B: Conditional Pop]] for valid operations | | ||
| - | | <color darkgreen>Y</color> | argument, a1 to 8037E1A0 (signed 32) | | ||
| - | | <color darkblue>Z</color> | segment address of jump | | ||
| - | |||
| - | ---- | ||
| - | |||
| - | ==== 0D: Conditional Push ==== | ||
| - | If result of operation is true, pushes next command on stack and jumps to segmented address | ||
| - | This command is never used in any of the level scripts. | ||
| - | |||
| - | ''0D 08 [<color darkred>XX</color>] 00 [<color darkgreen>YY YY YY YY</color>]'' | ||
| - | |||
| - | | <color darkred>X</color> | operation, a0 to 8037E1A0 (unsigned 8). See [[#0B: Conditional Pop]] for valid operations | | ||
| - | | <color darkgreen>Y</color> | argument, a1 to 8037E1A0 (signed 32) | | ||
| - | |||
| - | ---- | ||
| - | |||
| - | ==== 0E: Conditional Skip ==== | ||
| - | If result of operation is false, skips over following 0x0F, 0x10 commands. | ||
| - | This command is never used in any of the level scripts. | ||
| - | |||
| - | ''0E 08 [<color darkred>XX</color>] 00 [<color darkgreen>YY YY YY YY</color>]'' | ||
| - | |||
| - | | <color darkred>X</color> | operation, a0 to 8037E1A0 (unsigned 8). See [[#0B: Conditional Pop]] for valid operations | | ||
| - | | <color darkgreen>Y</color> | argument, a1 to 8037E1A0 (signed 32) | | ||
| - | |||
| - | |||
| - | ---- | ||
| - | |||
| - | ==== 0F: Skip Next ==== | ||
| - | Skips over the following 0x10 commands. | ||
| - | This command is never used in any of the level scripts. | ||
| - | |||
| - | ''0F 04 00 00'' | ||
| - | |||
| - | ---- | ||
| - | |||
| - | ==== 10: No Operation ==== | ||
| - | Doesn't do anything, nop. | ||
| - | This command is never used in any of the level scripts. | ||
| - | |||
| - | ''10 04 00 00'' | ||
| - | |||
| - | ---- | ||
| - | |||
| - | ==== 11: Set Accumulator From ASM ==== | ||
| - | Set level accumulator (8038BE24) from assembly routine. | ||
| - | |||
| - | ''11 08 [<color darkred>XX XX</color>] [<color darkgreen>YY YY YY YY</color>]'' | ||
| - | |||
| - | | <color darkred>X</color> | A0 value passed to function <color darkgreen>Y</color> | | ||
| - | | <color darkgreen>Y</color> | Assembly routine of format ''u32 func(u32 a0, u16 A1)'' | | ||
| - | |||
| - | Call assembly routine Y (A0 = halfword X, A1 = word from 0x8038BE24). | ||
| - | Store return value at 0x8038BE24. | ||
| - | |||
| - | | Game startup | 8016F5B0 | | ||
| - | | File select | 801766DC | | ||
| - | | File select -> Castle grounds | 8024BD5C | | ||
| - | | Other levels | 8024BE14, 8024BCD8 | | ||
| - | |||
| - | ---- | ||
| - | |||
| - | ==== 12: Actively Set Accumulator ==== | ||
| - | |||
| - | ''12 08 [<color darkred>XX XX</color>] [<color darkgreen>YY YY YY YY</color>]'' | ||
| - | |||
| - | | <color darkred>X</color> | A0 value passed to function <color darkgreen>Y</color> | | ||
| - | | <color darkgreen>Y</color> | Assembly routine of format ''u32 func(u32 a0, u16 A1)'' | | ||
| - | |||
| - | Call assembly routine Y (A0 = halfword X, A1 = word from 0x8038BE24). | ||
| - | Store return value at 0x8038BE24. | ||
| - | If return value is 0, set upper halfword @ 0x8039BE20 = 0 and do not continue to next command. | ||
| - | Else, set upper halfword @ 0x8039BE20 = 1 and continue to the next command. | ||
| - | |||
| - | | Demo screen | 8016F5B0 | | ||
| - | | File select | 801768A0 | | ||
| - | | Other levels | 8024BCD8 | | ||
| - | |||
| - | ---- | ||
| - | |||
| - | ==== 13: Set Accumulator ==== | ||
| - | Set level accumulator (8038BE24) to constant value. | ||
| - | |||
| - | ''13 04 [<color darkred>XX XX</color>]'' | ||
| - | |||
| - | | <color darkred>X</color> | Value to set level accumulator | | ||
| - | |||
| - | ---- | ||
| - | |||
| - | ==== 14: Push Pool State ==== | ||
| - | Calls PushPoolState/802783E8 and returns. | ||
| - | This command is never used in any of the level scripts. | ||
| - | |||
| - | ''14 04 00 00'' | ||
| - | |||
| - | ---- | ||
| - | |||
| - | ==== 15: Pop Pool State ==== | ||
| - | Calls PopPoolState/80278498 and returns. | ||
| - | This command is never used in any of the level scripts. | ||
| - | |||
| - | ''15 04 00 00'' | ||
| - | |||
| - | ---- | ||
| - | |||
| - | ==== 16: Load ROM to RAM ==== | ||
| - | Load raw data from ROM to absolute RAM address. Call 0x802786F0 (A0 = X, A1 = Y, A2 = Z) | ||
| - | |||
| - | ''16 10 00 00 [<color darkred>XX XX XX XX</color>] [<color darkgreen>YY YY YY YY</color>] [<color darkblue>ZZ ZZ ZZ ZZ</color>]'' | ||
| - | |||
| - | | <color darkred>X</color> | RAM address | | ||
| - | | <color darkgreen>Y</color> | ROM address start | | ||
| - | | <color darkblue>Z</color> | ROM address end | | ||
| - | |||
| - | ---- | ||
| - | |||
| - | ==== 17: Load ROM to Segment ==== | ||
| - | Load raw data from ROM to RAM segment. | ||
| - | |||
| - | ''17 0C 00 [<color darkred>XX</color>] [<color darkgreen>YY YY YY YY</color>] [<color darkblue>ZZ ZZ ZZ ZZ</color>]'' | ||
| - | |||
| - | | <color darkred>X</color> | RAM segment number | | ||
| - | | <color darkgreen>Y</color> | ROM address start | | ||
| - | | <color darkblue>Z</color> | ROM address end | | ||
| - | |||
| - | ---- | ||
| - | |||
| - | ==== 18: Decompress MIO0 to Segment ==== | ||
| - | Load and decompress MIO0 data from ROM to RAM segment. | ||
| - | |||
| - | ''18 0C 00 [<color darkred>XX</color>] [<color darkgreen>YY YY YY YY</color>] [<color darkblue>ZZ ZZ ZZ ZZ</color>]'' | ||
| - | |||
| - | | <color darkred>X</color> | RAM segment number | | ||
| - | | <color darkgreen>Y</color> | ROM address start | | ||
| - | | <color darkblue>Z</color> | ROM address end | | ||
| - | |||
| - | ---- | ||
| - | |||
| - | ==== 19: Create Mario Demo ==== | ||
| - | Create Mario face for the demo screen. | ||
| - | |||
| - | ''19 04 00 [<color darkred>XX</color>]'' | ||
| - | |||
| - | | <color darkred>X</color> | Settings: 01 No face, 02 Regular face, 03 Game over face | | ||
| - | |||
| - | Call 0x80278120 (A0 = 0x000E1000, A1 = 0); allocate 0xE1000 bytes for mario face settings | ||
| - | If allocation was successful: | ||
| - | Call 0x8019C450(A0 = 0x000E1000, A1 = pointer to allocated area in ram) | ||
| - | Call 0x8019C418(A0 = 0x80000400, A1 = 0x00025800) | ||
| - | Call 0x8019C418(A0 = 0x8039F800, A1 = 0x00070800) | ||
| - | Call 0x8019C4EC ; data gets loaded into 80000400 and 8039F800 after this call | ||
| - | Call 0x8019C684(A0 = X) | ||
| - | |||
| - | ---- | ||
| - | |||
| - | ==== 1A: Decompress MIO0 Textures ==== | ||
| - | Load and decompress MIO0 data from ROM to RAM segment (level terrain textures) | ||
| - | |||
| - | ''1A 0C 00 [<color darkred>XX</color>] [<color darkgreen>YY YY YY YY</color>] [<color darkblue>ZZ ZZ ZZ ZZ</color>]'' | ||
| - | |||
| - | | <color darkred>X</color> | RAM segment number | | ||
| - | | <color darkgreen>Y</color> | ROM address start | | ||
| - | | <color darkblue>Z</color> | ROM address end | | ||
| - | |||
| - | ---- | ||
| - | |||
| - | ==== 1B: Start Load Sequence ==== | ||
| - | Start load sequence. Used before a chain of load commands. | ||
| - | |||
| - | ''1B 04 00 00'' | ||
| - | |||
| - | ---- | ||
| - | |||
| - | ==== 1C: ?? ==== | ||
| - | Always follows 0x12 command. Used near end of level layout. | ||
| - | |||
| - | ''1C 04 00 00'' | ||
| - | |||
| - | ---- | ||
| - | |||
| - | ==== 1D: End Load Sequence ==== | ||
| - | Used after a chain of load commands. | ||
| - | |||
| - | ''1D 04 00 00'' | ||
| - | |||
| - | ---- | ||
| - | |||
| - | ==== 1E: ?? ==== | ||
| - | Command used near the end of level layout. Maybe builds level collision? | ||
| - | |||
| - | ''1E 04 00 00'' | ||
| - | |||
| - | ---- | ||
| - | |||
| - | ==== 1F: Start Area ==== | ||
| - | Start of an area. | ||
| - | |||
| - | ''1F 08 [<color darkred>XX</color>] 00 [<color darkgreen>YY YY YY YY</color>]'' | ||
| - | |||
| - | | <color darkred>X</color> | Area number | | ||
| - | | <color darkgreen>Y</color> | Segment offset address of geometry layout | | ||
| - | |||
| - | ---- | ||
| - | |||
| - | ==== 20: End Area ==== | ||
| - | End of an area. | ||
| - | |||
| - | ''20 04 00 00'' | ||
| - | |||
| - | ---- | ||
| - | |||
| - | ==== 21: Load Polygon Without Geo ==== | ||
| - | Load polygon data without geometry layout. | ||
| - | |||
| - | ''21 08 [<color darkred>X</color>]0 [<color darkgreen>YY</color>] [<color darkblue>ZZ ZZ ZZ ZZ</color>]'' | ||
| - | |||
| - | | <color darkred>X</color> | Drawing layer | | ||
| - | | <color darkgreen>Y</color> | ID of the model to be used with 3D objects | | ||
| - | | <color darkblue>Z</color> | Segment offset address | | ||
| - | |||
| - | ---- | ||
| - | |||
| - | ==== 22: Load Polygon With Geo ==== | ||
| - | Load polygon data with geometry layout. | ||
| - | |||
| - | ''22 08 00 [<color darkred>XX</color>] [<color darkgreen>YY YY YY YY</color>]'' | ||
| - | |||
| - | | <color darkred>X</color> | ID of the model to be used with 3D objects | | ||
| - | | <color darkgreen>Y</color> | Segment offset address | | ||
| - | |||
| - | ---- | ||
| - | |||
| - | ==== 23: ?? ==== | ||
| - | Unknown. | ||
| - | This command is never used in any of the level scripts. | ||
| - | |||
| - | ''23 0C [<color red>A</color>][<color green>B BB</color>] [<color blue>CC CC CC CC</color>] [<color purple>DD DD DD DD</color>]'' | ||
| - | |||
| - | | <color red>A</color> | most significant nibble of third byte | | ||
| - | | <color green>B</color> | 3 least significant nibbles of first word | | ||
| - | | <color blue>C</color> | word | | ||
| - | | <color purple>D</color> | float? | | ||
| - | |||
| - | <code c> | ||
| - | (short)sp[0x2a] = (short)8038be28[2] & 0xFFF; // B | ||
| - | (short)sp[0x28] = (short)8038be28[2] >> 12; // A | ||
| - | sp[0x24] = (int)8038be28[4]; // C | ||
| - | sp[0x2C] = (int)8038be28[8]; // D | ||
| - | if (sp[0x2a] < 0x100) { | ||
| - | f4 = sp[0x2C]; | ||
| - | v0 = 8037B940(*0x8038b8a0, 0, sp[0x28], sp[0x24], f4); | ||
| - | // t8 = sp[0x2a]; t7 = *0x8032ddc4; t9 = t8 << 2; t0 = t7 + t9; | ||
| - | t0 = *0x8032ddc4 + sp[0x2a] * 4; | ||
| - | *t0 = v0; | ||
| - | } | ||
| - | *0x8038be28 = *0x8038be28 + 8038be28[1]; // advance to next level command | ||
| - | </code> | ||
| - | ---- | ||
| - | ==== 24: Place Object ==== | ||
| - | Places a 3D object in the level. | ||
| - | |||
| - | ''24 18 [<color purple>AA</color>] [<color darkgray>ID</color>] [<color darkred>XX XX</color>] [<color darkgreen>YY YY</color>] [<color darkblue>ZZ ZZ</color>] [<color red>RX RX</color>] [<color green>RY RY</color>] [<color blue>RZ RZ</color>] [<color goldenrod>B1 B1</color>] [<color brown>B2 B2</color>] [<color darkcyan>BS BS BS BS</color>]'' | ||
| - | |||
| - | | <color purple>AA</color> | Act mask in which this object will appear in | | ||
| - | | <color darkgray>ID</color> | ID of the model to use for this object (defined by [[#21: Load Polygon Without Geo]] and [[#22: Load Polygon With Geo]]) | | ||
| - | | <color darkred>XX</color> | X position of object (s16) | | ||
| - | | <color darkgreen>YY</color> | Y position of object (s16) | | ||
| - | | <color darkblue>ZZ</color> | Z position of object (s16) | | ||
| - | | <color red>RX</color> | Rotation across X axis in degrees (s16) | | ||
| - | | <color green>RY</color> | Rotation across Y axis in degrees (s16) | | ||
| - | | <color blue>RZ</color> | Rotation across Z axis in degrees (s16) | | ||
| - | | <color goldenrod>B1</color> | Behavior parameter 1 (object->0x144)| | ||
| - | | <color brown>B2</color> | Behavior parameter 2 (object->0x188) | | ||
| - | | <color darkcyan>BS</color> | RAM segment address for behavior script | | ||
| - | |||
| - | ---- | ||
| - | |||
| - | ==== 25: Load Mario ==== | ||
| - | Loads the Mario object. | ||
| - | |||
| - | ''25 0C 00 [<color darkred>XX</color>] [<color darkgreen>YY YY YY YY</color>] [<color darkblue>ZZ ZZ ZZ ZZ</color>]'' | ||
| - | |||
| - | Always: ''25 0C 00 [<color darkred>01</color>] [<color darkgreen>00 00 00 01</color>] [<color darkblue>13 00 2E C0</color>]'' | ||
| - | |||
| - | | <color darkred>X</color> | ID of the model to use for Mario (defined by [[#21: Load Polygon Without Geo]] and [[#22: Load Polygon With Geo]]) | | ||
| - | | <color darkgreen>Y</color> | Some parameters, not sure what they do. | | ||
| - | | <color darkblue>Z</color> | RAM segment for behavior script | | ||
| - | |||
| - | ---- | ||
| - | |||
| - | ==== 26: Connect Warps ==== | ||
| - | Connect warps defined by previous [[#24: Place Object]] commands. | ||
| - | |||
| - | ''26 08 [<color red>AA</color>] [<color green>BB</color>] [<color blue>CC</color>] [<color purple>DD</color>] 00 00'' | ||
| - | |||
| - | | <color red>A</color> | Warp ID to jump from (defined by [[#21: Load Polygon Without Geo]] and [[#22: Load Polygon With Geo]]) | | ||
| - | | <color green>B</color> | Course ID number to warp to | | ||
| - | | <color blue>C</color> | Course area to jump to | | ||
| - | | <color purple>D</color> | Warp ID number in destination level area | | ||
| - | |||
| - | ---- | ||
| - | |||
| - | ==== 27: Painting Warp ==== | ||
| - | Define level warps for paintings inside the Castle. | ||
| - | |||
| - | ''27 08 [<color red>AA</color>] [<color green>BB</color>] [<color blue>CC</color>] [<color purple>DD</color>] 00 00'' | ||
| - | |||
| - | | <color red>A</color> | Warp ID to jump from (defined by [[#21: Load Polygon Without Geo]] and [[#22: Load Polygon With Geo]]) | | ||
| - | | <color green>B</color> | Course ID number to warp to | | ||
| - | | <color blue>C</color> | Course area to jump to | | ||
| - | | <color purple>D</color> | Warp ID number in destination level area | | ||
| - | |||
| - | ---- | ||
| - | |||
| - | ==== 28: Setup instant area warp ==== | ||
| - | Allows Mario to be instantly teleported to another area within the current world. The teleport to an area is triggered by the collision IDs 0x1B to 0x1E. | ||
| - | |||
| - | ''28 0C [<color darkcyan>??</color>] [<color purple>AA</color>] [<color darkred>XX XX</color>] [<color darkgreen>YY YY</color>] [<color darkblue>ZZ ZZ</color>] 00 00'' | ||
| - | |||
| - | | <color darkcyan>??</color> | (Course area # to go to) - 1? | | ||
| - | | <color purple>A</color> | Course area # to go to | | ||
| - | | <color darkred>X</color> | Teleport Mario by this amount on the X axis (s16) | | ||
| - | | <color darkgreen>Y</color> | Teleport Mario by this amount on the Y axis (s16) | | ||
| - | | <color darkblue>Z</color> | Teleport Mario by this amount on the Z axis (s16) | | ||
| - | |||
| - | Teleporting between 4 areas example: | ||
| - | (In area 1 level script) | ||
| - | Warp to area 2 (Collision 0x1C): [ 28 0C 01 02 XX XX YY YY ZZ ZZ 00 00 ] | ||
| - | |||
| - | (In area 2 level script) | ||
| - | Warp to area 1 (Collision 0x1B): [ 28 0C 00 01 XX XX YY YY ZZ ZZ 00 00 ] | ||
| - | Warp to area 3 (Collision 0x1D): [ 28 0C 02 03 XX XX YY YY ZZ ZZ 00 00 ] | ||
| - | |||
| - | (In area 3 level script) | ||
| - | Warp to area 2 (Collision 0x1C): [ 28 0C 01 02 XX XX YY YY ZZ ZZ 00 00 ] | ||
| - | Warp to area 4 (Collision 0x1E): [ 28 0C 03 04 XX XX YY YY ZZ ZZ 00 00 ] | ||
| - | |||
| - | (In area 4 level script) | ||
| - | Warp to area 3 (Collision 0x1D): [ 28 0C 02 03 XX XX YY YY ZZ ZZ 00 00 ] | ||
| - | |||
| - | ---- | ||
| - | |||
| - | ==== 29: ?? ==== | ||
| - | |||
| - | ---- | ||
| - | |||
| - | ==== 2A: ?? ==== | ||
| - | |||
| - | ''2A 04 00 00'' | ||
| - | ---- | ||
| - | |||
| - | ==== 0x2B: Set Mario's default position in the level ==== | ||
| - | 2B 0C [AA] 00 [RY RY] [XX XX] [YY YY] [ZZ ZZ] | ||
| - | |||
| - | |||
| - | |||
| - | |||
| - | Y = Y position of Mario (Signed 16-bits) | ||
| - | Z = Z position of Mario (Signed 16-bits) | ||
| - | | AA | Starting course area number | | ||
| - | | RY RY | Rotation across Y axis (Signed 16-bits)| | ||
| - | | X | X position of Mario (Signed 16-bits) | | ||
| - | | Y | Y position of Mario (Signed 16-bits) | | ||
| - | | Z | Z position of Mario (Signed 16-bits) | | ||
| - | ==== 2C: ?? ==== | ||
| - | ''2C 04 00 00'' | ||
| - | |||
| - | ---- | ||
| - | |||
| - | ==== 2D: ?? ==== | ||
| - | ''2D 04 00 00'' | ||
| - | |||
| - | ---- | ||
| - | |||
| - | ==== 2E: Load Collision ==== | ||
| - | Loads terrain collision data for level, and other special models to be placed in the level. | ||
| - | |||
| - | ''2E 08 00 00 [<color darkred>XX XX XX XX</color>]'' | ||
| - | |||
| - | | <color darkred>X</color> | Segmented address of [[Collision Data]] | | ||
| - | |||
| - | ---- | ||
| - | |||
| - | ==== 2F: Render Area?? ==== | ||
| - | Decides which area of the level geometry to render. Used in BBH, HMC, and Inside Castle levels. | ||
| - | |||
| - | ''2F 08 00 00 [<color darkred>XX XX XX XX</color>]'' | ||
| - | |||
| - | | <color darkred>X</color> | Segment offset pointer to ?? | | ||
| - | |||
| - | ---- | ||
| - | |||
| - | ==== 30: Show dialog ==== | ||
| - | Shows a dialog at the beginning of a level. Ignored if the value at 0x8038B8AC equals -1 or XX > 1. | ||
| - | |||
| - | ''30 04 [<color darkred>XX</color>] [<color darkgreen>YY</color>]'' | ||
| - | |||
| - | | <color darkred>X</color> | Always 00? | | ||
| - | | <color darkgreen>Y</color> | Dialog ID | | ||
| - | |||
| - | Examples: | ||
| - | [ 30 04 00 00 ] # Bob-Omb's Battlefield | ||
| - | [ 30 04 00 1E ] # Whomp's Fortress | ||
| - | [ 30 04 00 5A ] # Bowser 1 Course | ||
| - | [ 30 04 00 81 ] # Vanish Cap | ||
| - | [ 30 04 00 82 ] # Metal Cap | ||
| - | [ 30 04 00 83 ] # Wing Cap | ||
| - | |||
| - | ---- | ||
| - | ==== 31: Set Default Terrain ==== | ||
| - | Set default terrain. | ||
| - | |||
| - | ''31 04 00 [<color darkred>XX</color>]'' | ||
| - | |||
| - | | <color darkred>X</color> | 00 Normal A, 01 Normal B, 02 Snow, 03 Sand, 04 Haunted house, 05 Water levels, 06 Slippery Slide | | ||
| - | |||
| - | ---- | ||
| - | |||
| - | ==== 32: No Operation 2 ==== | ||
| - | No operation. This command is not used in any of the level scripts. | ||
| - | ''32 [<color darkred>XX</color>] '' | ||
| - | |||
| - | ---- | ||
| - | |||
| - | ==== 33: Fade Color ==== | ||
| - | Fade/overlay screen with color. | ||
| - | |||
| - | ''33 08 [<color darkred>XX</color>] [<color darkgreen>YY</color>] [<color red>RR</color>] [<color green>GG</color>] [<color blue>BB</color>] 00'' | ||
| - | |||
| - | | <color darkred>X</color> | 01 Enable, 00 Disable | | ||
| - | | <color darkgreen>Y</color> | Controls duration? usually 0x10 | | ||
| - | | <color red>R</color>,<color green>G</color>,<color blue>B</color> = red/green/blue color value | | ||
| - | |||
| - | ---- | ||
| - | |||
| - | ==== 34: Blackout Screen ==== | ||
| - | Calls [[http://level42.ca/projects/ultra64/Documentation/man/n64man/os/osViBlack.html|osViBlack(bool)]] (80323340), passing it X. | ||
| - | |||
| - | ''34 04 [<color darkred>XX</color>] 00'' | ||
| - | |||
| - | | <color darkred>X</color> | 1 = blackout, 0 = cancel blackout | | ||
| - | |||
| - | ---- | ||
| - | |||
| - | ==== 35: ?? ==== | ||
| - | ''35 04 [<color darkred>XX</color>] 00'' | ||
| - | If X is 0, call 0x803733B0 (A0 = 2) | ||
| - | Else, call 0x803733B0 (A0 = 1) | ||
| - | |||
| - | ---- | ||
| - | |||
| - | ==== 36: Set Music ==== | ||
| - | Set music | ||
| - | |||
| - | ''36 08 [??] [??] [??] [<color darkred>XX</color>] 00 00'' | ||
| - | |||
| - | | ? | Other music parameters? | | ||
| - | | <color darkred>X</color> | Sequence number | | ||
| - | |||
| - | ---- | ||
| - | |||
| - | ==== 37: Set Music ==== | ||
| - | Set music | ||
| - | |||
| - | ''37 04 00 [<color darkred>XX</color>]'' | ||
| - | |||
| - | | <color darkred>X</color> | Sequence number | | ||
| - | |||
| - | ---- | ||
| - | |||
| - | ==== 38: ?? ==== | ||
| - | ''38 04 [<color darkred>XX XX</color>]'' | ||
| - | |||
| - | Call 0x8024922C (A0 = X) | ||
| - | |||
| - | ---- | ||
| - | |||
| - | ==== 39: Place Macro Objects ==== | ||
| - | Place macro objects defined in segmented address. | ||
| - | |||
| - | ''39 08 00 00 [<color darkred>XX XX XX XX</color>]'' | ||
| - | |||
| - | | <color darkred>X</color> | Segment offset pointer to object placement list | | ||
| - | |||
| - | List format: (each entry is 10 bytes) | ||
| - | |||
| - | ''[<color purple>BB BB</color>] [<color darkred>XX XX</color>] [<color darkgreen>YY YY</color>] [<color darkblue>ZZ ZZ</color>] [?? ??]'' | ||
| - | |||
| - | | <color purple>B</color> | Object type ID (behavior, model, etc) | | ||
| - | | <color darkred>X</color>,<color darkgreen>Y</color>,<color darkblue>Z</color> | Coordinates | | ||
| - | | ?? | Always 00 00 ? | | ||
| - | |||
| - | ---- | ||
| - | |||
| - | ==== 3A: ?? ==== | ||
| - | |||
| - | ---- | ||
| - | |||
| - | ==== 3B: Jet Stream ==== | ||
| - | Define jet streams in JRB or DDD that repulse or suck Mario. | ||
| - | |||
| - | ''3B 0C 00 00 [<color darkred>XX XX</color>] [<color darkgreen>YY YY</color>] [<color darkblue>ZZ ZZ</color>] [<color darkgray>II II</color>]'' | ||
| - | |||
| - | | <color darkred>X</color> | X position | | ||
| - | | <color darkgreen>Y</color> | Y position | | ||
| - | | <color darkblue>Z</color> | Z position | | ||
| - | | <color darkgray>I</color> | Intensity. negative means repulsion, positive means suction | | ||
| - | |||
| - | ---- | ||
| - | |||
| - | ==== 3C: ?? ==== | ||
| - | Get/put remote values? Only used in main or menu level scripts. | ||
| - | |||
| - | ''3C 04 [<color darkred>XX</color>] [<color darkgreen>YY</color>]'' | ||
| - | |||
| - | | <color darkred>X</color> | ?? 01 in main level scripts, 00 in menu | | ||
| - | | <color darkgreen>Y</color> | ?? 00, 02, 03 | | ||
| - | |||
| - | ===== See Also ===== | ||
| - | [[List of Level Scripts]] | ||
| - | |||
| - | ===== References ===== | ||
| - | * http://origami64.net/showthread.php?tid=160 | ||
| - | * http://qubedstudios.rustedlogic.net/Mario64_HackingDoc1.5.txt | ||
| - | * http://s26.photobucket.com/user/Starxxon/media/M64Diagram.gif.html | ||
