Skip to main content

​
Overview

ingame.lua contains the major systems that run while the game is being played. It manages:
  • Custom respawn time calculation
  • Team gold balancing
  • Buyback status enforcement
  • Tower strength scaling
  • Troll-combo banning
  • The global mutator system
  • In-game event listeners (purchases, level-ups, reconnects, order filters)
The module defines the Ingame singleton class and is lazily required by pregame.lua and commands.lua.

​
The Ingame class

Ingame = class({})

​
Ingame:init()

Called once after the heroes have spawned. Wires up all in-game subsystems and registers Custom Game Event listeners. 
function Ingame:init()
    self:handleRespawnModifier()
    self:initGoldBalancer()
    self:checkBuybackStatus()
    self:addStrongTowers()
    self:loadTrollCombos()
    self:AddTowerBotController()
    self:initGlobalMutator()

    -- vote flags (set to true when the vote passes)
    self.voteEnabledCheatMode      = false
    self.voteDoubleCreeps          = false
    self.voteDisableAntiKamikaze   = false
    self.voteDisableRespawnLimit   = false
    self.voteEnableFatOMeter       = false
    self.voteEnableRefresh         = false
    self.voteEnableBuilder         = false
    self.voteAntiRat               = false

    -- respawn escalation thresholds
    self.timeToIncreaseRespawnRate    = 2400  -- 40 minutes
    self.timeToIncreaseRepawnInterval = 600
    self.timeToStopBalancingMechanic  = 1200  -- 20 minutes
end

​
10v10 player colour map

Player colours for the 10v10 layout are stored in self.playerColors, indexed by playerID. Values are {R, G, B} where each component is in the 0–255 range. 
self.playerColors    = {}
self.playerColors[0] = { 57, 117, 231 }     -- Blue
self.playerColors[1] = { 122, 241, 187 }    -- Teal
self.playerColors[2] = { 172, 10, 174 }     -- Purple
self.playerColors[3] = { 243, 234, 33 }     -- Yellow
self.playerColors[4] = { 240, 111, 19 }     -- Orange
self.playerColors[5] = { 255, 0, 0 }        -- Red
self.playerColors[6] = { 0, 66, 255 }       -- Dark Blue
self.playerColors[7] = { 25, 230, 185 }     -- Salmon / Seafoam
self.playerColors[8] = { 84, 0, 129 }       -- Indigo
self.playerColors[9] = { 255, 252, 0 }      -- Gold
-- Spectator / observer slots
self.playerColors[15] = { 254, 186, 14 }    -- Amber
self.playerColors[16] = { 32, 192, 0 }      -- Green
self.playerColors[17] = { 252, 255, 236 }   -- Off-white
self.playerColors[18] = { 150, 150, 151 }   -- Grey
self.playerColors[19] = { 126, 191, 241 }   -- Light Blue

​
Function reference

Registers a listener on the entity_killed game event. When a hero dies it calculates a modified respawn time:
function Ingame:handleRespawnModifier()
    ListenToGameEvent('entity_killed', function(keys)
        local respawnModifierPercentage = OptionManager:GetOption('respawnModifierPercentage')
        local respawnModifierConstant   = OptionManager:GetOption('respawnModifierConstant')
        -- ...
        timeLeft = timeLeft * (respawnModifierPercentage / 100) + respawnModifierConstant
    end, self)
end
After 40 minutes (timeToIncreaseRespawnRate = 2400 s) the respawn rate increases further unless voteDisableRespawnLimit is true.
Sets up a periodic timer that tracks gold disparity between Radiant and Dire. When a significant imbalance is detected, the losing team receives periodic gold injections to keep the game competitive.Key fields written:
  • self.radiantBalanceMoney / self.direBalanceMoney
  • self.radiantTotalBalanceMoney / self.direTotalBalanceMoney
  • self.timeImbalanceStarted
Balancing stops after timeToStopBalancingMechanic (1 200 s / 20 minutes).
Enforces the buybackCooldownConstant option. Listens for buyback events and applies a flat cooldown on top of the standard Dota buyback timer when the option is non-zero.
Reads OptionManager:GetOption('strongTowers') and OptionManager:GetOption('towerCount'). Iterates all map towers and scales HP/damage accordingly. Also handles the middleTowers option that adds extra towers to the mid lane.
Reads scripts/kv/troll_combos.kv (or the ban list from the current option set) and populates the internal troll-combo list. When OptionManager:GetOption('banTrollCombos') is true, ability picks that match a troll combo are rejected during selection.
Reads all active mutator options (vampirism, killstreakPower, cooldownReduction, explodeOnDeath, etc.) from OptionManager and applies them as global modifiers to every hero and creep in the game. Each mutator is backed by a modifier_*_mutator Lua class registered in pregame.lua.
Fires 4 seconds after a player reconnects. Sends lodAttemptReconnect to resync the client’s UI state and re-colours neutral items in the shop.
Awards an extra ability point at levels 23 and 24 (which the base game does not grant). Also recalculates the hero’s death XP reward using a custom formula:
local function GetXPForLevel(x)
    if x == 1 then return 100
    elseif x < 8 then return 20 * (x + 4)
    elseif x == 8 then return 330
    else return GetXPForLevel(x - 1) + 110
    end
end
Order filter registered on the game mode entity. Blocks glyph use when the team’s glyph is already active (custom fortify system). Also blocks neutral item purchases when OptionManager:GetOption('neutralItems') == 0.
Broadcasts a formatted notification message to all clients. Used by cheat commands to announce what was used and by whom.

​
Vote flags

The following boolean fields on the Ingame singleton are set to true when the corresponding player vote passes:
FieldCommand that sets itEffect
voteEnabledCheatMode-enablecheat / -ecUnlocks cheat commands
voteDoubleCreeps-doublecreeps / -dcSets neutralMultiply to 2
voteDisableAntiKamikaze-enablekamikaze / -ekRemoves kamikaze penalty
voteDisableRespawnLimit-enablerespawn / -erFreezes respawn escalation
voteEnableFatOMeter-enablefat / -efActivates the Fat-O-Meter
voteEnableRefresh-enablerefreshRefreshes cooldowns on death
voteEnableBuilder-enablebuilder / -ebOpens the ingame hero builder
voteAntiRat-antirat / -arLocks Tier-3 towers until earlier tiers fall

Build docs developers (and LLMs) love

Get started for freeTalk to us