Monster AI scripts: <monster.h>¶
Natives for monster AI scripts (dungeon/monster). They act on the monster running the script.
Natives are built-in engine functions declared with NATIVE(...). A native with one result returns a value (for example, hp = get_hp();). A native with multiple results writes to pointer arguments. OPTIONAL(...) marks arguments that a call can omit. Natives return immediately and do not yield frames; use WAIT(); to pause a script for one frame (25 FPS on PAL).
Declared in sdk/monster.h and sdk/helpers/monster.h. See C Language, SDK, and Patches for SDK syntax and API Reference for all headers. Generated by dc2tk api-docs from the SDK's headers; change the headers, not this page.
Natives¶
| Native | Number | What it does |
|---|---|---|
normalize_vector |
0 + 0 | Scales the vector held in three float variables to length 1, in place. |
VM_ARGS |
0 + 1 | Copies src_x, src_y, src_z into the three variables x, y, z. |
add_vector |
0 + 2 | Adds add_x, add_y, add_z to the vector held in variables x, y, z, in place. |
subtract_vector |
0 + 3 | Subtracts sub_x, sub_y, sub_z from the vector held in variables x, y, z, in place. |
scale_vector |
0 + 4 | Multiplies the vector held in variables x, y, z by scale, in place. |
divide_vector |
5 | Divides the vector held in variables x, y, z by divisor, in place. |
compare_angles |
6 | Compares two angles in radians, wrapping the difference into -pi to pi. |
wrap_angle |
0 + 7 | Wraps the angle held in a float variable into the range -pi to pi radians, in place. |
calc_square_root |
0 + 8 | Returns the square root of value. |
calc_atan2 |
0 + 9 | Returns atan2(y, x) in radians. |
VM_ARGS |
10 | Does nothing and reports success. |
VM_ARGS |
11 | Writes the length of the vector x, y, z into length. |
get_distance_between |
0 + 12 | Returns the distance between point 1 and point 2. |
VM_ARGS |
13 | Intersects a circle on the ground plane (X and Z only) with the line through points A and B. |
calc_angle_dot |
14 | Turns two yaw angles in radians into horizontal unit directions and writes their dot product into dot: 1 when they face the same way, -1 when opposite. |
VM_ARGS |
20 + 1 | Plays a sound effect from this monster's sound bank, with volume and pan set from the monster's position (full volume within 160 units, silent beyond 1200). |
VM_ARGS |
20 + 2 | Stops a sound effect from this monster's sound bank. |
VM_ARGS |
20 + 3 | Plays a sound effect from another monster's sound bank at fixed volume. |
stop_se_on_monster |
20 + 4 | Stops a sound effect from another monster's sound bank. |
set_camera_look_at |
25 | Turns off camera follow and player control of the active camera and sets the point it moves to look at, in world units. |
set_camera_follow |
25 + 1 | With on = 1 the active camera follows the player again and takes player control; with 0 both are turned off so scripts can place it. |
move_camera_to |
25 + 2 | Turns off camera follow and player control of the active camera and sets the eye position it moves to, in world units. |
VM_ARGS |
25 + 3 | Sets the dungeon camera mode. |
set_camera_speed |
25 + 4 | Sets how fast the active camera moves toward its next eye position and look point. |
shake_camera |
25 + 5 | Shakes the dungeon camera with strength power, fading linearly to nothing over frames. |
VM_ARGS |
31 | Sets the active camera's minimum and maximum distance from the player and its eye height when near and far (defaults 100, 160, 18, 10). |
VM_ARGS |
32 | Sets the active camera's height limits and how far it stays above the ground (defaults height -15, max 40, min -15, resting max 20, resting min -15, ground space 25). |
reset_camera_limits |
25 + 8 | Restores the active camera's distance and height limits to their defaults (distance 100 to 160, near height 18, far height 10, height -15, max 40, min -15, resting max 20, resting min -15, ground space 25). |
VM_ARGS |
35 | Writes a random whole number from 0 to range - 1 into value. |
get_random_float |
35 + 1 | Returns a random number from 0 up to range, truncated to a whole number and stored as a float. |
VM_ARGS |
35 + 2 | Stores value in a monster variable. |
get_monster_var |
35 + 3 | Reads a monster variable into value, as an int or a float to match the receiving variable's type. |
get_monster_count |
35 + 4 | Returns the number of script-driven monsters active on the floor, this one included. |
get_monster_kind |
35 + 5 | Returns this monster's kind number, the number create_monster and get_kind_pos take. |
get_monster_kind_slot |
41 | Returns the slot of the floor's loaded monster kinds that this monster was made from. |
VM_ARGS |
35 + 7 | Returns this monster's handle (24 plus its active slot), the number other natives take to pick a monster. |
get_player_disguise |
35 + 8 | When the player is transformed into a monster and that form matches the one this monster kind recognises as its own, returns the form's id; otherwise returns -1. |
reset_floor_timer |
35 + 9 | Sets the dungeon floor timer back to 0. |
get_floor_timer |
35 + 10 | Returns the dungeon floor timer, in frames since it was last reset. |
create_monster |
35 + 11 | Spawns a monster of the given kind, which must be loaded on this floor, at x, y, z (the origin when omitted). |
run_event_script |
35 + 12 | Asks the dungeon to run the event script with this number. |
get_frame_pos |
35 + 13 | Writes the world position of the named frame in this monster's model into x, y, z. |
VM_ARGS |
49 | Writes the world position of the named frame, searched across this monster and its linked parts, into x, y, z. |
VM_ARGS |
50 | Writes the world position of the named frame on the map piece this monster is linked to into x, y, z. |
VM_ARGS |
51 | Sets (on = 1) or clears (on = 0) dungeon pause bits given in mask: 1 monster AI, 2 player movement, 4 player control, 0x10 monster drawing, 0x20 sky, 0x80 map, 0x100 minimap, 0x200 pickups, 0x400 player status, 0x800 exit heal, 0x1000 enemy movement, 0x2000 weapon drawing, 0x4000 battle music, 0x8000 pad reset, 0x10000 monster names. |
check_pause_flags |
52 | Returns which of the dungeon pause bits in mask are set (the bitwise AND); the bits are the ones set_pause_flags lists. |
get_dungeon_flag |
53 | Returns a saved dungeon bit flag (0 or 1). |
set_dungeon_flag |
54 | Sets a saved dungeon bit flag to value (0 or 1). |
VM_ARGS |
35 + 20 | Returns the kind of the last attack that hit this monster. |
get_player_status |
56 | Returns the status bits of the character the player controls: 1 poison, 2 slow, 0x10 power boost, and 4, 8, 0x20, 0x40 for other conditions. |
VM_ARGS |
57 | Copies reserved image 0 or 1, loaded earlier by the monster's script, over the monster's first texture image. |
get_status_flags |
35 + 23 | Returns which of this monster's status bits in mask are set: 1 poison, 2 slow, 8 and 0x20 greyed out by a hit. |
VM_ARGS |
35 + 24 | Stores value in this monster's second variable set, indexes 0 to 31. |
VM_ARGS |
35 + 25 | Reads this monster's second variable set, indexes 0 to 31, into value as an int or a float to match the receiving variable's type. |
VM_ARGS |
60 + 1 | Sets how the player picks a target: 0 locks onto the nearest monster, 2 uses the cycling target selection. |
VM_ARGS |
60 + 2 | Sets the scene's motion blur amount; 0 turns it off. |
VM_ARGS |
35 + 28 | Shows (show = 1) or hides (show = 0) a piece of a named part of the active maps. |
get_event_info |
64 | Returns event state chosen by selector. |
VM_ARGS |
60 + 5 | Plays a looping sound effect from a monster's sound bank for keep_frames frames, then stops it. |
VM_ARGS |
35 + 31 | Sets how this monster's sound effects are mixed: 1 sets volume and pan from its position, 2 plays them at fixed volume. |
get_distance_to |
60 + 10 | Returns the distance from this monster to the point x, y, z. |
VM_ARGS |
70 + 1 | Casts a ray from 100 units above this monster along its facing turned by angle radians, up to distance units, and writes how far it gets before hitting map collision into clear_dist (distance when nothing is hit). |
VM_ARGS |
70 + 2 | Writes this monster's home position, where it was placed unless a script moved it, into x, y, z. |
VM_ARGS |
70 + 3 | Sets this monster's home position. |
VM_ARGS |
60 + 14 | Finds an active monster of the given kind number and writes its position into x, y, z. |
get_pos |
70 + 5 | Writes this monster's position into x, y, z. |
VM_ARGS |
70 + 6 | Moves this monster straight to x, y, z. |
VM_ARGS |
70 + 7 | Writes this monster's rotation in radians into rot_x, rot_y (yaw), rot_z. |
set_rot |
70 + 8 | Sets this monster's rotation in radians at once and cancels any turn started by turn_to. |
VM_ARGS |
70 + 9 | Starts this monster turning toward yaw (radians) by turn_speed radians per frame. |
VM_ARGS |
70 + 10 | Starts this monster walking toward x, y, z at speed units per frame. |
check_move_end |
70 + 11 | Returns 1 when this monster is within the arrive distance of its move_to point, else 0. |
stop_moving |
70 + 12 | Stops the walk started by move_to by setting the move speed to 0. |
VM_ARGS |
70 + 13 | Writes the position of this monster's target, usually the player, into x, y, z, and with a fourth argument the distance to it into dist. |
get_target_dist |
70 + 14 | Returns the distance from this monster to its target. |
VM_ARGS |
70 + 15 | Returns the world yaw in radians from this monster toward its target. |
get_pos_near_target |
70 + 16 | Writes the point distance units from this monster's target in the world direction angle (yaw in radians) into x, y, z. |
get_point_side |
87 | Returns where the point x, y, z lies around this monster's facing: 1 ahead (within 0.8 radians), 3 on the negative-angle side, 4 on the positive-angle side, 2 behind (beyond 3.0 radians). |
get_pos_from_facing |
70 + 18 | Writes the point distance units from this monster along its facing turned by angle radians into x, y, z. |
get_target_rot |
70 + 19 | Writes the rotation of this monster's target in radians into rot_x, rot_y (yaw), rot_z. |
get_angle_to |
70 + 20 | Returns the world yaw in radians from this monster toward the point x, y, z. |
VM_ARGS |
70 + 21 | Returns this monster's height above the ground, or 0 when it is standing on the ground. |
get_nearest_monster |
70 + 22 | Writes the position of the nearest other script-driven monster into x, y, z and its distance into dist. |
get_target_old_pos |
70 + 23 | Writes the position this monster's target had on the previous frame into x, y, z. |
get_target_speed |
70 + 24 | Returns how far this monster's target moved since the previous frame, in units. |
calc_step_toward |
70 + 25 | Moves step units from the from point toward the to point and writes the result into x, y, z. |
get_angle_between |
70 + 26 | Gets the direction from the from point to the to point. |
get_active_monster_pos |
70 + 27 | Writes the position of the given monster into x, y, z, and with a fifth argument its distance from this monster into dist. |
get_active_monster_rot |
98 | Writes the rotation of the given monster in radians into rot_x, rot_y (yaw), rot_z. |
get_active_monster_dist |
99 | Returns the distance from this monster to the given monster. |
VM_ARGS |
100 | Writes the yaw in radians of the given monster into yaw. |
VM_ARGS |
70 + 31 | Writes the rotation that faces this monster toward the point x, y, z into rot_x (pitch), rot_y (yaw) and rot_z (0), in radians. |
get_dir_between |
70 + 32 | Gets the direction from the from point to the to point (note the to point comes first). |
VM_ARGS |
70 + 33 | Casts a ray from this monster's position in the world direction yaw (radians, not relative to its facing), up to distance units, and writes how far it gets before hitting map collision into clear_dist (distance when nothing is hit). |
get_height_above_ground |
70 + 34 | Returns how high the point x, y, z is above the map ground below it. |
get_monster_in_range |
70 + 35 | Ranks the other script-driven monsters within range units of this monster by distance and returns the handle of the one at position rank (0 is the nearest), or -1 if there are not that many. |
VM_ARGS |
100 + 6 | Writes the world position of entry frame 0 to 2, set up by the character data, of a monster into x, y, z. |
measure_segment_clearance |
70 + 38 | Casts a ray from the from point to the to point and returns how far it gets before hitting map collision (the full length when nothing is hit). |
set_action_object |
110 | Registers the named frame of this monster's model as action object number index, used by natives that refer to objects by number. |
set_body |
110 + 1 | Only prints a diagnostic message. |
set_damage_legacy |
112 | Obsolete. |
add_attack_hit |
110 + 3 | Adds a damage hit to this monster that is active while a motion plays between two points, given as fractions 0.0 to 1.0 of the motion's length. |
link_map_part |
110 + 4 | Makes the named map part follow this monster. |
ride_map_piece |
110 + 5 | Makes this monster ride on the named piece of the named map part, so it moves with that piece. |
VM_ARGS |
110 + 6 | Loads an effect base by number or name so effects can be created from it; does nothing if it is already loaded. |
VM_ARGS |
110 + 7 | Sets when a photo of this monster can be taken. |
load_reserve_image |
110 + 8 | Reads an image file, such as "dungeon/monster/b13a01.img", into reserve slot 0 or 1 of this monster so a later texture swap can copy it into the model. |
VM_ARGS |
110 + 9 | Sets how many of the monsters nearest their target are allowed to come into sight, from 0 to 23. |
set_model_lighting |
120 | Turns scene lighting on (1) or off (0) for this monster's model, or for one named frame of it. |
set_model_color |
120 + 1 | Turns off lighting for this monster's model, or one named frame of it, and draws it with a flat colour. |
set_alpha |
120 + 2 | Sets the transparency this monster draws with, from 0.0 (invisible) to 1.0 (opaque). |
set_scale |
120 + 3 | Sets this monster's scale on each axis; 1.0 is normal size. |
set_monster_kind_alpha |
124 | Sets the transparency, 0.0 to 1.0, of the first monster on the floor whose kind number is monster_kind. |
start_color_pulse |
120 + 5 | Makes this monster's colour pulse toward red, green, blue (0 to 255) pulse_count times over each cycle of frames. |
VM_ARGS |
120 + 6 | Stops the colour pulse started with start_color_pulse on this monster. |
VM_ARGS |
120 + 7 | Sets (on = 1) or clears (on = 0) behaviour bits on this monster: 1 no lock-on, 4 walking replaces velocity, 8 ignore map collision, 16 not pushed by other monsters, 32 takes no damage and cannot be stunned, 64 vanishes at once on death, 256 skip ground search, 512 always counts as in sight. |
VM_ARGS |
110 + 18 | Sets (on = 1, the default) or clears (on = 0) status bits on this monster's scene character slot. |
set_mask_flag |
120 + 9 | Sets (on = 1) or clears (on = 0) mask flag bits on this monster. |
set_act_status |
120 + 10 | Sets the status value of this monster that other characters' action scripts read. |
set_invincible_time |
120 + 11 | Makes this monster take no damage for the given number of steps; 0 ends it. |
set_gravity |
132 | Unused stub. |
set_collision |
133 | Unused stub. |
get_rage_hits_left |
120 + 14 | Returns how many more hits it takes to enrage this monster; -1.0 for a boss. |
get_priority |
120 + 15 | Returns this monster's rank by distance to its target, 0 for the nearest monster, -1 for none. |
set_clip_dist |
120 + 16 | Sets the distance within which this monster comes into sight and shows its life gauge. |
show_stun_stars |
120 + 17 | Shows the stars circling this monster's head for the rest of its current stun. |
get_stun_stars_left |
120 + 18 | Returns how many steps the stun stars over this monster still show; 0 when it is not stunned. |
get_scale |
120 + 19 | Reads this monster's scale on each axis. |
VM_ARGS |
140 | Returns the radius this monster uses for map collision, or 15.0 when it has none. |
start_knockback |
150 | Knocks this monster back at speed (scaled by its knockback rate), slowing by decel each step, for the given number of steps. |
VM_ARGS |
150 + 1 | Marks this monster dead, stops its colour pulse, and scatters its reward money, its transformation badge if it has one, and random drop items, playing a sound. |
VM_ARGS |
150 + 2 | Starts this monster's fade-out, plays its death smoke unless attribute bit 2 is set, and scatters weapon experience pickups for the character that dealt the last hit. |
end_throw |
150 + 3 | Clears this monster's held or thrown state after it has been caught or thrown. |
VM_ARGS |
160 | Returns this monster's current attack power. |
VM_ARGS |
160 + 1 | Sets this monster's defence to its table defence multiplied by rate. |
VM_ARGS |
160 + 2 | Sets this monster's life. |
get_life |
160 + 3 | Reads this monster's life into an int variable, or its life as a fraction 0.0 to 1.0 of max life into a float variable. |
VM_ARGS |
160 + 4 | Returns how many hits on this monster did no damage. |
VM_ARGS |
160 + 5 | Returns a monster's current life. |
get_monster_life_ratio |
160 + 6 | Returns a monster's life as a fraction 0.0 to 1.0 of its max life. |
add_monster_life |
160 + 7 | Adds amount to a monster's life, negative to take life, clamped to 0 through max life. |
heal_monster_life_ratio |
160 + 8 | Heals a monster by a fraction of its max life, capped at max life; negative fractions do nothing. |
get_monster_max_life |
160 + 9 | Returns a monster's max life. |
show_damage_number |
160 + 10 | Pops up a damage number above a monster. |
VM_ARGS |
160 + 11 | Returns a monster's grade from its kind's table. |
set_guard_rate |
160 + 12 | Sets a monster's chance to guard a hit to its table chance multiplied by rate, capped at 100 percent. |
set_dodge_rate |
160 + 13 | Sets both of a monster's chances to dodge its target's attacks to their table values multiplied by rate, capped at 100 percent. |
VM_ARGS |
170 + 4 | Sets the damage percentages of the attack kinds picked by mask (bits 0 to 11) to their table values multiplied by rate, capped at 100. |
is_boss |
160 + 15 | Returns nonzero when this monster is a boss, whose life shows across the foot of the screen. |
VM_ARGS |
170 + 6 | Sets the size of one of this monster's entry objects, the frames used as hit points; index -1 means 0. |
get_entry_object_size |
160 + 17 | Returns the size of one of this monster's entry objects; index -1 means 0. |
reset_motion |
180 | Stops the motion of this monster and every part chained to it. |
VM_ARGS |
180 + 2 | Plays the named motion on this monster and every part chained to it. |
check_motion_end |
180 + 3 | Reads 1 into is_done when the motion of this monster, or of its named chained part, reaches its last frame within two steps or no motion plays. |
get_motion_progress |
180 + 4 | Reads how far the current motion of this monster, or of its named chained part, has played, from 0.0 to 1.0. |
get_motion_status |
180 + 5 | Reads the motion state of this monster, or of its named chained part: 0 none, 1 on first frame, 2 playing, 3 blending, 4 reached last frame. |
create_effect |
190 + 1 | Starts the named effect, owned by this monster. |
finish_effect |
190 + 2 | Tells this monster's effect in slot to run its finishing program (300) so it ends on its own. |
delete_effect |
193 | Removes this monster's effect in slot at once. |
set_effect_vec1 |
190 + 4 | Sets the first work vector of this monster's effect in slot, -1 for the last started one; effects use it as a position or direction. |
get_effect_vec1 |
195 | Reads the first work vector of this monster's effect in slot, -1 for the last started one. |
set_effect_vec2 |
190 + 6 | Sets the second work vector of this monster's effect in slot, -1 for the last started one. |
get_effect_vec2 |
197 | Reads the second work vector of this monster's effect in slot, -1 for the last started one. |
set_effect_target |
190 + 8 | Sets the target character (scene character number) of this monster's effect in slot, -1 for the last started one. |
get_effect_target |
199 | Returns the target character of this monster's effect in slot, -1 for the last started one. |
set_effect_owner |
190 + 10 | Sets the owner id of this monster's effect in slot, -1 for the last started one. |
get_effect_owner |
201 | Returns the owner id of this monster's effect in slot, -1 for the last started one. |
VM_ARGS |
190 + 12 | Sets script value number index of this monster's effect in slot, -1 for the last started one, to an int or float. |
add_sword_trail |
190 + 13 | Adds a sword trail to this monster using its trail effect 0 to 2. |
get_free_texture_block |
190 + 14 | Returns the next free effect texture block, or -1 when the pool is full. |
use_texture_block |
190 + 15 | Marks the next effect texture block as used by the current load level. |
fire_rocket |
190 + 16 | Fires a homing rocket from x, y, z in direction dir_x, dir_y, dir_z. |
clear_owner_effects |
190 + 17 | Stops every effect that belongs to the given owner id. |
VM_ARGS |
17 | Numbers the disc calls that this table never registers. |
VM_ARGS |
18 | |
VM_ARGS |
20 | |
VM_ARGS |
60 + 7 | |
VM_ARGS |
60 + 8 | |
VM_ARGS |
60 + 9 | |
VM_ARGS |
140 + 1 | |
VM_ARGS |
140 + 2 | |
VM_ARGS |
140 + 3 | |
VM_ARGS |
154 | |
VM_ARGS |
155 | |
VM_ARGS |
157 | |
VM_ARGS |
159 |
normalize_vector¶
Scales the vector held in three float variables to length 1, in place.
Original name: _NORMAL_VECTOR.
VM_ARGS¶
extern void copy_vector VM_ARGS(float *x, float *y, float *z, float src_x, any src_y, any src_z) NATIVE(0, 1);
Copies src_x, src_y, src_z into the three variables x, y, z.
Original name: _COPY_VECTOR.
add_vector¶
extern void add_vector(float *x, float *y, float *z, float add_x, float add_y, float add_z) NATIVE(0, 2);
Adds add_x, add_y, add_z to the vector held in variables x, y, z, in place.
Original name: _ADD_VECTOR.
subtract_vector¶
extern void subtract_vector(float *x, float *y, float *z, float sub_x, float sub_y, float sub_z) NATIVE(0, 3);
Subtracts sub_x, sub_y, sub_z from the vector held in variables x, y, z, in place.
Original name: _SUB_VECTOR.
scale_vector¶
Multiplies the vector held in variables x, y, z by scale, in place.
Original name: _SCALE_VECTOR.
divide_vector¶
Divides the vector held in variables x, y, z by divisor, in place. A divisor of 0 fails and leaves the vector unchanged.
Original name: _DIV_VECTOR.
compare_angles¶
Compares two angles in radians, wrapping the difference into -pi to pi. Returns 0 when angle is within tolerance of target, 1 when it is further ahead (positive difference) and -1 when it is further behind.
Original name: _ANGLE_CMP.
wrap_angle¶
Wraps the angle held in a float variable into the range -pi to pi radians, in place.
Original name: _ANGLE_LIMIT.
calc_square_root¶
Returns the square root of value.
Original name: _SQRT.
calc_atan2¶
Returns atan2(y, x) in radians. Scripts pass an X offset and a Z offset to get a yaw.
Original name: _ATAN2F.
VM_ARGS¶
Does nothing and reports success. Disc scripts pass a number and a variable, but the native reads and writes neither.
Original name: _ND_TEST.
VM_ARGS¶
Writes the length of the vector x, y, z into length.
Original name: _GET_DIST_VECTOR.
get_distance_between¶
extern float get_distance_between(float x1, float y1, float z1, float x2, float y2, float z2) NATIVE(0, 12);
Returns the distance between point 1 and point 2.
Original name: _GET_DIST_VECTOR2.
VM_ARGS¶
extern void calc_circle_line_hits VM_ARGS(float center_x, any center_z, OPTIONAL(float radius, float ax, float az, float bx, float bz, int *hit_count, float *hit1_x, float *hit1_z, float *hit2_x, float *hit2_z)) NATIVE(13);
Intersects a circle on the ground plane (X and Z only) with the line through points A and B. hit_count receives 0, 1 or 2; hit1 is written when there is at least one hit and hit2 only when there are two.
Original name: _CALC_IP_CIRCLE_LINE.
calc_angle_dot¶
Turns two yaw angles in radians into horizontal unit directions and writes their dot product into dot: 1 when they face the same way, -1 when opposite. Fails unless all three arguments are given.
Original name: _GET_ANGLE_INNER.
VM_ARGS¶
Plays a sound effect from this monster's sound bank, with volume and pan set from the monster's position (full volume within 160 units, silent beyond 1200).
Original name: _MY_SE_PLAY.
VM_ARGS¶
Stops a sound effect from this monster's sound bank.
Original name: _MY_SE_STOP.
VM_ARGS¶
Plays a sound effect from another monster's sound bank at fixed volume. Monster handles are character numbers 24 to 47 (24 plus the active slot), as get_monster_handle and get_monster_in_range give them. Fails unless both arguments are given.
Original name: _MONS_SE_PLAY.
stop_se_on_monster¶
Stops a sound effect from another monster's sound bank. Monster handles are character numbers 24 to 47 (24 plus the active slot), as get_monster_handle and get_monster_in_range give them.
Original name: _MONS_SE_STOP.
set_camera_look_at¶
Turns off camera follow and player control of the active camera and sets the point it moves to look at, in world units.
Original name: _SET_CAMERA_NEXT_REF.
set_camera_follow¶
With on = 1 the active camera follows the player again and takes player control; with 0 both are turned off so scripts can place it.
Original name: _SET_CAMERA_FOLLOW.
move_camera_to¶
Turns off camera follow and player control of the active camera and sets the eye position it moves to, in world units.
Original name: _SET_CAMERA_NEXT_POS.
VM_ARGS¶
Sets the dungeon camera mode. 0 is the normal player camera, 1 sits behind the player looking at the first monster (the boss), 2 circles a fixed arena point, 4 is a variant of the normal camera, and other values leave the camera to scripts.
Original name: _SET_CAMERA_MODE.
set_camera_speed¶
Sets how fast the active camera moves toward its next eye position and look point.
Original name: _SET_CAMERA_SPEED.
shake_camera¶
Shakes the dungeon camera with strength power, fading linearly to nothing over frames.
Original name: _CAMERA_QUAKE.
VM_ARGS¶
extern void set_camera_distance_limits VM_ARGS(float min_dist, float max_dist, float near_height, float far_height, any ignored) NATIVE(31);
Sets the active camera's minimum and maximum distance from the player and its eye height when near and far (defaults 100, 160, 18, 10). Pass -99999.9 to leave a value unchanged. The engine rejects calls with 1 to 4 arguments, so a fifth, ignored value is needed.
Original name: _SET_CAMERA_CTRL_PARAM1.
VM_ARGS¶
extern void set_camera_height_limits VM_ARGS(float height, float max_height, float min_height, float rest_max_height, float rest_min_height, float ground_space, any ignored) NATIVE(32);
Sets the active camera's height limits and how far it stays above the ground (defaults height -15, max 40, min -15, resting max 20, resting min -15, ground space 25). Pass -99999.9 to leave a value unchanged. The engine rejects calls with 1 to 6 arguments, so a seventh, ignored value is needed.
Original name: _SET_CAMERA_CTRL_PARAM2.
reset_camera_limits¶
Restores the active camera's distance and height limits to their defaults (distance 100 to 160, near height 18, far height 10, height -15, max 40, min -15, resting max 20, resting min -15, ground space 25).
Original name: _RESET_CAMERA_CTRL_PARAM.
VM_ARGS¶
Writes a random whole number from 0 to range - 1 into value. Fails unless both arguments are given.
Original name: _GET_RND.
get_random_float¶
Returns a random number from 0 up to range, truncated to a whole number and stored as a float.
Original name: _GET_RNDF.
VM_ARGS¶
Stores value in a monster variable. Indexes 0 to 7 belong to this monster; 8 to 135 are shared by all monsters on the floor. An int value is stored as an int and a float as a float.
Original name: _V_PUSH.
get_monster_var¶
Reads a monster variable into value, as an int or a float to match the receiving variable's type. Indexes 0 to 7 belong to this monster; 8 to 135 are shared by all monsters on the floor.
Original name: _V_POP.
get_monster_count¶
Returns the number of script-driven monsters active on the floor, this one included.
Original name: _GET_MONSTER_NUM.
get_monster_kind¶
Returns this monster's kind number, the number create_monster and get_kind_pos take.
Original name: _GET_MONSTER_INDEX.
get_monster_kind_slot¶
Returns the slot of the floor's loaded monster kinds that this monster was made from.
Original name: _GET_MONSTER_ID.
VM_ARGS¶
Returns this monster's handle (24 plus its active slot), the number other natives take to pick a monster.
Original name: _GET_USERID.
get_player_disguise¶
When the player is transformed into a monster and that form matches the one this monster kind recognises as its own, returns the form's id; otherwise returns -1.
Original name: _GET_USER_MONS_ID.
reset_floor_timer¶
Sets the dungeon floor timer back to 0. The timer counts frames.
Original name: _RESET_TIMER.
get_floor_timer¶
Returns the dungeon floor timer, in frames since it was last reset.
Original name: _GET_TIMER.
create_monster¶
extern void create_monster(int kind, OPTIONAL(float x, float y, float z, float yaw_or_rot_x, float rot_y, float rot_z)) NATIVE(35, 11);
Spawns a monster of the given kind, which must be loaded on this floor, at x, y, z (the origin when omitted). With five arguments the fifth is the yaw; with seven the last three are the X, Y and Z rotation in radians.
Original name: _CREATE_MONSTER.
run_event_script¶
Asks the dungeon to run the event script with this number. The dungeon picks the request up on its next check and clears it.
Original name: _RUN_EVENT_SCRIPT.
get_frame_pos¶
Writes the world position of the named frame in this monster's model into x, y, z. Fails if no frame has that name.
Original name: _GET_FRAME_POS.
VM_ARGS¶
extern void get_object_pos VM_ARGS(any object_name, OPTIONAL(float *x, float *y, float *z, string chara_name)) NATIVE(49);
Writes the world position of the named frame, searched across this monster and its linked parts, into x, y, z. With chara_name only the linked part with that name is searched. Fails unless given four or five arguments.
Original name: _GET_OBJ_POS.
VM_ARGS¶
extern void get_map_object_pos VM_ARGS(any frame_name, float *x, float *y, OPTIONAL(float *z)) NATIVE(50);
Writes the world position of the named frame on the map piece this monster is linked to into x, y, z. Fails if the monster is not linked to a map piece or the frame is missing.
Original name: _GET_MAPOBJ_POS.
VM_ARGS¶
extern void set_pause_flags VM_ARGS(enum pause_flags mask, int on, OPTIONAL(any extra3)) NATIVE(51);
Sets (on = 1) or clears (on = 0) dungeon pause bits given in mask: 1 monster AI, 2 player movement, 4 player control, 0x10 monster drawing, 0x20 sky, 0x80 map, 0x100 minimap, 0x200 pickups, 0x400 player status, 0x800 exit heal, 0x1000 enemy movement, 0x2000 weapon drawing, 0x4000 battle music, 0x8000 pad reset, 0x10000 monster names.
Original name: _SET_PAUSE.
check_pause_flags¶
Returns which of the dungeon pause bits in mask are set (the bitwise AND); the bits are the ones set_pause_flags lists.
Original name: _CHECK_PAUSE.
get_dungeon_flag¶
Returns a saved dungeon bit flag (0 or 1).
Original name: _GET_BIT_FLAG.
set_dungeon_flag¶
Sets a saved dungeon bit flag to value (0 or 1).
Original name: _SET_BIT_FLAG.
VM_ARGS¶
Returns the kind of the last attack that hit this monster.
Original name: _GET_ATT_TYPE.
get_player_status¶
Returns the status bits of the character the player controls: 1 poison, 2 slow, 0x10 power boost, and 4, 8, 0x20, 0x40 for other conditions.
Original name: _GET_USER_ATTR.
VM_ARGS¶
Copies reserved image 0 or 1, loaded earlier by the monster's script, over the monster's first texture image. Fails if that image was not loaded.
Original name: _TRANS_RESERV_IMG.
get_status_flags¶
Returns which of this monster's status bits in mask are set: 1 poison, 2 slow, 8 and 0x20 greyed out by a hit.
Original name: _GET_STS_ATTR.
VM_ARGS¶
Stores value in this monster's second variable set, indexes 0 to 31. An int value is stored as an int and a float as a float. Fails unless both arguments are given.
Original name: _V_PUSH2.
VM_ARGS¶
Reads this monster's second variable set, indexes 0 to 31, into value as an int or a float to match the receiving variable's type. Fails unless both arguments are given.
Original name: _V_POP2.
VM_ARGS¶
extern void set_lockon_mode VM_ARGS(enum lock_on_mode mode, OPTIONAL(any extra2, any extra3, any extra4, any extra5)) NATIVE(60, 1);
Sets how the player picks a target: 0 locks onto the nearest monster, 2 uses the cycling target selection.
Original name: _SET_LOCKON_MODE.
VM_ARGS¶
Sets the scene's motion blur amount; 0 turns it off.
Original name: _SET_MOTION_BLUR.
VM_ARGS¶
Shows (show = 1) or hides (show = 0) a piece of a named part of the active maps. Called with two arguments (parts_name, show) it shows or hides the whole part.
Original name: _SET_MAPOBJ_SHOW.
get_event_info¶
Returns event state chosen by selector. Only selector 0 is supported: the stopwatch time limit, 0 when the stopwatch counts up.
Original name: _GET_EVENT_INFO.
VM_ARGS¶
extern void loop_se_on_monster VM_ARGS(any monster, any se, any keep_frames, OPTIONAL(any extra4)) NATIVE(60, 5);
Plays a looping sound effect from a monster's sound bank for keep_frames frames, then stops it. Calling again before then restarts the count, so scripts call it every frame to keep the sound going. Monster handles are character numbers 24 to 47 (24 plus the active slot), as get_monster_handle and get_monster_in_range give them.
Original name: _MONS_SE_LOOP.
VM_ARGS¶
Sets how this monster's sound effects are mixed: 1 sets volume and pan from its position, 2 plays them at fixed volume. Any other value lasts one frame, after which the monster goes back to 1.
Original name: _MONS_VOL_CTRL.
get_distance_to¶
Returns the distance from this monster to the point x, y, z.
Original name: _GET_DIST.
VM_ARGS¶
extern void measure_clear_distance VM_ARGS(any distance, OPTIONAL(float angle, float *clear_dist)) NATIVE(70, 1);
Casts a ray from 100 units above this monster along its facing turned by angle radians, up to distance units, and writes how far it gets before hitting map collision into clear_dist (distance when nothing is hit).
Original name: _SEARCH_AREA.
VM_ARGS¶
Writes this monster's home position, where it was placed unless a script moved it, into x, y, z.
Original name: _GET_PLACE_POS.
VM_ARGS¶
Sets this monster's home position.
Original name: _SET_PLACE_POS.
VM_ARGS¶
Finds an active monster of the given kind number and writes its position into x, y, z. Only the first N active slots are checked, where N is the monster count, and it fails if none matches.
Original name: _GET_INDEX_POS.
get_pos¶
Writes this monster's position into x, y, z. Fails unless all three are given.
Original name: _GET_POS.
VM_ARGS¶
Moves this monster straight to x, y, z.
Original name: _SET_POS.
VM_ARGS¶
extern void get_rot VM_ARGS(any rot_x, float *rot_y, float *rot_z, OPTIONAL(any extra4)) NATIVE(70, 7);
Writes this monster's rotation in radians into rot_x, rot_y (yaw), rot_z. Called with four arguments, the first is an active monster slot (0 to 23, the handle minus 24) and that monster's rotation is written to the other three.
Original name: _GET_ROT.
set_rot¶
Sets this monster's rotation in radians at once and cancels any turn started by turn_to. Fails unless all three are given.
Original name: _SET_ROT.
VM_ARGS¶
Starts this monster turning toward yaw (radians) by turn_speed radians per frame. The turn ends when the monster faces yaw; get_rot shows progress.
Original name: _SET_NEXT_ROT.
VM_ARGS¶
extern void move_to VM_ARGS(any x, OPTIONAL(float y, float z, any speed, float arrive_dist)) NATIVE(70, 10);
Starts this monster walking toward x, y, z at speed units per frame. The walk ends within arrive_dist units of the point (20 when omitted), and ends at once if the monster is already that close; check_move_end polls it.
Original name: _SET_NEXT_POS.
check_move_end¶
Returns 1 when this monster is within the arrive distance of its move_to point, else 0.
Original name: _CHK_MOVE_END.
stop_moving¶
Stops the walk started by move_to by setting the move speed to 0.
Original name: _RESET_MOVE.
VM_ARGS¶
Writes the position of this monster's target, usually the player, into x, y, z, and with a fourth argument the distance to it into dist. Fails if there is no target.
Original name: _GET_TARGET_POS.
get_target_dist¶
Returns the distance from this monster to its target. Fails if there is no target.
Original name: _GET_TARGET_DIST.
VM_ARGS¶
Returns the world yaw in radians from this monster toward its target. Compare it with the monster's own yaw from get_rot. Fails if there is no target.
Original name: _GET_TARGET_ANGLE.
get_pos_near_target¶
extern void get_pos_near_target(float angle, float distance, float *x, float *y, float *z) NATIVE(70, 16);
Writes the point distance units from this monster's target in the world direction angle (yaw in radians) into x, y, z. Fails if there is no target.
Original name: _GET_TARGET_REF_POS.
get_point_side¶
Returns where the point x, y, z lies around this monster's facing: 1 ahead (within 0.8 radians), 3 on the negative-angle side, 4 on the positive-angle side, 2 behind (beyond 3.0 radians). When the point is closer than distance the result is 0 and the code writes the direction one argument further on.
Original name: _GET_REF_DIR.
get_pos_from_facing¶
extern void get_pos_from_facing(float angle, float distance, float *x, float *y, float *z) NATIVE(70, 18);
Writes the point distance units from this monster along its facing turned by angle radians into x, y, z.
Original name: _GET_REFANGLE_POS.
get_target_rot¶
Writes the rotation of this monster's target in radians into rot_x, rot_y (yaw), rot_z. Fails if there is no target.
Original name: _GET_TARGET_ROT.
get_angle_to¶
Returns the world yaw in radians from this monster toward the point x, y, z.
Original name: _GET_REF_ANGLE.
VM_ARGS¶
Returns this monster's height above the ground, or 0 when it is standing on the ground.
Original name: _GET_HIGH.
get_nearest_monster¶
Writes the position of the nearest other script-driven monster into x, y, z and its distance into dist. With no other monster the position is 0, 0, 0 and dist is -1.
Original name: _GET_NEAR_MONS_POS.
get_target_old_pos¶
Writes the position this monster's target had on the previous frame into x, y, z. Fails if there is no target.
Original name: _GET_TARGET_OLD_POS.
get_target_speed¶
Returns how far this monster's target moved since the previous frame, in units. Fails if there is no target.
Original name: _GET_TARGET_SPEED.
calc_step_toward¶
extern void calc_step_toward(float from_x, float from_y, float from_z, float to_x, float to_y, float to_z, float step, float *x, float *y, float *z, int *arrived) NATIVE(70, 25);
Moves step units from the from point toward the to point and writes the result into x, y, z. If the step reaches or passes the to point, x, y, z receive the to point and arrived receives 1, else 0.
Original name: _CALC_MOVE_NEXT_POS.
get_angle_between¶
extern void get_angle_between(float from_x, float from_y, float from_z, float to_x, float to_y, float to_z, float *rot_x, OPTIONAL(float *rot_y, float *rot_z)) NATIVE(70, 26);
Gets the direction from the from point to the to point. With one out argument rot_x receives the yaw in radians; with three they receive pitch, yaw and 0.
Original name: _GET_POSREF_ANGLE.
get_active_monster_pos¶
extern void get_active_monster_pos(int monster, float *x, float *y, float *z, OPTIONAL(float *dist)) NATIVE(70, 27);
Writes the position of the given monster into x, y, z, and with a fifth argument its distance from this monster into dist. Monster handles are character numbers 24 to 47 (24 plus the active slot), as get_monster_handle and get_monster_in_range give them.
Original name: _GET_ACTIVE_MONS_POS.
get_active_monster_rot¶
extern void get_active_monster_rot(int monster, float *rot_x, float *rot_y, float *rot_z) NATIVE(98);
Writes the rotation of the given monster in radians into rot_x, rot_y (yaw), rot_z. Monster handles are character numbers 24 to 47 (24 plus the active slot), as get_monster_handle and get_monster_in_range give them.
Original name: _GET_ACTIVE_MONS_ROT.
get_active_monster_dist¶
Returns the distance from this monster to the given monster. Monster handles are character numbers 24 to 47 (24 plus the active slot), as get_monster_handle and get_monster_in_range give them.
Original name: _GET_ACTIVE_MONS_DIST.
VM_ARGS¶
Writes the yaw in radians of the given monster into yaw. Monster handles are character numbers 24 to 47 (24 plus the active slot), as get_monster_handle and get_monster_in_range give them. Fails unless both arguments are given.
Original name: _GET_ACTIVE_MONS_ANGLE.
VM_ARGS¶
extern void get_rot_to VM_ARGS(any x, OPTIONAL(float y, float z, float *rot_x, float *rot_y, float *rot_z)) NATIVE(70, 31);
Writes the rotation that faces this monster toward the point x, y, z into rot_x (pitch), rot_y (yaw) and rot_z (0), in radians. Fails unless all six arguments are given.
Original name: _GET_REF_ROT.
get_dir_between¶
extern void get_dir_between(float to_x, float to_y, float to_z, float from_x, float from_y, float from_z, float *dir_x, OPTIONAL(float *dir_y, float *dir_z)) NATIVE(70, 32);
Gets the direction from the from point to the to point (note the to point comes first). With one out argument dir_x receives the yaw in radians; with three they receive the unit direction vector.
Original name: _GET_REF_ROT2.
VM_ARGS¶
extern void measure_flight_clearance VM_ARGS(any distance, OPTIONAL(float yaw, float *clear_dist)) NATIVE(70, 33);
Casts a ray from this monster's position in the world direction yaw (radians, not relative to its facing), up to distance units, and writes how far it gets before hitting map collision into clear_dist (distance when nothing is hit).
Original name: _FLYING_SEARCH_AREA.
get_height_above_ground¶
Returns how high the point x, y, z is above the map ground below it. If no ground is found within 300 units below, it returns -3.4e38.
Original name: _GET_HIGH2.
get_monster_in_range¶
Ranks the other script-driven monsters within range units of this monster by distance and returns the handle of the one at position rank (0 is the nearest), or -1 if there are not that many.
Original name: _GET_RANGE_MONS_ID.
VM_ARGS¶
extern void get_entry_object_pos VM_ARGS(any monster, OPTIONAL(int entry, float *x, float *y, float *z)) NATIVE(100, 6);
Writes the world position of entry frame 0 to 2, set up by the character data, of a monster into x, y, z. monster is a handle (24 to 47) or -1 for this monster. If the entry frame is missing the monster's own position is written.
Original name: _GET_ENTRY_OBJ_POS.
measure_segment_clearance¶
extern float measure_segment_clearance(float from_x, float from_y, float from_z, float to_x, float to_y, float to_z) NATIVE(70, 38);
Casts a ray from the from point to the to point and returns how far it gets before hitting map collision (the full length when nothing is hit).
Original name: _SEARCH_AREA2.
set_action_object¶
Registers the named frame of this monster's model as action object number index, used by natives that refer to objects by number. Fails if no frame has that name.
Original name: _SET_OBJ.
set_body¶
Only prints a diagnostic message. The arguments disc scripts pass (an int and a float) are ignored.
Original name: _SET_BODY.
set_damage_legacy¶
Obsolete. Prints a debug message and does nothing else; use add_attack_hit instead.
Original name: _SET_DMG.
add_attack_hit¶
extern void add_attack_hit(string hit_name, float radius, string motion_name, float start_ratio, float end_ratio, int index, OPTIONAL(int second_index)) NATIVE(110, 3);
Adds a damage hit to this monster that is active while a motion plays between two points, given as fractions 0.0 to 1.0 of the motion's length. The hit is a sphere at entry object index, or a capsule between index and second_index; its radius is twice the radius argument, or the entry object's own size when radius is 0 or less. hit_name names the damage settings, such as "通常攻撃".
Original name: _SET_DMG2.
link_map_part¶
Makes the named map part follow this monster. Does nothing outside a dungeon map.
Original name: _LINK_MAP_TO_OBJECT.
ride_map_piece¶
Makes this monster ride on the named piece of the named map part, so it moves with that piece.
Original name: _LINK_OBJECT_TO_PIECE.
VM_ARGS¶
Loads an effect base by number or name so effects can be created from it; does nothing if it is already loaded. level is the load level (-1 by default). is_loaded receives 1 when the base was newly loaded and 0 when it was already loaded or failed.
Original name: _LOAD_EFFECT_SCRIPT.
VM_ARGS¶
extern void set_photo_window VM_ARGS(any photo_no_or_motion, OPTIONAL(float start_ratio, float end_ratio, int photo_no)) NATIVE(110, 7);
Sets when a photo of this monster can be taken. With one argument, photo_no, a photo can be taken at any time; with four arguments (motion_name, start_ratio, end_ratio, photo_no) only while that motion plays between start_ratio and end_ratio, fractions 0.0 to 1.0 of its length. Other argument counts do nothing.
Original name: _SET_SCOOP.
load_reserve_image¶
Reads an image file, such as "dungeon/monster/b13a01.img", into reserve slot 0 or 1 of this monster so a later texture swap can copy it into the model.
Original name: _LOAD_RESERV_IMG.
VM_ARGS¶
Sets how many of the monsters nearest their target are allowed to come into sight, from 0 to 23. Applies to all monsters on the floor.
Original name: _SET_PRIORITY_LIMMIT.
set_model_lighting¶
Turns scene lighting on (1) or off (0) for this monster's model, or for one named frame of it. Off draws it with flat neutral colour 128.
Original name: _SET_MODEL_LIGHT_SWITCH.
set_model_color¶
extern void set_model_color(float red, OPTIONAL(float green, float blue, float alpha, string frame_name)) NATIVE(120, 1);
Turns off lighting for this monster's model, or one named frame of it, and draws it with a flat colour. Components run 0 to 255 with 128 as neutral.
Original name: _SET_MODEL_LIGHT_COLOR.
set_alpha¶
Sets the transparency this monster draws with, from 0.0 (invisible) to 1.0 (opaque).
Original name: _SET_ALPHA.
set_scale¶
Sets this monster's scale on each axis; 1.0 is normal size.
Original name: _SET_SCALE.
set_monster_kind_alpha¶
Sets the transparency, 0.0 to 1.0, of the first monster on the floor whose kind number is monster_kind.
Original name: _SET_INDEX_ALPHA.
start_color_pulse¶
extern void start_color_pulse(int red, int green, int blue, int pulse_count, int frames, OPTIONAL(int repeats)) NATIVE(120, 5);
Makes this monster's colour pulse toward red, green, blue (0 to 255) pulse_count times over each cycle of frames. repeats is the number of extra cycles, -1 to repeat forever, 0 by default.
Original name: _SET_PALLET_ANIM.
VM_ARGS¶
Stops the colour pulse started with start_color_pulse on this monster.
Original name: _RESET_PALLET_ANIM.
VM_ARGS¶
Sets (on = 1) or clears (on = 0) behaviour bits on this monster: 1 no lock-on, 4 walking replaces velocity, 8 ignore map collision, 16 not pushed by other monsters, 32 takes no damage and cannot be stunned, 64 vanishes at once on death, 256 skip ground search, 512 always counts as in sight.
Original name: _SET_ATTRIB.
VM_ARGS¶
Sets (on = 1, the default) or clears (on = 0) status bits on this monster's scene character slot.
Original name: _SET_STATUS.
set_mask_flag¶
Sets (on = 1) or clears (on = 0) mask flag bits on this monster. Bit 1 stops it guarding hits; bit 2 stops it dodging attacks.
Original name: _SET_INT_FLAG.
set_act_status¶
Sets the status value of this monster that other characters' action scripts read.
Original name: _SET_ACT_STATUS.
set_invincible_time¶
Makes this monster take no damage for the given number of steps; 0 ends it.
Original name: _SET_MUTEKI.
set_gravity¶
Unused stub. Does nothing and reports failure.
Original name: _SET_GRAVITY.
set_collision¶
Unused stub. Does nothing and reports failure.
Original name: _SET_COLLISION.
get_rage_hits_left¶
Returns how many more hits it takes to enrage this monster; -1.0 for a boss.
Original name: _GET_GEKIRIN.
get_priority¶
Returns this monster's rank by distance to its target, 0 for the nearest monster, -1 for none.
Original name: _GET_PRIORITY.
set_clip_dist¶
Sets the distance within which this monster comes into sight and shows its life gauge. The argument is multiplied by 20 to give world units; scripts pass 999999.0 to always show it.
Original name: _SET_CLIP_DIST.
show_stun_stars¶
Shows the stars circling this monster's head for the rest of its current stun.
Original name: _SET_PIYORI_MARK.
get_stun_stars_left¶
Returns how many steps the stun stars over this monster still show; 0 when it is not stunned.
Original name: _CHECK_PIYORI.
get_scale¶
Reads this monster's scale on each axis.
Original name: _GET_SCALE.
VM_ARGS¶
Returns the radius this monster uses for map collision, or 15.0 when it has none.
Original name: _GET_MONS_WIDTH.
start_knockback¶
Knocks this monster back at speed (scaled by its knockback rate), slowing by decel each step, for the given number of steps.
Original name: _BLOW_START.
VM_ARGS¶
Marks this monster dead, stops its colour pulse, and scatters its reward money, its transformation badge if it has one, and random drop items, playing a sound.
Original name: _SET_DEAD_START.
VM_ARGS¶
Starts this monster's fade-out, plays its death smoke unless attribute bit 2 is set, and scatters weapon experience pickups for the character that dealt the last hit.
Original name: _SET_DEAD_OFF.
end_throw¶
Clears this monster's held or thrown state after it has been caught or thrown.
Original name: _SET_SHROW_END.
VM_ARGS¶
Returns this monster's current attack power.
Original name: _GET_BASE_ATTACK.
VM_ARGS¶
Sets this monster's defence to its table defence multiplied by rate.
Original name: _SET_DEF_RATE.
VM_ARGS¶
Sets this monster's life. An int sets it directly; a float sets it as a fraction of max life. The result is clamped to 0 through max life, and a value above 0 marks the monster alive again.
Original name: _SET_MONSTER_LIFE.
get_life¶
Reads this monster's life into an int variable, or its life as a fraction 0.0 to 1.0 of max life into a float variable.
Original name: _GET_MONSTER_LIFE.
VM_ARGS¶
Returns how many hits on this monster did no damage.
Original name: _GET_NO_DAMAGE_CNT.
VM_ARGS¶
Returns a monster's current life. Scene character number of a monster (its slot plus 24), or -1 for this monster.
Original name: _GET_ACTIVE_MONS_LIFEI.
get_monster_life_ratio¶
Returns a monster's life as a fraction 0.0 to 1.0 of its max life. Scene character number of a monster (its slot plus 24), or -1 for this monster.
Original name: _GET_ACTIVE_MONS_LIFEF.
add_monster_life¶
Adds amount to a monster's life, negative to take life, clamped to 0 through max life. Scene character number of a monster (its slot plus 24), or -1 for this monster.
Original name: _SET_ACTIVE_MONS_LIFEI.
heal_monster_life_ratio¶
Heals a monster by a fraction of its max life, capped at max life; negative fractions do nothing. Scene character number of a monster (its slot plus 24), or -1 for this monster.
Original name: _SET_ACTIVE_MONS_LIFEF.
get_monster_max_life¶
Returns a monster's max life. Scene character number of a monster (its slot plus 24), or -1 for this monster.
Original name: _GET_ACTIVE_MONS_MAX_LIFE.
show_damage_number¶
extern void show_damage_number(int monster, int value, OPTIONAL(enum damage_number_color color)) NATIVE(160, 10);
Pops up a damage number above a monster. With color = 1 the number is drawn green. Scene character number of a monster (its slot plus 24), or -1 for this monster.
Original name: _SET_DAMAGE_SCORE.
VM_ARGS¶
Returns a monster's grade from its kind's table. Scene character number of a monster (its slot plus 24), or -1 for this monster.
Original name: _GET_MONS_GRADE.
set_guard_rate¶
Sets a monster's chance to guard a hit to its table chance multiplied by rate, capped at 100 percent. Scene character number of a monster (its slot plus 24), or -1 for this monster.
Original name: _SET_GUARD_RATE.
set_dodge_rate¶
Sets both of a monster's chances to dodge its target's attacks to their table values multiplied by rate, capped at 100 percent. Scene character number of a monster (its slot plus 24), or -1 for this monster.
Original name: _SET_ESCAPE_RATE.
VM_ARGS¶
extern void set_damage_kind_rate VM_ARGS(int monster, enum damage_kind_mask mask, float rate, OPTIONAL(any extra4)) NATIVE(170, 4);
Sets the damage percentages of the attack kinds picked by mask (bits 0 to 11) to their table values multiplied by rate, capped at 100. Scene character number of a monster (its slot plus 24), or -1 for this monster.
Original name: _SET_EXT_PARAM_RATE.
is_boss¶
Returns nonzero when this monster is a boss, whose life shows across the foot of the screen.
Original name: _GET_BOSS_FLAG.
VM_ARGS¶
extern void set_entry_object_size VM_ARGS(int index, float size, OPTIONAL(any extra3, any extra4)) NATIVE(170, 6);
Sets the size of one of this monster's entry objects, the frames used as hit points; index -1 means 0.
Original name: _SET_INDEXOBJ_SIZE.
get_entry_object_size¶
Returns the size of one of this monster's entry objects; index -1 means 0.
Original name: _GET_INDEXOBJ_SIZE.
reset_motion¶
Stops the motion of this monster and every part chained to it.
Original name: _RESET_MOTION.
VM_ARGS¶
extern void set_motion VM_ARGS(any motion_name, OPTIONAL(float speed, enum motion_flags flags)) NATIVE(180, 2);
Plays the named motion on this monster and every part chained to it. speed is frames advanced per step; -1 keeps the current speed. flags: 1 pause, 2 hold on the last frame instead of looping, 4 restart without blending.
Original name: _SET_MOS.
check_motion_end¶
Reads 1 into is_done when the motion of this monster, or of its named chained part, reaches its last frame within two steps or no motion plays.
Original name: _CHECK_MOS_END.
get_motion_progress¶
Reads how far the current motion of this monster, or of its named chained part, has played, from 0.0 to 1.0.
Original name: _NOW_MOS_WAIT.
get_motion_status¶
Reads the motion state of this monster, or of its named chained part: 0 none, 1 on first frame, 2 playing, 3 blending, 4 reached last frame.
Original name: _GET_MOS_STATUS.
create_effect¶
Starts the named effect, owned by this monster. With slot given it receives the effect's slot number for the other effect natives.
Original name: _ESM_CREATE.
finish_effect¶
Tells this monster's effect in slot to run its finishing program (300) so it ends on its own.
Original name: _ESM_FINISH.
delete_effect¶
Removes this monster's effect in slot at once.
Original name: _ESM_DELETE.
set_effect_vec1¶
Sets the first work vector of this monster's effect in slot, -1 for the last started one; effects use it as a position or direction.
Original name: _ESM_SET_VECT1.
get_effect_vec1¶
Reads the first work vector of this monster's effect in slot, -1 for the last started one.
Original name: _ESM_GET_VECT1.
set_effect_vec2¶
Sets the second work vector of this monster's effect in slot, -1 for the last started one.
Original name: _ESM_SET_VECT2.
get_effect_vec2¶
Reads the second work vector of this monster's effect in slot, -1 for the last started one.
Original name: _ESM_GET_VECT2.
set_effect_target¶
Sets the target character (scene character number) of this monster's effect in slot, -1 for the last started one.
Original name: _ESM_SET_TARGET_ID.
get_effect_target¶
Returns the target character of this monster's effect in slot, -1 for the last started one.
Original name: _ESM_GET_TARGET_ID.
set_effect_owner¶
Sets the owner id of this monster's effect in slot, -1 for the last started one.
Original name: _ESM_SET_USER_ID.
get_effect_owner¶
Returns the owner id of this monster's effect in slot, -1 for the last started one.
Original name: _ESM_GET_USER_ID.
VM_ARGS¶
Sets script value number index of this monster's effect in slot, -1 for the last started one, to an int or float.
Original name: _ESM_SET_VALUE.
add_sword_trail¶
extern void add_sword_trail(int trail, string motion_name, float start_ratio, float end_ratio, string start_frame, string end_frame, int length, int hold_frames, int fade_frames) NATIVE(190, 13);
Adds a sword trail to this monster using its trail effect 0 to 2. The trail starts while motion_name plays between start_ratio and end_ratio (fractions 0.0 to 1.0 of its length) and is drawn between the frames named start_frame and end_frame. length is the number of recorded positions drawn, hold_frames the steps before it fades, fade_frames the steps the fade takes.
Original name: _SW_EFFECT.
get_free_texture_block¶
Returns the next free effect texture block, or -1 when the pool is full.
Original name: _ESM_GET_NOTUESD_TEXB.
use_texture_block¶
Marks the next effect texture block as used by the current load level.
Original name: _ESM_ADD_TEXB.
fire_rocket¶
extern void fire_rocket(float x, float y, float z, float dir_x, float dir_y, float dir_z, OPTIONAL(float speed, int homing_delay, int homing_time, int damage)) NATIVE(190, 16);
Fires a homing rocket from x, y, z in direction dir_x, dir_y, dir_z. speed defaults to 12.0, homing_delay to 6 steps, homing_time to 45 steps and damage to this monster's attack power; give all four or none.
Original name: _SHOT_ROCKET_LAUNCHER.
clear_owner_effects¶
Stops every effect that belongs to the given owner id.
Original name: _ESM_ALL_CLEAR.
VM_ARGS¶
Numbers the disc calls that this table never registers. The engine prints "not found ext" and moves on, so these calls do nothing.
VM_ARGS¶
VM_ARGS¶
VM_ARGS¶
VM_ARGS¶
VM_ARGS¶
VM_ARGS¶
VM_ARGS¶
VM_ARGS¶
VM_ARGS¶
VM_ARGS¶
VM_ARGS¶
VM_ARGS¶
Helpers¶
Inline helper functions that wrap common sequences of native calls.
| Helper | What it does |
|---|---|
allow_guard_and_dodge |
Clears mask flag bits 1 and 2, so the monster can guard hits and dodge attacks again. |
forbid_guard_and_dodge |
Sets mask flag bits 1 and 2, so the monster can neither guard hits nor dodge attacks. |
set_scripted_movement |
Sets (on = 1) or clears (on = 0) attribute bits 4, 256 and 8 together: walking replaces velocity, ground search is skipped and map collision is ignored, so a script can move the monster freely. |
enter_state |
Stores state in monster variable 0, the behaviour bits other monster scripts read, and loops a motion at its own speed. |
reset_and_play_motion |
Stops the current and chained motions, then plays a motion at its own speed with the given flags. |
play_knockback |
Plays a hit reaction motion at its own speed and starts knocking the monster back. |
get_pos_and_rot |
Writes the monster's position and rotation into six float out parameters. |
spawn_effect |
Starts an effect script and sets its first vector (usually the position) and second vector. |
spawn_effect_at |
Starts an effect script and sets its first vector, usually its position. |
recover_from_throw |
Clears the no-damage attribute, stops moving and ends the thrown state, as a monster does when it lands after being thrown. |
get_unit_direction |
Writes the unit vector pointing from the from point to the to point into x, y, z. |
make_direction_from |
Replaces the point held in x, y, z with the unit vector pointing to it from the from point. |
make_offset_from |
Replaces the point held in x, y, z with the vector of the given length pointing to it from the from point. |
place_at_distance_from |
Moves the point held in x, y, z along the line from the from point so it lies length units from that point. |
set_vector_length |
Scales the vector held in x, y, z to the given length, keeping its direction. |
loop_motion |
Loops a motion at its own speed (speed -1, flags 0). |
loop_motion_f |
Loops a motion at its own speed, for scripts that pass the speed as the float -1.0. |
start_turning_to_target |
Reads the yaw toward the target into angle and starts turning toward it at turn_speed radians per frame. |
start_turning_to_monster |
Reads another monster's position into x, y, z and the yaw toward it into angle, and starts turning toward it at turn_speed radians per frame. |
snap_to_target_yaw |
Reads the yaw toward the target into angle and sets the monster's rotation to face it at once. |
set_home_here |
Reads the monster's position into x, y, z and makes it the monster's home position. |
get_home_distance |
Reads the home position and the monster's position, and writes the distance between them into dist. |
measure_clear_ahead |
Writes how far the monster can see ahead along its facing, up to 100 units, before map collision. |
allow_guard_and_dodge¶
Clears mask flag bits 1 and 2, so the monster can guard hits and dodge attacks again.
static inline void allow_guard_and_dodge(void)
{
set_mask_flag(MASK_NO_GUARD, 0);
set_mask_flag(MASK_NO_DODGE, 0);
}
forbid_guard_and_dodge¶
Sets mask flag bits 1 and 2, so the monster can neither guard hits nor dodge attacks.
static inline void forbid_guard_and_dodge(void)
{
set_mask_flag(MASK_NO_GUARD, 1);
set_mask_flag(MASK_NO_DODGE, 1);
}
set_scripted_movement¶
Sets (on = 1) or clears (on = 0) attribute bits 4, 256 and 8 together: walking replaces velocity, ground search is skipped and map collision is ignored, so a script can move the monster freely.
static inline void set_scripted_movement(int on)
{
set_attrib(MONSTER_ATTRIB_SET_VELOCITY, on);
set_attrib(MONSTER_ATTRIB_SKIP_GROUND, on);
set_attrib(MONSTER_ATTRIB_NO_MAP_HIT, on);
}
enter_state¶
Stores state in monster variable 0, the behaviour bits other monster scripts read, and loops a motion at its own speed.
static inline void enter_state(int state, string motion)
{
set_monster_var(0, state);
set_motion(motion, -1, 0);
}
reset_and_play_motion¶
Stops the current and chained motions, then plays a motion at its own speed with the given flags.
static inline void reset_and_play_motion(string motion, enum motion_flags flags)
{
reset_motion();
set_motion(motion, -1, flags);
}
play_knockback¶
Plays a hit reaction motion at its own speed and starts knocking the monster back.
static inline void play_knockback(string motion, enum motion_flags flags, float speed, float decel, int frames)
{
set_motion(motion, -1, flags);
start_knockback(speed, decel, frames);
}
get_pos_and_rot¶
Writes the monster's position and rotation into six float out parameters.
static inline void get_pos_and_rot(float *x, float *y, float *z, float *rot_x, float *rot_y, float *rot_z)
{
get_pos(x, y, z);
get_rot(rot_x, rot_y, rot_z);
}
spawn_effect¶
Starts an effect script and sets its first vector (usually the position) and second vector.
static inline void spawn_effect(string effect_name, float x, float y, float z, float x2, float y2, float z2)
{
create_effect(effect_name);
set_effect_vec1(-1, x, y, z);
set_effect_vec2(-1, x2, y2, z2);
}
spawn_effect_at¶
Starts an effect script and sets its first vector, usually its position.
static inline void spawn_effect_at(string effect_name, float x, float y, float z)
{
create_effect(effect_name);
set_effect_vec1(-1, x, y, z);
}
recover_from_throw¶
Clears the no-damage attribute, stops moving and ends the thrown state, as a monster does when it lands after being thrown.
static inline void recover_from_throw(void)
{
set_attrib(MONSTER_ATTRIB_NO_DAMAGE, 0);
stop_moving();
end_throw();
}
get_unit_direction¶
Writes the unit vector pointing from the from point to the to point into x, y, z.
static inline void get_unit_direction(float *x, float *y, float *z, float to_x, float to_y, float to_z, float from_x, float from_y, float from_z)
{
copy_vector(x, y, z, to_x, to_y, to_z);
subtract_vector(x, y, z, from_x, from_y, from_z);
normalize_vector(x, y, z);
}
make_direction_from¶
Replaces the point held in x, y, z with the unit vector pointing to it from the from point.
static inline void make_direction_from(float *x, float *y, float *z, float from_x, float from_y, float from_z)
{
subtract_vector(x, y, z, from_x, from_y, from_z);
normalize_vector(x, y, z);
}
make_offset_from¶
Replaces the point held in x, y, z with the vector of the given length pointing to it from the from point.
static inline void make_offset_from(float *x, float *y, float *z, float from_x, float from_y, float from_z, float length)
{
subtract_vector(x, y, z, from_x, from_y, from_z);
normalize_vector(x, y, z);
scale_vector(x, y, z, length);
}
place_at_distance_from¶
Moves the point held in x, y, z along the line from the from point so it lies length units from that point.
static inline void place_at_distance_from(float *x, float *y, float *z, float from_x, float from_y, float from_z, float length)
{
subtract_vector(x, y, z, from_x, from_y, from_z);
normalize_vector(x, y, z);
scale_vector(x, y, z, length);
add_vector(x, y, z, from_x, from_y, from_z);
}
set_vector_length¶
Scales the vector held in x, y, z to the given length, keeping its direction.
static inline void set_vector_length(float *x, float *y, float *z, float length)
{
normalize_vector(x, y, z);
scale_vector(x, y, z, length);
}
loop_motion¶
Loops a motion at its own speed (speed -1, flags 0).
loop_motion_f¶
Loops a motion at its own speed, for scripts that pass the speed as the float -1.0.
start_turning_to_target¶
Reads the yaw toward the target into angle and starts turning toward it at turn_speed radians per frame.
static inline void start_turning_to_target(float *angle, float turn_speed)
{
*angle = get_target_angle();
turn_to(*angle, turn_speed);
}
start_turning_to_monster¶
Reads another monster's position into x, y, z and the yaw toward it into angle, and starts turning toward it at turn_speed radians per frame.
static inline void start_turning_to_monster(int monster, float *x, float *y, float *z, float *angle, float turn_speed)
{
get_active_monster_pos(monster, x, y, z);
*angle = get_angle_to(*x, *y, *z);
turn_to(*angle, turn_speed);
}
snap_to_target_yaw¶
Reads the yaw toward the target into angle and sets the monster's rotation to face it at once.
static inline void snap_to_target_yaw(float *angle)
{
*angle = get_target_angle();
set_rot(0.0, *angle, 0.0);
}
set_home_here¶
Reads the monster's position into x, y, z and makes it the monster's home position.
static inline void set_home_here(float *x, float *y, float *z)
{
get_pos(x, y, z);
set_home_pos(*x, *y, *z);
}
get_home_distance¶
Reads the home position and the monster's position, and writes the distance between them into dist.
static inline void get_home_distance(float *home_x, float *home_y, float *home_z, float *x, float *y, float *z, float *dist)
{
get_home_pos(home_x, home_y, home_z);
get_pos(x, y, z);
*dist = get_distance_between(*x, *y, *z, *home_x, *home_y, *home_z);
}
measure_clear_ahead¶
Writes how far the monster can see ahead along its facing, up to 100 units, before map collision.
static inline void measure_clear_ahead(float *clear_dist)
{
measure_clear_distance(100.0, 0.0, clear_dist);
}
Programs¶
Program entry-point numbers started by the engine (enum program). Register an entry point in a script with PROGRAM(name, function);.
| Program | Number | When it runs |
|---|---|---|
init |
100 | Runs once when the monster is placed, right after its script is loaded (monster.cpp sets req_prog MONSTER_PROG_INIT and runs it before switching to 200). |
update |
200 | Normal behaviour loop: resumed every frame and restarted whenever the running program ends (runscript_opcodes.cpp CMonsterMan::RunScript, MONSTER_PROG_MAIN). |
stopped |
400 | Runs when a hit lands on a monster under the stop status or inflicts it (monster.cpp reaction 3, status bits 0x8/0x20, MONSTER_PROG_STATUS); retail bodies hold the damage pose until the status clears. |
damage |
500 | Runs when a hit staggers the monster (monster.cpp reaction 2 once the stagger total reaches the table limit, MONSTER_PROG_DAMAGE). |
knockdown |
600 | Runs when a hit with the knockdown flag knocks the monster over (monster.cpp reaction 4, MONSTER_PROG_KNOCK). |
guard |
700 | Runs when the monster guards a hit or takes no damage from it (monster.cpp MONSTER_PROG_GUARD). |
dodge_melee |
800 | Runs when the monster rolls its escape_rate0 chance to dodge an attack that its target started with murderous mode 0, which the action scripts set for melee swings (monster.cpp MONSTER_PROG_ESCAPE_0). |
dodge_shot |
900 | Runs when the monster rolls its escape_rate1 chance to dodge an attack that its target started with murderous mode 1, which the action scripts set when firing a gun (monster.cpp MONSTER_PROG_ESCAPE_1). |
death |
1000 | Runs when a hit brings the monster's life to zero or a death request arrives (monster.cpp reaction 6 and damage_req 4, MONSTER_PROG_DEAD). |
lifted |
1100 | Runs when the player picks the monster up and carries it (monster.cpp sets catch_state 1 and req_prog 1100). |
land |
1200 | Runs when a thrown monster hits the ground (monster.cpp catch_state 2 on landing, MONSTER_PROG_LAND). |
stun |
1400 | Runs when the monster is stunned by a stun hit, a nearby shock or a thrown monster colliding with it (monster.cpp MONSTER_PROG_PIYORI, sets piyori_time). |
Constants¶
| Name | Value | What it is |
|---|---|---|
PI |
3.1415927 |
enum camera_mode¶
Dungeon battle-area camera modes handled in dng_main.cpp.
| Name | Value |
|---|---|
CAMERA_MODE_PLAYER |
0 |
CAMERA_MODE_BOSS |
1 |
CAMERA_MODE_ARENA |
2 |
CAMERA_MODE_PLAYER_LOW |
4 |
enum damage_kind_mask¶
Bits selecting a monster's per-attack-kind damage percentages (ext_param, indexed through vs_attk_index by DamageKind).
| Name | Value |
|---|---|
DAMAGE_MASK_MAX_MELEE |
1 |
DAMAGE_MASK_MAX_GUN |
2 |
DAMAGE_MASK_LASER_GUN |
4 |
DAMAGE_MASK_GRENADE |
8 |
DAMAGE_MASK_MONICA_MELEE |
16 |
DAMAGE_MASK_MONICA_MAGIC |
32 |
DAMAGE_MASK_RIDEPOD_PUNCH |
64 |
DAMAGE_MASK_RIDEPOD_SWORD |
128 |
DAMAGE_MASK_RIDEPOD_GUN |
256 |
DAMAGE_MASK_KIND_14 |
512 |
DAMAGE_MASK_MONSTER |
1024 |
DAMAGE_MASK_ITEM |
2048 |
enum damage_number_color¶
Colour of a popped-up damage number in _SET_DAMAGE_SCORE.
| Name | Value |
|---|---|
DAMAGE_NUMBER_GREEN |
1 |
enum event_info¶
Selectors of _GET_EVENT_INFO.
| Name | Value |
|---|---|
EVENT_INFO_STOPWATCH_LIMIT |
0 |
enum lock_on_mode¶
How the player picks a target (scenesnd.hpp lock_on_mode): nearest monster or cycling selection.
| Name | Value |
|---|---|
LOCK_ON_MODE_NEAREST |
0 |
LOCK_ON_MODE_SELECT |
2 |
enum mask_flags¶
Monster mask_flag bits tested in monster.cpp: 1 cancels the guard roll, 2 cancels the dodge roll.
| Name | Value |
|---|---|
MASK_NO_GUARD |
1 |
MASK_NO_DODGE |
2 |
enum monster_attrib¶
Behaviour bits of an active monster (monster.hpp MONSTER_ATTRIB); bit 2 skips the death smoke in _SET_DEAD_OFF and bit 0x80 stops hits pushing the monster in CheckDamage.
| Name | Value |
|---|---|
MONSTER_ATTRIB_NO_LOCK_ON |
1 |
MONSTER_ATTRIB_NO_DEATH_SMOKE |
2 |
MONSTER_ATTRIB_SET_VELOCITY |
4 |
MONSTER_ATTRIB_NO_MAP_HIT |
8 |
MONSTER_ATTRIB_NO_BODY_HIT |
16 |
MONSTER_ATTRIB_NO_DAMAGE |
32 |
MONSTER_ATTRIB_QUICK_DEAD |
64 |
MONSTER_ATTRIB_NO_HIT_PUSH |
128 |
MONSTER_ATTRIB_SKIP_GROUND |
256 |
MONSTER_ATTRIB_ALWAYS_VIEW |
512 |
enum monster_status¶
Status bits that hits leave on a monster (monster.hpp MONSTER_STATUS_ATTR); 0x8 and 0x20 are the stop status for 300 and 900 steps.
| Name | Value |
|---|---|
MONSTER_STATUS_POISON |
1 |
MONSTER_STATUS_SLOW |
2 |
MONSTER_STATUS_STOP |
8 |
MONSTER_STATUS_STOP_LONG |
32 |
enum motion_flags¶
Motion playback flags (character.hpp CharaMotionFlag): pause, stop on the last frame, restart without blending.
| Name | Value |
|---|---|
CHARA_MOTION_PAUSE |
1 |
CHARA_MOTION_HOLD |
2 |
CHARA_MOTION_RESTART |
4 |
enum pause_flags¶
Dungeon battle-area pause bits (scenesnd.hpp DNG_PAUSE_*), each stopping one dungeon system while set.
| Name | Value |
|---|---|
DNG_PAUSE_MONSTER_AI |
1 |
DNG_PAUSE_PLAYER_STEP |
2 |
DNG_PAUSE_PLAYER_CONTROL |
4 |
DNG_PAUSE_MONSTER_DRAW |
16 |
DNG_PAUSE_SKY_DRAW |
32 |
DNG_PAUSE_MAP_DRAW |
128 |
DNG_PAUSE_MINIMAP |
256 |
DNG_PAUSE_PICKUPS |
512 |
DNG_PAUSE_PLAYER_STATUS |
1024 |
DNG_PAUSE_EXIT_HEAL |
2048 |
DNG_PAUSE_ENEMY_STEP |
4096 |
DNG_PAUSE_WEAPON_DRAW |
8192 |
DNG_PAUSE_BATTLE_MUSIC |
16384 |
DNG_PAUSE_PAD_RESET |
32768 |
DNG_PAUSE_MONSTER_NAMES |
65536 |
enum scene_chara_status¶
Drawing bits of a scene character slot (scenevillager.hpp SCENE_CHARA_STATUS).
| Name | Value |
|---|---|
SCENE_CHARA_NO_SHADOW |
8 |
SCENE_CHARA_HIDE |
16 |
SCENE_CHARA_EXCLAMATION |
32 |
SCENE_CHARA_NO_LIGHTING |
64 |
SCENE_CHARA_NO_FADE |
128 |
SCENE_CHARA_NO_DIST |
256 |
SCENE_CHARA_NO_MODEL |
512 |
enum se_mode¶
How a monster's sound effects are mixed (character.hpp se_positional).
| Name | Value |
|---|---|
SE_MODE_POSITIONAL |
1 |
SE_MODE_FIXED |
2 |