Macro objects are objects that are loaded into the level from the level script command 0x39. Their main purpose is to save space in the ROM, since they only take up 10 bytes whereas regular objects take up 24 bytes. However, they are more limited than the regular objects loaded from the level script command 0x24.

ROM Hacks of SM64 usually won't use macro objects, since ROM space is not an issue.

• You can only directly modify the position, Y rotation, and the first two behavior parameters of the object.
• They will always appear in every act in the level, as they don't have an act mask.
• Each macro object contains a preset ID, that references a list that tells the object what model ID and behavior are.
• Because the y-rotation is stored in 7 bits, it allows for a maximum range of 0 to 127. This maps to 0° to 360° in the game for the y-rotation. In order to receive the y-rotation from this number, multiply by 2.8125. This also means the highest accuracy available for macro objects is 2.8125°.

The level script command 0x39 loads a list of macro commands from a segmented address. The list ends if the preset ID is either 0x00 or 0x1E.

[AA AA] [XX XX] [YY YY] [ZZ ZZ] [B1] [B2]

The Preset ID is used to get the Model ID, Behavior address, and the default Behavior parameters for the object. The location of this table differs based on the version of the game you are using.

Each entry in the table takes up 8 bytes.

[BS BS BS BS] [MM MM] [B1] [B2]

There are 366 entries in this table, starting at preset ID 31.

(Object names are taken from TT64 and Quad64)