Scripting Instructions

Overview of the mobile scripting language. More...

Collaboration diagram for Scripting Instructions:

Macros
#define	SCRIPT_CB_TABLE_24(f)
#define	SCRIPT_CB_TABLE_23(f)
	DISABLE: Disable Scripting Interactions with the MOBILE running this script, while still executing script instructions.
#define	SCRIPT_CB_TABLE_22(f)
	WARP: Warp to a tilemap identified by the string at the arg index in current TILEMAP::strpool.
#define	SCRIPT_CB_TABLE_21(f)
#define	SCRIPT_CB_TABLE_20(f)
#define	SCRIPT_CB_TABLE_19(f)
#define	SCRIPT_CB_TABLE_18(f)
	EQJMP: Move script execution to a label defined by START if the last value pushed to MOBILE::script_stack is EQUAL TO the value pushed before it.
#define	SCRIPT_CB_TABLE_17(f)
	GTJMP: Move script execution to a label defined by START if the last value pushed to MOBILE::script_stack is GREATER THAN the value pushed before it.
#define	SCRIPT_CB_TABLE_16(f)
	LTJMP: Move script execution to a label defined by START if the last value pushed to MOBILE::script_stack is LESS THAN the value pushed before it.
#define	SCRIPT_CB_TABLE_15(f)
	ADD: Add the argument to the last value pushed to the stack, and push the result back onto the stack.
#define	SCRIPT_CB_TABLE_14(f)
	SUB: Subtract the argument from the last value pushed to the stack, and push the result back onto the stack.
#define	SCRIPT_CB_TABLE_13(f)
	GIVE: Give an ITEM to DSEKAI_STATE::player based on ITEM::gid from TILEMAP::item_defs.
#define	SCRIPT_CB_TABLE_12(f)
	TAKE: Give an ITEM to DSEKAI_STATE::player based on ITEM::gid from TILEMAP::item_defs.
#define	SCRIPT_CB_TABLE_11(f)
	DIE: Trigger death animation for MOBILE running this script and then vanish, becoming inactive.
#define	SCRIPT_CB_TABLE_10(f)
	GGET: Push a copy of a value from the global table at onto MOBILE::script_stack.
#define	SCRIPT_CB_TABLE_9(f)
	GSET: Pop a value from MOBILE::script_stack into the global table, overriding any previous value at that index.
#define	SCRIPT_CB_TABLE_8(f)
	FACE: Set the actor to face one of the Cardinal Directions.
#define	SCRIPT_CB_TABLE_7(f)
	RETURN: Return from an interaction subroutine to the main script.
#define	SCRIPT_CB_TABLE_6(f)
	SPEAK: Display a dialog window with the actor's MOBILE::sprite_id and a line of text from TILEMAP::strpool.
#define	SCRIPT_CB_TABLE_5(f)
	GOTO: Move script execution to a label defined by START.
#define	SCRIPT_CB_TABLE_4(f)
	START: Define a label index that can be jumped to.
#define	SCRIPT_CB_TABLE_3(f)
	SLEEP: Don't do anything for arg number of frames.
#define	SCRIPT_CB_TABLE_2(f)
	WALK: The actor walks in the direction specified on the stack.
#define	SCRIPT_CB_TABLE_1(f)
	INTERACT: Define a Scripting Interactions callback label.
#define	SCRIPT_CB_TABLE(f)
	NOOP: Not a valid instruction. Beginning of the script callback table, used to implement script parsing.

Detailed Description

Overview of the mobile scripting language.

All statements take a single numerical argument.

Args can range from 0 to SCRIPT_ARG_MAX. See scripting_args for more information on special arguments.

A script executed by a MOBILE also has access to MOBILE::script_stack, which can hold up to SCRIPT_STACK_DEPTH items.

Items on MOBILE::script_stack can range from 0 to SCRIPT_STACK_MAX in value.

Macro Definition Documentation

SCRIPT_CB_TABLE

#define SCRIPT_CB_TABLE

(

f

)

Value:

f( 0, NOOP, '\0' ) SCRIPT_CB_TABLE_1( f )

NOOP: Not a valid instruction. Beginning of the script callback table, used to implement script parsing.

SCRIPT_CB_TABLE_1

#define SCRIPT_CB_TABLE_1

(

f

)

Value:

f( 1,   INTERACT,'i' ) SCRIPT_CB_TABLE_2( f )

INTERACT: Define a Scripting Interactions callback label.

Arguments

• Index of the Scripting Interactions callback label to define.

This statement does nothing by itself, but it defines a point in the code that will be jumped to when a player interacts with the MOBILE running this SCRIPT.

Please see the section on Scripting Interactions for details on this instruction.

SCRIPT_CB_TABLE_10

#define SCRIPT_CB_TABLE_10

(

f

)

Value:

f( 10, GGET,    'a' ) SCRIPT_CB_TABLE_11( f )

GGET: Push a copy of a value from the global table at onto MOBILE::script_stack.

Arguments

• Index of the value to push in g_script_globals (up to SCRIPT_GLOBALS_MAX).

Stack Values Pushed

• Value of g_script_globals at the index specified.

Note

