feat: make host configurable via env var

Author: S1M0N38

docs/protocol-api.md

@@ -6,10 +6,21 @@ This document provides the TCP API protocol reference for developers who want to
 
 The BalatroBot API establishes a TCP socket connection to communicate with the Balatro game through the BalatroBot Lua mod. The protocol uses a simple JSON request-response model for synchronous communication.
 
-- **Host:** `127.0.0.1` (localhost)
-- **Port:** `12346` (default)
+- **Host:** `127.0.0.1` (default, configurable via `BALATROBOT_HOST`)
+- **Port:** `12346` (default, configurable via `BALATROBOT_PORT`)
 - **Message Format:** JSON
 
+### Configuration
+
+The API server can be configured using environment variables:
+
+- `BALATROBOT_HOST`: The network interface to bind to (default: `127.0.0.1`)
+    - `127.0.0.1`: Localhost only (secure for local development)
+    - `*` or `0.0.0.0`: All network interfaces (required for Docker or remote access)
+- `BALATROBOT_PORT`: The TCP port to listen on (default: `12346`)
+- `BALATROBOT_HEADLESS`: Enable headless mode (`1` to enable)
+- `BALATROBOT_FAST`: Enable fast mode for faster gameplay (`1` to enable)
+
 ### Communication Sequence
 
 The typical interaction follows a game loop where clients continuously query the game state, analyze it, and send appropriate actions:

src/lua/api.lua

@@ -75,16 +75,17 @@ function API.update(_)
     end
 
     API.server_socket:settimeout(SOCKET_TIMEOUT)
+    local host = G.BALATROBOT_HOST or "127.0.0.1"
     local port = G.BALATROBOT_PORT
-    local success, err = API.server_socket:bind("127.0.0.1", tonumber(port) or 12346)
+    local success, err = API.server_socket:bind(host, tonumber(port) or 12346)
     if not success then
       sendErrorMessage("Failed to bind to port " .. port .. ": " .. tostring(err), "API")
       API.server_socket = nil
       return
     end
 
     API.server_socket:listen(1)
-    sendDebugMessage("TCP server socket created on port " .. port, "API")
+    sendDebugMessage("TCP server socket created on " .. host .. ":" .. port, "API")
   end
 
   -- Accept client connection if we don't have one

src/lua/settings.lua

@@ -3,6 +3,7 @@ local headless = os.getenv("BALATROBOT_HEADLESS") == "1"
 local fast = os.getenv("BALATROBOT_FAST") == "1"
 local audio = os.getenv("BALATROBOT_AUDIO") == "1"
 local port = os.getenv("BALATROBOT_PORT")
+local host = os.getenv("BALATROBOT_HOST")
 
 SETTINGS = {}
 
@@ -184,6 +185,7 @@ end
 -- Main setup function
 SETTINGS.setup = function()
   G.BALATROBOT_PORT = port or "12346"
+  G.BALATROBOT_HOST = host or "127.0.0.1"
 
   -- Apply Love2D performance patches
   apply_love_patches()