From d325479ab7123ab5f9b434b17bb30898406aaf32 Mon Sep 17 00:00:00 2001
From: Jett <jed.adams@gmail.com>
Date: Sun, 28 Sep 2025 15:19:02 -0400
Subject: [PATCH 1/3] adding core_input_actions

action based input API vs direct input, allows remapping of buttons or keys to an action.
---
 examples/Makefile                  |   1 +
 examples/core/core_input_actions.c | 163 +++++++++++++++++++++++++++++
 2 files changed, 164 insertions(+)
 create mode 100644 examples/core/core_input_actions.c

diff --git a/examples/Makefile b/examples/Makefile
index ee17bb3509d7..6d409b51186c 100644
--- a/examples/Makefile
+++ b/examples/Makefile
@@ -524,6 +524,7 @@ CORE = \
     core/core_input_mouse_wheel \
     core/core_input_multitouch \
     core/core_input_virtual_controls \
+    core/core_input_actions \
     core/core_random_sequence \
     core/core_random_values \
     core/core_render_texture \
diff --git a/examples/core/core_input_actions.c b/examples/core/core_input_actions.c
new file mode 100644
index 000000000000..b9b18c21d5b7
--- /dev/null
+++ b/examples/core/core_input_actions.c
@@ -0,0 +1,163 @@
+
+/*******************************************************************************************
+*
+*   raylib [core_input_actions] example - presents a simple API for remapping input to actions 
+*
+*   Example complexity rating: [★☆☆☆] 1/4
+*
+*   Example originally created with raylib 5.5, last time updated with raylib 5.6
+*
+*   Example contributed by MonstersGoBoom and reviewed by Ramon Santamaria (@raysan5)
+*
+*   Example licensed under an unmodified zlib/libpng license, which is an OSI-certified,
+*   BSD-like license that allows static linking with closed source software
+*
+*   Copyright (c) 2025 MonstersGoBoom
+*
+********************************************************************************************/
+
+/*
+    Simple example for decoding input as actions, allowing remapping of input to different keys or gamepad buttons.
+    for example instead of 
+        IsKeyDown(KEY_LEFT)
+    you'd use
+        IsActionDown(ACTION_LEFT)
+    which can be reassigned to e.g. KEY_A and also assigned to a gamepad button. the action will trigger with either gamepad or keys 
+ */
+
+#include <stdio.h>
+#include <stdlib.h>
+#include <stdbool.h>
+#include "raylib.h"
+//  add your own action types here
+enum
+{
+    NO_ACTION,
+    ACTION_UP,
+    ACTION_DOWN,
+    ACTION_LEFT,
+    ACTION_RIGHT,
+    ACTION_FIRE,
+    MAX_ACTION
+} Action_Type;
+
+//  struct for key and button inputs
+typedef struct
+{
+    int key;
+    int button;
+} Action_Input_t;
+
+//  gamepad index, change this if you have multiple gamepads. 
+int GamePadID = 0;
+static Action_Input_t _actions[MAX_ACTION] = {0};
+
+//  combines IsKeyPressed and IsGameButtonPressed to one action
+bool isActionPressed(int action)
+{
+    if (action<MAX_ACTION)
+        return (IsKeyPressed(_actions[action].key) || IsGamepadButtonPressed(GamePadID, _actions[action].button));
+    return (false);
+}
+
+//  combines IsKeyReleased and IsGameButtonReleased to one action
+bool isActionReleased(int action)
+{
+    if (action<MAX_ACTION)  
+        return (IsKeyReleased(_actions[action].key) || IsGamepadButtonReleased(GamePadID, _actions[action].button));
+    return (false);
+}
+
+//  combines IsKeyDown and IsGameButtonDown to one action
+bool isActionDown(int action) 
+{
+    if (action<MAX_ACTION)  
+        return (IsKeyDown(_actions[action].key) || IsGamepadButtonDown(GamePadID, _actions[action].button));
+    return (false);
+}
+//  define the "default" keyset. here WASD and gamepad buttons on the left side for movement
+void DefaultActions()
+{
+    _actions[ACTION_UP].key = KEY_W;
+    _actions[ACTION_DOWN].key = KEY_S;
+    _actions[ACTION_LEFT].key = KEY_A;
+    _actions[ACTION_RIGHT].key = KEY_D;
+    _actions[ACTION_FIRE].key = KEY_SPACE;
+
+    _actions[ACTION_UP].button = GAMEPAD_BUTTON_LEFT_FACE_UP;
+    _actions[ACTION_DOWN].button = GAMEPAD_BUTTON_LEFT_FACE_DOWN;
+    _actions[ACTION_LEFT].button = GAMEPAD_BUTTON_LEFT_FACE_LEFT;
+    _actions[ACTION_RIGHT].button = GAMEPAD_BUTTON_LEFT_FACE_RIGHT;
+    _actions[ACTION_FIRE].button = GAMEPAD_BUTTON_RIGHT_FACE_DOWN;
+}
+
+//  define the "alternate" keyset. here Cursor Keys and gamepad buttons on the right side for movement
+void CursorActions()
+{
+    _actions[ACTION_UP].key = KEY_UP;
+    _actions[ACTION_DOWN].key = KEY_DOWN;
+    _actions[ACTION_LEFT].key = KEY_LEFT;
+    _actions[ACTION_RIGHT].key = KEY_RIGHT;
+    _actions[ACTION_FIRE].key = KEY_SPACE;
+
+    _actions[ACTION_UP].button = GAMEPAD_BUTTON_RIGHT_FACE_UP;
+    _actions[ACTION_DOWN].button = GAMEPAD_BUTTON_RIGHT_FACE_DOWN;
+    _actions[ACTION_LEFT].button = GAMEPAD_BUTTON_RIGHT_FACE_LEFT;
+    _actions[ACTION_RIGHT].button = GAMEPAD_BUTTON_RIGHT_FACE_RIGHT;
+    _actions[ACTION_FIRE].button = GAMEPAD_BUTTON_LEFT_FACE_DOWN;
+}
+
+int main(int argc, char **argv)
+{
+    const int screenWidth = 800;
+    const int screenHeight = 450;
+    InitWindow(screenWidth, screenHeight, "raylib [core] example - input via actions");
+    SetWindowState(FLAG_WINDOW_RESIZABLE);
+    SetTargetFPS(60);
+
+    //  set defaul actions 
+    char ctrl_set = 0;
+    DefaultActions();
+
+    Vector2 position = (Vector2){100, 100};
+    Vector2 size = (Vector2){32, 32};
+
+    while (!WindowShouldClose()) // Detect window close button or ESC key
+    {
+        //----------------------------------------------------------------------------------
+        BeginDrawing();
+        ClearBackground(DARKGRAY);
+        DrawText(ctrl_set == 0 ? "WASD Default Set" : "Cursor Set", 0, 0, 18, WHITE);
+        DrawText("Tab key toggles keyset", 0, 18, 18, WHITE);
+        DrawRectangleV(position, size, RED);
+        EndDrawing();
+
+        GamePadID = 0; //  set this to gamepad being checked
+        if (isActionDown(ACTION_UP))
+            position.y -= 2;
+        if (isActionDown(ACTION_DOWN))
+            position.y += 2;
+        if (isActionDown(ACTION_LEFT))
+            position.x -= 2;
+        if (isActionDown(ACTION_RIGHT))
+            position.x += 2;
+        if (isActionPressed(ACTION_FIRE))
+        {
+            position.x = (screenWidth-size.x)/2;
+            position.y = (screenHeight-size.y)/2;
+        }
+
+        //  switch control scheme by pressing TAB 
+        if (IsKeyPressed(KEY_TAB))
+        {
+            ctrl_set = !ctrl_set;
+            if (ctrl_set == 0)
+                DefaultActions();
+            else
+                CursorActions();
+        }
+        //----------------------------------------------------------------------------------
+    }
+    CloseWindow(); // Close window and OpenGL context
+    return 0;
+}
\ No newline at end of file

