Skip to content

Slash Commands

Slash commands let players interact with ggCON and its plugins directly from in-game chat. Type a command starting with / in any chat channel and ggCON responds instantly.

Built-in Commands

/help

Displays all available slash commands, grouped by source.

/help

Output example:

Commands:
  /help - Show available commands
  /unstuck - Teleport a short distance to escape stuck states
  [loot-drops]
    /starter - Claim the Starter Kit drop
  [kill-feed]
    /leaderboard - Show the top players

Commands from plugins are grouped under their plugin ID (in brackets) so you can quickly find what's available.

/unstuck

Frees a player who is stuck in terrain, fallen through the world, or otherwise unable to move, by teleporting them a short distance in a random horizontal direction.

/unstuck

Admin-configurable in Settings → General:

  • Distance — how far the player is moved (default 100 m)
  • Cooldown — how long a player must wait between uses (default 5 hours; set to 0 to disable the cooldown)
  • Require admin approval — when enabled, /unstuck queues the request for an admin to review instead of teleporting immediately. Admins see pending requests via a bell icon in the panel header and can approve or deny each one
  • Discord webhook — optionally post an alert to Discord whenever a new /unstuck request is queued for approval

Dead players can't use /unstuck — they're asked to respawn first.

How It Works

  1. A player types a /command in any chat channel (Local, Global, Squad, Admin)
  2. ggCON detects the command instantly — no log polling delay
  3. The command handler runs and sends a response back to the player as an in-game chat message or notification

Cooldown

Most slash commands share a 5-second per-player cooldown to prevent accidental double-triggers and spam. If a player sends a command during cooldown, it is silently ignored. (Some commands set their own longer cooldown — for example /unstuck.)

Plugin Slash Commands

Plugins can register their own slash commands. Examples from the built-in plugins:

Loot Drops registers a command for each configured drop pack:

  • /starter — claim the "Starter Kit" pack
  • /event-drop — claim the "Event Drop" pack

The command name is configurable per pack.

Quarter Master registers:

  • /shop — sends the player their personal storefront URL with a one-time login PIN

Kill Feed registers:

  • /leaderboard (alias /top) — shows a top-10 leaderboard in chat. Usage: /leaderboard [type] [window], with the two arguments in any order:
    • type — pvp (default), armed (the Armed NPC board; npc also works), animal, or puppet. Plural forms (animals, puppets) are accepted too, and zombie / zombies are aliases for the Puppet board
    • window — 24h, 7d (default), 30d, or all
    • e.g. /leaderboard armed 30d, /top animal

Taxi Service registers:

  • /taxi — lists destinations and fares; /taxi <name> books a ride; /taxi <group> books a ride to a random destination in that group; /taxi cancel cancels a pending ride and refunds the fare

Stash 'n Dash registers:

  • /stash — shows the current dead-drop: the items wanted, the time remaining, and where the drop cabinets are (or tells the player when there's no active drop)

See each plugin's documentation for details on its commands.

Panel-driven plugins

Not every plugin adds slash commands. The ggHaul and Player Spawn Plus plugins are driven entirely from the web panel and register no slash commands — so there's no /fridge, /loadout, or similar to type in chat.

Custom Slash Commands

Admins can create their own slash commands with predefined responses — no plugin required. Go to Settings → Slash Commands in the web panel to add commands like /discord, /rules, or /website.

For each custom command, you configure:

  • Command name — the word after / (e.g., discord)
  • Response text — the message sent back to the player
  • Color — the chat color of the response (Yellow, White, Cyan, Green, Red, Orange)
  • Prefix — optional text prepended to the response (e.g., [INFO])

The response text supports two placeholders that are filled in when the command runs:

  • {playerName} — the name of the player who ran the command
  • {steamId} — that player's Steam ID

Custom commands are registered at startup and when settings are saved. They appear in /help output alongside built-in and plugin commands.

Overriding built-in commands

A custom command may reuse the name of a built-in or plugin command (for example help) to replace its response — useful for translating or rewording built-in replies. Removing the custom command restores the original. Two custom commands cannot share the same name.

Listing registered commands

The GET /slash-commands.json endpoint returns every registered slash command grouped by source (core, custom, and each plugin) — the same data shown in /help.

Requirements

Slash commands work automatically — no additional configuration is needed. They are detected directly from the game engine, so the Log Watcher is not required for slash commands to function (though it is still needed for the Chat and Logs tabs in the panel).