After being pushed, the value will still remain in its index in g_script_globals, as well.

SCRIPT_CB_TABLE_11

#define SCRIPT_CB_TABLE_11

(

f

)

Value:

f( 11, DIE,     'z' ) SCRIPT_CB_TABLE_12( f )

DIE: Trigger death animation for MOBILE running this script and then vanish, becoming inactive.

See Mobile MP/HP for more information on mobile death.

SCRIPT_CB_TABLE_12

#define SCRIPT_CB_TABLE_12

(

f

)

Value:

f( 12, TAKE,    'k' ) SCRIPT_CB_TABLE_13( f )

TAKE: Give an ITEM to DSEKAI_STATE::player based on ITEM::gid from TILEMAP::item_defs.

Arguments

• ITEM::gid to take from player inventory.

Attention

: If the MOBILE executing this script is MOBILE_TYPE_SPECIAL, the item will remain in this mobile's inventory forever, wasting the limited resources of the engine. Try to only take if the item will be given back or if the mobile is disposable.

SCRIPT_CB_TABLE_13

#define SCRIPT_CB_TABLE_13

(

f

)

Value:

f( 13, GIVE,    'h' ) SCRIPT_CB_TABLE_14( f )

GIVE: Give an ITEM to DSEKAI_STATE::player based on ITEM::gid from TILEMAP::item_defs.

Arguments

• ITEM::gid to give from TILEMAP::item_defs.

SCRIPT_CB_TABLE_14

#define SCRIPT_CB_TABLE_14

(

f

)

Value:

f( 14, SUB,     '-' ) SCRIPT_CB_TABLE_15( f )

SUB: Subtract the argument from the last value pushed to the stack, and push the result back onto the stack.

Arguments

• Value to subtract.

Stack Values Popped

• Value to subtract from.

Stack Values Pushed

• Subtraction result.

SCRIPT_CB_TABLE_15

#define SCRIPT_CB_TABLE_15

(

f

)

Value:

f( 15, ADD,     '+' ) SCRIPT_CB_TABLE_16( f )

ADD: Add the argument to the last value pushed to the stack, and push the result back onto the stack.

Arguments

• Value to add.

Stack Values Popped

• Value to add to.

Stack Values Pushed

• Addition result.

SCRIPT_CB_TABLE_16

#define SCRIPT_CB_TABLE_16

(

f

)

Value:

f( 16, LTJMP,   '<' ) SCRIPT_CB_TABLE_17( f )

LTJMP: Move script execution to a label defined by START if the last value pushed to MOBILE::script_stack is LESS THAN the value pushed before it.

Arguments

• The index of the label as defined by a START instruction in the same script to jump to if the condition is TRUE.

Stack Values Pushed

• MOBILE::script_pc of next instruction to execute otherwise.

Attention

If (and only if) the condition is true and the jump is performed, this instruction will automatically push the index of the next instruction that would have otherwise been executed to the MOBILE::script_stack, so that it may be returned to with RETURN and e.g. SCRIPT_ARG_STACK.

SCRIPT_CB_TABLE_17

#define SCRIPT_CB_TABLE_17

(

f

)

Value:

f( 17, GTJMP,   '>' ) SCRIPT_CB_TABLE_18( f )

GTJMP: Move script execution to a label defined by START if the last value pushed to MOBILE::script_stack is GREATER THAN the value pushed before it.

Arguments

• The index of the label as defined by a START instruction in the same script to jump to if the condition is TRUE.

Stack Values Pushed

• MOBILE::script_pc of next instruction to execute otherwise.

Attention

If (and only if) the condition is true and the jump is performed, this instruction will automatically push the index of the next instruction that would have otherwise been executed to the MOBILE::script_stack, so that it may be returned to with RETURN and e.g. SCRIPT_ARG_STACK.

SCRIPT_CB_TABLE_18

#define SCRIPT_CB_TABLE_18

(

f

)

Value:

f( 18, EQJMP,   '=' ) SCRIPT_CB_TABLE_19( f )

EQJMP: Move script execution to a label defined by START if the last value pushed to MOBILE::script_stack is EQUAL TO the value pushed before it.

Arguments

• The index of the label as defined by a START instruction in the same script to jump to if the condition is TRUE.

Stack Values Pushed

• MOBILE::script_pc of next instruction to execute otherwise.

Attention

If (and only if) the condition is true and the jump is performed, this instruction will automatically push the index of the next instruction that would have otherwise been executed to MOBILE::script_stack, so that it may be returned to with RETURN and e.g. SCRIPT_ARG_STACK.

SCRIPT_CB_TABLE_19

#define SCRIPT_CB_TABLE_19

(

f

)

Value:

f( 19, POP,     '^' ) SCRIPT_CB_TABLE_20( f )

SCRIPT_CB_TABLE_2

#define SCRIPT_CB_TABLE_2

(

f

)

Value:

f( 2,   WALK,    'u' ) SCRIPT_CB_TABLE_3( f )

WALK: The actor walks in the direction specified on the stack.

Arguments

• Number of steps to walk.

Stack Values Popped

• One of the Cardinal Directions.

Note

