HOOK_ALLOW_INTERACT; new HUD functions (#73)

Added new hook: HOOK_ALLOW_INTERACT: Called before Mario interacts with an object. Return true to allow the interaction. The hook signature is bool function(MarioState, Object, InteractionType) Added new HUD constants: enum HudDisplayValue: HUD_DISPLAY_LIVES HUD_DISPLAY_COINS HUD_DISPLAY_STARS HUD_DISPLAY_WEDGES HUD_DISPLAY_KEYS HUD_DISPLAY_FLAGS HUD_DISPLAY_TIMER enum HudDisplayFlags: HUD_DISPLAY_FLAGS_NONE HUD_DISPLAY_FLAGS_LIVES HUD_DISPLAY_FLAGS_COIN_COUNT HUD_DISPLAY_FLAGS_STAR_COUNT HUD_DISPLAY_FLAGS_CAMERA_AND_POWER HUD_DISPLAY_FLAGS_KEYS HUD_DISPLAY_FLAGS_UNKNOWN_0020 HUD_DISPLAY_FLAGS_TIMER HUD_DISPLAY_FLAGS_EMPHASIZE_POWER Added new HUD functions: s32 hud_get_value(enum HudDisplayValue type) void hud_set_value(enum HudDisplayValue type, s32 value) void hud_render_power_meter(s32 health, f32 x, f32 y, f32 width, f32 height)
2026-04-28 04:51:40 +00:00 · 2022-05-01 02:33:38 +02:00 · 2022-05-01 02:33:38 +02:00 · 8812fbac8b
commit 8812fbac8b
parent a0e15a63db
15 changed files with 416 additions and 45 deletions
--- a/autogen/convert_constants.py
+++ b/autogen/convert_constants.py
@ -24,6 +24,7 @@ in_files = [
    "src/pc/djui/djui_hud_utils.h",
    "include/behavior_table.h",
    "src/pc/lua/utils/smlua_model_utils.h",
+    "src/pc/lua/utils/smlua_misc_utils.h",
    "include/object_constants.h",
    "include/mario_geo_switch_case_ids.h",
    "src/game/object_list_processor.h",
--- a/autogen/lua_definitions/constants.lua
+++ b/autogen/lua_definitions/constants.lua
@ -7822,43 +7822,98 @@ HOOK_ON_PLAYER_DISCONNECTED = 8
 HOOK_ON_HUD_RENDER = 9

 --- @type LuaHookedEventType
-HOOK_ON_INTERACT = 10
+HOOK_ALLOW_INTERACT = 10

 --- @type LuaHookedEventType
-HOOK_ON_LEVEL_INIT = 11
+HOOK_ON_INTERACT = 11

 --- @type LuaHookedEventType
-HOOK_ON_WARP = 12
+HOOK_ON_LEVEL_INIT = 12

 --- @type LuaHookedEventType
-HOOK_ON_SYNC_VALID = 13
+HOOK_ON_WARP = 13

 --- @type LuaHookedEventType
-HOOK_ON_OBJECT_UNLOAD = 14
+HOOK_ON_SYNC_VALID = 14

 --- @type LuaHookedEventType
-HOOK_ON_SYNC_OBJECT_UNLOAD = 15
+HOOK_ON_OBJECT_UNLOAD = 15

 --- @type LuaHookedEventType
-HOOK_ON_PAUSE_EXIT = 16
+HOOK_ON_SYNC_OBJECT_UNLOAD = 16

 --- @type LuaHookedEventType
-HOOK_GET_STAR_COLLECTION_DIALOG = 17
+HOOK_ON_PAUSE_EXIT = 17

 --- @type LuaHookedEventType
-HOOK_ON_SET_CAMERA_MODE = 18
+HOOK_GET_STAR_COLLECTION_DIALOG = 18

 --- @type LuaHookedEventType
-HOOK_ON_OBJECT_RENDER = 19
+HOOK_ON_SET_CAMERA_MODE = 19

 --- @type LuaHookedEventType
-HOOK_ON_DEATH = 20
+HOOK_ON_OBJECT_RENDER = 20

 --- @type LuaHookedEventType
-HOOK_ON_PACKET_RECEIVE = 21
+HOOK_ON_DEATH = 21

 --- @type LuaHookedEventType
-HOOK_MAX = 22
+HOOK_ON_PACKET_RECEIVE = 22
+
+--- @type LuaHookedEventType
+HOOK_MAX = 23
+
+--- @class HudDisplayFlags
+
+--- @type HudDisplayFlags
+HUD_DISPLAY_FLAGS_NONE = 0x0000
+
+--- @type HudDisplayFlags
+HUD_DISPLAY_FLAGS_LIVES = 0x0001
+
+--- @type HudDisplayFlags
+HUD_DISPLAY_FLAGS_COIN_COUNT = 0x0002
+
+--- @type HudDisplayFlags
+HUD_DISPLAY_FLAGS_STAR_COUNT = 0x0004
+
+--- @type HudDisplayFlags
+HUD_DISPLAY_FLAGS_CAMERA_AND_POWER = 0x0008
+
+--- @type HudDisplayFlags
+HUD_DISPLAY_FLAGS_KEYS = 0x0010
+
+--- @type HudDisplayFlags
+HUD_DISPLAY_FLAGS_UNKNOWN_0020 = 0x0020
+
+--- @type HudDisplayFlags
+HUD_DISPLAY_FLAGS_TIMER = 0x0040
+
+--- @type HudDisplayFlags
+HUD_DISPLAY_FLAGS_EMPHASIZE_POWER = 0x8000
+
+--- @class HudDisplayValue
+
+--- @type HudDisplayValue
+HUD_DISPLAY_LIVES = 0
+
+--- @type HudDisplayValue
+HUD_DISPLAY_COINS = 1
+
+--- @type HudDisplayValue
+HUD_DISPLAY_STARS = 2
+
+--- @type HudDisplayValue
+HUD_DISPLAY_WEDGES = 3
+
+--- @type HudDisplayValue
+HUD_DISPLAY_KEYS = 4
+
+--- @type HudDisplayValue
+HUD_DISPLAY_FLAGS = 5
+
+--- @type HudDisplayValue
+HUD_DISPLAY_TIMER = 6

 --- @class ModelExtendedId

--- a/autogen/lua_definitions/functions.lua
+++ b/autogen/lua_definitions/functions.lua
@ -7171,11 +7171,34 @@ function get_temp_s32_pointer(initialValue)
    -- ...
 end

+--- @param type HudDisplayValue
+--- @return integer
+function hud_get_value(type)
+    -- ...
+end
+
 --- @return nil
 function hud_hide()
    -- ...
 end

+--- @param health integer
+--- @param x number
+--- @param y number
+--- @param width number
+--- @param height number
+--- @return nil
+function hud_render_power_meter(health, x, y, width, height)
+    -- ...
+end
+
+--- @param type HudDisplayValue
+--- @param value integer
+--- @return nil
+function hud_set_value(type, value)
+    -- ...
+end
+
 --- @return nil
 function hud_show()
    -- ...
--- a/docs/lua/constants.md
+++ b/docs/lua/constants.md
@ -44,6 +44,9 @@
 - [sm64.h](#sm64h)
 - [smlua_hooks.h](#smlua_hooksh)
    - [enum LuaHookedEventType](#enum-LuaHookedEventType)
+- [smlua_misc_utils.h](#smlua_misc_utilsh)
+    - [enum HudDisplayFlags](#enum-HudDisplayFlags)
+    - [enum HudDisplayValue](#enum-HudDisplayValue)
 - [smlua_model_utils.h](#smlua_model_utilsh)
    - [enum ModelExtendedId](#enum-ModelExtendedId)
 - [sounds.h](#soundsh)
@ -2745,19 +2748,50 @@
 | HOOK_ON_PLAYER_CONNECTED | 7 |
 | HOOK_ON_PLAYER_DISCONNECTED | 8 |
 | HOOK_ON_HUD_RENDER | 9 |
-| HOOK_ON_INTERACT | 10 |
-| HOOK_ON_LEVEL_INIT | 11 |
-| HOOK_ON_WARP | 12 |
-| HOOK_ON_SYNC_VALID | 13 |
-| HOOK_ON_OBJECT_UNLOAD | 14 |
-| HOOK_ON_SYNC_OBJECT_UNLOAD | 15 |
-| HOOK_ON_PAUSE_EXIT | 16 |
-| HOOK_GET_STAR_COLLECTION_DIALOG | 17 |
-| HOOK_ON_SET_CAMERA_MODE | 18 |
-| HOOK_ON_OBJECT_RENDER | 19 |
-| HOOK_ON_DEATH | 20 |
-| HOOK_ON_PACKET_RECEIVE | 21 |
-| HOOK_MAX | 22 |
+| HOOK_ALLOW_INTERACT | 10 |
+| HOOK_ON_INTERACT | 11 |
+| HOOK_ON_LEVEL_INIT | 12 |
+| HOOK_ON_WARP | 13 |
+| HOOK_ON_SYNC_VALID | 14 |
+| HOOK_ON_OBJECT_UNLOAD | 15 |
+| HOOK_ON_SYNC_OBJECT_UNLOAD | 16 |
+| HOOK_ON_PAUSE_EXIT | 17 |
+| HOOK_GET_STAR_COLLECTION_DIALOG | 18 |
+| HOOK_ON_SET_CAMERA_MODE | 19 |
+| HOOK_ON_OBJECT_RENDER | 20 |
+| HOOK_ON_DEATH | 21 |
+| HOOK_ON_PACKET_RECEIVE | 22 |
+| HOOK_MAX | 23 |
+
+[:arrow_up_small:](#)
+
+<br />
+
+## [smlua_misc_utils.h](#smlua_misc_utils.h)
+
+### [enum HudDisplayFlags](#HudDisplayFlags)
+| Identifier | Value |
+| :--------- | :---- |
+| HUD_DISPLAY_FLAGS_NONE | 0x0000 |
+| HUD_DISPLAY_FLAGS_LIVES | 0x0001 |
+| HUD_DISPLAY_FLAGS_COIN_COUNT | 0x0002 |
+| HUD_DISPLAY_FLAGS_STAR_COUNT | 0x0004 |
+| HUD_DISPLAY_FLAGS_CAMERA_AND_POWER | 0x0008 |
+| HUD_DISPLAY_FLAGS_KEYS | 0x0010 |
+| HUD_DISPLAY_FLAGS_UNKNOWN_0020 | 0x0020 |
+| HUD_DISPLAY_FLAGS_TIMER | 0x0040 |
+| HUD_DISPLAY_FLAGS_EMPHASIZE_POWER | 0x8000 |
+
+### [enum HudDisplayValue](#HudDisplayValue)
+| Identifier | Value |
+| :--------- | :---- |
+| HUD_DISPLAY_LIVES | 0 |
+| HUD_DISPLAY_COINS | 1 |
+| HUD_DISPLAY_STARS | 2 |
+| HUD_DISPLAY_WEDGES | 3 |
+| HUD_DISPLAY_KEYS | 4 |
+| HUD_DISPLAY_FLAGS | 5 |
+| HUD_DISPLAY_TIMER | 6 |

 [:arrow_up_small:](#)

--- a/docs/lua/functions-4.md
+++ b/docs/lua/functions-4.md
@ -4860,6 +4860,26 @@

 <br />

+## [hud_get_value](#hud_get_value)
+
+### Lua Example
+`local integerValue = hud_get_value(type)`
+
+### Parameters
+| Field | Type |
+| ----- | ---- |
+| type | [enum HudDisplayValue](constants.md#enum-HudDisplayValue) |
+
+### Returns
+- `integer`
+
+### C Prototype
+`s32 hud_get_value(enum HudDisplayValue type);`
+
+[:arrow_up_small:](#)
+
+<br />
+
 ## [hud_hide](#hud_hide)

 ### Lua Example
@ -4878,6 +4898,51 @@

 <br />

+## [hud_render_power_meter](#hud_render_power_meter)
+
+### 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);`
+
+[:arrow_up_small:](#)
+
+<br />
+
+## [hud_set_value](#hud_set_value)
+
+### Lua Example
+`hud_set_value(type, value)`
+
+### Parameters
+| Field | Type |
+| ----- | ---- |
+| type | [enum HudDisplayValue](constants.md#enum-HudDisplayValue) |
+| value | `integer` |
+
+### Returns
+- None
+
+### C Prototype
+`void hud_set_value(enum HudDisplayValue type, s32 value);`
+
+[:arrow_up_small:](#)
+
+<br />
+
 ## [hud_show](#hud_show)

 ### Lua Example
--- a/docs/lua/functions.md
+++ b/docs/lua/functions.md
@ -1341,7 +1341,10 @@
   - [get_hand_foot_pos_z](functions-4.md#get_hand_foot_pos_z)
   - [get_network_area_timer](functions-4.md#get_network_area_timer)
   - [get_temp_s32_pointer](functions-4.md#get_temp_s32_pointer)
+   - [hud_get_value](functions-4.md#hud_get_value)
   - [hud_hide](functions-4.md#hud_hide)
+   - [hud_render_power_meter](functions-4.md#hud_render_power_meter)
+   - [hud_set_value](functions-4.md#hud_set_value)
   - [hud_show](functions-4.md#hud_show)
   - [movtexqc_register](functions-4.md#movtexqc_register)
   - [play_transition](functions-4.md#play_transition)
--- a/docs/lua/hooks.md
+++ b/docs/lua/hooks.md
@ -96,6 +96,7 @@ The lua functions sent to `hook_event()` will be automatically called by SM64 wh
 | HOOK_ON_PLAYER_CONNECTED | Called when a player connects | [MarioState](structs.md#MarioState) connector |
 | HOOK_ON_PLAYER_DISCONNECTED | Called when a player disconnects | [MarioState](structs.md#MarioState) disconnector |
 | HOOK_ON_HUD_RENDER | Called when the HUD is being rendered | None |
+| HOOK_ALLOW_INTERACT | Called before mario interacts with an object, return `true` to allow the interaction | [MarioState](structs.md#MarioState) interactor, [Object](structs.md#Object) interactee, [enum InteractionType](constants.md#enum-InteractionType) interactType |
 | HOOK_ON_INTERACT | Called when mario interacts with an object | [MarioState](structs.md#MarioState) interactor, [Object](structs.md#Object) interactee, [enum InteractionType](constants.md#enum-InteractionType) interactType, bool interactValue |
 | HOOK_ON_LEVEL_INIT | Called when the level is initialized | None |
 | HOOK_ON_WARP | Called when the local player warps | None |
--- a/src/game/interaction.c
+++ b/src/game/interaction.c
@ -2174,11 +2174,15 @@ void mario_process_interactions(struct MarioState *m) {
                m->collidedObjInteractTypes &= ~interactType;

                if (!(object->oInteractStatus & INT_STATUS_INTERACTED)) {
-                    if (sInteractionHandlers[i].handler(m, interactType, object)) {
-                        smlua_call_event_hooks_interact_params(HOOK_ON_INTERACT, m, object, interactType, true);
-                        break;
-                    } else {
-                        smlua_call_event_hooks_interact_params(HOOK_ON_INTERACT, m, object, interactType, false);
+                    bool allow = true;
+                    smlua_call_event_hooks_interact_params_ret_bool(HOOK_ALLOW_INTERACT, m, object, interactType, &allow);
+                    if (allow) {
+                        if (sInteractionHandlers[i].handler(m, interactType, object)) {
+                            smlua_call_event_hooks_interact_params(HOOK_ON_INTERACT, m, object, interactType, true);
+                            break;
+                        } else {
+                            smlua_call_event_hooks_interact_params(HOOK_ON_INTERACT, m, object, interactType, false);
+                        }
                    }
                }
            }
--- a/src/pc/djui/djui_hud_utils.c
+++ b/src/pc/djui/djui_hud_utils.c
@ -164,7 +164,7 @@ static void djui_hud_render_texture_raw(const u8* texture, u32 bitSize, u32 widt
 }

 void djui_hud_render_texture(struct TextureInfo* texInfo, f32 x, f32 y, f32 scaleW, f32 scaleH) {
-    djui_hud_render_texture_raw(texInfo->texture, texInfo->bitSize, texInfo->width, texInfo->width, x, y, scaleW, scaleH);
+    djui_hud_render_texture_raw(texInfo->texture, texInfo->bitSize, texInfo->width, texInfo->height, x, y, scaleW, scaleH);
 }

 void djui_hud_render_rect(f32 x, f32 y, f32 width, f32 height) {
--- a/src/pc/lua/smlua_constants_autogen.c
+++ b/src/pc/lua/smlua_constants_autogen.c
@ -2788,19 +2788,36 @@ char gSmluaConstants[] = ""
 "HOOK_ON_PLAYER_CONNECTED = 7\n"
 "HOOK_ON_PLAYER_DISCONNECTED = 8\n"
 "HOOK_ON_HUD_RENDER = 9\n"
-"HOOK_ON_INTERACT = 10\n"
-"HOOK_ON_LEVEL_INIT = 11\n"
-"HOOK_ON_WARP = 12\n"
-"HOOK_ON_SYNC_VALID = 13\n"
-"HOOK_ON_OBJECT_UNLOAD = 14\n"
-"HOOK_ON_SYNC_OBJECT_UNLOAD = 15\n"
-"HOOK_ON_PAUSE_EXIT = 16\n"
-"HOOK_GET_STAR_COLLECTION_DIALOG = 17\n"
-"HOOK_ON_SET_CAMERA_MODE = 18\n"
-"HOOK_ON_OBJECT_RENDER = 19\n"
-"HOOK_ON_DEATH = 20\n"
-"HOOK_ON_PACKET_RECEIVE = 21\n"
-"HOOK_MAX = 22\n"
+"HOOK_ALLOW_INTERACT = 10\n"
+"HOOK_ON_INTERACT = 11\n"
+"HOOK_ON_LEVEL_INIT = 12\n"
+"HOOK_ON_WARP = 13\n"
+"HOOK_ON_SYNC_VALID = 14\n"
+"HOOK_ON_OBJECT_UNLOAD = 15\n"
+"HOOK_ON_SYNC_OBJECT_UNLOAD = 16\n"
+"HOOK_ON_PAUSE_EXIT = 17\n"
+"HOOK_GET_STAR_COLLECTION_DIALOG = 18\n"
+"HOOK_ON_SET_CAMERA_MODE = 19\n"
+"HOOK_ON_OBJECT_RENDER = 20\n"
+"HOOK_ON_DEATH = 21\n"
+"HOOK_ON_PACKET_RECEIVE = 22\n"
+"HOOK_MAX = 23\n"
+"HUD_DISPLAY_LIVES = 0\n"
+"HUD_DISPLAY_COINS = 1\n"
+"HUD_DISPLAY_STARS = 2\n"
+"HUD_DISPLAY_WEDGES = 3\n"
+"HUD_DISPLAY_KEYS = 4\n"
+"HUD_DISPLAY_FLAGS = 5\n"
+"HUD_DISPLAY_TIMER = 6\n"
+"HUD_DISPLAY_FLAGS_NONE = 0x0000\n"
+"HUD_DISPLAY_FLAGS_LIVES = 0x0001\n"
+"HUD_DISPLAY_FLAGS_COIN_COUNT = 0x0002\n"
+"HUD_DISPLAY_FLAGS_STAR_COUNT = 0x0004\n"
+"HUD_DISPLAY_FLAGS_CAMERA_AND_POWER = 0x0008\n"
+"HUD_DISPLAY_FLAGS_KEYS = 0x0010\n"
+"HUD_DISPLAY_FLAGS_UNKNOWN_0020 = 0x0020\n"
+"HUD_DISPLAY_FLAGS_TIMER = 0x0040\n"
+"HUD_DISPLAY_FLAGS_EMPHASIZE_POWER = 0x8000\n"
 "E_MODEL_NONE = 0\n"
 "E_MODEL_MARIO = 1\n"
 "E_MODEL_SMOKE = 2\n"
--- a/src/pc/lua/smlua_functions_autogen.c
+++ b/src/pc/lua/smlua_functions_autogen.c
@ -14769,6 +14769,17 @@ int smlua_func_get_temp_s32_pointer(lua_State* L) {
    return 1;
 }

+int smlua_func_hud_get_value(lua_State* L) {
+    if(!smlua_functions_valid_param_count(L, 1)) { return 0; }
+
+    int type = smlua_to_integer(L, 1);
+    if (!gSmLuaConvertSuccess) { LOG_LUA("Failed to convert parameter 1"); return 0; }
+
+    lua_pushinteger(L, hud_get_value(type));
+
+    return 1;
+}
+
 int smlua_func_hud_hide(UNUSED lua_State* L) {
    if(!smlua_functions_valid_param_count(L, 0)) { return 0; }

@ -14778,6 +14789,38 @@ int smlua_func_hud_hide(UNUSED lua_State* L) {
    return 1;
 }

+int smlua_func_hud_render_power_meter(lua_State* L) {
+    if(!smlua_functions_valid_param_count(L, 5)) { return 0; }
+
+    s32 health = smlua_to_integer(L, 1);
+    if (!gSmLuaConvertSuccess) { LOG_LUA("Failed to convert parameter 1"); return 0; }
+    f32 x = smlua_to_number(L, 2);
+    if (!gSmLuaConvertSuccess) { LOG_LUA("Failed to convert parameter 2"); return 0; }
+    f32 y = smlua_to_number(L, 3);
+    if (!gSmLuaConvertSuccess) { LOG_LUA("Failed to convert parameter 3"); return 0; }
+    f32 width = smlua_to_number(L, 4);
+    if (!gSmLuaConvertSuccess) { LOG_LUA("Failed to convert parameter 4"); return 0; }
+    f32 height = smlua_to_number(L, 5);
+    if (!gSmLuaConvertSuccess) { LOG_LUA("Failed to convert parameter 5"); return 0; }
+
+    hud_render_power_meter(health, x, y, width, height);
+
+    return 1;
+}
+
+int smlua_func_hud_set_value(lua_State* L) {
+    if(!smlua_functions_valid_param_count(L, 2)) { return 0; }
+
+    int type = smlua_to_integer(L, 1);
+    if (!gSmLuaConvertSuccess) { LOG_LUA("Failed to convert parameter 1"); return 0; }
+    s32 value = smlua_to_integer(L, 2);
+    if (!gSmLuaConvertSuccess) { LOG_LUA("Failed to convert parameter 2"); return 0; }
+
+    hud_set_value(type, value);
+
+    return 1;
+}
+
 int smlua_func_hud_show(UNUSED lua_State* L) {
    if(!smlua_functions_valid_param_count(L, 0)) { return 0; }

@ -17075,7 +17118,10 @@ void smlua_bind_functions_autogen(void) {
    smlua_bind_function(L, "get_hand_foot_pos_z", smlua_func_get_hand_foot_pos_z);
    smlua_bind_function(L, "get_network_area_timer", smlua_func_get_network_area_timer);
    smlua_bind_function(L, "get_temp_s32_pointer", smlua_func_get_temp_s32_pointer);
+    smlua_bind_function(L, "hud_get_value", smlua_func_hud_get_value);
    smlua_bind_function(L, "hud_hide", smlua_func_hud_hide);
+    smlua_bind_function(L, "hud_render_power_meter", smlua_func_hud_render_power_meter);
+    smlua_bind_function(L, "hud_set_value", smlua_func_hud_set_value);
    smlua_bind_function(L, "hud_show", smlua_func_hud_show);
    smlua_bind_function(L, "movtexqc_register", smlua_func_movtexqc_register);
    smlua_bind_function(L, "play_transition", smlua_func_play_transition);
--- a/src/pc/lua/smlua_hooks.c
+++ b/src/pc/lua/smlua_hooks.c
@ -342,6 +342,42 @@ void smlua_call_event_hooks_interact_params(enum LuaHookedEventType hookType, st
    }
 }

+void smlua_call_event_hooks_interact_params_ret_bool(enum LuaHookedEventType hookType, struct MarioState* m, struct Object* obj, u32 interactType, bool* returnValue) {
+    lua_State* L = gLuaState;
+    if (L == NULL) { return; }
+    struct LuaHookedEvent* hook = &sHookedEvents[hookType];
+    for (int i = 0; i < hook->count; i++) {
+        s32 prevTop = lua_gettop(L);
+
+        // push the callback onto the stack
+        lua_rawgeti(L, LUA_REGISTRYINDEX, hook->reference[i]);
+
+        // push mario state
+        lua_getglobal(L, "gMarioStates");
+        lua_pushinteger(L, m->playerIndex);
+        lua_gettable(L, -2);
+        lua_remove(L, -2);
+
+        // push object
+        smlua_push_object(L, LOT_OBJECT, obj);
+
+        // push interact type
+        lua_pushinteger(L, interactType);
+
+        // call the callback
+        if (0 != smlua_call_hook(L, 3, 1, 0, hook->mod[i])) {
+            LOG_LUA("Failed to call the callback: %u", hookType);
+            continue;
+        }
+
+        // output the return value
+        if (lua_type(L, -1) == LUA_TBOOLEAN) {
+            *returnValue = smlua_to_boolean(L, -1);
+        }
+        lua_settop(L, prevTop);
+    }
+}
+
 void smlua_call_event_hooks_object_param(enum LuaHookedEventType hookType, struct Object* obj) {
    lua_State* L = gLuaState;
    if (L == NULL) { return; }
--- a/src/pc/lua/smlua_hooks.h
+++ b/src/pc/lua/smlua_hooks.h
@ -18,6 +18,7 @@ enum LuaHookedEventType {
    HOOK_ON_PLAYER_CONNECTED,
    HOOK_ON_PLAYER_DISCONNECTED,
    HOOK_ON_HUD_RENDER,
+    HOOK_ALLOW_INTERACT,
    HOOK_ON_INTERACT,
    HOOK_ON_LEVEL_INIT,
    HOOK_ON_WARP,
@ -44,6 +45,7 @@ static char* LuaHookedEventTypeName[] = {
    "HOOK_ON_PLAYER_CONNECTED",
    "HOOK_ON_PLAYER_DISCONNECTED",
    "HOOK_ON_HUD_RENDER",
+    "HOOK_ALLOW_INTERACT",
    "HOOK_ON_INTERACT",
    "HOOK_ON_LEVEL_INIT",
    "HOOK_ON_WARP",
@ -69,6 +71,7 @@ void smlua_call_event_hooks_mario_param_ret_bool(enum LuaHookedEventType hookTyp
 void smlua_call_event_hooks_mario_params(enum LuaHookedEventType hookType, struct MarioState* m1, struct MarioState* m2);
 void smlua_call_event_hooks_mario_params_ret_bool(enum LuaHookedEventType hookType, struct MarioState* m1, struct MarioState* m2, bool* returnValue);
 void smlua_call_event_hooks_interact_params(enum LuaHookedEventType hookType, struct MarioState* m, struct Object* obj, u32 interactType, bool interactValue);
+void smlua_call_event_hooks_interact_params_ret_bool(enum LuaHookedEventType hookType, struct MarioState* m, struct Object* obj, u32 interactType, bool* returnValue);
 void smlua_call_event_hooks_object_param(enum LuaHookedEventType hookType, struct Object* obj);
 bool smlua_call_event_hooks_ret_int(enum LuaHookedEventType hookType, s32* returnValue);
 void smlua_call_event_hooks_set_camera_mode_params(enum LuaHookedEventType hookType, struct Camera *c, s16 mode, s16 frames, bool* returnValue);
--- a/src/pc/lua/utils/smlua_misc_utils.c
+++ b/src/pc/lua/utils/smlua_misc_utils.c
@ -7,6 +7,8 @@
 #include "smlua_misc_utils.h"
 #include "pc/debuglog.h"
 #include "game/object_list_processor.h"
+#include "game/level_update.h"
+#include "pc/djui/djui_hud_utils.h"

 u32 get_network_area_timer(void) {
    return gNetworkAreaTimer;
@ -38,6 +40,62 @@ void hud_show(void) {
    gOverrideHideHud = 0;
 }

+s32 hud_get_value(enum HudDisplayValue type) {
+    switch (type) {
+        case HUD_DISPLAY_LIVES:  return gHudDisplay.lives;
+        case HUD_DISPLAY_COINS:  return gHudDisplay.coins;
+        case HUD_DISPLAY_STARS:  return gHudDisplay.stars;
+        case HUD_DISPLAY_WEDGES: return gHudDisplay.wedges;
+        case HUD_DISPLAY_KEYS:   return gHudDisplay.keys;
+        case HUD_DISPLAY_FLAGS:  return gHudDisplay.flags;
+        case HUD_DISPLAY_TIMER:  return gHudDisplay.timer;
+    }
+    return 0;
+}
+
+void hud_set_value(enum HudDisplayValue type, s32 value) {
+    switch (type) {
+        case HUD_DISPLAY_LIVES:  gHudDisplay.lives  = value; break;
+        case HUD_DISPLAY_COINS:  gHudDisplay.coins  = value; break;
+        case HUD_DISPLAY_STARS:  gHudDisplay.stars  = value; break;
+        case HUD_DISPLAY_WEDGES: gHudDisplay.wedges = value; break;
+        case HUD_DISPLAY_KEYS:   gHudDisplay.keys   = value; break;
+        case HUD_DISPLAY_FLAGS:  gHudDisplay.flags  = value; break;
+        case HUD_DISPLAY_TIMER:  gHudDisplay.timer  = value; break;
+    }
+}
+
+void hud_render_power_meter(s32 health, f32 x, f32 y, f32 width, f32 height) {
+    extern const u8 texture_power_meter_left_side[];
+    extern const u8 texture_power_meter_right_side[];
+    extern const u8 texture_power_meter_full[];
+    extern const u8 texture_power_meter_seven_segments[];
+    extern const u8 texture_power_meter_six_segments[];
+    extern const u8 texture_power_meter_five_segments[];
+    extern const u8 texture_power_meter_four_segments[];
+    extern const u8 texture_power_meter_three_segments[];
+    extern const u8 texture_power_meter_two_segments[];
+    extern const u8 texture_power_meter_one_segments[];
+    static struct TextureInfo sPowerMeterTexturesInfo[] = {
+        { texture_power_meter_left_side,      8, 32, 64 },
+        { texture_power_meter_right_side,     8, 32, 64 },
+        { texture_power_meter_one_segments,   8, 32, 32 },
+        { texture_power_meter_two_segments,   8, 32, 32 },
+        { texture_power_meter_three_segments, 8, 32, 32 },
+        { texture_power_meter_four_segments,  8, 32, 32 },
+        { texture_power_meter_five_segments,  8, 32, 32 },
+        { texture_power_meter_six_segments,   8, 32, 32 },
+        { texture_power_meter_seven_segments, 8, 32, 32 },
+        { texture_power_meter_full,           8, 32, 32 },
+    };
+    djui_hud_render_texture(&sPowerMeterTexturesInfo[0], x, y, width / 64, height / 64);
+    djui_hud_render_texture(&sPowerMeterTexturesInfo[1], x + width / 2, y, width / 64, height / 64);
+    s32 numWedges = MIN(MAX(health >> 8, 0), 8);
+    if (numWedges != 0) {
+        djui_hud_render_texture(&sPowerMeterTexturesInfo[numWedges + 1], x + width / 4, y + height / 4, width / 64,  height / 64);
+    }
+}
+
 ///

 bool warp_to_level(s32 aLevel, s32 aArea, s32 aAct) {
--- a/src/pc/lua/utils/smlua_misc_utils.h
+++ b/src/pc/lua/utils/smlua_misc_utils.h
@ -8,8 +8,33 @@ u32 get_network_area_timer(void);
 s32* get_temp_s32_pointer(s32 initialValue);
 s32 deref_s32_pointer(s32* pointer);

+enum HudDisplayValue {
+    HUD_DISPLAY_LIVES,
+    HUD_DISPLAY_COINS,
+    HUD_DISPLAY_STARS,
+    HUD_DISPLAY_WEDGES,
+    HUD_DISPLAY_KEYS,
+    HUD_DISPLAY_FLAGS,
+    HUD_DISPLAY_TIMER,
+};
+
+enum HudDisplayFlags {
+    HUD_DISPLAY_FLAGS_NONE = 0x0000,
+    HUD_DISPLAY_FLAGS_LIVES = 0x0001,
+    HUD_DISPLAY_FLAGS_COIN_COUNT = 0x0002,
+    HUD_DISPLAY_FLAGS_STAR_COUNT = 0x0004,
+    HUD_DISPLAY_FLAGS_CAMERA_AND_POWER = 0x0008,
+    HUD_DISPLAY_FLAGS_KEYS = 0x0010,
+    HUD_DISPLAY_FLAGS_UNKNOWN_0020 = 0x0020,
+    HUD_DISPLAY_FLAGS_TIMER = 0x0040,
+    HUD_DISPLAY_FLAGS_EMPHASIZE_POWER = 0x8000,
+};
+
 void hud_hide(void);
 void hud_show(void);
+s32  hud_get_value(enum HudDisplayValue type);
+void hud_set_value(enum HudDisplayValue type, s32 value);
+void hud_render_power_meter(s32 health, f32 x, f32 y, f32 width, f32 height);

 bool warp_to_level(s32 aLevel, s32 aArea, s32 aAct);
 bool warp_restart_level(void);