From 85b9fe1438840ef507164b9ea3891492534d3cb6 Mon Sep 17 00:00:00 2001
From: Jett <jed.adams@gmail.com>
Date: Sun, 28 Sep 2025 16:44:46 -0400
Subject: [PATCH 2/3] adjusted formatting.

---
 examples/core/core_input_actions.c | 30 ++++++++++++++++--------------
 1 file changed, 16 insertions(+), 14 deletions(-)

diff --git a/examples/core/core_input_actions.c b/examples/core/core_input_actions.c
index b9b18c21d5b7..633c3ee85755 100644
--- a/examples/core/core_input_actions.c
+++ b/examples/core/core_input_actions.c
@@ -25,12 +25,13 @@
     which can be reassigned to e.g. KEY_A and also assigned to a gamepad button. the action will trigger with either gamepad or keys 
  */
 
+
 #include <stdio.h>
 #include <stdlib.h>
 #include <stdbool.h>
 #include "raylib.h"
 //  add your own action types here
-enum
+typedef enum ActionType
 {
     NO_ACTION,
     ACTION_UP,
@@ -39,24 +40,24 @@ enum
     ACTION_RIGHT,
     ACTION_FIRE,
     MAX_ACTION
-} Action_Type;
+} ActionType;
 
 //  struct for key and button inputs