WALK will be blocked if tilemap terrain or another mobile is in the way. If blocked by a mobile, the WALK will retry until it is successful (on the assumption the mobile will move). Terrain doesn't move, so terrain blockages will just be ignored/skipped and execution will continue.

---

Attention

WALK is a multi-cycle instruction (to allow for the walking animation to complete. The direction will not be removed from the stack until walking is complete. Also, Scripting Interactions with a walking mobile are disabled while that mobile is in motion.

Note

If the direction popped is greater than 3, it will be divided by 4 and the remainder will be interpreted as the direction to walk.

SCRIPT_CB_TABLE_20

#define SCRIPT_CB_TABLE_20

(

f

)

Value:

f( 20, PUSH,    'v' ) SCRIPT_CB_TABLE_21( f )

SCRIPT_CB_TABLE_21

#define SCRIPT_CB_TABLE_21

(

f

)

Value:

f( 21, ANIM,    'n' ) SCRIPT_CB_TABLE_22( f )

SCRIPT_CB_TABLE_22

#define SCRIPT_CB_TABLE_22

(

f

)

Value:

f( 22, WARP,    'w' ) SCRIPT_CB_TABLE_23( f )

WARP: Warp to a tilemap identified by the string at the arg index in current TILEMAP::strpool.

Arguments

• Index of a string containing the name of the TILEMAP to warp to in the currently loaded TILEMAP::strpool.

SCRIPT_CB_TABLE_23

#define SCRIPT_CB_TABLE_23

(

f

)

Value:

f( 23, DISABLE, 'd' ) SCRIPT_CB_TABLE_24( f )

DISABLE: Disable Scripting Interactions with the MOBILE running this script, while still executing script instructions.

Arguments

• 0 To enable (disable disabled) or 1 to disable interaction.

SCRIPT_CB_TABLE_24

#define SCRIPT_CB_TABLE_24

(

f

)

Value:

f( 23, SHAKE, 'y' )

SCRIPT_CB_TABLE_3

#define SCRIPT_CB_TABLE_3

(

f

)

Value:

f( 3,   SLEEP,   's' ) SCRIPT_CB_TABLE_4( f )

SLEEP: Don't do anything for arg number of frames.

Arguments

• Number of frames to sleep. This may vary in terms of precise timing by platform.

SCRIPT_CB_TABLE_4

#define SCRIPT_CB_TABLE_4

(

f

)

Value:

f( 4,   START,   't' ) SCRIPT_CB_TABLE_5( f )

START: Define a label index that can be jumped to.

Arguments

• Index number for this label.

Labelled indexes defined with START may be jumped to later by GOTO or JMP instructions.

SCRIPT_CB_TABLE_5

#define SCRIPT_CB_TABLE_5

(

f

)

Value:

f( 5,   GOTO,    'g' ) SCRIPT_CB_TABLE_6( f )

GOTO: Move script execution to a label defined by START.

Arguments

• The index of the label as defined by a START instruction in the same script to jump to.

Stack Values Pushed

• MOBILE::script_pc of next instruction to execute otherwise.

Attention

This instruction will automatically push the index of the next instruction that would have otherwise been executed to the stack, so that it may be returned to with RETURN and e.g. SCRIPT_ARG_STACK.

SCRIPT_CB_TABLE_6

#define SCRIPT_CB_TABLE_6

(

f

)

Value:

f( 6,   SPEAK,   'p' ) SCRIPT_CB_TABLE_7( f )

SPEAK: Display a dialog window with the actor's MOBILE::sprite_id and a line of text from TILEMAP::strpool.

Arguments

• String index in TILEMAP::strpool to display.

SCRIPT_CB_TABLE_7

#define SCRIPT_CB_TABLE_7

(

f

)

Value:

f( 7,   RETURN,  'x' ) SCRIPT_CB_TABLE_8( f )

RETURN: Return from an interaction subroutine to the main script.

Arguments

• The instruction index to return to.

It is common to use this with SCRIPT_ARG_STACK_I, which uses the instruction number automatically pushed to the stack on interaction, and then increments the interaction count. This is not necessary, however, and more creative uses may be devised.

Note

This instruction returns to an individual instruction index in the sequence of the script by setting MOBILE::script_pc directly, NOT by a label defined by START.

SCRIPT_CB_TABLE_8

#define SCRIPT_CB_TABLE_8

(

f

)

Value:

f( 8,   FACE,    'f' ) SCRIPT_CB_TABLE_9( f )

FACE: Set the actor to face one of the Cardinal Directions.

Arguments

• One of the Cardinal Directions.

Note

If the argument supplied is greater than 3, it will be divided by 4 and the remainder will be interpreted as the direction to face.

SCRIPT_CB_TABLE_9

#define SCRIPT_CB_TABLE_9

(

f

)

Value:

f( 9,   GSET,    'b' ) SCRIPT_CB_TABLE_10( f )

GSET: Pop a value from MOBILE::script_stack into the global table, overriding any previous value at that index.

Arguments

• Index of the value to pop to in g_script_globals (up to SCRIPT_GLOBALS_MAX).

Stack Values Popped

• Value to insert into g_script_globals at the index specified.