GTerm

Garry's Mod external console software.

Client Installation

• Download the latest release.
• Launch the gterm executable whenever Garry's Mod is running.
• Restart Garry's Mod to complete the installation.
• Enjoy!

Server Installation (steamcmd)

• Download the latest release of gterm.
• Move the .dll (even on macos/linux!) under srcds/garrysmod/lua/bin (if the bin folder doesnt exist, create it).
• In srcds/garrysmod/lua/includes/init.lua add at the top of the file require("gterm").
• Restart the server.
• Launch the gterm executable.
• Enjoy!

IMPORTANT NOTE: GTerm communicates with the gmod module over a localhost TCP socket (127.0.0.1:27514), so GTerm must run on the same host as the server. If you run your server inside a docker container or any other sandbox, run GTerm inside that same sandbox (or otherwise share the loopback interface).

In case GTerm does NOT detect your Garry's Mod CLIENT installation

• Download the latest release of gterm.
• Move the .dll (even on macos/linux!) under GarrysMod/garrysmod/lua/bin (if the bin folder doesnt exist, create it).
• In GarrysMod/garrysmod/lua/menu/menu.lua add at the bottom of the file require("gterm").
• Restart Garry's Mod.
• Voila!

WebSocket API

GTerm includes a WebSocket server for console streaming and command execution.

Setup:

1. Enable API in Config.json: "API": true
2. Connect WebSocket clients to ws://localhost:27512/ws/

Configuration Options:

{
  "API": true,
  "APIPort": 27512,
  "APISecret": "your_secret_here"
}

Example Payloads:

Sending commands (text message):

status

Receiving console output (JSON):

{
  "Time": 1704123456,
  "Data": [
    {
      "Color": { "R": 255, "G": 255, "B": 255, "A": 255 },
      "Text": "hostname: My Server\n"
    }
  ]
}

MCP Server Integration

GTerm includes an MCP (Model Context Protocol) server for AI agents such as Cursor, Vscode, Zed, Claude Code, etc..

Setup:

1. Enable MCP in Config.json: "MCP": true
2. (Optional) Set "MCPSecret" for authentication
3. Configure your MCP client to connect to http://localhost:27513 (add ?secret=... if using authentication)

Available Tools:

• run_gmod_command - Execute console commands
• list_gmod_directory - Browse Garry's Mod file structure
• read_gmod_file - Read text files from installation
• execute_lua_code - Execute CLIENT-SIDE Lua code (if you have the permissions to do it)
• capture_console_output - Monitor console output for a specified duration

Configuration Options:

{
  "MCP": true,
  "MCPPort": 27513,
  "MCPCollectionWindowMs": 1000,
  "MCPSecret": "your_secret_here"
}

MCP Client Example (with secret):

{
  "mcpServers": {
    "gterm": {
      "url": "http://localhost:27513?secret=your_secret_here"
    }
  }
}