-typedef struct
+typedef struct ActionInput
 {
     int key;
     int button;
-} Action_Input_t;
+} ActionInput;
 
 //  gamepad index, change this if you have multiple gamepads. 
-int GamePadID = 0;
-static Action_Input_t _actions[MAX_ACTION] = {0};
+int gamepadIndex = 0;
+static ActionInput _actions[MAX_ACTION] = {0};
 
 //  combines IsKeyPressed and IsGameButtonPressed to one action
 bool isActionPressed(int action)
 {
     if (action<MAX_ACTION)
-        return (IsKeyPressed(_actions[action].key) || IsGamepadButtonPressed(GamePadID, _actions[action].button));
+        return (IsKeyPressed(_actions[action].key) || IsGamepadButtonPressed(gamepadIndex, _actions[action].button));
     return (false);
 }
 
@@ -64,7 +65,7 @@ bool isActionPressed(int action)
 bool isActionReleased(int action)
 {
     if (action<MAX_ACTION)  
-        return (IsKeyReleased(_actions[action].key) || IsGamepadButtonReleased(GamePadID, _actions[action].button));
+        return (IsKeyReleased(_actions[action].key) || IsGamepadButtonReleased(gamepadIndex, _actions[action].button));
     return (false);
 }
 
@@ -72,7 +73,7 @@ bool isActionReleased(int action)
 bool isActionDown(int action) 
 {
     if (action<MAX_ACTION)  
-        return (IsKeyDown(_actions[action].key) || IsGamepadButtonDown(GamePadID, _actions[action].button));
+        return (IsKeyDown(_actions[action].key) || IsGamepadButtonDown(gamepadIndex, _actions[action].button));
     return (false);
 }
 //  define the "default" keyset. here WASD and gamepad buttons on the left side for movement
