> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/DarkoniusXNG/Legends-of-Dota-Redux/llms.txt
> Use this file to discover all available pages before exploring further.

# commands.lua

> Player chat commands: vote, debug, and cheat commands

## Overview

`commands.lua` defines the `Commands` class and its single entry point `Commands:OnPlayerChat(keys)`. All player-typed commands are routed through this function.

## Entry point

### `Commands:OnPlayerChat(keys)`

`keys.playerid` — the player who typed the message\
`keys.text` — the raw chat string (lowercased before processing)

```lua theme={null}
function Commands:OnPlayerChat(keys)
    local playerID = keys.playerid
    local text     = string.lower(keys.text)

    local command
    local arguments = {}

    for k, v in pairs(util:split(text, " ")) do
        if string.match(v, "-") then
            command = v                              -- dash prefix → command token
        elseif string.match(v, "#") then
            playerID = tonumber(string.sub(v, 2))   -- hash prefix → target player ID
        else
            table.insert(arguments, v)              -- everything else → argument list
        end
    end

    if not command or not playerID then return end
    -- ...
end
```

## Parsing rules

| Token prefix | Meaning             | Example                             |
| ------------ | ------------------- | ----------------------------------- |
| `-`          | Command name        | `-gold`, `-ar`, `-enablecheat`      |
| `#`          | Target player ID    | `#3` targets playerID 3             |
| (none)       | Positional argument | `500` after `-gold` sets the amount |

You can target another player by including `#<playerID>` anywhere in the message:

```
-gold 500 #3
```

Use `-pid` first to discover player IDs.

## The `IsCommand` closure

Inside `OnPlayerChat`, a local closure is created to do prefix-matched command detection:

```lua theme={null}
local function IsCommand(s)
    local len = string.len(s)
    return string.sub(command, 1, len) == s
end
```

This means `-ar` matches `-antirat` and `-antirat` both match `IsCommand("-ar")`.

## Vote commands

Vote commands require a threshold percentage of players to accept before taking effect. They use `util:CreateVoting(...)` internally.

| Command           | Alias | Condition                         | Effect                                       |
| ----------------- | ----- | --------------------------------- | -------------------------------------------- |
| `-antirat`        | `-ar` | `antiRat == 0` and cheat mode off | Enables anti-rat protection on Tier-3 towers |
| `-doublecreeps`   | `-dc` | `neutralMultiply < 2`             | Doubles neutral camp spawns                  |
| `-enablecheat`    | `-ec` | Cheat mode not already on         | Enables cheat mode for all players           |
| `-enablekamikaze` | `-ek` | Anti-kamikaze active              | Disables the kamikaze death penalty          |
| `-enablebuilder`  | `-eb` | Builder not enabled               | Opens the ingame hero builder                |
| `-enablerespawn`  | `-er` | Respawn limit active              | Freezes escalating respawn times             |
| `-enablefat`      | `-ef` | Fat-O-Meter off                   | Activates the Fat-O-Meter mechanic           |
| `-enablerefresh`  | —     | Refresh-on-death off              | Refreshes cooldowns on death                 |
| `-switchteam`     | —     | Team imbalance or single-player   | Moves the player to the other team           |

**Vote thresholds** depend on the map:

* `all_allowed` map: some votes require only **50 %** (e.g. `-antirat`, `-doublecreeps`, `-enablefat`, `-enablerefresh`)
* All other maps: **100 %** required

Example — anti-rat vote:

```lua theme={null}
if IsCommand("-antirat") or IsCommand("-ar") then
    if OptionManager:GetOption('antiRat') == 0 and not Ingame.voteEnabledCheatMode then
        util:CreateVoting(
            "lodVotingAntirat", playerID, 10,
            OptionManager:GetOption('mapname') == 'all_allowed' and 50 or 100,
            function()
                OptionManager:SetOption('antiRat', 1)
                Ingame:giveAntiRatProtection()
                Ingame.voteAntiRat = true
                EmitGlobalSound("Event.CheatEnabled")
            end
        )
    elseif OptionManager:GetOption('antiRat') == 1 then
        util:DisplayError(playerID, "#antiRatAlreadyOn")
    end
end
```

## Debug commands

Always available regardless of cheat mode:

| Command           | Effect                                                                          |
| ----------------- | ------------------------------------------------------------------------------- |
| `-test`           | Sends a test message and prints the map name                                    |
| `-fixhero`        | Re-spawns the player's hero with the correct build (fixes wisp-spawn edge case) |
| `-printabilities` | Broadcasts all of the hero's current abilities to chat                          |
| `-pid`            | Lists every active player ID and hero name in chat                              |
| `-fixcasting`     | Removes and re-adds all talent abilities to fix stuck casting state             |
| `-bot mode`       | Reports whether bots are in early- or late-game mode                            |
| `gg`              | Plays the `Memes.GG` sound when `memesRedux` is active                          |

## Cheat commands

Cheat commands are only available when `util:isSinglePlayerMode()` is `true` **or** `Ingame.voteEnabledCheatMode` is `true`.

| Command                 | Alias                  | Effect                                          |
| ----------------------- | ---------------------- | ----------------------------------------------- |
| `-gold [amount]`        | —                      | Gives `amount` gold (default 100 000)           |
| `-points [n]`           | —                      | Sets hero ability points to `n` (default 1)     |
| `-god`                  | —                      | Toggles `modifier_invulnerable`                 |
| `-nofog`                | —                      | Disables fog of war                             |
| `-fog`                  | —                      | Re-enables fog of war                           |
| `-aghs`                 | `-aghanim`, `-scepter` | Toggles Aghanim's Scepter consumed modifier     |
| `-regen`                | —                      | Toggles fountain regen aura                     |
| `-gem`                  | —                      | Toggles true sight aura                         |
| `-invis`                | —                      | Toggles permanent invisibility                  |
| `-dif [level]`          | —                      | Sets bot difficulty (1–4)                       |
| `-reflect`              | —                      | Toggles spell reflect                           |
| `-spellblock`           | —                      | Toggles spell block                             |
| `-cooldown`             | —                      | Toggles no-cooldown mode                        |
| `-globalcast`           | —                      | Toggles global cast range                       |
| `-wtf`                  | `-wtfmenu`             | Toggles WTF mode (no cooldowns/mana costs)      |
| `-unwtf`                | —                      | Disables WTF mode                               |
| `-lvlup [n]`            | —                      | Levels hero up by `n` (default 1)               |
| `-lvlmax`               | —                      | Instantly sets hero to maximum level            |
| `-item <name>`          | —                      | Gives the named item (e.g. `item_blink`)        |
| `-addability <name>`    | `-giveability`, `-add` | Gives the named ability                         |
| `-removeability <name>` | `-remove`              | Removes the named ability (use `all` to clear)  |
| `-dagger`               | —                      | Gives the dev global-teleport dagger            |
| `-dagon`                | —                      | Gives the dev ultra-dagon                       |
| `-teleport`             | —                      | Gives the dev teleport dagger                   |
| `-startgame`            | —                      | Forces the game clock to start                  |
| `-respawn`              | —                      | Instantly respawns the hero                     |
| `-refresh`              | —                      | Restores HP/mana and ends all cooldowns         |
| `-bot switch`           | —                      | Toggles bots between early- and late-game AI    |
| `-fortify`              | —                      | Fortifies all buildings for both teams          |
| `-fortify_dire`         | —                      | Toggles fountain regen on all Dire buildings    |
| `-fortify_rad`          | —                      | Toggles fountain regen on all Radiant buildings |