From 85ac4583d03567aa54da559cea6abbebcfbc1a78 Mon Sep 17 00:00:00 2001
From: Michael Oliver <michael.oliver_@outlook.com>
Date: Sat, 20 Dec 2025 11:39:51 +0000
Subject: [PATCH] feat(IW3 MP): add gsc method `ButtonPressed`

---
 README.md                 | 31 ++++++++++++++++++++++++++++++-
 src/game/iw3/mp/main.cpp  | 28 ++++++++++++++++++++++++++++
 src/game/iw3/mp/structs.h | 35 +++++++++++++++++++++++++++++++++++
 src/game/iw3/mp/symbols.h |  5 +++++
 4 files changed, 98 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index a1b9a7c..77e69a3 100644
--- a/README.md
+++ b/README.md
@@ -63,7 +63,7 @@ GSC Entity fields:
 
 - `self.noclip = <bool>` - toggles noclip
 - `self.ufo = <bool>` - toggles ufomode
-- `self.god = <bool>` - toggles godmode
+- `self.entityflags = <int>` - gentity flags e.g. `1` is godmode
 
 GSC Functions:
 
@@ -76,6 +76,35 @@ GSC Methods:
 - `NightVisionButtonPressed`
 - `SetVelocity` - Changes current player velocity. `self setVelocity((0, 0, 300)); // Go up.`
 - `CloneBrushModelToScriptModel`
+- **HOST ONLY** `ButtonPressed` e.g. `self ButtonPressed("DPAD_DOWN")` - See **keynames** below for valid button identifiers.
+
+<details>
+<summary>keynames</summary>
+
+```
+BUTTON_A
+BUTTON_B
+BUTTON_X
+BUTTON_Y
+BUTTON_LSHLDR
+BUTTON_RSHLDR
+BUTTON_START
+BUTTON_BACK
+BUTTON_LSTICK
+BUTTON_RSTICK
+BUTTON_RTRIG
+BUTTON_LTRIG
+DPAD_UP
+DPAD_DOWN
+DPAD_LEFT
+DPAD_RIGHT
+APAD_UP
+APAD_DOWN
+APAD_LEFT
+APAD_RIGHT
+```
+
+</details>
 
 ### Loading single-player maps
 
diff --git a/src/game/iw3/mp/main.cpp b/src/game/iw3/mp/main.cpp
index 4090f39..ce0fa51 100644
--- a/src/game/iw3/mp/main.cpp
+++ b/src/game/iw3/mp/main.cpp
@@ -1454,6 +1454,33 @@ void PlayerCmd_GetRightMove(scr_entref_t entref)
     Scr_AddInt(cl->lastUsercmd.rightmove);
 }
 
+int CL_IsKeyPressed(const int localClientNum, const char *keyName)
+{
+    const int keynum = Key_StringToKeynum(keyName);
+    if (keynum >= 0)
+        return playerKeys[0].keys[keynum].down;
+    else
+        return 0;
+}
+
+void PlayerCmd_ButtonPressed(scr_entref_t entref)
+{
+    if (entref.classnum != 0)
+        Scr_ObjectError("not an entity");
+
+    char *button = Scr_GetString(0);
+    if (!button || !*button)
+        Scr_Error("usage: <client> buttonPressed(<button name>)");
+
+    // toupper
+    for (char *p = button; *p; p++)
+        if (*p >= 'a' && *p <= 'z')
+            *p -= 32;
+
+    const int keypressed = CL_IsKeyPressed(0, button);
+    return Scr_AddInt(keypressed);
+}
+
 void PlayerCmd_SetVelocity(scr_entref_t entref)
 {
     if (entref.classnum != 0)
@@ -1596,6 +1623,7 @@ IW3_MP_Plugin::IW3_MP_Plugin()
     Scr_AddMethod("getrightmove", PlayerCmd_GetRightMove, 0);
     Scr_AddMethod("setvelocity", PlayerCmd_SetVelocity, 0);
     Scr_AddMethod("nightvisionbuttonpressed", PlayerCmd_NightVisionButtonPressed, 0);
+    Scr_AddMethod("buttonpressed", PlayerCmd_ButtonPressed, 0);
 
     SV_ClientThinkDetour = Detour(SV_ClientThink, SV_ClientThinkHook);
     SV_ClientThinkDetour.Install();
diff --git a/src/game/iw3/mp/structs.h b/src/game/iw3/mp/structs.h
index 84a3b2f..4eb2559 100644
--- a/src/game/iw3/mp/structs.h
+++ b/src/game/iw3/mp/structs.h
@@ -2674,6 +2674,41 @@ static_assert(sizeof(cgs_t) == 15972, "");
 #define YAW 1
 #define ROLL 2
 
+struct field_t
+{
+    int cursor;
+    int scroll;
+    int drawWidth;
+    int widthInPixels;
+    float charHeight;
+    int fixedSize;
+    char buffer[256];
+};
+
+struct KeyState
+{
+    int down;
+    int repeats;
+    const char *binding;
+};
+
+enum LocSelInputState : __int32
+{
+    LOC_SEL_INPUT_NONE = 0x0,
+    LOC_SEL_INPUT_CONFIRM = 0x1,
+    LOC_SEL_INPUT_CANCEL = 0x2,
+};
+
+struct PlayerKeyState
+{
+    field_t chatField;
+    int chat_team;
+    int overstrikeMode;
+    int anyKeyDown;
+    KeyState keys[256];
+    LocSelInputState locSelInputState;
+};
+
 } // namespace mp
 } // namespace iw3
 
diff --git a/src/game/iw3/mp/symbols.h b/src/game/iw3/mp/symbols.h
index a41deef..7b5100b 100644
--- a/src/game/iw3/mp/symbols.h
+++ b/src/game/iw3/mp/symbols.h
@@ -198,6 +198,11 @@ static auto Scr_AddSourceBuffer =
     reinterpret_cast<char *(*)(const char *filename, const char *extFilename, const char *codePos, bool archive)>(
         0x822212C0);
 
+typedef int (*Key_StringToKeynum_t)(const char *str);
+static Key_StringToKeynum_t Key_StringToKeynum = reinterpret_cast<Key_StringToKeynum_t>(0x822D69A8);
+
+static PlayerKeyState *playerKeys = reinterpret_cast<PlayerKeyState *>(0x8242AB38);
+
 // Variables
 static auto cgArray = reinterpret_cast<cg_s **>(0x823F28A0);
 static auto cgsArray = reinterpret_cast<cgs_t *>(0x823F2890);