@@ -111,12 +112,13 @@ int main(int argc, char **argv)
 {
     const int screenWidth = 800;
     const int screenHeight = 450;
+
     InitWindow(screenWidth, screenHeight, "raylib [core] example - input via actions");
     SetWindowState(FLAG_WINDOW_RESIZABLE);
     SetTargetFPS(60);
 
     //  set defaul actions 
-    char ctrl_set = 0;
+    char actionSet = 0;
     DefaultActions();
 
     Vector2 position = (Vector2){100, 100};
@@ -127,12 +129,12 @@ int main(int argc, char **argv)
         //----------------------------------------------------------------------------------
         BeginDrawing();
         ClearBackground(DARKGRAY);
-        DrawText(ctrl_set == 0 ? "WASD Default Set" : "Cursor Set", 0, 0, 18, WHITE);
+        DrawText(actionSet == 0 ? "WASD Default Set" : "Cursor Set", 0, 0, 18, WHITE);
         DrawText("Tab key toggles keyset", 0, 18, 18, WHITE);
         DrawRectangleV(position, size, RED);
         EndDrawing();
 
-        GamePadID = 0; //  set this to gamepad being checked
+        gamepadIndex = 0; //  set this to gamepad being checked
         if (isActionDown(ACTION_UP))
             position.y -= 2;
         if (isActionDown(ACTION_DOWN))
@@ -150,8 +152,8 @@ int main(int argc, char **argv)
         //  switch control scheme by pressing TAB 
         if (IsKeyPressed(KEY_TAB))
         {
-            ctrl_set = !ctrl_set;
-            if (ctrl_set == 0)
+            actionSet = !actionSet;
+            if (actionSet == 0)
                 DefaultActions();
             else
                 CursorActions();

From 356a3d0aa43b5146956edc950314a4d77136fdc1 Mon Sep 17 00:00:00 2001
From: Jett <jed.adams@gmail.com>
Date: Sun, 28 Sep 2025 16:47:40 -0400
Subject: [PATCH 3/3] updates for struct name

and fixed a typo
---
 examples/core/core_input_actions.c | 65 +++++++++++++++++-------------
 1 file changed, 37 insertions(+), 28 deletions(-)

diff --git a/examples/core/core_input_actions.c b/examples/core/core_input_actions.c
index 633c3ee85755..b8266a8f4642 100644
--- a/examples/core/core_input_actions.c
+++ b/examples/core/core_input_actions.c
@@ -1,7 +1,7 @@
 
 /*******************************************************************************************
 *
-*   raylib [core_input_actions] example - presents a simple API for remapping input to actions 
+*   raylib [core_inputactionInputs] example - presents a simple API for remapping input to actions 
 *
 *   Example complexity rating: [★☆☆☆] 1/4
 *
@@ -30,7 +30,9 @@
 #include <stdlib.h>
 #include <stdbool.h>
 #include "raylib.h"
+
 //  add your own action types here
+
 typedef enum ActionType
 {
     NO_ACTION,
@@ -51,13 +53,13 @@ typedef struct ActionInput
 
 //  gamepad index, change this if you have multiple gamepads. 
 int gamepadIndex = 0;
-static ActionInput _actions[MAX_ACTION] = {0};
+static ActionInput actionInputs[MAX_ACTION] = {0};
 
 //  combines IsKeyPressed and IsGameButtonPressed to one action
 bool isActionPressed(int action)
 {
     if (action<MAX_ACTION)
-        return (IsKeyPressed(_actions[action].key) || IsGamepadButtonPressed(gamepadIndex, _actions[action].button));
+        return (IsKeyPressed(actionInputs[action].key) || IsGamepadButtonPressed(gamepadIndex, actionInputs[action].button));
     return (false);
 }
 
@@ -65,7 +67,7 @@ bool isActionPressed(int action)
 bool isActionReleased(int action)
 {
     if (action<MAX_ACTION)  
-        return (IsKeyReleased(_actions[action].key) || IsGamepadButtonReleased(gamepadIndex, _actions[action].button));
+        return (IsKeyReleased(actionInputs[action].key) || IsGamepadButtonReleased(gamepadIndex, actionInputs[action].button));
     return (false);
 }
 
@@ -73,41 +75,45 @@ bool isActionReleased(int action)
 bool isActionDown(int action) 
 {
     if (action<MAX_ACTION)  
-        return (IsKeyDown(_actions[action].key) || IsGamepadButtonDown(gamepadIndex, _actions[action].button));
+        return (IsKeyDown(actionInputs[action].key) || IsGamepadButtonDown(gamepadIndex, actionInputs[action].button));
     return (false);
 }
 //  define the "default" keyset. here WASD and gamepad buttons on the left side for movement
 void DefaultActions()
 {
-    _actions[ACTION_UP].key = KEY_W;
-    _actions[ACTION_DOWN].key = KEY_S;
-    _actions[ACTION_LEFT].key = KEY_A;
-    _actions[ACTION_RIGHT].key = KEY_D;
-    _actions[ACTION_FIRE].key = KEY_SPACE;
-
-    _actions[ACTION_UP].button = GAMEPAD_BUTTON_LEFT_FACE_UP;
-    _actions[ACTION_DOWN].button = GAMEPAD_BUTTON_LEFT_FACE_DOWN;
-    _actions[ACTION_LEFT].button = GAMEPAD_BUTTON_LEFT_FACE_LEFT;
-    _actions[ACTION_RIGHT].button = GAMEPAD_BUTTON_LEFT_FACE_RIGHT;
-    _actions[ACTION_FIRE].button = GAMEPAD_BUTTON_RIGHT_FACE_DOWN;
+    actionInputs[ACTION_UP].key = KEY_W;
+    actionInputs[ACTION_DOWN].key = KEY_S;
+    actionInputs[ACTION_LEFT].key = KEY_A;
+    actionInputs[ACTION_RIGHT].key = KEY_D;
+    actionInputs[ACTION_FIRE].key = KEY_SPACE;
+
+    actionInputs[ACTION_UP].button = GAMEPAD_BUTTON_LEFT_FACE_UP;
+    actionInputs[ACTION_DOWN].button = GAMEPAD_BUTTON_LEFT_FACE_DOWN;
+    actionInputs[ACTION_LEFT].button = GAMEPAD_BUTTON_LEFT_FACE_LEFT;
+    actionInputs[ACTION_RIGHT].button = GAMEPAD_BUTTON_LEFT_FACE_RIGHT;
+    actionInputs[ACTION_FIRE].button = GAMEPAD_BUTTON_RIGHT_FACE_DOWN;
 }
 
 //  define the "alternate" keyset. here Cursor Keys and gamepad buttons on the right side for movement
 void CursorActions()
 {
-    _actions[ACTION_UP].key = KEY_UP;
-    _actions[ACTION_DOWN].key = KEY_DOWN;
-    _actions[ACTION_LEFT].key = KEY_LEFT;
-    _actions[ACTION_RIGHT].key = KEY_RIGHT;
-    _actions[ACTION_FIRE].key = KEY_SPACE;
-
-    _actions[ACTION_UP].button = GAMEPAD_BUTTON_RIGHT_FACE_UP;
-    _actions[ACTION_DOWN].button = GAMEPAD_BUTTON_RIGHT_FACE_DOWN;
-    _actions[ACTION_LEFT].button = GAMEPAD_BUTTON_RIGHT_FACE_LEFT;
-    _actions[ACTION_RIGHT].button = GAMEPAD_BUTTON_RIGHT_FACE_RIGHT;
-    _actions[ACTION_FIRE].button = GAMEPAD_BUTTON_LEFT_FACE_DOWN;
+    actionInputs[ACTION_UP].key = KEY_UP;
+    actionInputs[ACTION_DOWN].key = KEY_DOWN;
+    actionInputs[ACTION_LEFT].key = KEY_LEFT;
+    actionInputs[ACTION_RIGHT].key = KEY_RIGHT;
+    actionInputs[ACTION_FIRE].key = KEY_SPACE;
+
+    actionInputs[ACTION_UP].button = GAMEPAD_BUTTON_RIGHT_FACE_UP;
+    actionInputs[ACTION_DOWN].button = GAMEPAD_BUTTON_RIGHT_FACE_DOWN;
+    actionInputs[ACTION_LEFT].button = GAMEPAD_BUTTON_RIGHT_FACE_LEFT;
+    actionInputs[ACTION_RIGHT].button = GAMEPAD_BUTTON_RIGHT_FACE_RIGHT;
+    actionInputs[ACTION_FIRE].button = GAMEPAD_BUTTON_LEFT_FACE_DOWN;
 }
 
+//------------------------------------------------------------------------------------
+// Program main entry point
+//------------------------------------------------------------------------------------
+
 int main(int argc, char **argv)
 {
     const int screenWidth = 800;
@@ -117,7 +123,7 @@ int main(int argc, char **argv)
     SetWindowState(FLAG_WINDOW_RESIZABLE);
     SetTargetFPS(60);
 
-    //  set defaul actions 
+    //  set default actions 
     char actionSet = 0;
     DefaultActions();
 
@@ -160,6 +166,9 @@ int main(int argc, char **argv)
         }
         //----------------------------------------------------------------------------------
     }
+
+    // De-Initialization
+    //--------------------------------------------------------------------------------------    
     CloseWindow(); // Close window and OpenGL context
     return 0;
 }
\ No newline at end of file