List of Opcodes: Difference between revisions
Happylappy (talk | contribs) m SwitchLives & SwitchRandom |
m Document the Flash opcode |
||
Line 1,761: | Line 1,761: | ||
|} | |} | ||
=== 0x81 - Flash === | === 0x81 - Flash === | ||
Zeroes-out the return address used by the <code>Return</code> opcode. This opcode is not used in the base game. | |||
No parameters. | No parameters. |
Latest revision as of 20:10, 22 December 2024
The scripting engine used in Explorers of Sky has different opcodes. ExplorerScript translates most of them literally, preserving the same parameters and functionality. However, some opcodes are translated to ExplorerScript constructs, such as if statements.
This article documents the different opcodes, their purpose and parameters. The purpose of unkX parameters is unknown.
What is an opcode?
An opcode is an instruction to the machine (it tells the machine to 'do' something). In modern programming, it would be most similar to a function. For a more technical description, see here.
Types of parameters
- uint: An unsigned integer (a number without decimals). It cannot be negative. It is possible that in the game's code, there are only signed integers and no unsigned integers, but not enough research has been done on the matter. For the most part, it shouldn't matter.
- sint: A signed integer (a number without decimals). It can be either positive or negative.
- bitfield: A bitfield is uint where each bits (0 or 1) are treated independantly. They are used to store multiple binary (boolean) values efficiently. Opcodes that use it usually come in the
Set
andReset
variant. TheSet
variant define to true the values which are 1 in the input bitfield (while leaving the others untouched), andReset
define to false the values which are 1 in the input bitfield (while also leaving the others untouched). - String: Text (i.e dialogue). There should always be a quotation mark (") at the beginning and end.
- ConstString: Same as String.
- Routine: Any of the 701 coroutines from Unionall. Always begins with "CORO_"
- Entity: An actor, performer. (not an object!)
- Object: An object in a scene. (not an actor or perfomer!)
- Level: Any level from the Level List. Will always begin with "LEVEL_".
- Bgm: Any music in the game. Will always begin with "BGM_". (example: BGM_CRAGGY_COAST)
- PositionMark: A position. Will be written as "Position<'MarkName', x, y>". Once a position mark is written in a script, SkyTemple will show an option to place it visually in the scene.
- Face: A portrait expression. Will always begin with "FACE_". (examples: FACE_NORMAL, FACE_HAPPY, FACE_PAIN)
- FaceMode: A portrait position. Will always begin with "FACE_MODE_".
- Direction: A direction for an entity to move in or turn to. Will always begin with "DIR_". (examples: DIR_UP, DIR_RIGHT)
- ProcessSpecial: One of the games special processes. Can be referred to by its number, or name.
- Effect: A graphical effect.
- GameVar: Any of the game's Script Variables. Will always begin with "$".
Relevant Opcodes
These opcodes can be directly called from ExplorerScript.
0x0 - Null
Does nothing.
No parameters.
0x1 - back_ChangeGround
Sets the Map Background from a Level without changing the chunks from the currently loaded Map Background. Entities such as actors, objects, and performers will not be deleted when this opcode is executed.
This has very few uses in the game—a notable use is how Wigglytuff's Chamber has its door open, as seen via LEVEL_G01P04A and LEVEL_G01P04A2.
# | Type | Name | Description |
---|---|---|---|
1 | Level | level_id | An entry in the Level List. This opcode will pull from the Level's Map Background. |
0x2 - back_SetBackEffect
Performs various effects related to the currently loaded Animation Palettes.
# | Type | Name | Description |
---|---|---|---|
1 | uint | effect |
|
0x3 - back_SetBackScrollOffset
Shifts the background by a certain number of pixels, without affecting entities such as actors, objects, or performers. Backgrounds used with this opcode will display a "loop" effect, i.e., it has the appearance of scrolling forever.
This opcode seems to only work for only a few Levels, such as LEVEL_P13P01A, LEVEL_S13P06A, and LEVEL_V03P11A.
# | Type | Name | Description |
---|---|---|---|
1 | sint | offset0 | The number of pixels to shift either:
Which one the game performs for a given Level is hardcoded. |
2 | sint | offset1 | The number of pixels to shift either:
Which one the game performs for a given Level is hardcoded. |
0x4 - back_SetBackScrollSpeed
Continuously scrolls the background at a certain speed, without affecting entities such as actors, objects, or performers. Backgrounds used with this opcode will display a "loop" effect, i.e., it has the appearance of scrolling forever.
This opcode seems to only work for only a few Levels, such as LEVEL_P13P01A, LEVEL_S13P06A, and LEVEL_V03P11A.
# | Type | Name | Description |
---|---|---|---|
1 | sint16 | speed0 | The speed to scroll either:
Which one the game performs for a given Level seems to be hardcoded. |
2 | sint16 | speed1 | The speed to scroll either:
Which one the game performs for a given Level seems to be hardcoded. |
0x5 - back_SetBanner
Displays broken text using the FONT/banner.bin:FONT/b_pal.bin
font, editable in the Misc. Graphics tab of SkyTemple. This opcode will delete any actors, objects, and performers that are currently loaded.
# | Type | Name | Description |
---|---|---|---|
1 | sint | chapter_number | The chapter number displayed for the banner. A value of -1 will be "Final Chapter". |
2 | uint | unk1 | Currently unknown. |
0x6 - back_SetBanner2
Displays text using the FONT/banner.bin:FONT/b_pal.bin
font, editable in the Misc. Graphics tab of SkyTemple. This opcode is typically used for chapter introductions, which includes chapter text and a subtitle displayed over a Map Background. This opcode will delete any actors, objects, and performers that are currently loaded.
# | Type | Name | Description |
---|---|---|---|
1 | Level | level | An entry in the Level List. This opcode will pull from the Level's Map Background. |
2 | uint | unk1 | Currently unknown. Typically, the game uses 0 for this parameter, but it seems to have no effect. |
3 | uint | x | The pixel position the camera will center the Map Background on its X-axis. |
4 | uint | y | The pixel position the camera will center the Map Background on its Y-axis. |
5 | sint | chapter_number | The chapter number displayed for the banner. A value of -1 will be "Final Chapter". |
6 | String | title | The title of the chapter, e.g., "A Storm At Sea" for Chapter 1. |
0x7 - back_SetEffect
Performs various effects related to the current Map Background's layers across a certain number of frames.
# | Type | Name | Description |
---|---|---|---|
1 | uint | effect |
|
2 | uint | duration | The number of frames used to play a given effect. |
0x8 - back_SetDungeonBanner
Displays a specific string using the FONT/banner.bin:FONT/b_pal.bin
font, editable in the Misc. Graphics tab of SkyTemple. The text chosen is defined in Dungeons tab as a dungeon's back_SetDungeonBanner
string. This opcode will delete any actors, objects, and performers that are currently loaded.
# | Type | Name | Description |
---|---|---|---|
1 | uint | dungeon_id | The ID of a dungeon, as listed in the Dungeons tab of SkyTemple. |
2 | uint | unk1 | Currently unknown. Does not seem to affect much. |
0x9 - back_SetGround
Sets the Map Background from a Level. Upon using this opcode, the variable $GROUND_MAP
will be updated to match the ID of the chosen Level. This opcode will delete any actors, objects, and performers that are currently loaded.
# | Type | Name | Description |
---|---|---|---|
1 | Level | level_id | An entry in the Level List. This opcode will pull from the Level's Map Background. |
0xa - back_SetSpecialEpisodeBanner
Displays text using the FONT/banner.bin:FONT/b_pal.bin
font, editable in the Misc. Graphics tab of SkyTemple. This opcode is used for Special Episodes 1-3. This opcode plays a short animation of a green line shooting across the screen, followed by text scrolling across the screen horizontally from opposite directions. This opcode will delete any actors, objects, and performers that are currently loaded.
# | Type | Name | Description |
---|---|---|---|
1 | sint | episode_number | The episode number displayed for the banner. A value of -1 will be "Final Chapter". |
2 | String | title | The title of the episode, e.g., "Bidoof's Wish" for Special Episode 1. |
0xb - back_SetSpecialEpisodeBanner2
Displays text using the FONT/banner_c.bin:FONT/b_pal_r.bin
font, editable in the Misc. Graphics tab of SkyTemple. This opcode is only used for Special Episode 4. This opcode features an elaborate animation featuring hearts and sparkles, along with text scrolling across the screen horizontally from opposite directions. This opcode will delete any actors, objects, and performers that are currently loaded.
# | Type | Name | Description |
---|---|---|---|
1 | sint | episode_number | The episode number displayed for the banner. A value of -1 will be "Final Chapter". |
2 | String | title | The title of the episode, e.g., "Bidoof's Wish" for Special Episode 1. |
0xc - back_SetSpecialEpisodeBanner3
Displays text using the FONT/banner.bin:FONT/b_pal.bin
font, editable in the Misc. Graphics tab of SkyTemple. This opcode is only used for Special Episode 5. This opcode features no animation, but the end result is similar to the opcode back_SetSpecialEpisodeBanner
. This opcode will delete any actors, objects, and performers that are currently loaded.
# | Type | Name | Description |
---|---|---|---|
1 | sint | episode_number | The episode number displayed for the banner. A value of -1 will be "Final Chapter". |
2 | String | title | The title of the episode, e.g., "Bidoof's Wish" for Special Episode 1. |
0xd - back_SetTitleBanner
Displays user-defined text using the FONT/banner.bin:FONT/b_pal.bin
font, editable in the Misc. Graphics tab of SkyTemple. This opcode will delete any actors, objects, and performers that are currently loaded.
# | Type | Name | Description |
---|---|---|---|
1 | uint | y | The Y-axis pixel position of the title. |
2 | String | title | The title displayed on the Touch Screen. |
0xe - back_SetWeather
Displays a weather effect that overlays the current Map Background.
# | Type | Name | Description |
---|---|---|---|
1 | sint | weather_id | Values of 0 and below mean no weather effect is to be displayed.
|
0xf - back_SetWeatherEffect
Currently unknown. The only values this opcode accepts seems to be 1, 2, and 3. Its only known use is in V00P02/m01a04a.ssb, which is a test script used by the developers.
# | Type | Name | Description |
---|---|---|---|
1 | uint | unk0 | Currently unknown. |
0x10 - back_SetWeatherScrollOffset
Currently unknown. This opcode is not used in the base game.
# | Type | Name | Description |
---|---|---|---|
1 | uint | unk0 | Currently unknown. |
2 | uint | unk1 | Currently unknown. |
0x11 - back_SetWeatherScrollSpeed
Currently unknown. This opcode is not used in the base game.
# | Type | Name | Description |
---|---|---|---|
1 | uint | unk0 | Currently unknown. |
2 | uint | unk1 | Currently unknown. |
0x12 - back2_SetBackEffect
The same as back_SetBackEffect
, but for the Top Screen.
# | Type | Name | Description |
---|---|---|---|
1 | uint | effect_id |
|
0x13 - back2_SetBackScrollOffset
The same as back_SetBackScrollOffset
, but for the Top Screen.
# | Type | Name | Description |
---|---|---|---|
1 | sint | offset0 | The number of pixels to shift either:
Which one the game performs for a given Level seems to be hardcoded. |
2 | sint | offset1 | The number of pixels to shift either:
Which one the game performs for a given Level seems to be hardcoded. |
0x14 - back2_SetBackScrollSpeed
The same as back_SetBackScrollSpeed
, but for the Top Screen.
# | Type | Name | Description |
---|---|---|---|
1 | sint | speed0 | The speed to scroll either:
Which one the game performs for a given Level seems to be hardcoded. |
2 | sint | speed1 | The speed to scroll either:
Which one the game performs for a given Level seems to be hardcoded. |
0x15 - back2_SetData
Currently unknown. This opcode is not used in the base game.
# | Type | Name | Description |
---|---|---|---|
1 | uint | unk0 | Currently unknown. |
2 | uint | unk1 | Currently unknown. |
0x16 - back2_SetEffect
The same as back_SetEffect
, but for the Top Screen.
# | Type | Name | Description |
---|---|---|---|
1 | uint | effect |
|
2 | uint | duration | The number of frames used to play a given effect.
|
0x17 - back2_SetGround
Mostly the same as back_SetGround
, but for the Top Screen. This opcode only works if back2_SetMode(4);
is used prior to this opcode.
# | Type | Name | Description |
---|---|---|---|
1 | Level | level_id | An entry in the Level List. This opcode will pull from the Level's Map Background. |
0x18 - back2_SetMode
Determines a hardcoded status of the Top Screen.
# | Type | Name | Description |
---|---|---|---|
1 | sint | mode | A value of 0 is no mode. A negative value seems to set the Top Screen to the overworld's current Top Screen setting.
|
0x19 - back2_SetSpecialActing
Currently unknown.
# | Type | Name | Description |
---|---|---|---|
1 | uint | unk0 | Currently unknown. |
2 | uint | unk1 | Currently unknown. |
3 | uint | unk2 | Currently unknown. |
0x1a - back2_SetWeather
The same as back_SetWeather
, but for the Top Screen.
# | Type | Name | Description |
---|---|---|---|
1 | sint | weather_id | Values of 0 and below mean no weather effect is to be displayed.
|
0x1b - back2_SetWeatherEffect
Currently unknown. Potentially has similar functionality as back_SetWeatherEffect
, but for the Top Screen.
# | Type | Name | Description |
---|---|---|---|
1 | uint | unk0 | Currently unknown. |
0x1c - back2_SetWeatherScrollOffset
Currently unknown. Potentially has similar functionality as back_SetWeatherScrollOffset
, but for the Top Screen.
# | Type | Name | Description |
---|---|---|---|
1 | uint | unk0 | Currently unknown. |
2 | uint | unk1 | Currently unknown. |
0x1d - back2_SetWeatherScrollSpeed
Currently unknown. Potentially has similar functionality as back_SetWeatherScrollSpeed
, but for the Top Screen.
# | Type | Name | Description |
---|---|---|---|
1 | uint | unk0 | Currently unknown. |
2 | uint | unk1 | Currently unknown. |
0x1e - bgm_FadeOut
Fades out the BGM that is currently playing over a certain period of time on the first BGM track.
# | Type | Name | Description |
---|---|---|---|
1 | uint | duration | The number of frames used to fade out and silence a given BGM. |
0x1f - bgm_Play
Instantly plays a BGM on the first BGM track.
# | Type | Name | Description |
---|---|---|---|
1 | Bgm | bgm_id | A music track defined in SOUND/BGM of the ROM. |
0x20 - bgm_PlayFadeIn
Starts playing a BGM over a certain period of time and at a certain volume on the first BGM track.
# | Type | Name | Description |
---|---|---|---|
1 | Bgm | bgm_id | A music track defined in SOUND/BGM of the ROM. |
2 | uint | duration | The number of frames used to fade in the BGM. |
3 | uint | volume | The volume that the BGM will play at. It has a maximum of 256 and a minimum of 0. |
0x21 - bgm_Stop
Instantly stops the BGM that is currently playing on the first BGM track.
No parameters.
0x22 - bgm_ChangeVolume
Changes the volume of the BGM that is currently playing on the first BGM track.
# | Type | Name | Description |
---|---|---|---|
1 | uint | duration | The number of frames used to change the BGM's volume. |
2 | uint | volume | The volume that the BGM will play at. It has a maximum of 256 and a minimum of 0. |
0x23 - bgm2_FadeOut
Fades out the BGM that is currently playing over a certain period of time on the second BGM track.
# | Type | Name | Description |
---|---|---|---|
1 | uint | duration | The number of frames used to fade out and silence a given BGM. |
0x24 - bgm2_Play
Instantly plays a BGM on the second BGM track.
# | Type | Name | Description |
---|---|---|---|
1 | Bgm | bgm_id | A music track defined in SOUND/BGM of the ROM. |
0x25 - bgm2_PlayFadeIn
Starts playing a BGM over a certain period of time and at a certain volume on the second BGM track.
# | Type | Name | Description |
---|---|---|---|
1 | Bgm | bgm_id | A music track defined in SOUND/BGM of the ROM. |
2 | uint | duration | The number of frames used to fade in the BGM. |
3 | uint | volume | The volume that the BGM will play at. It has a maximum of 256 and a minimum of 0. |
0x26 - bgm2_Stop
Instantly stops the BGM that is currently playing on the second BGM track.
No parameters.
0x27 - bgm2_ChangeVolume
Changes the volume of the BGM that is currently playing on the second BGM track.
# | Type | Name | Description |
---|---|---|---|
1 | uint | duration | The number of frames to change the BGM's volume. |
2 | uint | volume | The volume that the BGM will play at. It has a maximum of 256 and a minimum of 0. |
0x38 - CallCommon
Jumps to the specified Unionall Coroutine, runs its code, and returns to the line of code in which this opcode was used (only if return;
was used in the Coroutine). This opcode can be used in any script, no matter the type (Common, Enter, Acting, or Sub).
If used in the context of an actor/object/performer, this should not be used in with-statements.
# | Type | Name | Description |
---|---|---|---|
1 | Routine | coro_id | One of the 701 possible Unionall Coroutines. |
0x39 - camera_Move2Default
Moves the camera toward an active Type 1 actor (e.g., ACTOR_PLAYER) without restricting the angles used.
# | Type | Name | Description |
---|---|---|---|
1 | uint | speed | Movement speed. Higher values result in a faster speed. 0 will result in an instant movement.
Values starting at 32770 and above will be slower than a value of 1. |
0x3a - camera_Move2MyPosition
Moves the camera toward a specific entity's position (i.e., an actor, object, or performer) without restricting the angles used.
This opcode does not have a parameter for an entity, as it must be used in a with-statement or a targeted routine.
# | Type | Name | Description |
---|---|---|---|
1 | uint | speed | Movement speed. Higher values result in a faster speed. 0 will result in an instant movement.
Values starting at 32770 and above will be slower than a value of 1. |
0x3b - camera_Move2Myself
Moves the camera toward a specific entity (i.e., an actor, object, or performer) without restricting the angles used.
This opcode does not have a parameter for an entity, as it must be used in a with-statement or a targeted routine.
# | Type | Name | Description |
---|---|---|---|
1 | uint | speed | Movement speed. Higher values result in a faster speed. 0 will result in an instant movement.
Values starting at 32770 and above will be slower than a value of 1. |
0x3c - camera_Move2PositionMark
Moves the camera to one or more Position Marks without restricting the angles used.
# | Type | Name | Description |
---|---|---|---|
1 | uint | num_parameters | The number of parameters to read from this opcode. |
2+ | PositionMark | pos_marker | A structure consisting of a name, X unit, and Y unit. Units are defined as 8 pixels.
This parameter may be repeated multiple times. |
0x3d - camera_Move2PositionMark
Moves the camera to a Position Mark without restricting the angles used.
# | Type | Name | Description |
---|---|---|---|
1 | uint | speed | Movement speed. Higher values result in a faster speed. 0 will result in an instant movement.
Values starting at 32770 and above will be slower than a value of 1. |
2 | PositionMark | pos_marker | A structure consisting of a name, X unit, and Y unit. Units are defined as 8 pixels. |
0x3e - camera_Move3Default
Moves the camera toward an active Type 1 actor (e.g., ACTOR_PLAYER) in a rapid, strange motion.
# | Type | Name | Description |
---|---|---|---|
1 | uint | speed | Supposedly movement speed based off of similar opcodes, but does not seem to affect much. |
0x3f - camera_Move3MyPosition
Moves the camera toward a specific entity's position (i.e., an actor, object, or performer) in a rapid, strange motion.
This opcode does not have a parameter for an entity, as it must be used in a with-statement or a targeted routine.
# | Type | Name | Description |
---|---|---|---|
1 | uint | speed | Supposedly movement speed based off of similar opcodes, but does not seem to affect much. |
0x40 - camera_Move3Myself
Moves the camera toward a specific entity (i.e., an actor, object, or performer) in a rapid, strange motion.
This opcode does not have a parameter for an entity, as it must be used in a with-statement or a targeted routine.
# | Type | Name | Description |
---|---|---|---|
1 | uint | speed | Supposedly movement speed based off of similar opcodes, but does not seem to affect much. |
0x41 - camera_Move3PositionMark
Moves the camera to one or more Position Marks in a rapid, strange motion.
# | Type | Name | Description |
---|---|---|---|
1 | uint | num_parameters | The number of parameters to read from this opcode. |
2+ | PositionMark | pos_marker | A structure consisting of a name, X unit, and Y unit. Units are defined as 8 pixels.
This parameter may be repeated multiple times. |
0x42 - camera_Move3PositionMark
Moves the camera to a Position Mark without restricting the angles used.
# | Type | Name | Description |
---|---|---|---|
1 | uint | speed | Supposedly movement speed based off of similar opcodes, but does not seem to affect much. |
2 | PositionMark | pos_marker | A structure consisting of a name, X unit, and Y unit. Units are defined as 8 pixels. |
0x43 - camera_MoveDefault
Moves the camera toward an active Type 1 actor (e.g., ACTOR_PLAYER) while restricting movement by eight angles—as if movement was performed using the D-Pad.
# | Type | Name | Description |
---|---|---|---|
1 | uint | speed | Movement speed. Higher values result in a faster speed. 0 will result in an instant movement.
Values starting at 32770 and above will be slower than a value of 1. |
0x44 - camera_MoveMyPosition
Moves the camera toward a specific entity's position (i.e., an actor, object, or performer) while restricting movement by eight angles—as if movement was performed using the D-Pad.
This opcode does not have a parameter for an entity, as it must be used in a with-statement or a targeted routine.
# | Type | Name | Description |
---|---|---|---|
1 | uint | speed | Movement speed. Higher values result in a faster speed. 0 will result in an instant movement.
Values starting at 32770 and above will be slower than a value of 1. |
0x45 - camera_MoveMyself
Moves the camera toward a specific entity (i.e., an actor, object, or performer) while restricting movement by eight angles—as if movement was performed using the D-Pad.
This opcode does not have a parameter for an entity, as it must be used in a with-statement or a targeted routine.
# | Type | Name | Description |
---|---|---|---|
1 | uint | speed | Movement speed. Higher values result in a faster speed. 0 will result in an instant movement.
Values starting at 32770 and above will be slower than a value of 1. |
0x46 - camera_MovePositionMark
Moves the camera to one or more Position Marks while restricting movement by eight angles—as if movement was performed using the D-Pad.
# | Type | Name | Description |
---|---|---|---|
1 | uint | num_parameters | The number of parameters to read from this opcode. |
2+ | PositionMark | pos_marker | A structure consisting of a name, X unit, and Y unit. Units are defined as 8 pixels.
This parameter may be repeated multiple times. |
0x47 - camera_MovePositionMark
Moves the camera to a Position Mark while restricting movement by eight angles—as if movement was performed using the D-Pad.
# | Type | Name | Description |
---|---|---|---|
1 | uint | speed | Movement speed. Higher values result in a faster speed. 0 will result in an instant movement.
Values starting at 32770 and above will be slower than a value of 1. |
2 | PositionMark | pos_marker | A structure consisting of a name, X unit, and Y unit. Units are defined as 8 pixels. |
0x48 - camera_SetDefault
Instantly sets the camera to a Type 1 actor (e.g., ACTOR_PLAYER).
No parameters.
0x49 - camera_SetEffect
Continuously shakes the camera at specified intensities. Entities will be affected by the camera shaking, but not textboxes and portraits. The camera will continue to shake even if it is moved using another opcode.
# | Type | Name | Description |
---|---|---|---|
1 | uint | mode | Values of 0 or 3+ mean the camera will not shake.
|
2 | uint | intensity | The intensity of the shake. Higher values will result in a more intense shake. |
3 | uint | speed | Movement speed. Higher values result in a slower speed. |
0x4a - camera_SetMyPosition
Instantly sets the camera toward a specific entity's position (i.e., an actor, object, or performer).
This opcode does not have a parameter for an entity, as it must be used in a with-statement or a targeted routine.
No parameters.
0x4b - camera_SetMyself
Instantly sets the camera to a specific entity (i.e., an actor, object, or performer). Once performed, the camera will now follow the entity wherever it moves.
This opcode does not have a parameter for an entity, as it must be used in a with-statement or a targeted routine.
No parameters.
0x4c - camera_SetPositionMark
Instantly sets the camera to a Position Mark.
# | Type | Name | Description |
---|---|---|---|
1 | PositionMark | pos_marker | A structure consisting of a name, X unit, and Y unit. Units are defined as 8 pixels. |
0x4d - camera2_Move2Default
The same as camera_Move2Default
, but for the Top Screen.
# | Type | Name | Description |
---|---|---|---|
1 | uint | speed | Movement speed. Higher values result in a faster speed. 0 will result in an instant movement.
Values starting at 32770 and above will be slower than a value of 1. |
0x4e - camera2_Move2MyPosition
The same as camera_Move2MyPosition
, but for the Top Screen.
# | Type | Name | Description |
---|---|---|---|
1 | uint | speed | Movement speed. Higher values result in a faster speed. 0 will result in an instant movement.
Values starting at 32770 and above will be slower than a value of 1. |
0x4f - camera2_Move2Myself
The same as camera_Move2Myself
, but for the Top Screen.
# | Type | Name | Description |
---|---|---|---|
1 | uint | speed | Movement speed. Higher values result in a faster speed. 0 will result in an instant movement.
Values starting at 32770 and above will be slower than a value of 1. |
0x50 - camera2_Move2PositionMark
The same as camera_Move2PositionMark
, but for the Top Screen.
# | Type | Name | Description |
---|---|---|---|
1 | uint | num_parameters | The number of parameters to read from this opcode. |
2+ | PositionMark | pos_marker | A structure consisting of a name, X unit, and Y unit. Units are defined as 8 pixels.
This parameter may be repeated multiple times. |
0x51 - camera2_Move2PositionMark
The same as camera_Move2PositionMark
, but for the Top Screen.
# | Type | Name | Description |
---|---|---|---|
1 | uint | speed | Movement speed. Higher values result in a faster speed. 0 will result in an instant movement.
Values starting at 32770 and above will be slower than a value of 1. |
2 | PositionMark | pos_marker | A structure consisting of a name, X unit, and Y unit. Units are defined as 8 pixels. |
0x52 - camera2_Move3Default
The same as camera_Move3Default
, but for the Top Screen.
# | Type | Name | Description |
---|---|---|---|
1 | uint | speed | Supposedly movement speed based off of similar opcodes, but does not seem to affect much. |
0x53 - camera2_Move3MyPosition
The same as camera_Move3MyPosition
, but for the Top Screen.
# | Type | Name | Description |
---|---|---|---|
1 | uint | speed | Supposedly movement speed based off of similar opcodes, but does not seem to affect much. |
0x54 - camera2_Move3Myself
The same as camera_Move3Myself
, but for the Top Screen.
# | Type | Name | Description |
---|---|---|---|
1 | uint | speed | Supposedly movement speed based off of similar opcodes, but does not seem to affect much. |
0x55 - camera2_Move3PositionMark
The same as camera_Move3PositionMark
, but for the Top Screen.
# | Type | Name | Description |
---|---|---|---|
1 | uint | num_parameters | The number of parameters to read from this opcode. |
2+ | PositionMark | pos_marker | A structure consisting of a name, X unit, and Y unit. Units are defined as 8 pixels.
This parameter may be repeated multiple times. |
0x56 - camera2_Move3PositionMark
The same as camera_Move3PositionMark
, but for the Top Screen.
# | Type | Name | Description |
---|---|---|---|
1 | uint | speed | Supposedly movement speed based off of similar opcodes, but does not seem to affect much. |
2 | PositionMark | pos_marker | A structure consisting of a name, X unit, and Y unit. Units are defined as 8 pixels. |
0x57 - camera2_MoveDefault
The same as camera_MoveDefault
, but for the Top Screen.
# | Type | Name | Description |
---|---|---|---|
1 | uint | speed | Movement speed. Higher values result in a faster speed. 0 will result in an instant movement.
Values starting at 32770 and above will be slower than a value of 1. |
0x58 - camera2_MoveMyPosition
The same as camera_MoveMyPosition
, but for the Top Screen.
# | Type | Name | Description |
---|---|---|---|
1 | uint | speed | Movement speed. Higher values result in a faster speed. 0 will result in an instant movement.
Values starting at 32770 and above will be slower than a value of 1. |
0x59 - camera2_MoveMyself
The same as camera_MoveMyself
, but for the Top Screen.
# | Type | Name | Description |
---|---|---|---|
1 | uint | speed | Movement speed. Higher values result in a faster speed. 0 will result in an instant movement.
Values starting at 32770 and above will be slower than a value of 1. |
0x5a - camera2_MovePositionMark
The same as camera_MovePositionMark
, but for the Top Screen.
# | Type | Name | Description |
---|---|---|---|
1 | uint | num_parameters | The number of parameters to read from this opcode. |
2+ | PositionMark | pos_marker | A structure consisting of a name, X unit, and Y unit. Units are defined as 8 pixels.
This parameter may be repeated multiple times. |
0x5b - camera2_MovePositionMark
The same as camera_MovePositionMark
, but for the Top Screen.
# | Type | Name | Description |
---|---|---|---|
1 | uint | speed | Movement speed. Higher values result in a faster speed. 0 will result in an instant movement.
Values starting at 32770 and above will be slower than a value of 1. |
2 | PositionMark | pos_marker | A structure consisting of a name, X unit, and Y unit. Units are defined as 8 pixels. |
0x5c - camera2_SetDefault
The same as camera_SetDefault
, but for the Top Screen.
No parameters.
0x5d - camera2_SetEffect
The same as camera_SetEffect
, but for the Top Screen.
# | Type | Name | Description |
---|---|---|---|
1 | uint | mode | Values of 0 or 3+ mean the camera will not shake.
|
2 | uint | intensity | The intensity of the shake. Higher values will result in a more intense shake. |
3 | uint | speed | Movement speed. Higher values result in a slower speed. |
0x5e - camera2_SetMyPosition
The same as camera_SetMyPosition
, but for the Top Screen.
No parameters.
0x5f - camera2_SetMyself
The same as camera_SetMyself
, but for the Top Screen.
No parameters.
0x60 - camera2_SetPositionMark
The same as camera_SetPositionMark
, but for the Top Screen.
# | Type | Name | Description |
---|---|---|---|
1 | PositionMark | pos_marker | A structure consisting of a name, X unit, and Y unit. Units are defined as 8 pixels.
This parameter may be repeated multiple times. |
0x61 - CancelCut
Reverses the effects of the opcode CancelRecoverCommon
, i.e., disallows the game from reloading Unionall at a Coroutine by pressing the Start button.
No parameters.
0x62 - CancelRecoverCommon
Allows reloading Unionall at a specified Coroutine by pressing the Start button. This can be done in a cutscene and the overworld.
Once the Start button is pressed, the game will stop the current script, fade out the entire screen, and reload Unionall and begin running code at the specified Coroutine.
# | Type | Name | Description |
---|---|---|---|
1 | Routine | coro_id | One of the 701 possible Unionall Coroutines. |
0x6a - debug_Assert
Does nothing in the final game.
# | Type | Name | Description |
---|---|---|---|
1 | uint | unk0 | Currently unknown. |
0x6b - debug_Print
Does nothing in the final game.
If the script is running using SkyTemple's debugger and the "Script Debug" checkbox is ticked, the specified string will be printed to the Debug Log.
# | Type | Name | Description |
---|---|---|---|
1 | ConstString | txt | A string to be printed to the Debug Log. |
0x6c - debug_PrintFlag
Does nothing in the final game.
If the script is running using SkyTemple's debugger and the "Script Debug" checkbox is ticked, the specified string will be printed to the Debug Log, along with the value of the specified script variable.
# | Type | Name | Description |
---|---|---|---|
1 | GameVar | var | One of the 115 possible script variables. Indexed variables are not encouraged to use, since the Debug Log will only read from the first index. |
2 | ConstString | txt | A string to be printed to the Debug Log. |
0x6d - debug_PrintScenario
If the script is running using SkyTemple's debugger and the "Script Debug" checkbox is ticked, the specified string will be printed to the Debug Log, along with two indices of the specified script variable.
This opcode's Debug Log implementation currently seems broken, as it prints the first index of the specified variable twice.
# | Type | Name | Description |
---|---|---|---|
1 | GameVar | var | One of the 115 possible script variables. A two-indexed variable (e.g., $SCENARIO_MAIN ) is encouraged to use.
|
2 | ConstString | txt | A string to be printed to the Debug Log. |
0x6f - Destroy
Instantly removes an active entity (i.e., an actor, object, or performer) from memory.
This opcode does not have a parameter for an entity, as it must be used in a with-statement or a targeted routine.
No parameters.
0x71 - EndAnimation
Stops an actor or object's looping animation once it reaches the end of its animation frames.
This opcode does not have a parameter for an entity, as it must be used in a with-statement or a targeted routine.
No parameters.
0x72 - ExecuteActing
Currently unknown.
# | Type | Name | Description |
---|---|---|---|
1 | uint | unk0 | Currently unknown. |
0x73 - ExecuteCommon
Jumps to a Unionall Coroutine, runs its code, and returns to the line in which this opcode was called. This opcode should be called if the specified Coroutine ends with hold;
. Typically, the base game uses this command with Coroutines whose names end with "FUNC_SERIES".
This opcode does not have a parameter for an entity, as it must be used in a with-statement.
# | Type | Name | Description |
---|---|---|---|
1 | Routine | coro_id | One of the 701 possible Unionall Coroutines. |
2 | uint | unk1 | Unknown. |
0x81 - Flash
Zeroes-out the return address used by the Return
opcode. This opcode is not used in the base game.
No parameters.
0x83 - item_GetVariable
Saves the value in a specific item slot (set by item_Set
) to a script variable.
# | Type | Name | Description |
---|---|---|---|
1 | uint | slot | An item slot used by many item_ opcodes.
|
2 | GameVar | var | One of the indexed variables. Non-indexed values causes the IndexError. |
0x84 - item_Set
Sets an item into an item slot, which can be used by other various item_
opcodes.
Items in slot 0 may also be added to the player's bag and storage with hardcoded menus, such as message_Menu(MENU_GIVE_ITEM);
and message_Menu(MENU_GIVE_ITEM2);
, respectively. Additionally, the text tag [s_item:X]
will display the item's name, where X is the item slot number.
Item slots 0-3 are safe to use, but item slots 4 and beyond will begin to overwrite other memory!
# | Type | Name | Description |
---|---|---|---|
1 | uint | slot | An item slot used by many item_ opcodes.
|
2 | uint | item_id | The ID of the item, where all are listed in the Items tab of SkyTemple. |
3 | uint | item_stack | The stack count of an item, if it belongs to a Thrown category. Treasure Boxes will also use this as the item earned when opening the box at Xatu's Appraisal. |
0x85 - item_SetTableData
Sets a random item from predefined tables into an item slot, which can be used by other various item_
opcodes. This opcode is used mainly in Spinda's Cafe, for redeeming a random Recycle Shop prize and for receiving items from Treasure Town NPCs after giving them Sky Gifts.
Items in slot 0 may also be added to the player's bag and storage with hardcoded menus, such as message_Menu(MENU_GIVE_ITEM);
and message_Menu(MENU_GIVE_ITEM2);
, respectively. Additionally, the text tag [s_item:X]
will display the item's name, where X is the item slot number.
# | Type | Name | Description |
---|---|---|---|
1 | uint | slot | An item slot used by many item_ opcodes.
|
2 | uint | table | Some unknown item tables related to Spinda's Cafe. |
0x86 - item_SetVariable
Saves the value of a script variable to an item slot. Items in slot 0 may also be added to the player's bag and storage with hardcoded menus, such as message_Menu(MENU_GIVE_ITEM);
and message_Menu(MENU_GIVE_ITEM2);
, respectively. Additionally, the text tag [s_item:X]
will display the item's name, where X is the item slot number.
# | Type | Name | Description |
---|---|---|---|
1 | uint | slot | An item slot used by many item_ opcodes.
|
2 | GameVar | var | One of the 115 possible script variables. |
0x88 - JumpCommon
Jumps to the specified Unionall Coroutine and runs its code, without returning to the line in which this opcode was first used. This opcode can be used in any script, no matter the type (Common, Enter, Acting, or Sub), but is mostly used by the base game in Unionall.
If attempting to execute a Unionall Coroutine from inside an Enter, Acting, or Sub script to play Acting scripts, use supervision_ExecuteCommon
instead.
# | Type | Name | Description |
---|---|---|---|
1 | Routine | coro_id | One of the 701 possible Unionall Coroutines. |
0x8a - LoadPosition
Sets various attributes of an entity (i.e., an actor, object, or performer) to the values of all indexed $POSITION_
script variables. These include changing the entity's X and Y coordinates, height, and direction.
This opcode does not have a parameter for an entity, as it must be used in a with-statement or a targeted routine.
# | Type | Name | Description |
---|---|---|---|
1 | uint | index | Index used by all $POSITION_ script variables, ranged from 0-2 (inclusive).
|
0x8b - Lock
Suspends the current routine until the opcode Unlock
is called with the same lock_id.
# | Type | Name | Description |
---|---|---|---|
1 | uint | lock_id | The ID of a Lock, ranged from 0-19 (inclusive). |
0x8c - main_EnterAdventure
Performs various functions related to entering a dungeon using the crossroads menu.
# | Type | Name | Description |
---|---|---|---|
1 | sint | mode | Most modes are not known, but:
|
2 | uint | unk1 | Currently unknown. |
0x8d - main_EnterDungeon
Attempts to exit ground mode and begins dungeon mode at a specific dungeon.
If attempting to run this opcode before selecting any option from the Top Menu, the game will not enter any dungeon and instead attempt to load a DEMO Unionall coroutine or the Top Menu.
# | Type | Name | Description |
---|---|---|---|
1 | sint | dungeon_id | The dungeon ID to enter, which are all listed in the Dungeons tab of SkyTemple. A value of -1 actually enters dungeon mode—it is insufficient to use this opcode a single time to enter a specific dungeon. |
2 | uint | duration | The number of frames used to fade out the screens. |
0x8e - main_EnterGround
Stops the current script to reload Unionall starting from the Coroutine CORO_EVENT_DIVIDE. This opcode also updates the following script variables:
$GROUND_ENTER
: This opcode's level_id_enter parameter.$GROUND_ENTER_LINK
: Set to 0.$GROUND_GETOUT
: The value of$GROUND_ENTER
prior to using this opcode.$GROUND_MAP
: The Level ID used to display the Map Background.$GROUND_PLACE
: The World Map Marker ID that determines where the player appears on the Top Screen when selecting "Map and team" in the overworld.$GROUND_START_MODE
: Set to 3.
In the base game, using this opcode allows for transitioning between Levels in the Overworld, as the game will eventually run the supervision_ExecuteEnter
opcode.
# | Type | Name | Description |
---|---|---|---|
1 | Level | level_id | An entry in the Level List. Ideally, this opcode would load the specified Level's Enter00 script. |
2 | uint | duration | The number of frames used to fade out the screens. |
0x8f - main_EnterGroundMulti
Stops the current script to reload Unionall starting from the Coroutine CORO_EVENT_DIVIDE. This opcode also updates the following script variables:
$GROUND_ENTER
: This opcode's level_id_enter parameter.$GROUND_ENTER_LINK
: This opcode's level_id_link parameter.$GROUND_GETOUT
: The value of$GROUND_ENTER
prior to using this opcode.$GROUND_MAP
: The Level ID used to display the Map Background.$GROUND_PLACE
: The World Map Marker ID that determines where the player appears on the Top Screen when selecting "Map and team" in the overworld.$GROUND_START_MODE
: Set to 3.
In the base game, using this opcode allows for transitioning between Levels in the Overworld, as the game will eventually run the supervision_ExecuteEnter
opcode.
# | Type | Name | Description |
---|---|---|---|
1 | Level | level_id_enter | An entry in the Level List. Ideally, this opcode would load the specified Level's Enter00 script. |
2 | uint | duration | The number of frames used to fade out the screens. |
3 | Level | level_id_link | An entry in the Level List. Used to update $GROUND_ENTER_LINK .
|
0x90 - main_EnterRescueUser
Exits ground mode and begins dungeon mode while taking an SOS Mail. Dungeon selection seems to be determined by the SOS Mail chosen via message_Menu(MENU_S_O_S_MAIL_PICKER);
.
# | Type | Name | Description |
---|---|---|---|
1 | uint | duration | The number of frames used to fade out the screens. |
0x91 - main_EnterTraining
Performs various functions related to entering a dungeon using Marowak Dojo.
# | Type | Name | Description |
---|---|---|---|
1 | uint | mode | Most modes are not known, but:
|
2 | uint | unk1 | Currently unknown. |
0x92 - main_EnterTraining2
Performs various functions related to entering a dungeon using Marowak Dojo's Final Maze.
# | Type | Name | Description |
---|---|---|---|
1 | uint | mode | Most modes are not known, but:
|
2 | uint | unk1 | Currently unknown. |
0x93 - main_SetGround
Updates the following variables' values to be this opcode's level_id parameter:
$GROUND_ENTER
$GROUND_GETOUT
# | Type | Name | Description |
---|---|---|---|
1 | Level | level_id | An entry in the Level List. |
0x94 - me_Play
Instantly plays a special sound effect that can seamlessly interrupt any BGM tracks that are currently playing.
# | Type | Name | Description |
---|---|---|---|
1 | uint | me_id | A sound effect defined in SOUND/ME of the ROM. |
0x95 - me_Stop
Instantly stops the currently-playing special sound effect called with me_Play
.
No parameters.
0x96 - message_Close
Suspends the current routine and allows for closing an active textbox (and portrait, if active) set by one of the following opcodes:
message_ImitationSound
message_Mail
message_Monologue
message_Notice
message_SpecialTalk
message_Talk
By pressing the A Button, B Button, or tapping the textbox via the Touch Screen. Once the textbox is closed, the current routine resumes.
No parameters.
0x97 - message_CloseEnforce
Instantly closes an active textbox (and portrait, if active) once the game finishes displaying a string set by one of the following opcodes:
message_ImitationSound
message_Mail
message_Monologue
message_Notice
message_SpecialTalk
message_Talk
No parameters.
0x98 - message_Explanation
Displays the string defined in the txt parameter centered in the middle of the Touch Screen. The string will appear without any frame defined in FONT/frameX.wte
(as seen in the Misc. Graphics tab of SkyTemple). This opcode does not need message_Close
to suspend the routine.
This opcode does not support displaying a portrait. No sound will emit from the text scrolling.
# | Type | Name | Description |
---|---|---|---|
1 | String | txt | Text to be displayed on the Touch Screen. |
0x99 - message_FacePositionOffset
Offsets the active portrait in pixels by multiples of 8.
# | Type | Name | Description |
---|---|---|---|
1 | sint | x | The offset to shift the portrait box across the X-axis. |
2 | sint | y | The offset to shift the portrait box across the Y-axis. |
0x9a - message_ImitationSound
Displays the string defined in the txt parameter at the bottom of the Touch Screen. The string will appear surrounded by a player-chosen frame defined in FONT/frameX.wte
(as seen in the Misc. Graphics tab of SkyTemple).
This opcode does not support displaying a portrait. No sound will emit from the text scrolling.
# | Type | Name | Description |
---|---|---|---|
1 | String | txt | Text to be displayed on the Touch Screen. |
0x9b - message_KeyWait
If an active textbox has finished displaying its string and was created by one of the following opcodes:
message_ImitationSound
message_Mail
message_Monologue
message_Notice
message_SpecialTalk
message_Talk
This opcode suspends the current routine until the A Button, B Button or textbox is pressed (via the Touch Screen). Once done so, the textbox will not close, but the current routine will resume.
No parameters.
0x9c - message_Mail
Displays the string defined in the txt parameter at the bottom of the Touch Screen. The string will appear surrounded by a player-chosen frame defined in FONT/frameX.wte
(as seen in the Misc. Graphics tab of SkyTemple).
This opcode does not support displaying a portrait. No sound will emit from the text scrolling.
# | Type | Name | Description |
---|---|---|---|
1 | String | txt | Text to be displayed on the Touch Screen. |
0x9d - message_Menu
Executes various hardcoded "menu" functionalities given a certain ID. Some IDs result in an actual menu, while others simply perform a silent task.
# | Type | Name | Description |
---|---|---|---|
1 | Menu | menu_id | The ID of a menu, the list of which can be seen by typing MENU_ in SkyTemple's Script Engine Debugger.
|
0x9e - message_Monologue
Displays the string defined in the txt parameter at the bottom of the Touch Screen. The string will appear surrounded by a player-chosen frame defined in FONT/frameX.wte
(as seen in the Misc. Graphics tab of SkyTemple).
This opcode supports displaying a portrait. No sound will emit from the text scrolling.
# | Type | Name | Description |
---|---|---|---|
1 | String | txt | Text to be displayed on the Touch Screen. |
0x9f - message_Narration
Fades in the screen and instantly displays the string defined in the txt parameter centered in the middle of the Touch Screen. The string will appear without any frame defined in FONT/frameX.wte
(as seen in the Misc. Graphics tab of SkyTemple). This opcode does not need message_Close
to suspend the routine. Once the routine is resumed (by pressing the A Button, B Button, or text via the Touch Screen), the screen will fade out, including the string.
# | Type | Name | Description |
---|---|---|---|
1 | uint | duration | The number of frames used to fade in/out the Touch Screen. |
2 | String | txt | Text to be displayed on the Touch Screen. |
0xa0 - message_Notice
Instantly displays the string defined in the txt parameter at the bottom of the Touch Screen. The string will appear surrounded by a player-chosen frame defined in FONT/frameX.wte
(as seen in the Misc. Graphics tab of SkyTemple).
This opcode does not support displaying a portrait.
# | Type | Name | Description |
---|---|---|---|
1 | String | txt | Text to be displayed on the Touch Screen. |
0xa1 - message_EmptyActor
Disallows a portrait from appearing alongside a textbox, along with disallowing a name to appear in the textbox if message_Talk
follows this opcode.
No parameters.
0xa2 - message_ResetActor
Disallows a portrait from appearing alongside a textbox, along with setting a speech bubble (the text tag [M:T1]) to the start of next script string if message_Talk
follows this opcode.
No parameters.
0xa3 - message_SetActor
Sets the specified actor's name to the start of the next script string if message_Talk
follows this opcode.
# | Type | Name | Description |
---|---|---|---|
1 | Entity | actor_id | An entry in the Actor List. |
0xa4 - message_SetFace
Sets the specified actor's name to the start of the next script string if message_Talk
follows this opcode. Will also display a portrait of the actor's species at a specified position if message_Talk
or message_Monologue
follow this opcode.
# | Type | Name | Description |
---|---|---|---|
1 | Entity | actor_id | An entry in the Actor List. |
2 | Face | face_id | The ID of a portrait, the list of which can be seen by typing FACE_ in SkyTemple's Script Engine Debugger. |
3 | FaceMode | face_mode | The position of a portrait, the list of which can be seen by typing FACE_POS_ in SkyTemple's Script Engine Debugger.
|
0xa5 - message_SetFaceEmpty
Displays a portrait of the actor's species at a specified position if message_Talk
or message_Monologue
follow this opcode.
# | Type | Name | Description |
---|---|---|---|
1 | Entity | actor_id | An entry in the Actor List. |
2 | Face | face_id | The ID of a portrait, the list of which can be seen by typing FACE_ in SkyTemple's Script Engine Debugger. |
3 | FaceMode | face_mode | The position of a portrait, the list of which can be seen by typing FACE_POS_ in SkyTemple's Script Engine Debugger.
|
0xa6 - message_SetFaceOnly
Sets a speech bubble (the text tag [M:T1]) to the start of the next script string if message_Talk
follows this opcode. Will also display a portrait of the actor's species at a specified position if message_Talk
or message_Monologue
follow this opcode.
# | Type | Name | Description |
---|---|---|---|
1 | Entity | actor_id | An entry in the Actor List. |
2 | Face | face_id | The ID of a portrait, the list of which can be seen by typing FACE_ in SkyTemple's Script Engine Debugger. |
3 | FaceMode | face_mode | The position of a portrait, the list of which can be seen by typing FACE_POS_ in SkyTemple's Script Engine Debugger.
|
0xa7 - message_SetFacePosition
Re-positions an actor's portrait.
# | Type | Name | Description |
---|---|---|---|
1 | FaceMode | face_mode | The position of a portrait, the list of which can be seen by typing FACE_POS_ in SkyTemple's Script Engine Debugger.
|
0xa8 - message_SetWaitMode
Makes strings displayed with a message_
opcode auto-scroll. For both parameters, a value of -1 means the auto-scroll will stop.
# | Type | Name | Description |
---|---|---|---|
1 | sint | duration0 | Sets the frame count for a textbox auto-advancing, once the end of the string has been displayed and the following opcode is message_KeyWait(); .
|
2 | sint | duration1 | Sets the frame count for text tags such as [K] auto-advancing. |
0xa9 - message_SpecialTalk
Displays a random Text String based off of the actor ACTOR_TALK_SUB's Talk Group.
# | Type | Name | Description |
---|---|---|---|
1 | uint | category | A category of Text String.
|
0xae - message_Talk
Displays the string defined in the txt parameter at the bottom of the Touch Screen. The string will appear surrounded by a player-chosen frame defined in FONT/frameX.wte
(as seen in the Misc. Graphics tab of SkyTemple).
This opcode supports displaying a portrait. The sound effect 16133 will emit from the each character scrolling in the text.
# | Type | Name | Description |
---|---|---|---|
1 | String | txt | Text to be displayed on the Touch Screen. |
0xaf - Move2Position
Moves an entity (i.e., an actor, object, or performer) to a specific pixel position without restricting the angles used.
This opcode does not have a parameter for an entity, as it must be used in a with-statement or a targeted routine.
# | Type | Name | Description |
---|---|---|---|
1 | uint | speed | Movement speed. Higher values result in a faster speed. 0 will result in an instant movement.
Values starting at 32770 and above will be slower than a value of 1. |
2 | uint | x | The pixel position on the X-axis. |
3 | uint | y | The pixel position on the Y-axis. |
0xb0 - Move2PositionLives
Moves an entity (i.e., an actor, object, or performer) to an actor without restricting the angles used.
This opcode must be used in a with-statement or a targeted routine.
# | Type | Name | Description |
---|---|---|---|
1 | uint | speed | Movement speed. Higher values result in a faster speed. 0 will result in an instant movement.
Values starting at 32770 and above will be slower than a value of 1. |
2 | Entity | actor_id | An entry in the Actor List. |
0xb1 - Move2PositionMark
Moves an entity (i.e., an actor, object, or performer) to one or more Position Marks without restricting the angles used.
This opcode does not have a parameter for an entity, as it must be used in a with-statement or a targeted routine.
# | Type | Name | Description |
---|---|---|---|
1 | uint | num_parameters | The number of parameters to read from this opcode. |
2+ | PositionMark | pos_marker | A structure consisting of a name, X unit, and Y unit. Units are defined as 8 pixels.
This parameter may be repeated multiple times. |
0xb2 - Move2PositionMark
Moves an entity (i.e., an actor, object, or performer) to a Position Mark without restricting the angles used.
This opcode does not have a parameter for an entity, as it must be used in a with-statement or a targeted routine.
# | Type | Name | Description |
---|---|---|---|
1 | uint | speed | Movement speed. Higher values result in a faster speed. 0 will result in an instant movement.
Values starting at 32770 and above will be slower than a value of 1. |
2 | PositionMark | pos_marker | A structure consisting of a name, X unit, and Y unit. Units are defined as 8 pixels. |
0xb3 - Move2PositionOffset
Offsets an entity (i.e., an actor, object, or performer) from its current position across both axes without restricting the angles used.
This opcode does not have a parameter for an entity, as it must be used in a with-statement or a targeted routine.
# | Type | Name | Description |
---|---|---|---|
1 | uint | num_parameters | The number of parameters to read from this opcode. |
2+ | sint | x, y | The pixel offset to shift the entity across the X or Y-axis.
This parameter may be repeated multiple times. |
0xb4 - Move2PositionOffset
Offsets an entity (i.e., an actor, object, or performer) from its current position across both axes without restricting the angles used.
This opcode does not have a parameter for an entity, as it must be used in a with-statement or a targeted routine.
# | Type | Name | Description |
---|---|---|---|
1 | uint | speed | Movement speed. Higher values result in a faster speed. 0 will result in an instant movement.
Values starting at 32770 and above will be slower than a value of 1. |
2 | sint | x | The pixel offset to shift the entity across the X-axis. |
3 | sint | y | The pixel offset to shift the entity across the Y-axis. |
0xb5 - Move2PositionOffsetRandom
Continuously and randomly offsets an entity (i.e., an actor, object, or performer) from its current position across both axes without restricting the angles used.
This opcode does not have a parameter for an entity, as it must be used in a with-statement or a targeted routine.
# | Type | Name | Description |
---|---|---|---|
1 | uint | speed | Movement speed. Higher values result in a faster speed. 0 will result in an instant movement.
Values starting at 32770 and above will be slower than a value of 1. |
2 | sint | x | Determines something about the random pixel value chosen to apply to the X-axis; somewhat unknown. |
3 | sint | y | Determines something about the random pixel value chosen to apply to the Y-axis; somewhat unknown. |
0xb6 - Move3Position
Moves an entity (i.e., an actor, object, or performer) to a specific pixel position in a rapid, strange motion.
This opcode does not have a parameter for an entity, as it must be used in a with-statement or a targeted routine.
# | Type | Name | Description |
---|---|---|---|
1 | uint | speed | Movement speed. Higher values result in a faster speed. 0 will result in an instant movement.
Values starting at 32770 and above will be slower than a value of 1. |
2 | uint | x | The pixel position on the X-axis. |
3 | uint | y | The pixel position on the Y-axis. |
0xb7 - Move3PositionLives
Moves an entity (i.e., an actor, object, or performer) to an actor in a rapid, strange motion.
This opcode must be used in a with-statement or a targeted routine.
# | Type | Name | Description |
---|---|---|---|
1 | uint | speed | Movement speed. Higher values result in a faster speed. 0 will result in an instant movement.
Values starting at 32770 and above will be slower than a value of 1. |
2 | Entity | actor_id | An entry in the Actor List. |
0xb8 - Move3PositionMark
Moves an entity (i.e., an actor, object, or performer) to a Position Mark in a rapid, strange motion.
This opcode does not have a parameter for an entity, as it must be used in a with-statement or a targeted routine.
# | Type | Name | Description |
---|---|---|---|
1 | uint | num_parameters | The number of parameters to read from this opcode. |
2+ | PositionMark | pos_marker | A structure consisting of a name, X unit, and Y unit. Units are defined as 8 pixels.
This parameter may be repeated multiple times. |
0xb9 - Move3PositionMark
Moves an entity (i.e., an actor, object, or performer) to a Position Mark in a rapid, strange motion.
This opcode does not have a parameter for an entity, as it must be used in a with-statement or a targeted routine.
# | Type | Name | Description |
---|---|---|---|
1 | uint | speed | Movement speed. Higher values result in a faster speed. 0 will result in an instant movement.
Values starting at 32770 and above will be slower than a value of 1. |
2 | PositionMark | pos_marker | A structure consisting of a name, X unit, and Y unit. Units are defined as 8 pixels. |
0xba - Move3PositionOffset
Offsets an entity (i.e., an actor, object, or performer) from its current position across both axes in a rapid, strange motion.
This opcode does not have a parameter for an entity, as it must be used in a with-statement or a targeted routine.
# | Type | Name | Description |
---|---|---|---|
1 | uint | num_parameters | The number of parameters to read from this opcode. |
2+ | sint | x, y | The pixel offset to shift the entity across the X or Y-axis.
This parameter may be repeated multiple times. |
0xbb - Move3PositionOffset
Offsets an entity (i.e., an actor, object, or performer) from its current position across both axes in a rapid, strange motion.
This opcode does not have a parameter for an entity, as it must be used in a with-statement or a targeted routine.
# | Type | Name | Description |
---|---|---|---|
1 | uint | speed | Movement speed. Higher values result in a faster speed. 0 will result in an instant movement.
Values starting at 32770 and above will be slower than a value of 1. |
2 | sint | x | The pixel offset to shift the entity across the X-axis. |
3 | sint | y | The pixel offset to shift the entity across the Y-axis. |
0xbc - Move3PositionOffsetRandom
Continuously and randomly offsets an entity (i.e., an actor, object, or performer) from its current position across both axes in a rapid, strange motion.
This opcode does not have a parameter for an entity, as it must be used in a with-statement or a targeted routine.
# | Type | Name | Description |
---|---|---|---|
1 | uint | speed | Movement speed. Higher values result in a faster speed. 0 will result in an instant movement.
Values starting at 32770 and above will be slower than a value of 1. |
2 | sint | x | Determines something about the random pixel value chosen to apply to the X-axis; somewhat unknown. |
3 | sint | y | Determines something about the random pixel value chosen to apply to the Y-axis; somewhat unknown. |
0xbd - MoveDirection
Offsets an entity (i.e., an actor, object, or performer) by a certain number of pixels based on a given direction. Movement is performed while restricting movement by eight angles—as if movement was performed using the D-Pad.
This opcode does not have a parameter for an entity, as it must be used in a with-statement or a targeted routine.
# | Type | Name | Description |
---|---|---|---|
1 | uint | speed | Movement speed. Higher values result in a faster speed. 0 will result in an instant movement. |
2 | sint | offset | The pixel offset to shift the entity relative to the entity's direction. |
3 | Direction | direction | The type of direction, the list of which can be seen by typing DIR_ in SkyTemple's Script Engine Debugger.
|
0xbe - MoveHeight
Moves an entity (i.e., an actor, object, or performer) to a certain pixel height, displacing it from its shadow. When used, the entity's animation and direction will not change.
This opcode does not have a parameter for an entity, as it must be used in a with-statement or a targeted routine.
# | Type | Name | Description |
---|---|---|---|
1 | uint | speed | Movement speed. Higher values result in a faster speed. 0 will result in an instant movement. |
2 | sint | height | The pixel height to set the entity relative to their shadow. |
0xbf - MovePosition
Moves an entity (i.e., an actor, object, or performer) to a specific pixel position while restricting movement by eight angles—as if movement was performed using the D-Pad.
This opcode does not have a parameter for an entity, as it must be used in a with-statement or a targeted routine.
# | Type | Name | Description |
---|---|---|---|
1 | uint | speed | Movement speed. Higher values result in a faster speed. 0 will result in an instant movement.
Values starting at 32770 and above will be slower than a value of 1. |
2 | uint | x | The pixel position on the X-axis. |
3 | uint | y | The pixel position on the Y-axis. |
0xc0 - MovePositionLives
Moves an entity (i.e., an actor, object, or performer) to an actor while restricting movement by eight angles—as if movement was performed using the D-Pad.
This opcode must be used in a with-statement or a targeted routine.
# | Type | Name | Description |
---|---|---|---|
1 | uint | speed | Movement speed. Higher values result in a faster speed. 0 will result in an instant movement.
Values starting at 32770 and above will be slower than a value of 1. |
2 | Entity | actor_id | An entry in the Actor List. |
0xc1 - MovePositionLivesTime
Moves an entity (i.e., an actor, object, or performer) to an actor while restricting movement by eight angles—as if movement was performed using the D-Pad. Movement will end once either the entity reaches the actor or after a certain number of frames have passed—whichever comes first.
This opcode must be used in a with-statement or a targeted routine.
# | Type | Name | Description |
---|---|---|---|
1 | uint | speed | Movement speed. Higher values result in a faster speed. 0 will result in an instant movement.
Values starting at 32770 and above will be slower than a value of 1. |
2 | Entity | actor_id | An entry in the Actor List. |
3 | uint | duration | The number of frames used to move the entity. |
0xc2 - MovePositionMark
Moves an entity (i.e., an actor, object, or performer) to a Position Mark while restricting movement by eight angles—as if movement was performed using the D-Pad.
This opcode does not have a parameter for an entity, as it must be used in a with-statement or a targeted routine.
# | Type | Name | Description |
---|---|---|---|
1 | uint | num_parameters | The number of parameters to read from this opcode. |
2+ | PositionMark | pos_marker | A structure consisting of a name, X unit, and Y unit. Units are defined as 8 pixels.
This parameter may be repeated multiple times. |
0xc3 - MovePositionMark
Moves an entity (i.e., an actor, object, or performer) to a Position Mark while restricting movement by eight angles—as if movement was performed using the D-Pad.
This opcode does not have a parameter for an entity, as it must be used in a with-statement or a targeted routine.
# | Type | Name | Description |
---|---|---|---|
1 | uint | speed | Movement speed. Higher values result in a faster speed. 0 will result in an instant movement.
Values starting at 32770 and above will be slower than a value of 1. |
2 | PositionMark | pos_marker | A structure consisting of a name, X unit, and Y unit. Units are defined as 8 pixels. |
0xc4 - MovePositionMarkTime
Moves an entity (i.e., an actor, object, or performer) to an Position Mark while restricting movement by eight angles—as if movement was performed using the D-Pad. Movement will end once either the entity reaches the Position Mark or after a certain number of frames have passed—whichever comes first.
This opcode does not have a parameter for an entity, as it must be used in a with-statement or a targeted routine.
# | Type | Name | Description |
---|---|---|---|
1 | uint | speed | Movement speed. Higher values result in a faster speed. 0 will result in an instant movement.
Values starting at 32770 and above will be slower than a value of 1. |
2 | PositionMark | pos_marker | A structure consisting of a name, X unit, and Y unit. Units are defined as 8 pixels. |
3 | uint | duration | The number of frames used to move the entity. |
0xc5 - MovePositionOffset
Offsets an entity (i.e., an actor, object, or performer) from its current position across both axes while restricting movement by eight angles—as if movement was performed using the D-Pad.
This opcode does not have a parameter for an entity, as it must be used in a with-statement or a targeted routine.
# | Type | Name | Description |
---|---|---|---|
1 | uint | num_parameters | The number of parameters to read from this opcode. |
2+ | sint | x, y | The pixel offset to shift the entity across the X or Y-axis.
This parameter may be repeated multiple times. |
0xc6 - MovePositionOffset
Offsets an entity (i.e., an actor, object, or performer) from its current position across both axes while restricting movement by eight angles—as if movement was performed using the D-Pad.
This opcode does not have a parameter for an entity, as it must be used in a with-statement or a targeted routine.
# | Type | Name | Description |
---|---|---|---|
1 | uint | speed | Movement speed. Higher values result in a faster speed. 0 will result in an instant movement.
Values starting at 32770 and above will be slower than a value of 1. |
2 | sint | x | The pixel offset to shift the entity across the X-axis. |
3 | sint | y | The pixel offset to shift the entity across the Y-axis. |
0xc7 - MoveSpecial
Currently unknown. Seems to move an entity (i.e., an actor, object, or performer) based on some hardcoded behaviors.
This opcode does not have a parameter for an entity, as it must be used in a with-statement or a targeted routine.
# | Type | Name | Description |
---|---|---|---|
1 | uint | mode | Determines the kind of action.
|
2 | uint | unk1 | Currently unknown. Seems to affect how far the entity will move? |
3 | uint | unk2 | Currently unknown. |
0xc8 - MoveTurn
Moves an entity (i.e., an actor, object, or performer) based on a certain pattern. Unlike other Move
opcodes, this opcode will make the entity interact with the currently loaded Map Background's collision (i.e., the entity stops when hitting a wall).
This opcode does not have a parameter for an entity, as it must be used in a with-statement or a targeted routine.
# | Type | Name | Description |
---|---|---|---|
1 | uint | distance | How far the entity will move. Higher values result in greater distance being covered. |
2 | uint | speed | Movement speed. Higher values result in a faster speed. 0 will result in an instant movement.
Values starting at 32770 and above will be slower than a value of 1. This parameter also seems to affect the distance traveled. |
3 | uint | pattern | A hardcoded pattern to move in.
Values 6 and above seem to be variations of random movement. |
0xca - PauseEffect
Instantly pauses the current graphical effect of an entity (i.e., an actor, object, or performer). The effect will freeze mid-frame.
This opcode does not have a parameter for an entity, as it must be used in a with-statement or a targeted routine.
# | Type | Name | Description |
---|---|---|---|
1 | Effect | effect_id | A graphical effect to display relative to an entity. |
0xcc - ProcessSpecial
Executes one of the game's Special Processes. The return value of a Special Process can be checked by encasing this opcode in a switch
statement. A negative return value is not acceptable and will cause the game to suspend indefinitely.
This opcode cannot be used in targeted routines.
# | Type | Name | Description |
---|---|---|---|
1 | ProcessSpecial | process_id | One of the game's Special Processes. |
2 | sint | process_param1 | The first parameter used by the Special Process. |
3 | sint | process_param2 | The first parameter used by the Special Process. |
0xcd - PursueTurnLives
Causes an entity (i.e., an actor, object, or performer) to continuously turn toward an actor for a certain number of frames.
This opcode must be used in a with-statement or a targeted routine.
# | Type | Name | Description |
---|---|---|---|
1 | uint | duration | The number of frames used to make the entity turn. A value of 0 will make the entity turn forever. |
2 | uint | speed | Turning speed. Higher values result in a slower speed. |
3 | Entity | actor_id | The actor to turn toward. |
4 | uint | rotation |
A value of 10 will make the entity choose the nearest rotation. |
0xce - PursueTurnLives2
Causes an entity (i.e., an actor, object, or performer) to continuously turn toward an actor for a certain number of frames.
This opcode must be used in a with-statement or a targeted routine.
# | Type | Name | Description |
---|---|---|---|
1 | uint | duration | The number of frames used to make the entity turn. A value of 0 will make the entity turn forever. |
2 | uint | speed | Turning speed. Higher values result in a slower speed. |
3 | Entity | actor_id | The actor to turn toward. |
4 | uint | rotation |
A value of 10 will make the entity choose the nearest rotation. |
0xcf - ResetAttribute
Currently unknown. Seems to get ignored when parsed in the scripting engine.
# | Type | Name | Description |
---|---|---|---|
1 | uint | unk0 | Currently unknown. |
0xd0 - ResetFunctionAttribute
Sets certain bits of an entity's (i.e., an actor, object, or performer) "function" attribute to 0.
# | Type | Name | Description |
---|---|---|---|
1 | bitfield | function_bitfield | Most bits' purposes are unknown. Bit 1 appears to be the bit used for allowing an entity to follow a Type 1 actor, like the actor ACTOR_ATTENDANT1 in the overworld. |
0xd1 - ResetHitAttribute
Sets certain bits of an entity's (i.e., an actor, object, or performer) "hit" attribute to 0.
# | Type | Name | Description |
---|---|---|---|
1 | bitfield | hit_bitfield | Most bits' purposes are unknown.
|
0xd2 - ResetOutputAttribute
Sets certain bits of an entity's (i.e., an actor, object, or performer) "output" attribute to 0.
# | Type | Name | Description |
---|---|---|---|
1 | bitfield | output_bitfield |
|
0xd3 - ResetReplyAttribute
Sets certain bits of an entity's (i.e., an actor, object, or performer) "reply" attribute to 0.
# | Type | Name | Description |
---|---|---|---|
1 | bitfield | reply_bitfield | Most bits' purposes are unknown.
|
0xd4 - ResumeEffect
Resumes the current graphical effect of an entity (i.e., an actor, object, or performer) that has been paused with PauseEffect
prior to using this opcode.
This opcode does not have a parameter for an entity, as it must be used in a with-statement or a targeted routine.
# | Type | Name | Description |
---|---|---|---|
1 | Effect | effect_id | A graphical effect to display relative to an entity. |
0xd6 - SavePosition
Saves various attributes of an entity (i.e., an actor, object, or performer) to the following script variables:
$POSITION_X
: The pixel position of the entity on the X-axis multiplied by 256.$POSITION_Y
: The pixel position of the entity on the Y-axis multiplied by 256.$POSITION_HEIGHT
: The pixel height (i.e., displacement of the entity from their shadow) of the entity multiplied by 256.$POSITION_DIRECTION
: The direction the entity is facing.
This opcode does not have a parameter for an entity, as it must be used in a with-statement or a targeted routine.
# | Type | Name | Description |
---|---|---|---|
1 | uint | index | Index used by all $POSITION_ script variables, ranged from 0-2 (inclusive).
|
0xd7 - screen_FadeChange
Changes the brightness of the screen across a certain number of frames. This opcode will not affect:
- Entities who have had their 4th "output" bit set to 1 (e.g., by using
SetOutputAttribute(16);
with them). - Portraits.
- Textboxes.
# | Type | Name | Description |
---|---|---|---|
1 | uint | suspension_flag | Determines whether the script will suspend until this opcode's operation is complete. 0 is false and 1 is true. |
2 | uint | duration | The number of frames used to change the Touch Screen's brightness. |
3 | uint | start_brightness | The brightness level the opcode will begin at.
|
4 | uint | end_brightness | The brightness level the opcode will end at.
|
0xd8 - screen_FadeChangeAll
Changes the brightness of the screen across a certain number of frames. This opcode will affect everything on the Touch Screen.
# | Type | Name | Description |
---|---|---|---|
1 | uint | suspension_flag | Determines whether the script will suspend until this opcode's operation is complete. 0 is false and anything else is true. |
2 | uint | duration | The number of frames used to change the Touch Screen's brightness. |
3 | uint | start_brightness | The brightness level the opcode will begin at.
|
4 | uint | end_brightness | The brightness level the opcode will end at.
|
0xd9 - screen_FadeIn
Changes the brightness of the screen to its default state across a certain number of frames. This opcode will not affect:
- Entities who have had their 4th "output" bit set to 1 (e.g., by using
SetOutputAttribute(16);
with them). - Portraits.
- Textboxes.
# | Type | Name | Description |
---|---|---|---|
1 | uint | suspension_flag | Determines whether the script will suspend until this opcode's operation is complete. 0 is false and anything else is true. |
2 | uint | duration | The number of frames used to change the Touch Screen's brightness. |
0xda - screen_FadeInAll
Changes the brightness of the screen to its default state across a certain number of frames. This opcode will affect everything on the Touch Screen.
# | Type | Name | Description |
---|---|---|---|
1 | uint | suspension_flag | Determines whether the script will suspend until this opcode's operation is complete. 0 is false and anything else is true. |
2 | uint | duration | The number of frames used to change the Touch Screen's brightness. |
0xdb - screen_FadeOut
Changes the brightness of the screen to its minimum (i.e., a black screen) across a certain number of frames. This opcode will not affect:
- Entities who have had their 4th "output" bit set to 1 (e.g., by using
SetOutputAttribute(16);
with them). - Portraits.
- Textboxes.
# | Type | Name | Description |
---|---|---|---|
1 | uint | suspension_flag | Determines whether the script will suspend until this opcode's operation is complete. 0 is false and anything else is true. |
2 | uint | duration | The number of frames used to change the Touch Screen's brightness. |
0xdc - screen_FadeOutAll
Changes the brightness of the screen to its minimum (i.e., a black screen) across a certain number of frames. This opcode will affect everything on the Touch Screen.
# | Type | Name | Description |
---|---|---|---|
1 | uint | suspension_flag | Determines whether the script will suspend until this opcode's operation is complete. 0 is false and anything else is true. |
2 | uint | duration | The number of frames used to change the Touch Screen's brightness. |
0xdd - screen_FlushChange
Does nothing.
# | Type | Name | Description |
---|---|---|---|
1 | uint | unk0 | Does nothing. |
2 | uint | unk1 | Does nothing. |
3 | uint | unk2 | Does nothing. |
4 | uint | unk3 | Does nothing. |
5 | uint | unk4 | Does nothing. |
6 | uint | unk5 | Does nothing. |
7 | uint | unk6 | Does nothing. |
8 | uint | unk7 | Does nothing. |
0xde - screen_FlushIn
Changes the color of the screen from a specific state (given by the opcode's parameters, which affect the Touch Screen instantly) to its default state across a certain number of frames. This opcode will affect all entities (i.e., actors, objects, and performers) on the Touch Screen.
# | Type | Name | Description |
---|---|---|---|
1 | uint | suspension_flag | Determines whether the script will suspend until this opcode's operation is complete. 0 is false and anything else is true. |
2 | uint | duration | The number of frames used to change the Touch Screen's color. |
3 | uint | mode |
|
4 | uint | r | Unused if mode is not 2 or 4. Byte used for the color red. Has a minimum of 0 and a maximium of 255. |
5 | uint | g | Unused if mode is not 2 or 4. Byte used for the color green. Has a minimum of 0 and a maximium of 255. |
6 | uint | b | Unused if mode is not 2 or 4. Byte used for the color blue. Has a minimum of 0 and a maximium of 255. |
0xdf - screen_FlushOut
Changes the color of the screen across a certain number of frames. This opcode will affect all entities (i.e., actors, objects, and performers) on the Touch Screen.
# | Type | Name | Description |
---|---|---|---|
1 | uint | suspension_flag | Determines whether the script will suspend until this opcode's operation is complete. 0 is false and anything else is true. |
2 | uint | duration | The number of frames used to change the Touch Screen's color. |
3 | uint | mode |
|
4 | uint | r | Unused if mode is not 2 or 4. Byte used for the color red. Has a minimum of 0 and a maximium of 255. |
5 | uint | g | Unused if mode is not 2 or 4. Byte used for the color green. Has a minimum of 0 and a maximium of 255. |
6 | uint | b | Unused if mode is not 2 or 4. Byte used for the color blue. Has a minimum of 0 and a maximium of 255. |
0xe0 - screen_WhiteChange
Changes the brightness of the screen across a certain number of frames. This opcode will not affect:
- Entities who have had their 4th "output" bit set to 1 (e.g., by using
SetOutputAttribute(16);
with them). - Portraits.
- Textboxes.
# | Type | Name | Description |
---|---|---|---|
1 | uint | suspension_flag | Determines whether the script will suspend until this opcode's operation is complete. 0 is false and 1 is true. |
2 | uint | duration | The number of frames used to change the Touch Screen's brightness. |
3 | uint | start_brightness | The brightness level the opcode will begin at.
|
4 | uint | end_brightness | The brightness level the opcode will end at.
|
0xe1 - screen_WhiteChangeAll
Changes the brightness of the screen across a certain number of frames. This opcode will affect everything on the Touch Screen.
# | Type | Name | Description |
---|---|---|---|
1 | uint | suspension_flag | Determines whether the script will suspend until this opcode's operation is complete. 0 is false and anything else is true. |
2 | uint | duration | The number of frames used to change the Touch Screen's brightness. |
3 | uint | start_brightness | The brightness level the opcode will begin at.
|
4 | uint | end_brightness | The brightness level the opcode will end at.
|
0xe2 - screen_WhiteIn
Does nothing. Do not be deceived by this opcode's name: After using screen_WhiteOut
, use screen_FadeIn
to restore the Touch Screen's brightness level!
# | Type | Name | Description |
---|---|---|---|
1 | uint | unk0 | Does nothing. |
2 | uint | unk1 | Does nothing. |
0xe3 - screen_WhiteInAll
Does nothing. Do not be deceived by this opcode's name: After using screen_WhiteOutAll
, use screen_FadeInAll
to restore the Touch Screen's brightness level!
# | Type | Name | Description |
---|---|---|---|
1 | uint | unk0 | Does nothing. |
2 | uint | unk1 | Does nothing. |
0xe4 - screen_WhiteOut
Changes the brightness of the screen to its maximum (i.e., a white screen) across a certain number of frames. This opcode will not affect:
- Entities who have had their 4th "output" bit set to 1 (e.g., by using
SetOutputAttribute(16);
with them). - Portraits.
- Textboxes.
# | Type | Name | Description |
---|---|---|---|
1 | uint | suspension_flag | Determines whether the script will suspend until this opcode's operation is complete. 0 is false and anything else is true. |
2 | uint | duration | The number of frames used to change the Touch Screen's brightness. |
0xe5 - screen_WhiteOutAll
Changes the brightness of the screen to its maximum (i.e., a white screen) across a certain number of frames. This opcode will affect everything on the Touch Screen.
# | Type | Name | Description |
---|---|---|---|
1 | uint | suspension_flag | Determines whether the script will suspend until this opcode's operation is complete. 0 is false and anything else is true. |
2 | uint | duration | The number of frames used to change the Touch Screen's brightness. |
0xe6 - screen2_FadeChange
Changes the brightness of the screen across a certain number of frames. This opcode will affect everything on the Top Screen.
# | Type | Name | Description |
---|---|---|---|
1 | uint | suspension_flag | Determines whether the script will suspend until this opcode's operation is complete. 0 is false and 1 is true. |
2 | uint | duration | The number of frames used to change the Top Screen's brightness. |
3 | uint | start_brightness | The brightness level the opcode will begin at.
|
4 | uint | end_brightness | The brightness level the opcode will end at.
|
0xe7 - screen2_FadeChangeAll
Does nothing.
# | Type | Name | Description |
---|---|---|---|
1 | uint | unk0 | Does nothing. |
2 | uint | unk1 | Does nothing. |
3 | uint | unk2 | Does nothing. |
4 | uint | unk3 | Does nothing. |
0xe8 - screen2_FadeIn
Changes the brightness of the screen to its default state across a certain number of frames. This opcode will affect everything on the Top Screen.
# | Type | Name | Description |
---|---|---|---|
1 | uint | suspension_flag | Determines whether the script will suspend until this opcode's operation is complete. 0 is false and anything else is true. |
2 | uint | duration | The number of frames used to change the Top Screen's brightness. |
0xe9 - screen2_FadeInAll
Does nothing.
# | Type | Name | Description |
---|---|---|---|
1 | uint | unk0 | Does nothing. |
2 | uint | unk1 | Does nothing. |
0xea - screen2_FadeOut
Changes the brightness of the screen to its minimum (i.e., a black screen) across a certain number of frames. This opcode will affect everything on the Top Screen.
# | Type | Name | Description |
---|---|---|---|
1 | uint | suspension_flag | Determines whether the script will suspend until this opcode's operation is complete. 0 is false and anything else is true. |
2 | uint | duration | The number of frames used to change the Top Screen's brightness. |
0xeb - screen2_FadeOutAll
Does nothing.
# | Type | Name | Description |
---|---|---|---|
1 | uint | unk0 | Does nothing. |
2 | uint | unk1 | Does nothing. |
0xec - screen2_FlushChange
Does nothing.
# | Type | Name | Description |
---|---|---|---|
1 | uint | unk0 | Does nothing. |
2 | uint | unk1 | Does nothing. |
3 | uint | unk2 | Does nothing. |
4 | uint | unk3 | Does nothing. |
5 | uint | unk4 | Does nothing. |
6 | uint | unk5 | Does nothing. |
7 | uint | unk6 | Does nothing. |
8 | uint | unk7 | Does nothing. |
0xed - screen2_FlushIn
The same as screen_FlushIn
, but for the Top Screen.
# | Type | Name | Description |
---|---|---|---|
1 | uint | suspension_flag | Determines whether the script will suspend until this opcode's operation is complete. 0 is false and anything else is true. |
2 | uint | duration | The number of frames used to change the Top Screen's color. |
3 | uint | mode |
|
4 | uint | r | Unused if mode is not 2 or 4. Byte used for the color red. Has a minimum of 0 and a maximium of 255. |
5 | uint | g | Unused if mode is not 2 or 4. Byte used for the color green. Has a minimum of 0 and a maximium of 255. |
6 | uint | b | Unused if mode is not 2 or 4. Byte used for the color blue. Has a minimum of 0 and a maximium of 255. |
0xee - screen2_FlushOut
The same as screen_FlushOut
, but for the Top Screen.
# | Type | Name | Description |
---|---|---|---|
1 | uint | suspension_flag | Determines whether the script will suspend until this opcode's operation is complete. 0 is false and anything else is true. |
2 | uint | duration | The number of frames used to change the Top Screen's color. |
3 | uint | mode |
|
4 | uint | r | Unused if mode is not 2 or 4. Byte used for the color red. Has a minimum of 0 and a maximium of 255. |
5 | uint | g | Unused if mode is not 2 or 4. Byte used for the color green. Has a minimum of 0 and a maximium of 255. |
6 | uint | b | Unused if mode is not 2 or 4. Byte used for the color blue. Has a minimum of 0 and a maximium of 255. |
0xef - screen2_WhiteChange
Changes the brightness of the screen across a certain number of frames. This opcode will affect everything on the Top Screen.
# | Type | Name | Description |
---|---|---|---|
1 | uint | suspension_flag | Determines whether the script will suspend until this opcode's operation is complete. 0 is false and anything else is true. |
2 | uint | duration | The number of frames used to change the Top Screen's brightness. |
3 | uint | start_brightness | The brightness level the opcode will begin at.
|
4 | uint | end_brightness | The brightness level the opcode will end at.
|
0xf0 - screen2_WhiteChangeAll
Does nothing.
# | Type | Name | Description |
---|---|---|---|
1 | uint | unk0 | Does nothing. |
2 | uint | unk1 | Does nothing. |
3 | uint | unk2 | Does nothing. |
4 | uint | unk3 | Does nothing. |
0xf1 - screen2_WhiteIn
Does nothing. Do not be deceived by this opcode's name: After using screen2_WhiteOut
, use screen2_FadeIn
to restore the Top Screen's brightness level!
# | Type | Name | Description |
---|---|---|---|
1 | uint | unk0 | Does nothing. |
2 | uint | unk1 | Does nothing. |
0xf2 - screen2_WhiteInAll
Does nothing.
# | Type | Name | Description |
---|---|---|---|
1 | uint | unk0 | Does nothing. |
2 | uint | unk1 | Does nothing. |
0xf3 - screen2_WhiteOut
Changes the brightness of the screen to its maximum (i.e., a white screen) across a certain number of frames. This opcode will affect everything on the Top Screen.
# | Type | Name | Description |
---|---|---|---|
1 | uint | suspension_flag | Determines whether the script will suspend until this opcode's operation is complete. 0 is false and anything else is true. |
2 | uint | duration | The number of frames used to change the Top Screen's brightness. |
0xf4 - screen2_WhiteOutAll
Does nothing.
# | Type | Name | Description |
---|---|---|---|
1 | uint | unk0 | Does nothing. |
2 | uint | unk1 | Does nothing. |
0xf5 - se_ChangePan
Changes the panning of the currently-playing sound effect across a certain number of frames.
# | Type | Name | Description |
---|---|---|---|
1 | uint | se_id | A sound effect defined in SOUND/SE of the ROM. Actually encoded as sound_bank_id << 8 + sound_id , but it can also be represented as an integer.
|
2 | uint | duration | The number of frames used to change the SE's panning. |
3 | uint | pan | The panning of the SE. This parameter gets recalculated internally as ((pan * 0x3f + ((pan * 0x3f >> 7) >> 0x18)) >> 8) + 0x40 , which is eventually split up into two halfwords, then recalculated further into a signed byte.
What this means is that:
More research on this parameter may be needed. |
0xf6 - se_ChangeVolume
Changes the volume of the currently-playing sound effect across a certain number of frames.
# | Type | Name | Description |
---|---|---|---|
1 | uint | se_id | A sound effect defined in SOUND/SE of the ROM. Actually encoded as sound_bank_id << 8 + sound_id , but it can also be represented as an integer.
|
2 | uint | duration | The number of frames used to change the SE's volume. |
3 | uint | volume | The volume that the SE will play at. It has a maximum of 256 and a minimum of 0. |
0xf7 - se_FadeOut
Fades out the currently-playing sound effect across a certain number of frames.
# | Type | Name | Description |
---|---|---|---|
1 | uint | se_id | A sound effect defined in SOUND/SE of the ROM. Actually encoded as sound_bank_id << 8 + sound_id , but it can also be represented as an integer.
|
2 | uint | duration | The number of frames used to fade out and silence a given SE. |
0xf8 - se_Play
Instantly plays a sound effect.
# | Type | Name | Description |
---|---|---|---|
1 | uint | se_id | A sound effect defined in SOUND/SE of the ROM. Actually encoded as sound_bank_id << 8 + sound_id , but it can also be represented as an integer.
|
0xf9 - se_PlayFull
Instantly plays a sound effect at a specified volume and panning.
# | Type | Name | Description |
---|---|---|---|
1 | uint | se_id | A sound effect defined in SOUND/SE of the ROM. Actually encoded as sound_bank_id << 8 + sound_id , but it can also be represented as an integer.
|
2 | uint | volume | The volume that the SE will play at. It has a maximum of 256 and a minimum of 0. |
3 | uint | pan | The panning of the SE. This parameter gets recalculated internally as ((pan * 0x3f + ((pan * 0x3f >> 7) >> 0x18)) >> 8) + 0x40 , which is eventually split up into two halfwords, then recalculated further into a signed byte.
What this means is that:
More research on this parameter may be needed. |
0xfa - se_PlayPan
Instantly plays a sound effect at a specified panning.
# | Type | Name | Description |
---|---|---|---|
1 | uint | se_id | A sound effect defined in SOUND/SE of the ROM. Actually encoded as sound_bank_id << 8 + sound_id , but it can also be represented as an integer.
|
2 | uint | pan | The panning of the SE. This parameter gets recalculated internally as ((pan * 0x3f + ((pan * 0x3f >> 7) >> 0x18)) >> 8) + 0x40 , which is eventually split up into two halfwords, then recalculated further into a signed byte.
What this means is that:
More research on this parameter may be needed. |
0xfb - se_PlayVolume
Instantly plays a sound effect at a specified volume.
# | Type | Name | Description |
---|---|---|---|
1 | uint | se_id | A sound effect defined in SOUND/SE of the ROM. Actually encoded as sound_bank_id << 8 + sound_id , but it can also be represented as an integer.
|
2 | uint | volume | The volume that the SE will play at. It has a maximum of 256 and a minimum of 0. |
0xfc - se_Stop
Instantly stops a specified sound effect.
# | Type | Name | Description |
---|---|---|---|
1 | uint | se_id | A sound effect defined in SOUND/SE of the ROM. Actually encoded as sound_bank_id << 8 + sound_id , but it can also be represented as an integer.
|
0xfd - SetAnimation
Plays a sprite's animation, optionally changing its speed and animation flags.
# | Type | Name | Description |
---|---|---|---|
1 | uint | id | Animation table index. Converted to an Animation ID for the current sprite using the SetAnimation table. |
0xfe - SetAttribute
Does nothing.
# | Type | Name | Description |
---|---|---|---|
1 | uint | unk0 | Does nothing. |
0xff - SetBlink
Sets a specific entity (i.e., an actor, object, or performer) to continuously flicker in and out of view at a certain interval.
This opcode does not have a parameter for an entity, as it must be used in a with-statement or a targeted routine.
# | Type | Name | Description |
---|---|---|---|
1 | uint | visible_interval | The number of frames to wait for while the entity is visible. |
2 | uint | invisible_interval | The number of frames to wait for while the entity is invisible. |
0x100 - SetDirection
Instantly sets a specific entity (i.e., an actor, object, or performer) to a specified direction.
This opcode does not have a parameter for an entity, as it must be used in a with-statement or a targeted routine.
# | Type | Name | Description |
---|---|---|---|
1 | Direction | direction | The type of direction, the list of which can be seen by typing DIR_ in SkyTemple's Script Engine Debugger.
|
0x101 - SetDirectionLives
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | uint | unk0 | |
2 | uint | unk1 |
0x102 - SetEffect
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | Effect | effect_id | |
2 | uint | position_marker_id? |
0x103 - SetFunctionAttribute
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | bitfield | unk0 |
0x104 - SetHeight
Moves an actor "vertically" by distancing it from its shadow.
# | Type | Name | Description |
---|---|---|---|
1 | uint | unk0 | number of pixels to move up or down by. |
0x105 - SetHitAttribute
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | bitfield | unk0 |
0x106 - SetMoveRange
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | PositionMark | pos_marker | |
5 | uint | unk4 | |
6 | uint | unk5 |
0x107 - SetOutputAttribute
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | bitfield | unk0 |
0x108 - SetPosition
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | uint | x | |
2 | uint | y |
0x109 - SetPositionInitial
<TO DO: Opcode description>
No parameters.
0x10a - SetPositionLives
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | uint | unk0 |
0x10b - SetPositionMark
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | PositionMark | pos_marker |
0x10c - SetPositionOffset
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | sint | x | |
2 | sint | y |
0x10d - SetPositionOffsetRandom
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | sint | x | |
2 | sint | y |
0x10e - SetReplyAttribute
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | bitfield | unk0 |
0x10f - SetupOutputAttributeAndAnimation
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | uint | unk0 | |
2 | uint | unk1 | |
3 | uint | unk2 |
0x110 - Slide2Position
Moves an entity (i.e., an actor, object, or performer) to a specific pixel position without animation. Must be used in a with-statement or a targeted routine.
# | Type | Name | Description |
---|---|---|---|
1 | uint | speed | Movement speed. Higher values result in a faster speed. 0 will result in an instant movement.Values starting at 32770 and above will be slower than a value of 1. |
2 | uint | x | The pixel position on the X-axis. |
3 | uint | y | The pixel position on the Y-axis. |
0x111 - Slide2PositionLives
Moves an entity (i.e., an actor, object, or performer) to an actor without animation. Must be used in a with-statement or a targeted routine.
# | Type | Name | Description |
---|---|---|---|
1 | uint | speed | Movement speed. Higher values result in a faster speed. 0 will result in an instant movement.Values starting at 32770 and above will be slower than a value of 1. |
2 | uint | actor_id | The ID of the actor to move the entity to. |
0x112 - Slide2PositionMark
Moves an entity (i.e., an actor, object, or performer) to one or more Position Marks without animation, and without restricting the angles used.
This opcode does not have a parameter for an entity, as it must be used in a with-statement or a targeted routine.
# | Type | Name | Description |
---|---|---|---|
1 | uint | num_parameters | The number of parameters to read from this opcode. |
2+ | PositionMark | pos_marker | A structure consisting of a name, X unit, and Y unit. Units are defined as 8 pixels.
This parameter may be repeated multiple times. |
0x113 - Slide2PositionMark
Moves an entity (i.e., an actor, object, or performer) to a Position Mark without animation, and without restricting the angles used.
This opcode does not have a parameter for an entity, as it must be used in a with-statement or a targeted routine.
# | Type | Name | Description |
---|---|---|---|
1 | uint | speed | Movement speed. Higher values result in a faster speed. 0 will result in an instant movement. Values starting at 32770 and above will be slower than a value of 1. |
2 | PositionMark | pos_mark | A structure consisting of a name, X unit, and Y unit. Units are defined as 8 pixels. |
0x114 - Slide2PositionOffset
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | uint | num_parameters | |
2+ | sint | x | These two parameters may be repeated multiple times |
3+ | sint | y |
0x115 - Slide2PositionOffset
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | uint | speed | |
2 | sint | x | |
3 | sint | y |
0x116 - Slide2PositionOffsetRandom
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | uint | speed | |
2 | sint | x | |
3 | sint | y |
0x117 - Slide3Position
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | uint | speed | |
2 | uint | x | |
3 | uint | y |
0x118 - Slide3PositionLives
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | uint | speed | |
2 | uint | actor_id |
0x119 - Slide3PositionMark
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | uint | num_parameters | |
2+ | PositionMark | pos_marker | This parameter may be repeated multiple times |
0x11a - Slide3PositionMark
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | uint | speed | |
2 | PositionMark | pos_marker |
0x11b - Slide3PositionOffset
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | uint | num_parameters | |
2+ | sint | x | These two parameters may be repeated multiple times |
3+ | sint | y |
0x11c - Slide3PositionOffset
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | uint | speed | |
2 | sint | x | |
3 | sint | y |
0x11d - Slide3PositionOffsetRandom
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | uint | speed | |
2 | sint | x | |
3 | sint | y |
0x11e - SlideHeight
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | uint | unk0 | |
2 | uint | unk1 |
0x11f - SlidePosition
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | uint | unk0 | |
2 | uint | x | |
3 | uint | y |
0x120 - SlidePositionLives
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | uint | unk0 | |
2 | uint | unk1 |
0x121 - SlidePositionLivesTime
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | uint | unk0 | |
2 | uint | unk1 | |
3 | uint | unk2 |
0x122 - SlidePositionMark
Moves an entity (i.e., an actor, object, or performer) to a Position Mark while restricting movement by eight angles—as if movement was performed using the D-Pad. Unlike MovePositionMark, this will not turn the entity to face the direction they are moving in.
This opcode does not have a parameter for an entity, as it must be used in a with-statement or a targeted routine.
# | Type | Name | Description |
---|---|---|---|
1 | uint | num_parameters | The number of parameters to read from this opcode. |
2+ | PositionMark | pos_marker | A structure consisting of a name, X unit, and Y unit. Units are defined as 8 pixels.
This parameter may be repeated multiple times. |
0x123 - SlidePositionMark
Moves an entity (i.e., an actor, object, or performer) to a Position Mark while restricting movement by eight angles—as if movement was performed using the D-Pad. Unlike MovePositionMark, this will not turn the entity to face the direction they are moving in.
This opcode does not have a parameter for an entity, as it must be used in a with-statement or a targeted routine.
# | Type | Name | Description |
---|---|---|---|
1 | uint | speed | Movement speed. Higher values result in a faster speed. 0 will result in an instant movement.
Values starting at 32770 and above will be slower than a value of 1. |
2 | PositionMark | pos_marker | A structure consisting of a name, X unit, and Y unit. Units are defined as 8 pixels. |
0x124 - SlidePositionMarkTime
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | uint | unk0 | |
2 | uint | unk1 | |
3 | PositionMark | pos_marker |
0x125 - SlidePositionOffset
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | uint | num_parameters | |
2+ | sint | x | This parameter may be repeated multiple times |
0x126 - SlidePositionOffset
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | uint | speed | |
2 | sint | x | |
3 | sint | y |
0x127 - sound_FadeOut
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | uint | unk0 |
0x128 - sound_Stop
<TO DO: Opcode description>
No parameters.
0x129 - StopAnimation
<TO DO: Opcode description>
No parameters.
0x12a - supervision_Acting
Loads a sector of the Acting scene.
# | Type | Name | Description |
---|---|---|---|
1 | uint | layer_id | The ID of the sector to load. |
0x12b - supervision_ActingInvisible
Loads a sector of the Acting scene. Actors and objects in this sector will be invisible.
# | Type | Name | Description |
---|---|---|---|
1 | uint | layer_id | The ID of the sector to load. |
0x12c - supervision_ExecuteActing
Loads a specified Acting script from the specified level from within Enter/Acting/Sub scripts.
# | Type | Name | Description |
---|---|---|---|
1 | Level | level | |
2 | ConstString | script_id | |
3 | uint | unk2 |
0x12d - supervision_ExecuteActingSub
Loads a specified Acting script from the specified level from within Unionall
# | Type | Name | Description |
---|---|---|---|
1 | Level | level | |
2 | ConstString | script_id | |
3 | uint | unk2 |
0x12e - supervision_ExecuteCommon
Loads a specified Unionall coroutine from within Enter/Acting/Sub scripts.
# | Type | Name | Description |
---|---|---|---|
1 | Routine | coro_id |
0x12f - supervision_ExecuteEnter
Loads an Enter script from the specified level.
# | Type | Name | Description |
---|---|---|---|
1 | uint | level_id | An entry in the Level list. |
0x130 - supervision_ExecuteStation
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | Level | level | |
2 | ConstString | script_id | |
3 | uint | unk2 |
0x131 - supervision_ExecuteStationCommon
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | Level | level | |
2 | uint | unk1 |
0x132 - supervision_ExecuteStationCommonSub
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | Level | level | |
2 | uint | unk1 |
0x133 - supervision_ExecuteStationSub
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | Level | level | |
2 | ConstString | script_id | |
3 | uint | unk2 |
0x134 - supervision_ExecuteExport
Loads a specified Acting scene of the level S00P01A
# | Type | Name | Description |
---|---|---|---|
1 | ConstString | script_id |
0x135 - supervision_ExecuteExportSub
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | ConstString | const |
0x136 - supervision_LoadStation
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | Level | level | |
2 | ConstString | script_id |
0x137 - supervision_Remove
Unloads a sector of the Sub scene.
# | Type | Name | Description |
---|---|---|---|
1 | uint | layer_id | The ID of the sector to unload. |
0x138 - supervision_RemoveActing
Unloads a sector of the Acting scene.
# | Type | Name | Description |
---|---|---|---|
1 | uint | layer_id | The ID of the sector to unload. |
0x139 - supervision_RemoveCommon
Unloads a sector of the Enter scene.
# | Type | Name | Description |
---|---|---|---|
1 | uint | layer_id | The ID of the sector to unload. |
0x13a - supervision_SpecialActing
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | uint | unk0 | |
2 | uint | unk1 | |
3 | uint | unk2 |
0x13b - supervision_Station
Loads a sector of the Sub scene.
# | Type | Name | Description |
---|---|---|---|
1 | uint | station_id | The ID of the sector to load. |
0x13c - supervision_StationCommon
Loads a sector of the Enter scene.
Can be used to call sectors of an enter scene within acting scenes!
# | Type | Name | Description |
---|---|---|---|
1 | uint | station_id | The ID of the sector to load. |
0x13d - supervision_Suspend
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | sint | unk0 |
0x13e - supervision2_SpecialActing
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | uint | unk0 | |
2 | uint | unk1 | |
3 | uint | unk2 |
0x14c - Turn2Direction
Makes an actor rotate to a specified direction.
This opcode does not have a parameter for an entity, as it must be used in a with-statement or a targeted routine.
# | Type | Name | Description |
---|---|---|---|
1 | uint | speed | How fast the actor turns. The higher the number, the slower the turn. |
2 | uint | rotationdirection | The way that the actor will turn to face the specified direction. 1 = clockwise, 2 = counterclockwise, 10 = the most efficient direction to turn. |
3 | Direction | direction | The direction that the actor will turn to face. |
0x14d - Turn2DirectionLives
Makes an actor rotate to face another actor. Must be used in a with-statement or a targeted routine.
# | Type | Name | Description |
---|---|---|---|
1 | uint | speed | How fast the actor turns. The higher the number, the slower the turn. |
2 | uint | rotationdirection | The way that the actor will turn to face the specified direction. 1 = clockwise, 2 = counterclockwise, 10 = the most efficient direction to turn. |
3 | Entity | actor_id | The target actor that the actor will turn to face. |
0x14e - Turn2DirectionLives2
Makes an actor rotate to face another actor. Must be used in a with-statement or a targeted routine.
# | Type | Name | Description |
---|---|---|---|
1 | uint | speed | How fast the actor turns. The higher the number, the slower the turn. |
2 | uint | rotationdirection | The way that the actor will turn to face the specified direction. 1 = clockwise, 2 = counterclockwise, 10 = the most efficient direction to turn. |
3 | uint | actor_id | ID of the target actor from Level List that the actor will turn to face. |
0x14f - Turn2DirectionMark
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | uint | unk0 | |
2 | uint | unk1 | |
3 | PositionMark | pos_marker | |
4 | uint | unk6 | |
5 | uint | unk7 |
0x150 - Turn2DirectionTurn
Makes an actor turn at a certain angle.
This opcode does not have a parameter for an entity, as it must be used in a with-statement or a targeted routine.
# | Type | Name | Description |
---|---|---|---|
1 | uint | speed | How fast the actor turns. The higher the number, the slower the turn. |
2 | uint | rotationdirection | The way that the actor will turn to face the specified direction. 1 = clockwise, 2 = counterclockwise, 10 = the most efficient direction to turn. |
3 | uint | angle | 1: 45 degrees left, 2: 45 degrees right, 3: 90 degrees right, 4: 90 degrees left, 5: 180 degrees |
0x151 - Turn3
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | uint | unk0 | |
2 | uint | unk1 | |
3 | uint | unk2 | |
4 | uint | unk3 |
0x152 - TurnDirection
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | Direction | direction |
0x153 - TurnDirectionLives
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | uint | unk0 | |
2 | uint | unk1 |
0x154 - TurnDirectionLives2
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | uint | unk0 | |
2 | uint | unk1 |
0x155 - TurnDirectionMark
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | uint | unk0 | |
2 | PositionMark | pos_marker |
0x156 - Unlock
Resumes the routine that was suspended when Lock
was called with the specified lock_id.
# | Type | Name | Description |
---|---|---|---|
1 | uint | lock_id | The ID of a Lock, ranged from 0-19 (inclusive). |
0x157 - Wait
Pauses the routine for a set number of frames. After the number of frames, the routine will resume.
# | Type | Name | Description |
---|---|---|---|
1 | uint | duration | The number of frames that the routine will wait for before resuming. |
0x158 - WaitAnimation
Pauses the routine until the specified actor has finished its animation. After the actor finishes its animation, the routine will resume.
This opcode does not have a parameter for an entity, as it must be used in a with-statement or a targeted routine.
0x159 - WaitBackEffect
Pauses the current routine until back_SetBackEffect is called.
No parameters.
0x15a - WaitBack2Effect
Pauses the current routine until back2_SetBackEffect is called.
No parameters.
0x15b - WaitBgm
Pauses the current routine until the specified BGM on the first BGM track has ended. After the BGM ends, the routine will resume.
# | Type | Name | Description |
---|---|---|---|
1 | Bgm | bgm_id | A non-looped music track defined in SOUND/BGM of the ROM. Looped music tracks softlocks the game. |
0x15c - WaitBgm2
Pauses the current routine until the specified BGM on the second BGM track has ended. After the BGM ends, the routine will resume.
# | Type | Name | Description |
---|---|---|---|
1 | Bgm | bgm_id | A non-looped music track defined in SOUND/BGM of the ROM. Looped music tracks softlocks the game. |
0x15d - WaitBgmSignal
Pauses the routine until a DSE event with ID 0xF6 on the current BGM track is triggered. This can be used to sync certain parts of the scene to the background music.
No parameters.
0x15e - WaitEffect
Pauses the routine until the effect on the specified actor/peformer has ended. After the effect ends, the routine will resume.
This opcode does not have a parameter for an entity, as it must be used in a with-statement or a targeted routine.
0x15f - WaitEndAnimation
<TO DO: Opcode description>
No parameters.
0x160 - WaitExecuteLives
Pauses the routine until the specified actor has finished its action (Move2Position, Slide2Position, etc.). After the actor finishes its action, the routine will resume.
# | Type | Name | Description |
---|---|---|---|
1 | Entity | actor_id | The actor that the routine will wait for. |
0x161 - WaitExecuteObject
Pauses the current routine until the specified object has finished its action (Move2Position, Slide2Position, etc.). After the object finishes its action, the routine will resume.
# | Type | Name | Description |
---|---|---|---|
1 | Object | object_id | The ID of the object that the routine will wait for. |
0x162 - WaitExecutePerformer
Pauses the current routine until the specified performer has finished its current action (Move2Position, Slide2Position, etc.) After the performer has finished its action, the routine will resume.
# | Type | Name | Description |
---|---|---|---|
1 | uint | performer_id | The ID of the performer that the routine will wait for. |
0x163 - WaitFadeIn
Pauses the current routine and waits for the screen to fade in. After the screen fades in, the routine will resume.
No parameters.
0x164 - WaitLockLives
Pauses the current routine until a Lock opcode with the specified lock_id is reached in the specified actor's targeted routine. After the lock is reached, the routine will resume.
# | Type | Name | Description |
---|---|---|---|
1 | uint | lock_id | |
2 | Entity | actor |
0x165 - WaitLockObject
Pauses the current routine until a Lock opcode with the specified lock_id is reached in the specified object's targeted routine. After the lock is reached, the routine will resume.
# | Type | Name | Description |
---|---|---|---|
1 | uint | lock_id | |
2 | Object | object |
0x166 - WaitLockPerformer
Pauses the current routine until a Lock opcode with the specified lock_id is reached in the specified performer's targeted routine. After the lock is reached, the routine will resume.
# | Type | Name | Description |
---|---|---|---|
1 | uint | lock_id | |
2 | uint | performer |
0x167 - WaitLockSupervision
Pauses the current routine until a Lock opcode with the specified lock_id is reached in def 0
. After the lock is reached, the routine will resume.
# | Type | Name | Description |
---|---|---|---|
1 | uint | lock_id |
0x168 - WaitMe
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | uint | unk0 |
0x169 - WaitMoveCamera
<TO DO: Opcode description>
No parameters.
0x16a - WaitMoveCamera2
<TO DO: Opcode description>
No parameters.
0x16b - WaitRandom
Pauses the routine for a random number of frames. After the number of frames, the routine will resume.
# | Type | Name | Description |
---|---|---|---|
1 | uint | duration_min | Minimum number of frames that the routine will wait for before resuming. |
2 | uint | duration_max | Maximum number of frames that the routine will wait for before resuming. |
0x16c - WaitScreenFade
Waits until screen_FadeIn finishes executing.
No parameters.
0x16d - WaitScreenFadeAll
Waits until screen_FadeInAll finishes executing.
No parameters.
0x16e - WaitScreen2Fade
Waits until screen2_FadeIn finishes executing.
No parameters.
0x16f - WaitSe
Pauses the current routine until the specified sound effect has ended. After the sound effect ends, the routine will resume.
# | Type | Name | Description |
---|---|---|---|
1 | uint | se_id | The ID of the sound to wait for the end of before resuming the routine. |
0x170 - WaitSpecialActing
<TO DO: Opcode description>
No parameters.
0x171 - WaitSubScreen
<TO DO: Opcode description>
No parameters.
0x172 - WaitSubSpecialActing
<TO DO: Opcode description>
No parameters.
0x173 - worldmap_BlinkMark
Shows a blinking world map marker.
# | Type | Name | Description |
---|---|---|---|
1 | uint | world_map_marker_id |
0x174 - worldmap_ChangeLevel
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | uint | unk0 |
0x175 - worldmap_DeleteArrow
Remove the yellow arrow from the world map.
No parameters.
0x176 - worldmap_MoveCamera
Moves the camera to the specified world map marker.
# | Type | Name | Description |
---|---|---|---|
1 | uint | world_map_marker_id |
0x177 - worldmap_OffMessage
Removes a textbox with the world map marker's name from the Top Screen
No parameters.
0x178 - worldmap_SetArrow
Shows an arrow pointing to a specified world map marker
# | Type | Name | Description |
---|---|---|---|
1 | uint | world_map_marker_id |
0x179 - worldmap_SetCamera
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | uint | unk0 |
0x17a - worldmap_SetLevel
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | uint | unk0 |
0x17b - worldmap_SetMark
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | uint | unk0 |
0x17c - worldmap_SetMessage
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | String | txt |
0x17d - worldmap_SetMessagePlace
Shows a textbox on the Top Screen with the specified world map marker's name.
# | Type | Name | Description |
---|---|---|---|
1 | uint | world_map_marker_id |
0x17e - worldmap_SetMode
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | uint | unk0 |
Other Opcodes
These opcodes cannot be directly called from ExplorerScript, since they are represented as higher-level constructs.
0x28 - Branch
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | GameVar | var | |
2 | uint | value | |
3 | uint | jump_address |
0x29 - BranchBit
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | GameVar | var | |
2 | uint | index | |
3 | uint | jump_address |
0x2a - BranchDebug
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | uint | param | |
2 | uint | jump_address |
0x2b - BranchEdit
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | uint | param | |
2 | uint | jump_address |
0x2c - BranchExecuteSub
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | uint | unk0 | |
2 | uint | jump_address |
0x2d - BranchPerformance
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | uint | index | |
2 | uint | value | |
3 | uint | jump_address |
0x2e - BranchScenarioNow
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | GameVar | var | |
2 | uint | unk1 | |
3 | uint | unk2 | |
4 | uint | jump_address |
0x2f - BranchScenarioNowAfter
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | GameVar | var | |
2 | uint | unk1 | |
3 | uint | unk2 | |
4 | uint | jump_address |
0x30 - BranchScenarioNowBefore
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | GameVar | var | |
2 | uint | unk1 | |
3 | uint | unk2 | |
4 | uint | jump_address |
0x31 - BranchScenarioAfter
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | GameVar | var | |
2 | uint | unk1 | |
3 | uint | unk2 | |
4 | uint | jump_address |
0x32 - BranchScenarioBefore
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | GameVar | var | |
2 | uint | unk1 | |
3 | uint | unk2 | |
4 | uint | jump_address |
0x33 - BranchSum
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | uint | unk0 | |
2 | uint | unk1 | |
3 | uint | unk2 | |
4 | uint | jump_address |
0x34 - BranchValue
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | GameVar | var | |
2 | uint | operator | |
3 | uint | value | |
4 | uint | jump_address |
0x35 - BranchVariable
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | GameVar | var | |
2 | uint | operator | |
3 | GameVar | cmp_var | |
4 | uint | jump_address |
0x36 - BranchVariation
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | uint | param | |
2 | uint | jump_address |
0x37 - Call
Jumps to the specified address, runs code, and returns to the line of code in which this opcode was used (only if return;
was used in the routine this opcode calls). Only one call can be stored at a time!
Use within macros is ill-advised, as using return;
within a macro will just end the macro!
# | Type | Name | Description |
---|---|---|---|
1 | uint | jump_address | The address to call, e.g., call @label_0; if §label_0; is defined in the script.
|
0x63 - Case
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | uint | value | |
2 | uint | jump_address |
0x64 - CaseMenu
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | String | choice | |
2 | uint | jump_address |
0x65 - CaseMenu2
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | uint? | choice? | |
2 | uint | jump_address |
0x66 - CaseScenario
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | uint | operator | |
2 | uint | value | |
3 | uint | jump_address |
0x67 - CaseText
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | uint | value | |
2 | String | display |
0x68 - CaseValue
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | uint | operator | |
2 | uint | value | |
3 | uint | jump_address |
0x69 - CaseVariable
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | uint | operator | |
2 | GameVar | var | |
3 | uint | jump_address |
0x6e - DefaultText
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | String | txt |
0x70 - End
<TO DO: Opcode description>
No parameters.
0x74 - flag_CalcBit
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | GameVar | var | |
2 | uint | index | |
3 | uint | value |
0x75 - flag_CalcValue
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | GameVar | var | |
2 | uint | calc_operator | |
3 | uint | value |
0x76 - flag_CalcVariable
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | GameVar | var | |
2 | uint | calc_operator | |
3 | GameVar | var_to_set_from |
0x77 - flag_Clear
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | GameVar | var |
0x78 - flag_Initial
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | GameVar | var |
0x79 - flag_Set
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | GameVar | var | |
2 | uint | value |
0x7a - flag_ResetDungeonResult
<TO DO: Opcode description>
No parameters.
0x7b - flag_ResetScenario
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | GameVar | var |
0x7c - flag_SetAdventureLog
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | uint | unk0 |
0x7d - flag_SetDungeonMode
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | uint | dungeon_id | |
2 | DungeonMode | dungen_mode |
0x7e - flag_SetDungeonResult
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | uint | unk0 | |
2 | uint | unk1 |
0x7f - flag_SetPerformance
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | uint | index | |
2 | uint | value |
0x80 - flag_SetScenario
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | GameVar | var | |
2 | uint | scenario_value | |
3 | uint | level_value |
0x82 - Hold
Will stall a script forever.
No parameters.
0x87 - Jump
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | uint | jump_address |
0x89 - lives
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | Entity | actor_id |
0xaa - message_SwitchMenu
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | uint | unk0 | |
2 | uint | unk1 |
0xab - message_SwitchMenu2
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | uint | unk0 | |
2 | uint | unk1 | |
3 | uint | unk2 |
0xac - message_SwitchMonologue
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | GameVar | var |
0xad - message_SwitchTalk
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | GameVar | var |
0xc9 - object
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | Object | object_id |
0xcb - performer
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | uint | performer_id |
0xd5 - Return
If run from within a macro, ends the macro.
If run after the "call" opcode was used, will return to the address of the call opcode.
If used within a script, ends the script.
No parameters.
0x13f - Switch
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | GameVar | var |
0x140 - SwitchDirection
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | Direction | direction |
0x141 - SwitchDirectionLives
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | uint | unk0 |
0x142 - SwitchDirectionLives2
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | uint | unk0 |
0x143 - SwitchDirectionMark
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | PositionMark | pos_marker |
0x144 - SwitchDungeonMode
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | uint | dungeon_id |
0x145 - SwitchLives
If inside a Switch Case, take the case equal to the species ID of the specified Actor!
# | Type | Name | Description |
---|---|---|---|
1 | Entity | actor_id | An entry in the Actor List. |
0x146 - SwitchRandom
To be used in a switch statement. Will switch to a case of a random number below the specified integer.
# | Type | Name | Description |
---|---|---|---|
1 | uint | max_value | Largest random output, plus 1 |
0x147 - SwitchScenario
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | GameVar | var |
0x148 - SwitchScenarioLevel
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | GameVar | var |
0x149 - SwitchSector
<TO DO: Opcode description>
No parameters.
0x14a - SwitchValue
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | GameVar | var | |
2 | uint | unk1 | |
3 | uint | unk2 |
0x14b - SwitchVariable
<TO DO: Opcode description>
# | Type | Name | Description |
---|---|---|---|
1 | GameVar | var | |
2 | uint | unk1 | |
3 | uint | unk2 |