100 KiB
⏪ Lua Functions
functions from save_file.h
save_file_clear_flags
Lua Example
save_file_clear_flags(flags)
Parameters
| Field | Type |
|---|---|
| flags | integer |
Returns
- None
C Prototype
void save_file_clear_flags(u32 flags);
save_file_do_save
Lua Example
save_file_do_save(fileIndex, forceSave)
Parameters
| Field | Type |
|---|---|
| fileIndex | integer |
| forceSave | integer |
Returns
- None
C Prototype
void save_file_do_save(s32 fileIndex, s8 forceSave);
save_file_erase
Lua Example
save_file_erase(fileIndex)
Parameters
| Field | Type |
|---|---|
| fileIndex | integer |
Returns
- None
C Prototype
void save_file_erase(s32 fileIndex);
save_file_erase_current_backup_save
Lua Example
save_file_erase_current_backup_save()
Parameters
- None
Returns
- None
C Prototype
void save_file_erase_current_backup_save(void);
save_file_get_cap_pos
Lua Example
local integerValue = save_file_get_cap_pos(capPos)
Parameters
| Field | Type |
|---|---|
| capPos | Vec3s |
Returns
integer
C Prototype
s32 save_file_get_cap_pos(Vec3s capPos);
save_file_get_course_coin_score
Lua Example
local integerValue = save_file_get_course_coin_score(fileIndex, courseIndex)
Parameters
| Field | Type |
|---|---|
| fileIndex | integer |
| courseIndex | integer |
Returns
integer
C Prototype
s32 save_file_get_course_coin_score(s32 fileIndex, s32 courseIndex);
save_file_get_course_star_count
Lua Example
local integerValue = save_file_get_course_star_count(fileIndex, courseIndex)
Parameters
| Field | Type |
|---|---|
| fileIndex | integer |
| courseIndex | integer |
Returns
integer
C Prototype
s32 save_file_get_course_star_count(s32 fileIndex, s32 courseIndex);
save_file_get_flags
Lua Example
local integerValue = save_file_get_flags()
Parameters
- None
Returns
integer
C Prototype
u32 save_file_get_flags(void);
save_file_get_max_coin_score
Lua Example
local integerValue = save_file_get_max_coin_score(courseIndex)
Parameters
| Field | Type |
|---|---|
| courseIndex | integer |
Returns
integer
C Prototype
u32 save_file_get_max_coin_score(s32 courseIndex);
save_file_get_sound_mode
Lua Example
local integerValue = save_file_get_sound_mode()
Parameters
- None
Returns
integer
C Prototype
u16 save_file_get_sound_mode(void);
save_file_get_star_flags
Lua Example
local integerValue = save_file_get_star_flags(fileIndex, courseIndex)
Parameters
| Field | Type |
|---|---|
| fileIndex | integer |
| courseIndex | integer |
Returns
integer
C Prototype
u32 save_file_get_star_flags(s32 fileIndex, s32 courseIndex);
save_file_get_total_star_count
Lua Example
local integerValue = save_file_get_total_star_count(fileIndex, minCourse, maxCourse)
Parameters
| Field | Type |
|---|---|
| fileIndex | integer |
| minCourse | integer |
| maxCourse | integer |
Returns
integer
C Prototype
s32 save_file_get_total_star_count(s32 fileIndex, s32 minCourse, s32 maxCourse);
save_file_is_cannon_unlocked
Lua Example
local integerValue = save_file_is_cannon_unlocked(fileIndex, courseIndex)
Parameters
| Field | Type |
|---|---|
| fileIndex | integer |
| courseIndex | integer |
Returns
integer
C Prototype
s32 save_file_is_cannon_unlocked(s32 fileIndex, s32 courseIndex);
save_file_reload
Lua Example
save_file_reload(load_all)
Parameters
| Field | Type |
|---|---|
| load_all | integer |
Returns
- None
C Prototype
void save_file_reload(u8 load_all);
save_file_remove_star_flags
Lua Example
save_file_remove_star_flags(fileIndex, courseIndex, starFlagsToRemove)
Parameters
| Field | Type |
|---|---|
| fileIndex | integer |
| courseIndex | integer |
| starFlagsToRemove | integer |
Returns
- None
C Prototype
void save_file_remove_star_flags(s32 fileIndex, s32 courseIndex, u32 starFlagsToRemove);
save_file_set_course_coin_score
Lua Example
save_file_set_course_coin_score(fileIndex, courseIndex, coinScore)
Parameters
| Field | Type |
|---|---|
| fileIndex | integer |
| courseIndex | integer |
| coinScore | integer |
Returns
- None
C Prototype
void save_file_set_course_coin_score(s32 fileIndex, s32 courseIndex, u8 coinScore);
save_file_set_flags
Lua Example
save_file_set_flags(flags)
Parameters
| Field | Type |
|---|---|
| flags | integer |
Returns
- None
C Prototype
void save_file_set_flags(u32 flags);
save_file_set_star_flags
Lua Example
save_file_set_star_flags(fileIndex, courseIndex, starFlags)
Parameters
| Field | Type |
|---|---|
| fileIndex | integer |
| courseIndex | integer |
| starFlags | integer |
Returns
- None
C Prototype
void save_file_set_star_flags(s32 fileIndex, s32 courseIndex, u32 starFlags);
touch_coin_score_age
Lua Example
touch_coin_score_age(fileIndex, courseIndex)
Parameters
| Field | Type |
|---|---|
| fileIndex | integer |
| courseIndex | integer |
Returns
- None
C Prototype
void touch_coin_score_age(s32 fileIndex, s32 courseIndex);
functions from seqplayer.h
sequence_player_get_tempo
Lua Example
local integerValue = sequence_player_get_tempo(player)
Parameters
| Field | Type |
|---|---|
| player | integer |
Returns
integer
C Prototype
u16 sequence_player_get_tempo(u8 player);
sequence_player_get_tempo_acc
Lua Example
local integerValue = sequence_player_get_tempo_acc(player)
Parameters
| Field | Type |
|---|---|
| player | integer |
Returns
integer
C Prototype
u16 sequence_player_get_tempo_acc(u8 player);
sequence_player_get_transposition
Lua Example
local integerValue = sequence_player_get_transposition(player)
Parameters
| Field | Type |
|---|---|
| player | integer |
Returns
integer
C Prototype
u16 sequence_player_get_transposition(u8 player);
sequence_player_set_tempo
Lua Example
sequence_player_set_tempo(player, tempo)
Parameters
| Field | Type |
|---|---|
| player | integer |
| tempo | integer |
Returns
- None
C Prototype
void sequence_player_set_tempo(u8 player, u16 tempo);
sequence_player_set_tempo_acc
Lua Example
sequence_player_set_tempo_acc(player, tempoAcc)
Parameters
| Field | Type |
|---|---|
| player | integer |
| tempoAcc | integer |
Returns
- None
C Prototype
void sequence_player_set_tempo_acc(u8 player, u16 tempoAcc);
sequence_player_set_transposition
Lua Example
sequence_player_set_transposition(player, transposition)
Parameters
| Field | Type |
|---|---|
| player | integer |
| transposition | integer |
Returns
- None
C Prototype
void sequence_player_set_transposition(u8 player, u16 transposition);
functions from smlua_anim_utils.h
get_mario_vanilla_animation
Lua Example
local AnimationValue = get_mario_vanilla_animation(index)
Parameters
| Field | Type |
|---|---|
| index | integer |
Returns
C Prototype
struct Animation *get_mario_vanilla_animation(u16 index);
smlua_anim_util_get_current_animation_name
Lua Example
local stringValue = smlua_anim_util_get_current_animation_name(obj)
Parameters
| Field | Type |
|---|---|
| obj | Object |
Returns
string
C Prototype
const char *smlua_anim_util_get_current_animation_name(struct Object *obj);
smlua_anim_util_set_animation
Lua Example
smlua_anim_util_set_animation(obj, name)
Parameters
| Field | Type |
|---|---|
| obj | Object |
| name | string |
Returns
- None
C Prototype
void smlua_anim_util_set_animation(struct Object *obj, const char *name);
functions from smlua_audio_utils.h
audio_sample_destroy
Lua Example
audio_sample_destroy(audio)
Parameters
| Field | Type |
|---|---|
| audio | ModAudio |
Returns
- None
C Prototype
void audio_sample_destroy(struct ModAudio* audio);
audio_sample_load
Lua Example
local ModAudioValue = audio_sample_load(filename)
Parameters
| Field | Type |
|---|---|
| filename | string |
Returns
C Prototype
struct ModAudio* audio_sample_load(const char* filename);
audio_sample_play
Lua Example
audio_sample_play(audio, position, volume)
Parameters
| Field | Type |
|---|---|
| audio | ModAudio |
| position | Vec3f |
| volume | number |
Returns
- None
C Prototype
void audio_sample_play(struct ModAudio* audio, Vec3f position, f32 volume);
audio_sample_stop
Lua Example
audio_sample_stop(audio)
Parameters
| Field | Type |
|---|---|
| audio | ModAudio |
Returns
- None
C Prototype
void audio_sample_stop(struct ModAudio* audio);
audio_stream_destroy
Lua Example
audio_stream_destroy(audio)
Parameters
| Field | Type |
|---|---|
| audio | ModAudio |
Returns
- None
C Prototype
void audio_stream_destroy(struct ModAudio* audio);
audio_stream_get_frequency
Lua Example
local numberValue = audio_stream_get_frequency(audio)
Parameters
| Field | Type |
|---|---|
| audio | ModAudio |
Returns
number
C Prototype
f32 audio_stream_get_frequency(struct ModAudio* audio);
audio_stream_get_looping
Lua Example
local booleanValue = audio_stream_get_looping(audio)
Parameters
| Field | Type |
|---|---|
| audio | ModAudio |
Returns
boolean
C Prototype
bool audio_stream_get_looping(struct ModAudio* audio);
audio_stream_get_position
Lua Example
local numberValue = audio_stream_get_position(audio)
Parameters
| Field | Type |
|---|---|
| audio | ModAudio |
Returns
number
C Prototype
f32 audio_stream_get_position(struct ModAudio* audio);
audio_stream_get_volume
Lua Example
local numberValue = audio_stream_get_volume(audio)
Parameters
| Field | Type |
|---|---|
| audio | ModAudio |
Returns
number
C Prototype
f32 audio_stream_get_volume(struct ModAudio* audio);
audio_stream_load
Lua Example
local ModAudioValue = audio_stream_load(filename)
Parameters
| Field | Type |
|---|---|
| filename | string |
Returns
C Prototype
struct ModAudio* audio_stream_load(const char* filename);
audio_stream_pause
Lua Example
audio_stream_pause(audio)
Parameters
| Field | Type |
|---|---|
| audio | ModAudio |
Returns
- None
C Prototype
void audio_stream_pause(struct ModAudio* audio);
audio_stream_play
Lua Example
audio_stream_play(audio, restart, volume)
Parameters
| Field | Type |
|---|---|
| audio | ModAudio |
| restart | boolean |
| volume | number |
Returns
- None
C Prototype
void audio_stream_play(struct ModAudio* audio, bool restart, f32 volume);
audio_stream_set_frequency
Lua Example
audio_stream_set_frequency(audio, freq)
Parameters
| Field | Type |
|---|---|
| audio | ModAudio |
| freq | number |
Returns
- None
C Prototype
void audio_stream_set_frequency(struct ModAudio* audio, f32 freq);
audio_stream_set_looping
Lua Example
audio_stream_set_looping(audio, looping)
Parameters
| Field | Type |
|---|---|
| audio | ModAudio |
| looping | boolean |
Returns
- None
C Prototype
void audio_stream_set_looping(struct ModAudio* audio, bool looping);
audio_stream_set_position
Lua Example
audio_stream_set_position(audio, pos)
Parameters
| Field | Type |
|---|---|
| audio | ModAudio |
| pos | number |
Returns
- None
C Prototype
void audio_stream_set_position(struct ModAudio* audio, f32 pos);
audio_stream_set_volume
Lua Example
audio_stream_set_volume(audio, volume)
Parameters
| Field | Type |
|---|---|
| audio | ModAudio |
| volume | number |
Returns
- None
C Prototype
void audio_stream_set_volume(struct ModAudio* audio, f32 volume);
audio_stream_stop
Lua Example
audio_stream_stop(audio)
Parameters
| Field | Type |
|---|---|
| audio | ModAudio |
Returns
- None
C Prototype
void audio_stream_stop(struct ModAudio* audio);
smlua_audio_utils_replace_sequence
Lua Example
smlua_audio_utils_replace_sequence(sequenceId, bankId, defaultVolume, m64Name)
Parameters
| Field | Type |
|---|---|
| sequenceId | integer |
| bankId | integer |
| defaultVolume | integer |
| m64Name | string |
Returns
- None
C Prototype
void smlua_audio_utils_replace_sequence(u8 sequenceId, u8 bankId, u8 defaultVolume, const char* m64Name);
smlua_audio_utils_reset_all
Lua Example
smlua_audio_utils_reset_all()
Parameters
- None
Returns
- None
C Prototype
void smlua_audio_utils_reset_all(void);
functions from smlua_camera_utils.h
camera_allow_toxic_gas_camera
Lua Example
camera_allow_toxic_gas_camera(allow)
Parameters
| Field | Type |
|---|---|
| allow | integer |
Returns
- None
C Prototype
void camera_allow_toxic_gas_camera(u8 allow);
camera_config_enable_analog_cam
Lua Example
camera_config_enable_analog_cam(enable)
Parameters
| Field | Type |
|---|---|
| enable | boolean |
Returns
- None
C Prototype
void camera_config_enable_analog_cam(bool enable);
camera_config_enable_free_cam
Lua Example
camera_config_enable_free_cam(enable)
Parameters
| Field | Type |
|---|---|
| enable | boolean |
Returns
- None
C Prototype
void camera_config_enable_free_cam(bool enable);
camera_config_enable_mouse_look
Lua Example
camera_config_enable_mouse_look(enable)
Parameters
| Field | Type |
|---|---|
| enable | boolean |
Returns
- None
C Prototype
void camera_config_enable_mouse_look(bool enable);
camera_config_get_aggression
Lua Example
local integerValue = camera_config_get_aggression()
Parameters
- None
Returns
integer
C Prototype
u32 camera_config_get_aggression(void);
camera_config_get_deceleration
Lua Example
local integerValue = camera_config_get_deceleration()
Parameters
- None
Returns
integer
C Prototype
u32 camera_config_get_deceleration(void);
camera_config_get_pan_level
Lua Example
local integerValue = camera_config_get_pan_level()
Parameters
- None
Returns
integer
C Prototype
u32 camera_config_get_pan_level(void);
camera_config_get_x_sensitivity
Lua Example
local integerValue = camera_config_get_x_sensitivity()
Parameters
- None
Returns
integer
C Prototype
u32 camera_config_get_x_sensitivity(void);
camera_config_get_y_sensitivity
Lua Example
local integerValue = camera_config_get_y_sensitivity()
Parameters
- None
Returns
integer
C Prototype
u32 camera_config_get_y_sensitivity(void);
camera_config_invert_x
Lua Example
camera_config_invert_x(invert)
Parameters
| Field | Type |
|---|---|
| invert | boolean |
Returns
- None
C Prototype
void camera_config_invert_x(bool invert);
camera_config_invert_y
Lua Example
camera_config_invert_y(invert)
Parameters
| Field | Type |
|---|---|
| invert | boolean |
Returns
- None
C Prototype
void camera_config_invert_y(bool invert);
camera_config_is_analog_cam_enabled
Lua Example
local booleanValue = camera_config_is_analog_cam_enabled()
Parameters
- None
Returns
boolean
C Prototype
bool camera_config_is_analog_cam_enabled(void);
camera_config_is_free_cam_enabled
Lua Example
local booleanValue = camera_config_is_free_cam_enabled()
Parameters
- None
Returns
boolean
C Prototype
bool camera_config_is_free_cam_enabled(void);
camera_config_is_mouse_look_enabled
Lua Example
local booleanValue = camera_config_is_mouse_look_enabled()
Parameters
- None
Returns
boolean
C Prototype
bool camera_config_is_mouse_look_enabled(void);
camera_config_is_x_inverted
Lua Example
local booleanValue = camera_config_is_x_inverted()
Parameters
- None
Returns
boolean
C Prototype
bool camera_config_is_x_inverted(void);
camera_config_is_y_inverted
Lua Example
local booleanValue = camera_config_is_y_inverted()
Parameters
- None
Returns
boolean
C Prototype
bool camera_config_is_y_inverted(void);
camera_config_set_aggression
Lua Example
camera_config_set_aggression(value)
Parameters
| Field | Type |
|---|---|
| value | integer |
Returns
- None
C Prototype
void camera_config_set_aggression(u32 value);
camera_config_set_deceleration
Lua Example
camera_config_set_deceleration(value)
Parameters
| Field | Type |
|---|---|
| value | integer |
Returns
- None
C Prototype
void camera_config_set_deceleration(u32 value);
camera_config_set_pan_level
Lua Example
camera_config_set_pan_level(value)
Parameters
| Field | Type |
|---|---|
| value | integer |
Returns
- None
C Prototype
void camera_config_set_pan_level(u32 value);
camera_config_set_x_sensitivity
Lua Example
camera_config_set_x_sensitivity(value)
Parameters
| Field | Type |
|---|---|
| value | integer |
Returns
- None
C Prototype
void camera_config_set_x_sensitivity(u32 value);
camera_config_set_y_sensitivity
Lua Example
camera_config_set_y_sensitivity(value)
Parameters
| Field | Type |
|---|---|
| value | integer |
Returns
- None
C Prototype
void camera_config_set_y_sensitivity(u32 value);
camera_freeze
Lua Example
camera_freeze()
Parameters
- None
Returns
- None
C Prototype
void camera_freeze(void);
camera_get_checking_surfaces
Lua Example
local booleanValue = camera_get_checking_surfaces()
Parameters
- None
Returns
boolean
C Prototype
bool camera_get_checking_surfaces(void);
camera_is_frozen
Lua Example
local booleanValue = camera_is_frozen()
Parameters
- None
Returns
boolean
C Prototype
bool camera_is_frozen(void);
camera_reset_overrides
Lua Example
camera_reset_overrides()
Parameters
- None
Returns
- None
C Prototype
void camera_reset_overrides(void);
camera_romhack_allow_centering
Lua Example
camera_romhack_allow_centering(allow)
Parameters
| Field | Type |
|---|---|
| allow | integer |
Returns
- None
C Prototype
void camera_romhack_allow_centering(u8 allow);
camera_romhack_allow_dpad_usage
Lua Example
camera_romhack_allow_dpad_usage(allow)
Parameters
| Field | Type |
|---|---|
| allow | integer |
Returns
- None
C Prototype
void camera_romhack_allow_dpad_usage(u8 allow);
camera_set_checking_surfaces
Lua Example
camera_set_checking_surfaces(value)
Parameters
| Field | Type |
|---|---|
| value | boolean |
Returns
- None
C Prototype
void camera_set_checking_surfaces(bool value);
camera_set_romhack_override
Lua Example
camera_set_romhack_override(rco)
Parameters
| Field | Type |
|---|---|
| rco | enum RomhackCameraOverride |
Returns
- None
C Prototype
void camera_set_romhack_override(enum RomhackCameraOverride rco);
camera_unfreeze
Lua Example
camera_unfreeze()
Parameters
- None
Returns
- None
C Prototype
void camera_unfreeze(void);
functions from smlua_collision_utils.h
collision_find_ceil
Lua Example
local SurfaceValue = collision_find_ceil(x, y, z)
Parameters
| Field | Type |
|---|---|
| x | number |
| y | number |
| z | number |
Returns
C Prototype
struct Surface* collision_find_ceil(f32 x, f32 y, f32 z);
collision_find_floor
Lua Example
local SurfaceValue = collision_find_floor(x, y, z)
Parameters
| Field | Type |
|---|---|
| x | number |
| y | number |
| z | number |
Returns
C Prototype
struct Surface* collision_find_floor(f32 x, f32 y, f32 z);
collision_get_temp_wall_collision_data
Lua Example
local WallCollisionDataValue = collision_get_temp_wall_collision_data()
Parameters
- None
Returns
C Prototype
struct WallCollisionData* collision_get_temp_wall_collision_data(void);
get_surface_from_wcd_index
Lua Example
local SurfaceValue = get_surface_from_wcd_index(wcd, index)
Parameters
| Field | Type |
|---|---|
| wcd | WallCollisionData |
| index | integer |
Returns
C Prototype
struct Surface* get_surface_from_wcd_index(struct WallCollisionData* wcd, s8 index);
get_water_surface_pseudo_floor
Lua Example
local SurfaceValue = get_water_surface_pseudo_floor()
Parameters
- None
Returns
C Prototype
struct Surface* get_water_surface_pseudo_floor(void);
smlua_collision_util_find_surface_types
Lua Example
smlua_collision_util_find_surface_types(data)
Parameters
| Field | Type |
|---|---|
| data | Pointer <Collision> |
Returns
- None
C Prototype
void smlua_collision_util_find_surface_types(Collision* data);
smlua_collision_util_get
Lua Example
local PointerValue = smlua_collision_util_get(name)
Parameters
| Field | Type |
|---|---|
| name | string |
Returns
Pointer<Collision>
C Prototype
Collision* smlua_collision_util_get(const char* name);
smlua_collision_util_get_current_terrain_collision
Lua Example
local PointerValue = smlua_collision_util_get_current_terrain_collision()
Parameters
- None
Returns
Pointer<Collision>
C Prototype
Collision* smlua_collision_util_get_current_terrain_collision(void);
smlua_collision_util_get_level_collision
Lua Example
local PointerValue = smlua_collision_util_get_level_collision(level, area)
Parameters
| Field | Type |
|---|---|
| level | integer |
| area | integer |
Returns
Pointer<Collision>
C Prototype
Collision *smlua_collision_util_get_level_collision(u32 level, u16 area);
functions from smlua_deprecated.h
functions from smlua_gfx_utils.h
get_fog_color
Description
Gets a value of the global fog color
Lua Example
local integerValue = get_fog_color(index)
Parameters
| Field | Type |
|---|---|
| index | integer |
Returns
integer
C Prototype
u8 get_fog_color(u8 index);
get_fog_intensity
Description
Gets the intensity of the fog
Lua Example
local numberValue = get_fog_intensity()
Parameters
- None
Returns
number
C Prototype
f32 get_fog_intensity(void);
get_lighting_color
Description
Gets a value of the global lighting color
Lua Example
local integerValue = get_lighting_color(index)
Parameters
| Field | Type |
|---|---|
| index | integer |
Returns
integer
C Prototype
u8 get_lighting_color(u8 index);
get_lighting_color_ambient
Description
Gets a value of the global ambient lighting color
Lua Example
local integerValue = get_lighting_color_ambient(index)
Parameters
| Field | Type |
|---|---|
| index | integer |
Returns
integer
C Prototype
u8 get_lighting_color_ambient(u8 index);
get_lighting_dir
Description
Gets a value of the global lighting direction
Lua Example
local numberValue = get_lighting_dir(index)
Parameters
| Field | Type |
|---|---|
| index | integer |
Returns
number
C Prototype
f32 get_lighting_dir(u8 index);
get_skybox
Description
Gets the current skybox
Lua Example
local integerValue = get_skybox()
Parameters
- None
Returns
integer
C Prototype
s8 get_skybox(void);
get_skybox_color
Description
Gets a value of the global skybox color
Lua Example
local integerValue = get_skybox_color(index)
Parameters
| Field | Type |
|---|---|
| index | integer |
Returns
integer
C Prototype
u8 get_skybox_color(u8 index);
get_vertex_color
Description
Gets a value of the global vertex shading color
Lua Example
local integerValue = get_vertex_color(index)
Parameters
| Field | Type |
|---|---|
| index | integer |
Returns
integer
C Prototype
u8 get_vertex_color(u8 index);
set_fog_color
Description
Sets a value of the global fog color
Lua Example
set_fog_color(index, value)
Parameters
| Field | Type |
|---|---|
| index | integer |
| value | integer |
Returns
- None
C Prototype
void set_fog_color(u8 index, u8 value);
set_fog_intensity
Description
Sets the intensity of the fog (this value scales very quickly, 1.0 to 1.1 is a desirable range)
Lua Example
set_fog_intensity(intensity)
Parameters
| Field | Type |
|---|---|
| intensity | number |
Returns
- None
C Prototype
void set_fog_intensity(f32 intensity);
set_lighting_color
Description
Sets a value of the global lighting color
Lua Example
set_lighting_color(index, value)
Parameters
| Field | Type |
|---|---|
| index | integer |
| value | integer |
Returns
- None
C Prototype
void set_lighting_color(u8 index, u8 value);
set_lighting_color_ambient
Description
Sets a value of the global lighting color (run this after set_lighting_color for the ambient color to not be overriden)
Lua Example
set_lighting_color_ambient(index, value)
Parameters
| Field | Type |
|---|---|
| index | integer |
| value | integer |
Returns
- None
C Prototype
void set_lighting_color_ambient(u8 index, u8 value);
set_lighting_dir
Description
Sets a value of the global lighting direction
Lua Example
set_lighting_dir(index, value)
Parameters
| Field | Type |
|---|---|
| index | integer |
| value | number |
Returns
- None
C Prototype
void set_lighting_dir(u8 index, f32 value);
set_override_far
Description
Sets the override far plane
Lua Example
set_override_far(far)
Parameters
| Field | Type |
|---|---|
| far | number |
Returns
- None
C Prototype
void set_override_far(f32 far);
set_override_fov
Description
Sets the override FOV
Lua Example
set_override_fov(fov)
Parameters
| Field | Type |
|---|---|
| fov | number |
Returns
- None
C Prototype
void set_override_fov(f32 fov);
set_override_near
Description
Sets the override near plane
Lua Example
set_override_near(near)
Parameters
| Field | Type |
|---|---|
| near | number |
Returns
- None
C Prototype
void set_override_near(f32 near);
set_override_skybox
Description
Sets the override skybox
Lua Example
set_override_skybox(background)
Parameters
| Field | Type |
|---|---|
| background | integer |
Returns
- None
C Prototype
void set_override_skybox(s8 background);
set_skybox_color
Description
Sets a value of the global skybox color
Lua Example
set_skybox_color(index, value)
Parameters
| Field | Type |
|---|---|
| index | integer |
| value | integer |
Returns
- None
C Prototype
void set_skybox_color(u8 index, u8 value);
set_vertex_color
Description
Sets a value of the global vertex shading color
Lua Example
set_vertex_color(index, value)
Parameters
| Field | Type |
|---|---|
| index | integer |
| value | integer |
Returns
- None
C Prototype
void set_vertex_color(u8 index, u8 value);
functions from smlua_level_utils.h
level_is_vanilla_level
Lua Example
local booleanValue = level_is_vanilla_level(levelNum)
Parameters
| Field | Type |
|---|---|
| levelNum | integer |
Returns
boolean
C Prototype
bool level_is_vanilla_level(s16 levelNum);
level_register
Lua Example
local integerValue = level_register(scriptEntryName, courseNum, fullName, shortName, acousticReach, echoLevel1, echoLevel2, echoLevel3)
Parameters
| Field | Type |
|---|---|
| scriptEntryName | string |
| courseNum | integer |
| fullName | string |
| shortName | string |
| acousticReach | integer |
| echoLevel1 | integer |
| echoLevel2 | integer |
| echoLevel3 | integer |
Returns
integer
C Prototype
s16 level_register(const char* scriptEntryName, s16 courseNum, const char* fullName, const char* shortName, u32 acousticReach, u32 echoLevel1, u32 echoLevel2, u32 echoLevel3);
smlua_level_util_change_area
Lua Example
smlua_level_util_change_area(areaIndex)
Parameters
| Field | Type |
|---|---|
| areaIndex | integer |
Returns
- None
C Prototype
void smlua_level_util_change_area(s32 areaIndex);
smlua_level_util_get_info
Lua Example
local CustomLevelInfoValue = smlua_level_util_get_info(levelNum)
Parameters
| Field | Type |
|---|---|
| levelNum | integer |
Returns
C Prototype
struct CustomLevelInfo* smlua_level_util_get_info(s16 levelNum);
smlua_level_util_get_info_from_course_num
Lua Example
local CustomLevelInfoValue = smlua_level_util_get_info_from_course_num(courseNum)
Parameters
| Field | Type |
|---|---|
| courseNum | integer |
Returns
C Prototype
struct CustomLevelInfo* smlua_level_util_get_info_from_course_num(u8 courseNum);
smlua_level_util_get_info_from_short_name
Lua Example
local CustomLevelInfoValue = smlua_level_util_get_info_from_short_name(shortName)
Parameters
| Field | Type |
|---|---|
| shortName | string |
Returns
C Prototype
struct CustomLevelInfo* smlua_level_util_get_info_from_short_name(const char* shortName);
warp_exit_level
Lua Example
local booleanValue = warp_exit_level(aDelay)
Parameters
| Field | Type |
|---|---|
| aDelay | integer |
Returns
boolean
C Prototype
bool warp_exit_level(s32 aDelay);
warp_restart_level
Lua Example
local booleanValue = warp_restart_level()
Parameters
- None
Returns
boolean
C Prototype
bool warp_restart_level(void);
warp_to_castle
Lua Example
local booleanValue = warp_to_castle(aLevel)
Parameters
| Field | Type |
|---|---|
| aLevel | integer |
Returns
boolean
C Prototype
bool warp_to_castle(s32 aLevel);
warp_to_level
Lua Example
local booleanValue = warp_to_level(aLevel, aArea, aAct)
Parameters
| Field | Type |
|---|---|
| aLevel | integer |
| aArea | integer |
| aAct | integer |
Returns
boolean
C Prototype
bool warp_to_level(s32 aLevel, s32 aArea, s32 aAct);
warp_to_start_level
Lua Example
local booleanValue = warp_to_start_level()
Parameters
- None
Returns
boolean
C Prototype
bool warp_to_start_level(void);
warp_to_warpnode
Lua Example
local booleanValue = warp_to_warpnode(aLevel, aArea, aAct, aWarpId)
Parameters
| Field | Type |
|---|---|
| aLevel | integer |
| aArea | integer |
| aAct | integer |
| aWarpId | integer |
Returns
boolean
C Prototype
bool warp_to_warpnode(s32 aLevel, s32 aArea, s32 aAct, s32 aWarpId);
functions from smlua_math_utils.h
clamp
Description
Clamps a signed 32-bit integer a between bounds b (minimum) and c (maximum)
Lua Example
local integerValue = clamp(a, b, c)
Parameters
| Field | Type |
|---|---|
| a | integer |
| b | integer |
| c | integer |
Returns
integer
C Prototype
s32 clamp(s32 a, s32 b, s32 c);
clampf
Description
Clamps a floating-point number a between bounds b (minimum) and c (maximum)
Lua Example
local numberValue = clampf(a, b, c)
Parameters
| Field | Type |
|---|---|
| a | number |
| b | number |
| c | number |
Returns
number
C Prototype
f32 clampf(f32 a, f32 b, f32 c);
degrees_to_sm64
Description
Converts an angle from degrees to SM64 format
Lua Example
local integerValue = degrees_to_sm64(degreesAngle)
Parameters
| Field | Type |
|---|---|
| degreesAngle | number |
Returns
integer
C Prototype
s16 degrees_to_sm64(f32 degreesAngle);
hypotf
Description
Computes the hypotenuse of a right triangle given sides a and b using the Pythagorean theorem
Lua Example
local numberValue = hypotf(a, b)
Parameters
| Field | Type |
|---|---|
| a | number |
| b | number |
Returns
number
C Prototype
f32 hypotf(f32 a, f32 b);
max
Description
Finds the maximum of two signed 32-bit integers
Lua Example
local integerValue = max(a, b)
Parameters
| Field | Type |
|---|---|
| a | integer |
| b | integer |
Returns
integer
C Prototype
s32 max(s32 a, s32 b);
maxf
Description
Finds the maximum of two floating-point numbers
Lua Example
local numberValue = maxf(a, b)
Parameters
| Field | Type |
|---|---|
| a | number |
| b | number |
Returns
number
C Prototype
f32 maxf(f32 a, f32 b);
min
Description
Finds the minimum of two signed 32-bit integers
Lua Example
local integerValue = min(a, b)
Parameters
| Field | Type |
|---|---|
| a | integer |
| b | integer |
Returns
integer
C Prototype
s32 min(s32 a, s32 b);
minf
Description
Finds the minimum of two floating-point numbers
Lua Example
local numberValue = minf(a, b)
Parameters
| Field | Type |
|---|---|
| a | number |
| b | number |
Returns
number
C Prototype
f32 minf(f32 a, f32 b);
radians_to_sm64
Description
Converts an angle from radians to SM64 format
Lua Example
local integerValue = radians_to_sm64(radiansAngle)
Parameters
| Field | Type |
|---|---|
| radiansAngle | number |
Returns
integer
C Prototype
s16 radians_to_sm64(f32 radiansAngle);
sm64_to_degrees
Description
Converts an angle from SM64 format to degrees
Lua Example
local numberValue = sm64_to_degrees(sm64Angle)
Parameters
| Field | Type |
|---|---|
| sm64Angle | integer |
Returns
number
C Prototype
f32 sm64_to_degrees(s16 sm64Angle);
sm64_to_radians
Description
Converts an angle from SM64 format to radians
Lua Example
local numberValue = sm64_to_radians(sm64Angle)
Parameters
| Field | Type |
|---|---|
| sm64Angle | integer |
Returns
number
C Prototype
f32 sm64_to_radians(s16 sm64Angle);
sqr
Description
Computes the square of a signed 32-bit integer
Lua Example
local integerValue = sqr(x)
Parameters
| Field | Type |
|---|---|
| x | integer |
Returns
integer
C Prototype
s32 sqr(s32 x);
sqrf
Description
Computes the square of a floating-point number
Lua Example
local numberValue = sqrf(x)
Parameters
| Field | Type |
|---|---|
| x | number |
Returns
number
C Prototype
f32 sqrf(f32 x);
functions from smlua_misc_utils.h
allocate_mario_action
Description
Allocates an action ID with bitwise flags
Lua Example
local integerValue = allocate_mario_action(actFlags)
Parameters
| Field | Type |
|---|---|
| actFlags | integer |
Returns
integer
C Prototype
u32 allocate_mario_action(u32 actFlags);
course_is_main_course
Description
Checks if a course is a main course and not the castle or secret levels
Lua Example
local booleanValue = course_is_main_course(courseNum)
Parameters
| Field | Type |
|---|---|
| courseNum | integer |
Returns
boolean
C Prototype
bool course_is_main_course(u16 courseNum);
deref_s32_pointer
Description
Gets the 32-bit integer value from the pointer
Lua Example
local integerValue = deref_s32_pointer(pointer)
Parameters
| Field | Type |
|---|---|
| pointer | Pointer <integer> |
Returns
integer
C Prototype
s32 deref_s32_pointer(s32* pointer);
djui_attempting_to_open_playerlist
Description
Checks if the DJUI playerlist is attempting to be opened
Lua Example
local booleanValue = djui_attempting_to_open_playerlist()
Parameters
- None
Returns
boolean
C Prototype
bool djui_attempting_to_open_playerlist(void);
djui_is_playerlist_open
Description
Checks if the DJUI playerlist is open
Lua Example
local booleanValue = djui_is_playerlist_open()
Parameters
- None
Returns
boolean
C Prototype
bool djui_is_playerlist_open(void);
djui_is_popup_disabled
Description
Returns if popups are disabled
Lua Example
local booleanValue = djui_is_popup_disabled()
Parameters
- None
Returns
boolean
C Prototype
bool djui_is_popup_disabled(void);
djui_menu_get_font
Description
Gets the DJUI menu font
Lua Example
local enumValue = djui_menu_get_font()
Parameters
- None
Returns
C Prototype
enum DjuiFontType djui_menu_get_font(void);
djui_menu_get_theme
Description
Gets the DJUI menu theme
Lua Example
local DjuiThemeValue = djui_menu_get_theme()
Parameters
- None
Returns
C Prototype
struct DjuiTheme* djui_menu_get_theme(void);
djui_popup_create_global
Description
Creates a DJUI popup that is broadcasted to every client
Lua Example
djui_popup_create_global(message, lines)
Parameters
| Field | Type |
|---|---|
| message | string |
| lines | integer |
Returns
- None
C Prototype
void djui_popup_create_global(const char* message, int lines);
djui_reset_popup_disabled_override
Description
Resets if popups are disabled
Lua Example
djui_reset_popup_disabled_override()
Parameters
- None
Returns
- None
C Prototype
void djui_reset_popup_disabled_override(void);
djui_set_popup_disabled_override
Description
Sets if popups are disabled
Lua Example
djui_set_popup_disabled_override(value)
Parameters
| Field | Type |
|---|---|
| value | boolean |
Returns
- None
C Prototype
void djui_set_popup_disabled_override(bool value);
get_coopnet_id
Description
Gets the CoopNet ID of a player if CoopNet is being used and the player is connected, otherwise "-1" is returned
Lua Example
local stringValue = get_coopnet_id(localIndex)
Parameters
| Field | Type |
|---|---|
| localIndex | integer |
Returns
string
C Prototype
const char* get_coopnet_id(s8 localIndex);
get_current_save_file_num
Description
Gets the current save file number (1-indexed)
Lua Example
local integerValue = get_current_save_file_num()
Parameters
- None
Returns
integer
C Prototype
s16 get_current_save_file_num(void);
get_date_and_time
Description
Gets the system clock's date and time
Lua Example
local DateTimeValue = get_date_and_time()
Parameters
- None
Returns
C Prototype
struct DateTime* get_date_and_time(void);
get_dialog_box_state
Description
Gets the current state of the dialog box
Lua Example
local integerValue = get_dialog_box_state()
Parameters
- None
Returns
integer
C Prototype
s8 get_dialog_box_state(void);
get_dialog_id
Description
Gets the current dialog box ID
Lua Example
local integerValue = get_dialog_id()
Parameters
- None
Returns
integer
C Prototype
s16 get_dialog_id(void);
get_dialog_response
Description
Gets the choice selected inside of a dialog box (0-1)
Lua Example
local integerValue = get_dialog_response()
Parameters
- None
Returns
integer
C Prototype
s32 get_dialog_response(void);
get_envfx
Description
Gets the non overridden environment effect (e.g. snow)
Lua Example
local integerValue = get_envfx()
Parameters
- None
Returns
integer
C Prototype
u16 get_envfx(void);
get_environment_region
Description
Gets an environment region (gas/water boxes) height value
Lua Example
local numberValue = get_environment_region(index)
Parameters
| Field | Type |
|---|---|
| index | integer |
Returns
number
C Prototype
f32 get_environment_region(u8 index);
get_global_timer
Description
Gets the global timer that has been ticking at 30 frames per second since game boot
Lua Example
local integerValue = get_global_timer()
Parameters
- None
Returns
integer
C Prototype
u32 get_global_timer(void);
get_got_file_coin_hi_score
Description
Checks if the save file's coin "HI SCORE" was obtained with the last star or key collection
Lua Example
local booleanValue = get_got_file_coin_hi_score()
Parameters
- None
Returns
boolean
C Prototype
bool get_got_file_coin_hi_score(void);
get_hand_foot_pos_x
Description
Gets the X coordinate of Mario's hand (0-1) or foot (2-3) but it is important to note that the positions are not updated off-screen
Lua Example
local numberValue = get_hand_foot_pos_x(m, index)
Parameters
| Field | Type |
|---|---|
| m | MarioState |
| index | integer |
Returns
number
C Prototype
f32 get_hand_foot_pos_x(struct MarioState* m, u8 index);
get_hand_foot_pos_y
Description
Gets the Y coordinate of Mario's hand (0-1) or foot (2-3) but it is important to note that the positions are not updated off-screen
Lua Example
local numberValue = get_hand_foot_pos_y(m, index)
Parameters
| Field | Type |
|---|---|
| m | MarioState |
| index | integer |
Returns
number
C Prototype
f32 get_hand_foot_pos_y(struct MarioState* m, u8 index);
get_hand_foot_pos_z
Description
Gets the Z coordinate of Mario's hand (0-1) or foot (2-3) but it is important to note that the positions are not updated off-screen
Lua Example
local numberValue = get_hand_foot_pos_z(m, index)
Parameters
| Field | Type |
|---|---|
| m | MarioState |
| index | integer |
Returns
number
C Prototype
f32 get_hand_foot_pos_z(struct MarioState* m, u8 index);
get_last_completed_course_num
Description
Gets the last course a star or key was collected in
Lua Example
local integerValue = get_last_completed_course_num()
Parameters
- None
Returns
integer
C Prototype
u8 get_last_completed_course_num(void);
get_last_completed_star_num
Description
Gets the last collected star's number (1-7)
Lua Example
local integerValue = get_last_completed_star_num()
Parameters
- None
Returns
integer
C Prototype
u8 get_last_completed_star_num(void);
get_last_star_or_key
Description
Gets if the last objective collected was a star (0) or a key (1)
Lua Example
local integerValue = get_last_star_or_key()
Parameters
- None
Returns
integer
C Prototype
u8 get_last_star_or_key(void);
get_local_discord_id
Description
Gets the local discord ID if it isn't disabled, otherwise "0" is returned
Lua Example
local stringValue = get_local_discord_id()
Parameters
- None
Returns
string
C Prototype
const char* get_local_discord_id(void);
get_network_area_timer
Description
Gets the current area's networked timer
Lua Example
local integerValue = get_network_area_timer()
Parameters
- None
Returns
integer
C Prototype
u32 get_network_area_timer(void);
get_os_name
Description
Gets the name of the operating system the game is running on
Lua Example
local stringValue = get_os_name()
Parameters
- None
Returns
string
C Prototype
const char* get_os_name(void);
get_save_file_modified
Description
Checks if the save file has been modified without saving
Lua Example
local booleanValue = get_save_file_modified()
Parameters
- None
Returns
boolean
C Prototype
bool get_save_file_modified(void);
get_temp_s32_pointer
Description
Returns a temporary 32-bit integer pointer
Lua Example
local PointerValue = get_temp_s32_pointer(initialValue)
Parameters
| Field | Type |
|---|---|
| initialValue | integer |
Returns
Pointer<integer>
C Prototype
s32* get_temp_s32_pointer(s32 initialValue);
get_time
Description
Gets the Unix Timestamp
Lua Example
local integerValue = get_time()
Parameters
- None
Returns
integer
C Prototype
s64 get_time(void);
get_ttc_speed_setting
Description
Gets TTC's speed setting
Lua Example
local integerValue = get_ttc_speed_setting()
Parameters
- None
Returns
integer
C Prototype
s16 get_ttc_speed_setting(void);
get_volume_env
Description
Gets the volume level of environment sounds effects
Lua Example
local numberValue = get_volume_env()
Parameters
- None
Returns
number
C Prototype
f32 get_volume_env(void);
get_volume_level
Description
Gets the volume level of music
Lua Example
local numberValue = get_volume_level()
Parameters
- None
Returns
number
C Prototype
f32 get_volume_level(void);
get_volume_master
Description
Gets the master volume level
Lua Example
local numberValue = get_volume_master()
Parameters
- None
Returns
number
C Prototype
f32 get_volume_master(void);
get_volume_sfx
Description
Gets the volume level of sound effects
Lua Example
local numberValue = get_volume_sfx()
Parameters
- None
Returns
number
C Prototype
f32 get_volume_sfx(void);
get_water_level
Description
Gets the water level in an area
Lua Example
local integerValue = get_water_level(index)
Parameters
| Field | Type |
|---|---|
| index | integer |
Returns
integer
C Prototype
s16 get_water_level(u8 index);
hud_get_flash
Description
Gets if the star counter on the HUD should flash
Lua Example
local integerValue = hud_get_flash()
Parameters
- None
Returns
integer
C Prototype
s8 hud_get_flash(void);
hud_get_value
Lua Example
local integerValue = hud_get_value(type)
Parameters
| Field | Type |
|---|---|
| type | enum HudDisplayValue |
Returns
integer
C Prototype
s32 hud_get_value(enum HudDisplayValue type);
hud_hide
Description
Hides the HUD
Lua Example
hud_hide()
Parameters
- None
Returns
- None
C Prototype
void hud_hide(void);
hud_is_hidden
Description
Checks if the HUD is hidden
Lua Example
local booleanValue = hud_is_hidden()
Parameters
- None
Returns
boolean
C Prototype
bool hud_is_hidden(void);
hud_render_power_meter
Description
Renders a power meter on the HUD
Lua Example
hud_render_power_meter(health, x, y, width, height)
Parameters
| Field | Type |
|---|---|
| health | integer |
| x | number |
| y | number |
| width | number |
| height | number |
Returns
- None
C Prototype
void hud_render_power_meter(s32 health, f32 x, f32 y, f32 width, f32 height);
hud_render_power_meter_interpolated
Description
Renders an interpolated power meter on the HUD
Lua Example
hud_render_power_meter_interpolated(health, prevX, prevY, prevWidth, prevHeight, x, y, width, height)
Parameters
| Field | Type |
|---|---|
| health | integer |
| prevX | number |
| prevY | number |
| prevWidth | number |
| prevHeight | number |
| x | number |
| y | number |
| width | number |
| height | number |
Returns
- None
C Prototype
void hud_render_power_meter_interpolated(s32 health, f32 prevX, f32 prevY, f32 prevWidth, f32 prevHeight, f32 x, f32 y, f32 width, f32 height);
hud_set_flash
Description
Sets if the star counter on the HUD should flash
Lua Example
hud_set_flash(value)
Parameters
| Field | Type |
|---|---|
| value | integer |
Returns
- None
C Prototype
void hud_set_flash(s8 value);
hud_set_value
Description
Sets a HUD display value
Lua Example
hud_set_value(type, value)
Parameters
| Field | Type |
|---|---|
| type | enum HudDisplayValue |
| value | integer |
Returns
- None
C Prototype
void hud_set_value(enum HudDisplayValue type, s32 value);
hud_show
Description
Shows the HUD
Lua Example
hud_show()
Parameters
- None
Returns
- None
C Prototype
void hud_show(void);
is_game_paused
Description
Checks if the game is paused
Lua Example
local booleanValue = is_game_paused()
Parameters
- None
Returns
boolean
C Prototype
bool is_game_paused(void);
is_transition_playing
Description
Checks if a screen transition is playing
Lua Example
local booleanValue = is_transition_playing()
Parameters
- None
Returns
boolean
C Prototype
bool is_transition_playing(void);
mod_file_exists
Description
Checks if a file exists inside of a mod
Lua Example
local booleanValue = mod_file_exists(filename)
Parameters
| Field | Type |
|---|---|
| filename | string |
Returns
boolean
C Prototype
bool mod_file_exists(const char* filename);
movtexqc_register
Description
Registers a custom moving texture entry (used for vanilla water boxes)
Lua Example
movtexqc_register(name, level, area, type)
Parameters
| Field | Type |
|---|---|
| name | string |
| level | integer |
| area | integer |
| type | integer |
Returns
- None
C Prototype
void movtexqc_register(const char* name, s16 level, s16 area, s16 type);
play_transition
Description
Plays a screen transition
Lua Example
play_transition(transType, time, red, green, blue)
Parameters
| Field | Type |
|---|---|
| transType | integer |
| time | integer |
| red | integer |
| green | integer |
| blue | integer |
Returns
- None
C Prototype
void play_transition(s16 transType, s16 time, u8 red, u8 green, u8 blue);
reset_window_title
Description
Resets the window title
Lua Example
reset_window_title()
Parameters
- None
Returns
- None
C Prototype
void reset_window_title(void);
save_file_get_using_backup_slot
Description
Checks if the save file is using its backup slot
Lua Example
local booleanValue = save_file_get_using_backup_slot()
Parameters
- None
Returns
boolean
C Prototype
bool save_file_get_using_backup_slot(void);
save_file_set_using_backup_slot
Description
Sets if the save file should use its backup slot
Lua Example
save_file_set_using_backup_slot(usingBackupSlot)
Parameters
| Field | Type |
|---|---|
| usingBackupSlot | boolean |
Returns
- None
C Prototype
void save_file_set_using_backup_slot(bool usingBackupSlot);
set_environment_region
Description
Sets an environment region (gas/water boxes) height value
Lua Example
set_environment_region(index, value)
Parameters
| Field | Type |
|---|---|
| index | integer |
| value | integer |
Returns
- None
C Prototype
void set_environment_region(u8 index, s32 value);
set_got_file_coin_hi_score
Description
Sets if the save file's coin "HI SCORE" was obtained with the last star or key collection
Lua Example
set_got_file_coin_hi_score(value)
Parameters
| Field | Type |
|---|---|
| value | boolean |
Returns
- None
C Prototype
void set_got_file_coin_hi_score(bool value);
set_last_completed_course_num
Description
Sets the last course a star or key was collected in
Lua Example
set_last_completed_course_num(courseNum)
Parameters
| Field | Type |
|---|---|
| courseNum | integer |
Returns
- None
C Prototype
void set_last_completed_course_num(u8 courseNum);
set_last_completed_star_num
Description
Sets the last collected star's number (1-7)
Lua Example
set_last_completed_star_num(starNum)
Parameters
| Field | Type |
|---|---|
| starNum | integer |
Returns
- None
C Prototype
void set_last_completed_star_num(u8 starNum);
set_last_star_or_key
Description
Sets if the last objective collected was a star (0) or a key (1)
Lua Example
set_last_star_or_key(value)
Parameters
| Field | Type |
|---|---|
| value | integer |
Returns
- None
C Prototype
void set_last_star_or_key(u8 value);
set_override_envfx
Description
Sets the override environment effect (e.g. snow)
Lua Example
set_override_envfx(envfx)
Parameters
| Field | Type |
|---|---|
| envfx | integer |
Returns
- None
C Prototype
void set_override_envfx(s32 envfx);
set_save_file_modified
Description
Sets if the save file has been modified without saving
Lua Example
set_save_file_modified(value)
Parameters
| Field | Type |
|---|---|
| value | boolean |
Returns
- None
C Prototype
void set_save_file_modified(bool value);
set_ttc_speed_setting
Description
Sets TTC's speed setting (TTC_SPEED_*)
Lua Example
set_ttc_speed_setting(speed)
Parameters
| Field | Type |
|---|---|
| speed | integer |
Returns
- None
C Prototype
void set_ttc_speed_setting(s16 speed);
set_volume_env
Description
Sets the volume level of environment sounds effects
Lua Example
set_volume_env(volume)
Parameters
| Field | Type |
|---|---|
| volume | number |
Returns
- None
C Prototype
void set_volume_env(f32 volume);
set_volume_level
Description
Sets the volume level of music
Lua Example
set_volume_level(volume)
Parameters
| Field | Type |
|---|---|
| volume | number |
Returns
- None
C Prototype
void set_volume_level(f32 volume);
set_volume_master
Description
Sets the master volume level
Lua Example
set_volume_master(volume)
Parameters
| Field | Type |
|---|---|
| volume | number |
Returns
- None
C Prototype
void set_volume_master(f32 volume);
set_volume_sfx
Description
Sets the volume level of sound effects
Lua Example
set_volume_sfx(volume)
Parameters
| Field | Type |
|---|---|
| volume | number |
Returns
- None
C Prototype
void set_volume_sfx(f32 volume);
set_water_level
Description
Sets the water level in an area
Lua Example
set_water_level(index, height, sync)
Parameters
| Field | Type |
|---|---|
| index | integer |
| height | integer |
| sync | boolean |
Returns
- None
C Prototype
void set_water_level(u8 index, s16 height, bool sync);
set_window_title
Description
Sets the window title to a custom title
Lua Example
set_window_title(title)
Parameters
| Field | Type |
|---|---|
| title | string |
Returns
- None
C Prototype
void set_window_title(const char* title);
functions from smlua_model_utils.h
smlua_model_util_get_id
Lua Example
local enumValue = smlua_model_util_get_id(name)
Parameters
| Field | Type |
|---|---|
| name | string |
Returns
C Prototype
enum ModelExtendedId smlua_model_util_get_id(const char* name);
functions from smlua_obj_utils.h
get_temp_object_hitbox
Lua Example
local ObjectHitboxValue = get_temp_object_hitbox()
Parameters
- None
Returns
C Prototype
struct ObjectHitbox* get_temp_object_hitbox(void);
get_trajectory
Lua Example
local PointerValue = get_trajectory(name)
Parameters
| Field | Type |
|---|---|
| name | string |
Returns
Pointer<Trajectory>
C Prototype
Trajectory* get_trajectory(const char* name);
obj_check_hitbox_overlap
Lua Example
local booleanValue = obj_check_hitbox_overlap(o1, o2)
Parameters
| Field | Type |
|---|---|
| o1 | Object |
| o2 | Object |
Returns
boolean
C Prototype
bool obj_check_hitbox_overlap(struct Object *o1, struct Object *o2);
obj_check_overlap_with_hitbox_params
Lua Example
local booleanValue = obj_check_overlap_with_hitbox_params(o, x, y, z, h, r, d)
Parameters
| Field | Type |
|---|---|
| o | Object |
| x | number |
| y | number |
| z | number |
| h | number |
| r | number |
| d | number |
Returns
boolean
C Prototype
bool obj_check_overlap_with_hitbox_params(struct Object *o, f32 x, f32 y, f32 z, f32 h, f32 r, f32 d);
obj_count_objects_with_behavior_id
Lua Example
local integerValue = obj_count_objects_with_behavior_id(behaviorId)
Parameters
| Field | Type |
|---|---|
| behaviorId | enum BehaviorId |
Returns
integer
C Prototype
s32 obj_count_objects_with_behavior_id(enum BehaviorId behaviorId);
obj_get_collided_object
Lua Example
local ObjectValue = obj_get_collided_object(o, index)
Parameters
| Field | Type |
|---|---|
| o | Object |
| index | integer |
Returns
C Prototype
struct Object *obj_get_collided_object(struct Object *o, s16 index);
obj_get_field_f32
Lua Example
local numberValue = obj_get_field_f32(o, fieldIndex)
Parameters
| Field | Type |
|---|---|
| o | Object |
| fieldIndex | integer |
Returns
number
C Prototype
f32 obj_get_field_f32(struct Object *o, s32 fieldIndex);
obj_get_field_s16
Lua Example
local integerValue = obj_get_field_s16(o, fieldIndex, fieldSubIndex)
Parameters
| Field | Type |
|---|---|
| o | Object |
| fieldIndex | integer |
| fieldSubIndex | integer |
Returns
integer
C Prototype
s16 obj_get_field_s16(struct Object *o, s32 fieldIndex, s32 fieldSubIndex);
obj_get_field_s32
Lua Example
local integerValue = obj_get_field_s32(o, fieldIndex)
Parameters
| Field | Type |
|---|---|
| o | Object |
| fieldIndex | integer |
Returns
integer
C Prototype
s32 obj_get_field_s32(struct Object *o, s32 fieldIndex);
obj_get_field_u32
Lua Example
local integerValue = obj_get_field_u32(o, fieldIndex)
Parameters
| Field | Type |
|---|---|
| o | Object |
| fieldIndex | integer |
Returns
integer
C Prototype
u32 obj_get_field_u32(struct Object *o, s32 fieldIndex);
obj_get_first
Lua Example
local ObjectValue = obj_get_first(objList)
Parameters
| Field | Type |
|---|---|
| objList | enum ObjectList |
Returns
C Prototype
struct Object *obj_get_first(enum ObjectList objList);
obj_get_first_with_behavior_id
Lua Example
local ObjectValue = obj_get_first_with_behavior_id(behaviorId)
Parameters
| Field | Type |
|---|---|
| behaviorId | enum BehaviorId |
Returns
C Prototype
struct Object *obj_get_first_with_behavior_id(enum BehaviorId behaviorId);
obj_get_first_with_behavior_id_and_field_f32
Lua Example
local ObjectValue = obj_get_first_with_behavior_id_and_field_f32(behaviorId, fieldIndex, value)
Parameters
| Field | Type |
|---|---|
| behaviorId | enum BehaviorId |
| fieldIndex | integer |
| value | number |
Returns
C Prototype
struct Object *obj_get_first_with_behavior_id_and_field_f32(enum BehaviorId behaviorId, s32 fieldIndex, f32 value);
obj_get_first_with_behavior_id_and_field_s32
Lua Example
local ObjectValue = obj_get_first_with_behavior_id_and_field_s32(behaviorId, fieldIndex, value)
Parameters
| Field | Type |
|---|---|
| behaviorId | enum BehaviorId |
| fieldIndex | integer |
| value | integer |
Returns
C Prototype
struct Object *obj_get_first_with_behavior_id_and_field_s32(enum BehaviorId behaviorId, s32 fieldIndex, s32 value);
obj_get_nearest_object_with_behavior_id
Lua Example
local ObjectValue = obj_get_nearest_object_with_behavior_id(o, behaviorId)
Parameters
| Field | Type |
|---|---|
| o | Object |
| behaviorId | enum BehaviorId |
Returns
C Prototype
struct Object *obj_get_nearest_object_with_behavior_id(struct Object *o, enum BehaviorId behaviorId);
obj_get_next
Lua Example
local ObjectValue = obj_get_next(o)
Parameters
| Field | Type |
|---|---|
| o | Object |
Returns
C Prototype
struct Object *obj_get_next(struct Object *o);
obj_get_next_with_same_behavior_id
Lua Example
local ObjectValue = obj_get_next_with_same_behavior_id(o)
Parameters
| Field | Type |
|---|---|
| o | Object |
Returns
C Prototype
struct Object *obj_get_next_with_same_behavior_id(struct Object *o);
obj_get_next_with_same_behavior_id_and_field_f32
Lua Example
local ObjectValue = obj_get_next_with_same_behavior_id_and_field_f32(o, fieldIndex, value)
Parameters
| Field | Type |
|---|---|
| o | Object |
| fieldIndex | integer |
| value | number |
Returns
C Prototype
struct Object *obj_get_next_with_same_behavior_id_and_field_f32(struct Object *o, s32 fieldIndex, f32 value);
obj_get_next_with_same_behavior_id_and_field_s32
Lua Example
local ObjectValue = obj_get_next_with_same_behavior_id_and_field_s32(o, fieldIndex, value)
Parameters
| Field | Type |
|---|---|
| o | Object |
| fieldIndex | integer |
| value | integer |
Returns
C Prototype
struct Object *obj_get_next_with_same_behavior_id_and_field_s32(struct Object *o, s32 fieldIndex, s32 value);
obj_get_temp_spawn_particles_info
Lua Example
local SpawnParticlesInfoValue = obj_get_temp_spawn_particles_info(modelId)
Parameters
| Field | Type |
|---|---|
| modelId | enum ModelExtendedId |
Returns
C Prototype
struct SpawnParticlesInfo* obj_get_temp_spawn_particles_info(enum ModelExtendedId modelId);
obj_has_behavior_id
Lua Example
local integerValue = obj_has_behavior_id(o, behaviorId)
Parameters
| Field | Type |
|---|---|
| o | Object |
| behaviorId | enum BehaviorId |
Returns
integer
C Prototype
s32 obj_has_behavior_id(struct Object *o, enum BehaviorId behaviorId);
obj_has_model_extended
Lua Example
local integerValue = obj_has_model_extended(o, modelId)
Parameters
| Field | Type |
|---|---|
| o | Object |
| modelId | enum ModelExtendedId |
Returns
integer
C Prototype
s32 obj_has_model_extended(struct Object *o, enum ModelExtendedId modelId);
obj_is_attackable
Lua Example
local booleanValue = obj_is_attackable(o)
Parameters
| Field | Type |
|---|---|
| o | Object |
Returns
boolean
C Prototype
bool obj_is_attackable(struct Object *o);
obj_is_breakable_object
Lua Example
local booleanValue = obj_is_breakable_object(o)
Parameters
| Field | Type |
|---|---|
| o | Object |
Returns
boolean
C Prototype
bool obj_is_breakable_object(struct Object *o);
obj_is_bully
Lua Example
local booleanValue = obj_is_bully(o)
Parameters
| Field | Type |
|---|---|
| o | Object |
Returns
boolean
C Prototype
bool obj_is_bully(struct Object *o);
obj_is_coin
Lua Example
local booleanValue = obj_is_coin(o)
Parameters
| Field | Type |
|---|---|
| o | Object |
Returns
boolean
C Prototype
bool obj_is_coin(struct Object *o);
obj_is_exclamation_box
Lua Example
local booleanValue = obj_is_exclamation_box(o)
Parameters
| Field | Type |
|---|---|
| o | Object |
Returns
boolean
C Prototype
bool obj_is_exclamation_box(struct Object *o);
obj_is_grabbable
Lua Example
local booleanValue = obj_is_grabbable(o)
Parameters
| Field | Type |
|---|---|
| o | Object |
Returns
boolean
C Prototype
bool obj_is_grabbable(struct Object *o) ;
obj_is_mushroom_1up
Lua Example
local booleanValue = obj_is_mushroom_1up(o)
Parameters
| Field | Type |
|---|---|
| o | Object |
Returns
boolean
C Prototype
bool obj_is_mushroom_1up(struct Object *o);
obj_is_secret
Lua Example
local booleanValue = obj_is_secret(o)
Parameters
| Field | Type |
|---|---|
| o | Object |
Returns
boolean
C Prototype
bool obj_is_secret(struct Object *o);
obj_is_valid_for_interaction
Lua Example
local booleanValue = obj_is_valid_for_interaction(o)
Parameters
| Field | Type |
|---|---|
| o | Object |
Returns
boolean
C Prototype
bool obj_is_valid_for_interaction(struct Object *o);
obj_move_xyz
Lua Example
obj_move_xyz(o, dx, dy, dz)
Parameters
| Field | Type |
|---|---|
| o | Object |
| dx | number |
| dy | number |
| dz | number |
Returns
- None
C Prototype
void obj_move_xyz(struct Object *o, f32 dx, f32 dy, f32 dz);
obj_set_field_f32
Lua Example
obj_set_field_f32(o, fieldIndex, value)
Parameters
| Field | Type |
|---|---|
| o | Object |
| fieldIndex | integer |
| value | number |
Returns
- None
C Prototype
void obj_set_field_f32(struct Object *o, s32 fieldIndex, f32 value);
obj_set_field_s16
Lua Example
obj_set_field_s16(o, fieldIndex, fieldSubIndex, value)
Parameters
| Field | Type |
|---|---|
| o | Object |
| fieldIndex | integer |
| fieldSubIndex | integer |
| value | integer |
Returns
- None
C Prototype
void obj_set_field_s16(struct Object *o, s32 fieldIndex, s32 fieldSubIndex, s16 value);
obj_set_field_s32
Lua Example
obj_set_field_s32(o, fieldIndex, value)
Parameters
| Field | Type |
|---|---|
| o | Object |
| fieldIndex | integer |
| value | integer |
Returns
- None
C Prototype
void obj_set_field_s32(struct Object *o, s32 fieldIndex, s32 value);
obj_set_field_u32
Lua Example
obj_set_field_u32(o, fieldIndex, value)
Parameters
| Field | Type |
|---|---|
| o | Object |
| fieldIndex | integer |
| value | integer |
Returns
- None
C Prototype
void obj_set_field_u32(struct Object *o, s32 fieldIndex, u32 value);
obj_set_model_extended
Lua Example
obj_set_model_extended(o, modelId)
Parameters
| Field | Type |
|---|---|
| o | Object |
| modelId | enum ModelExtendedId |
Returns
- None
C Prototype
void obj_set_model_extended(struct Object *o, enum ModelExtendedId modelId);
obj_set_vel
Lua Example
obj_set_vel(o, vx, vy, vz)
Parameters
| Field | Type |
|---|---|
| o | Object |
| vx | number |
| vy | number |
| vz | number |
Returns
- None
C Prototype
void obj_set_vel(struct Object *o, f32 vx, f32 vy, f32 vz);
set_whirlpools
Lua Example
set_whirlpools(x, y, z, strength, area, index)
Parameters
| Field | Type |
|---|---|
| x | number |
| y | number |
| z | number |
| strength | integer |
| area | integer |
| index | integer |
Returns
- None
C Prototype
void set_whirlpools(f32 x, f32 y, f32 z, s16 strength, s16 area, s32 index);
spawn_non_sync_object
Lua Example
local ObjectValue = spawn_non_sync_object(behaviorId, modelId, x, y, z, objSetupFunction)
Parameters
| Field | Type |
|---|---|
| behaviorId | enum BehaviorId |
| modelId | enum ModelExtendedId |
| x | number |
| y | number |
| z | number |
| objSetupFunction | Lua Function () |
Returns
C Prototype
struct Object* spawn_non_sync_object(enum BehaviorId behaviorId, enum ModelExtendedId modelId, f32 x, f32 y, f32 z, LuaFunction objSetupFunction);
spawn_sync_object
Lua Example
local ObjectValue = spawn_sync_object(behaviorId, modelId, x, y, z, objSetupFunction)
Parameters
| Field | Type |
|---|---|
| behaviorId | enum BehaviorId |
| modelId | enum ModelExtendedId |
| x | number |
| y | number |
| z | number |
| objSetupFunction | Lua Function () |
Returns
C Prototype
struct Object* spawn_sync_object(enum BehaviorId behaviorId, enum ModelExtendedId modelId, f32 x, f32 y, f32 z, LuaFunction objSetupFunction);
functions from smlua_text_utils.h
smlua_text_utils_act_name_get
Lua Example
local stringValue = smlua_text_utils_act_name_get(courseNum, actNum)
Parameters
| Field | Type |
|---|---|
| courseNum | integer |
| actNum | integer |
Returns
string
C Prototype
const char* smlua_text_utils_act_name_get(s16 courseNum, u8 actNum);
smlua_text_utils_act_name_mod_index
Lua Example
local integerValue = smlua_text_utils_act_name_mod_index(courseNum, actNum)
Parameters
| Field | Type |
|---|---|
| courseNum | integer |
| actNum | integer |
Returns
integer
C Prototype
s32 smlua_text_utils_act_name_mod_index(s16 courseNum, u8 actNum);
smlua_text_utils_act_name_replace
Lua Example
smlua_text_utils_act_name_replace(courseNum, actNum, name)
Parameters
| Field | Type |
|---|---|
| courseNum | integer |
| actNum | integer |
| name | string |
Returns
- None
C Prototype
void smlua_text_utils_act_name_replace(s16 courseNum, u8 actNum, const char* name);
smlua_text_utils_act_name_reset
Lua Example
smlua_text_utils_act_name_reset(courseNum, actNum)
Parameters
| Field | Type |
|---|---|
| courseNum | integer |
| actNum | integer |
Returns
- None
C Prototype
void smlua_text_utils_act_name_reset(s16 courseNum, u8 actNum);
smlua_text_utils_castle_secret_stars_replace
Lua Example
smlua_text_utils_castle_secret_stars_replace(name)
Parameters
| Field | Type |
|---|---|
| name | string |
Returns
- None
C Prototype
void smlua_text_utils_castle_secret_stars_replace(const char* name);
smlua_text_utils_course_acts_replace
Lua Example
smlua_text_utils_course_acts_replace(courseNum, courseName, act1, act2, act3, act4, act5, act6)
Parameters
| Field | Type |
|---|---|
| courseNum | integer |
| courseName | string |
| act1 | string |
| act2 | string |
| act3 | string |
| act4 | string |
| act5 | string |
| act6 | string |
Returns
- None
C Prototype
void smlua_text_utils_course_acts_replace(s16 courseNum, const char* courseName, const char* act1, const char* act2, const char* act3, const char* act4, const char* act5, const char* act6);
smlua_text_utils_course_name_get
Lua Example
local stringValue = smlua_text_utils_course_name_get(courseNum)
Parameters
| Field | Type |
|---|---|
| courseNum | integer |
Returns
string
C Prototype
const char* smlua_text_utils_course_name_get(s16 courseNum);
smlua_text_utils_course_name_mod_index
Lua Example
local integerValue = smlua_text_utils_course_name_mod_index(courseNum)
Parameters
| Field | Type |
|---|---|
| courseNum | integer |
Returns
integer
C Prototype
s32 smlua_text_utils_course_name_mod_index(s16 courseNum);
smlua_text_utils_course_name_replace
Lua Example
smlua_text_utils_course_name_replace(courseNum, name)
Parameters
| Field | Type |
|---|---|
| courseNum | integer |
| name | string |
Returns
- None
C Prototype
void smlua_text_utils_course_name_replace(s16 courseNum, const char* name);
smlua_text_utils_course_name_reset
Lua Example
smlua_text_utils_course_name_reset(courseNum)
Parameters
| Field | Type |
|---|---|
| courseNum | integer |
Returns
- None
C Prototype
void smlua_text_utils_course_name_reset(s16 courseNum);
smlua_text_utils_dialog_replace
Lua Example
smlua_text_utils_dialog_replace(dialogId, unused, linesPerBox, leftOffset, width, str)
Parameters
| Field | Type |
|---|---|
| dialogId | enum DialogId |
| unused | integer |
| linesPerBox | integer |
| leftOffset | integer |
| width | integer |
| str | string |
Returns
- None
C Prototype
void smlua_text_utils_dialog_replace(enum DialogId dialogId, u32 unused, s8 linesPerBox, s16 leftOffset, s16 width, const char* str);
smlua_text_utils_extra_text_replace
Lua Example
smlua_text_utils_extra_text_replace(index, text)
Parameters
| Field | Type |
|---|---|
| index | integer |
| text | string |
Returns
- None
C Prototype
void smlua_text_utils_extra_text_replace(s16 index, const char* text);
smlua_text_utils_get_language
Lua Example
local stringValue = smlua_text_utils_get_language()
Parameters
- None
Returns
string
C Prototype
const char* smlua_text_utils_get_language(void);
smlua_text_utils_secret_star_replace
Lua Example
smlua_text_utils_secret_star_replace(courseNum, courseName)
Parameters
| Field | Type |
|---|---|
| courseNum | integer |
| courseName | string |
Returns
- None
C Prototype
void smlua_text_utils_secret_star_replace(s16 courseNum, const char* courseName);
functions from sound_init.h
disable_background_sound
Lua Example
disable_background_sound()
Parameters
- None
Returns
- None
C Prototype
void disable_background_sound(void);
enable_background_sound
Lua Example
enable_background_sound()
Parameters
- None
Returns
- None
C Prototype
void enable_background_sound(void);
fadeout_cap_music
Lua Example
fadeout_cap_music()
Parameters
- None
Returns
- None
C Prototype
void fadeout_cap_music(void);
fadeout_level_music
Lua Example
fadeout_level_music(fadeTimer)
Parameters
| Field | Type |
|---|---|
| fadeTimer | integer |
Returns
- None
C Prototype
void fadeout_level_music(s16 fadeTimer);
fadeout_music
Lua Example
fadeout_music(fadeOutTime)
Parameters
| Field | Type |
|---|---|
| fadeOutTime | integer |
Returns
- None
C Prototype
void fadeout_music(s16 fadeOutTime);
lower_background_noise
Lua Example
lower_background_noise(a)
Parameters
| Field | Type |
|---|---|
| a | integer |
Returns
- None
C Prototype
void lower_background_noise(s32 a);
play_cap_music
Lua Example
play_cap_music(seqArgs)
Parameters
| Field | Type |
|---|---|
| seqArgs | integer |
Returns
- None
C Prototype
void play_cap_music(u16 seqArgs);
play_cutscene_music
Lua Example
play_cutscene_music(seqArgs)
Parameters
| Field | Type |
|---|---|
| seqArgs | integer |
Returns
- None
C Prototype
void play_cutscene_music(u16 seqArgs);
play_infinite_stairs_music
Lua Example
play_infinite_stairs_music()
Parameters
- None
Returns
- None
C Prototype
void play_infinite_stairs_music(void);
play_menu_sounds
Lua Example
play_menu_sounds(soundMenuFlags)
Parameters
| Field | Type |
|---|---|
| soundMenuFlags | integer |
Returns
- None
C Prototype
void play_menu_sounds(s16 soundMenuFlags);
play_painting_eject_sound
Lua Example
play_painting_eject_sound()
Parameters
- None
Returns
- None
C Prototype
void play_painting_eject_sound(void);
play_shell_music
Lua Example
play_shell_music()
Parameters
- None
Returns
- None
C Prototype
void play_shell_music(void);
raise_background_noise
Lua Example
raise_background_noise(a)
Parameters
| Field | Type |
|---|---|
| a | integer |
Returns
- None
C Prototype
void raise_background_noise(s32 a);
reset_volume
Lua Example
reset_volume()
Parameters
- None
Returns
- None
C Prototype
void reset_volume(void);
set_background_music
Lua Example
set_background_music(a, seqArgs, fadeTimer)
Parameters
| Field | Type |
|---|---|
| a | integer |
| seqArgs | integer |
| fadeTimer | integer |
Returns
- None
C Prototype
void set_background_music(u16 a, u16 seqArgs, s16 fadeTimer);
stop_cap_music
Lua Example
stop_cap_music()
Parameters
- None
Returns
- None
C Prototype
void stop_cap_music(void);
stop_shell_music
Lua Example
stop_shell_music()
Parameters
- None
Returns
- None
C Prototype
void stop_shell_music(void);
functions from spawn_sound.c
calc_dist_to_volume_range_1
Lua Example
local integerValue = calc_dist_to_volume_range_1(distance)
Parameters
| Field | Type |
|---|---|
| distance | number |
Returns
integer
C Prototype
s32 calc_dist_to_volume_range_1(f32 distance);
calc_dist_to_volume_range_2
Lua Example
local integerValue = calc_dist_to_volume_range_2(distance)
Parameters
| Field | Type |
|---|---|
| distance | number |
Returns
integer
C Prototype
s32 calc_dist_to_volume_range_2(f32 distance);
cur_obj_play_sound_1
Lua Example
cur_obj_play_sound_1(soundMagic)
Parameters
| Field | Type |
|---|---|
| soundMagic | integer |
Returns
- None
C Prototype
void cur_obj_play_sound_1(s32 soundMagic);
cur_obj_play_sound_2
Lua Example
cur_obj_play_sound_2(soundMagic)
Parameters
| Field | Type |
|---|---|
| soundMagic | integer |
Returns
- None
C Prototype
void cur_obj_play_sound_2(s32 soundMagic);
exec_anim_sound_state
Lua Example
exec_anim_sound_state(soundStates, maxSoundStates)
Parameters
| Field | Type |
|---|---|
| soundStates | SoundState |
| maxSoundStates | integer |
Returns
- None
C Prototype
void exec_anim_sound_state(struct SoundState *soundStates, u16 maxSoundStates);
functions from surface_collision.h
find_ceil_height
Lua Example
local numberValue = find_ceil_height(x, y, z)
Parameters
| Field | Type |
|---|---|
| x | number |
| y | number |
| z | number |
Returns
number
C Prototype
f32 find_ceil_height(f32 x, f32 y, f32 z);
find_floor_height
Lua Example
local numberValue = find_floor_height(x, y, z)
Parameters
| Field | Type |
|---|---|
| x | number |
| y | number |
| z | number |
Returns
number
C Prototype
f32 find_floor_height(f32 x, f32 y, f32 z);
find_poison_gas_level
Lua Example
local numberValue = find_poison_gas_level(x, z)
Parameters
| Field | Type |
|---|---|
| x | number |
| z | number |
Returns
number
C Prototype
f32 find_poison_gas_level(f32 x, f32 z);
find_wall_collisions
Lua Example
local integerValue = find_wall_collisions(colData)
Parameters
| Field | Type |
|---|---|
| colData | WallCollisionData |
Returns
integer
C Prototype
s32 find_wall_collisions(struct WallCollisionData *colData);
find_water_level
Lua Example
local numberValue = find_water_level(x, z)
Parameters
| Field | Type |
|---|---|
| x | number |
| z | number |
Returns
number
C Prototype
f32 find_water_level(f32 x, f32 z);
functions from surface_load.h
get_area_terrain_size
Lua Example
local integerValue = get_area_terrain_size(data)
Parameters
| Field | Type |
|---|---|
| data | Pointer <integer> |
Returns
integer
C Prototype
u32 get_area_terrain_size(s16 *data);
load_area_terrain
Lua Example
load_area_terrain(index, data, surfaceRooms, macroObjects)
Parameters
| Field | Type |
|---|---|
| index | integer |
| data | Pointer <integer> |
| surfaceRooms | Pointer <integer> |
| macroObjects | Pointer <integer> |
Returns
- None
C Prototype
void load_area_terrain(s16 index, s16 *data, s8 *surfaceRooms, s16 *macroObjects);
load_object_collision_model
Lua Example
load_object_collision_model()
Parameters
- None
Returns
- None
C Prototype
void load_object_collision_model(void);
obj_get_surface_from_index
Lua Example
local SurfaceValue = obj_get_surface_from_index(o, index)
Parameters
| Field | Type |
|---|---|
| o | Object |
| index | integer |
Returns
C Prototype
struct Surface *obj_get_surface_from_index(struct Object *o, u32 index);
surface_has_force
Lua Example
local booleanValue = surface_has_force(surfaceType)
Parameters
| Field | Type |
|---|---|
| surfaceType | integer |
Returns
boolean
C Prototype
bool surface_has_force(s16 surfaceType);