API Documentation

for enemy in objManager.ienemies do
    if enemy:isValidTarget(600) then
        if enemy.healthPercent < 0.5 then
            player:attack(enemy)
        end
    end
end

for enemy in objManager.ienemies do
    if enemy:isValidTarget(1200) then
        -- Check if enemy has our mark
        if enemy:hasBuff("zedpassivecd") then
            local buffTime = enemy:getBuffTime("zedpassivecd")
            if buffTime > 2 then
                -- Safe to engage
                player:attack(enemy)
            end
        end
    end
end

local target = TargetSelector.getLowHP(600)
if target then
    -- Predict where they'll be in 0.5s
    local predictedPos = target:predictPosition(0.5)
    -- Attack them
    player:attack(target)
    -- Move away from their position
    local awayPos = player.pos + (player.pos - predictedPos):normalize() * 100
    player
        :move(awayPos.x, awayPos.y, awayPos.z)
end

for minion in objManager.ienemyminions do
    if minion:isValidTarget(600) then
        local aaDamage = damage.autoattack(player, minion)
        -- Last hit if we can kill it
        if minion.health < aaDamage then
            player:attack(minion)
            break
        end
    end
end

local bestPosition = nil
local maxHits = 0
for enemy in objManager.ienemies do
    if enemy:isValidTarget(1000) then
        -- Count enemies in AOE range
        local nearbyEnemies = objManager.getEnemiesInRange(300, enemy)
        if #nearbyEnemies > maxHits then
            maxHits = #nearbyEnemies
            bestPosition = enemy.pos
        end
    end
end
if maxHits >= 2 then
    player
        :castSpell("pos", 3, bestPosition)
end

local enemies = objManager.getEnemiesInRange(1000, player)
if #enemies >= 3 then
    -- Too many enemies, retreat
    player:move(safePosition)
end

local input = {
    delay = 0.25,
    radius = 70,
    range = 1000,
    speed = 1400,
    type = SkillshotType.Line,
    collisionFlags = Collision_Minions
}
local prediction = pred.get_prediction(target, input)
if prediction.hitChance >= HitChance_High then
    player
        :castSpell("pos", 0, prediction.castPosition)
end

for enemy in objManager.ienemies do
    if enemy:isValidTarget(900) then
        -- Check if they're stunned/rooted/snared
        if pred.is_immobile(enemy) then
            local timeImmobile = pred.time_until_mobile(enemy)
            -- If they're immobile for at least 1s, guaranteed hit
            if timeImmobile >= 1.0 then
                player
                    :castSpell("pos", 3, enemy.pos)
            end
        end
    end
end

local target = TargetSelector.getLowHP(1000)
if target then
    local qDmg = damage.spell(player, target, 0)
    local wDmg = damage.spell(player, target, 1)
    local eDmg = damage.spell(player, target, 2)
    local rDmg = damage.spell(player, target, 3)
    local aaDmg = damage.autoattack(player, target) * 2
    local totalDamage = qDmg + wDmg + eDmg + rDmg + aaDmg
    if totalDamage > target.health * 1.2 then
        -- We can kill with 20% safety margin
        print("All-in: " .. totalDamage .. " > " .. target.health)
    end
end

-- Check if we can kill with Q+W+E combo
local spellMask = (1<<0) | (1<<1) | (1<<2) -- Q | W | E
for enemy in objManager.ienemies do
    if enemy:isValidTarget(800) then
        if damage.isKillable(enemy, spellMask, true) then
            -- Execute combo
            player:castSpell("obj", 0, enemy)
            player:castSpell("obj", 1, enemy)
            player:castSpell("obj", 2, enemy)
        end
    end
end

local selector = TargetSelector()
    :setMode(TargetMode.LowHP)
    :range(1000)
    :onlyKillable()
    :excludeClones()
    :notUnderTower()
local target = selector:execute()
if target then
    player:attack(target)
end

-- Prioritize low HP enemies that are closer
local target = TargetSelector()
    :setMode(TargetMode.Custom)
    :range(1000)
    :customScore(function(enemy)
        local hpScore = (1 - enemy:healthPercent()) * 100
        local distScore = (1000 - enemy:dist(player)) / 10
        return hpScore + distScore
    end)
    :execute()
if target then
    player:attack(target)
end

if player:spellState(0) == SpellState.Ready then
    local target = TargetSelector.getClosest(1000)
    if target then
        player
            :castSpell("pos", 0, target.pos)
    end
end

local qReady = player:spellState(0) == SpellState.Ready
local wReady = player:spellState(1) == SpellState.Ready
local eReady = player:spellState(2) == SpellState.Ready
if qReady and wReady and eReady then
    local target = TargetSelector.getLowHP(800)
    if target then
        player:castSpell("obj", 0, target)
        player:castSpell("obj", 1, target)
        player:castSpell("obj", 2, target)
    end
end

-- Find direction away from enemies
local enemyDir = Vector3(0, 0, 0)
local enemyCount = 0
for enemy in objManager.ienemies do
    if enemy:dist(player) < 1000 then
        enemyDir = enemyDir + (enemy.pos - player.pos)
        enemyCount = enemyCount + 1
    end
end
if enemyCount > 0 then
    -- Normalize and go opposite direction
    local escapeDir = geometry.normalize(-enemyDir)
    local escapePos = player.pos + escapeDir * 400
    player
        :move(escapePos.x, escapePos.y, escapePos.z)
end

local target = TargetSelector.getClosest(1000)
if target then
    local castPos = target.pos
    local skillshotWidth = 80
    -- Check if other enemies are in the line
    local hitCount = 0
    for enemy in objManager.ienemies do
        if geometry.intersectLine(player.pos, castPos,
                                 enemy.pos, skillshotWidth) then
            hitCount = hitCount + 1
        end
    end
    print("Can hit " .. hitCount .. " enemies")
end

events::on<OnSpellCastEvent>(function(event)
    if event.caster.isEnemy then
        print("Enemy cast: " .. event.spellName)
        -- Dodge if it's a dangerous spell
        if event.spellName == "LuxLightBinding" then
            local dodgePos = player.pos + player.dir * 200
            player
                :move(dodgePos.x, dodgePos.y, dodgePos.z)
        end
    end
end)

events::on<OnTickEvent>(function()
    -- Main script logic runs every tick
    local target = TargetSelector.getClosest(1000)
    if target and target:isValidTarget(900) then
        -- Combo logic
        if player:spellState(0) == SpellState.Ready then
            local pred = pred.get_prediction(target, qInput)
            if pred.hitChance >= HitChance_High then
                player
                    :castSpell("pos", 0, pred.castPosition)
            end
        end
    end
end)

events::on<OnBuffAddEvent>(function(event)
    if event.target.isMe and event.buffName == "zhonyasringshield" then
        print("Zhonya's active! Invulnerable for 2.5s")
    end
    -- Track enemy buffs
    if event.target.isEnemy and event.buffName == "summonerexhaust" then
        print(event.target.charName .. " exhausted!")
    end
end)

Thread-safe key-value storage for frequently accessed game data.

• Automatic expiration with configurable TTL
• O(1) hash-based lookups
• Built-in statistics and monitoring

-- Cache enemy positions with 2 second TTL
cb.add(cb.CB_TICK, function()
    for enemy in objManager.ienemies do
        if enemy:isValidTarget() then
            local key = "pos_" .. enemy.networkID
            cache.set(key, enemy.pos, 2.0)
        end
    end
end)
-- Later, retrieve cached position
local cachedPos = cache.get("pos_" .. enemy.networkID)
if cachedPos then
    -- Use cached position for calculations
    local distance = player.pos:dist(cachedPos)
end

-- Calculate and cache combo damage
function getComboDamage(target)
    local cacheKey = "combo_" .. target.networkID
    if cache.has(cacheKey) then
        return cache.get(cacheKey)
    end
    -- Expensive calculation
    local qDmg = damage.spell(player, target, 0)
    local wDmg = damage.spell(player, target, 1)
    local eDmg = damage.spell(player, target, 2)
    local total = qDmg + wDmg + eDmg
    -- Cache for 0.5 seconds
    cache.set(cacheKey, total, 0.5)
    return total
end
-- Use cached damage
local dmg = getComboDamage(enemy)
if dmg > enemy.health then
    -- Execute combo
end

-- Cache spell data to avoid repeated lookups
function getSpellData(spellName)
    local cacheKey = "spell_" .. spellName
    if cache.has(cacheKey) then
        return cache.get(cacheKey)
    end
    local spellData = SpellDB.get(spellName)
    cache.set(cacheKey, spellData, 60) -- Cache for 1 minute
    return spellData
end
-- Monitor cache performance
local stats = cache.stats()
print("Cache hit rate: " .. (stats.hits / (stats.hits + stats.misses) * 100) .. "%")

• Fast lookups: O(1) average case using hash tables
• Memory management: Automatic cleanup of expired entries
• Thread safety: Minimal lock contention for concurrent access
• Low overhead: Negligible performance impact for cache hits

Best used for: expensive calculations, database queries, position predictions, and frequently accessed data.

Detect, analyze, and query buffs/debuffs on any game unit.

• Real-time detection with duration tracking
• Stack counting and type classification
• Extensive buff database with metadata

cb.add(cb.CB_TICK, function()
    local me = player
    -- Check if we're stunned or rooted
    if me:hasBuff("stun") or me:hasBuff("root") then
        -- Cancel combo, we can't move
        return
    end
    -- Check for silence (can't cast spells)
    if me:hasBuff("silence") then
        -- Skip spell casting logic
        return
    end
    -- Proceed with normal logic
end)

-- Track Vayne Silver Bolts stacks
for enemy in objManager.ienemies do
    if enemy:isValidTarget(550) then
        local stacks = enemy:getBuffCount("VayneSilverDebuff")
        if stacks == 2 then
            -- Enemy has 2 stacks, next AA will proc
            print(enemy.charName .. " has 2 silver bolt stacks!")
        end
    end
end
-- Track Darius passive stacks
local target = TargetSelector.get(player, 400)
if target then
    local hemorrhageStacks = target:getBuffCount("dariushemo")
    if hemorrhageStacks >= 5 then
        -- Full passive stacks - DON'T fight!
        print("DANGER: Full Darius passive!")
    end
end

-- Wait for enemy buff to expire before engaging
local target = TargetSelector.get(player, 1000)
if target then
    -- Check if enemy has defensive buff
    if target:hasBuff("summonerbarrier") then
        local remaining = target:getBuffRemaining("summonerbarrier")
        print("Barrier expires in " .. remaining .. "s")
        if remaining < 0.5 then
            -- Barrier about to expire, prepare combo
            prepareCombo(target)
        end
    end
    -- Check steroid buff duration
    if player:hasBuff("LuluW") then
        local duration = player:getBuffDuration("LuluW")
        local remaining = player:getBuffRemaining("LuluW")
        print("Whimsy: " .. remaining .. "/" .. duration .. "s")
        if remaining > 2 then
            -- Plenty of time, play aggressive
            executeCombo(target)
        end
    end
end

-- Debug: Print all buffs on player
local allBuffs = player:getAllBuffs()
print("Active buffs on player:")
for i, buff in ipairs(allBuffs) do
    local remaining = player:getBuffRemaining(buff.name)
    local stacks = player:getBuffCount(buff.name)
    print(string.format(
        "[%d] %s (x%d) - %.1fs remaining",
        i, buff.name, stacks, remaining
    ))
    if buffs.isCC(buff.name) then
        print("  ^^ THIS IS CC!")
    end
end

The module includes a comprehensive JSON database containing metadata for hundreds of League of Legends buffs:

• Buff ID and name: Internal identifiers
• Type classification: Buff, debuff, or neutral
• Scope: Personal, team, or global effects
• Effect type: Damage, healing, shield, movement, etc.
• CC classification: Stun, root, slow, silence, etc.

The Buffs module integrates seamlessly with:

• GameObject: Access buffs on any game unit
• Events: CB_UPDATE_BUFF, CB_REMOVE_BUFF callbacks
• Prediction: Factor in buff effects for movement speed
• Damage: Calculate damage with buff modifiers

Query item data, manage inventory, and use active items.

• Item database with stats and effects
• Inventory queries and purchases
• Active item casting and cooldowns

-- Item IDs
local YOUMUUS = 3142
local ECLIPSE = 6692
local BOTRK = 3153
cb.add(cb.CB_TICK, function()
    local target = TargetSelector.get(player, 1000)
    if not target then return end
    -- Use Youmuu's for speed boost
    if player:hasItem(YOUMUUS) then
        local slot = player:getItemSlot(YOUMUUS)
        if items.getCooldown(slot) == 0 then
            player:useItem(slot)
        end
    end
    -- Use Eclipse when in range
    if player:hasItem(ECLIPSE) and target.dist < 550 then
        local slot = player:getItemSlot(ECLIPSE)
        if items.getCooldown(slot) == 0 then
            player:useItem(slot)
            player:attack(target)
        end
    end
    -- Use BotRK on low HP target
    if player:hasItem(BOTRK) and target:healthPercent() < 50 then
        local slot = player:getItemSlot(BOTRK)
        if items.getCooldown(slot) == 0 then
            player:castSpell("obj", slot, target)
        end
    end
end)

-- Track mythic item completion
local MYTHIC_ITEMS = {
    3152, -- Hextech Rocketbelt
    6653, -- Liandry's Anguish
    3068, -- Sunfire Aegis
    6632, -- Divine Sunderer
}
local hasMythic = false
for _, itemId in ipairs(MYTHIC_ITEMS) do
    if player:hasItem(itemId) then
        hasMythic = true
        local info = items.getInfo(itemId)
        print("Mythic completed: " .. info.name)
        break
    end
end
if not hasMythic then
    print("No mythic item yet - " .. player.gold .. "g available")
end

-- Auto-use defensive items
local ZHONYAS = 3157
local STOPWATCH = 2420
local QSS = 3140
cb.add(cb.CB_TICK, function()
    local me = player
    -- Use Zhonya's when low HP and in danger
    if me:hasItem(ZHONYAS) and me:healthPercent() < 20 then
        local enemiesNearby = 0
        for enemy in objManager.ienemies do
            if enemy:isValidTarget(600) then
                enemiesNearby = enemiesNearby + 1
            end
        end
        if enemiesNearby >= 2 then
            local slot = me:getItemSlot(ZHONYAS)
            if items.getCooldown(slot) == 0 then
                me:useItem(slot)
                print("ZHONYAS ACTIVATED!")
            end
        end
    end
    -- Use QSS to cleanse CC
    if me:hasItem(QSS) then
        if me:hasBuff("stun") or me:hasBuff("root") or me:hasBuff("charm") then
            local slot = me:getItemSlot(QSS)
            if items.getCooldown(slot) == 0 then
                me:useItem(slot)
                print("QSS CLEANSED CC!")
            end
        end
    end
end)

-- Query item information
local itemId = 3089 -- Rabadon's Deathcap
local info = items.getInfo(itemId)
if info then
    print("Item: " .. info.name)
    print("Cost: " .. info.gold.total)
    print("AP: " .. info.stats.abilityPower)
    if items.isActive(itemId) then
        print("Has active component")
    else
        print("Passive item only")
    end
end
-- Check inventory value
local totalGold = 0
for slot = 0, 6 do
    local item = player:getItemInSlot(slot)
    if item then
        local info = items.getInfo(item.id)
        totalGold = totalGold + info.gold.total
    end
end
print("Inventory value: " .. totalGold .. "g")

Item slot numbering:

• Slots 0-5: Main inventory slots (6 items)
• Slot 6: Trinket slot
• Active items: Use via SpellSlot.Item1 through SpellSlot.Item6

Note: Trinkets use SpellSlot.Trinket for casting

The Items module integrates with:

• Damage: Calculate item damage (BotRK, Eclipse, etc.)
• Spells: Cast active items like spells
• GameObject: Query item stats on any unit
• Events: React to item purchases and usage

LINQ-style fluent API for powerful object collection queries.

• Chainable filter, sort, and aggregate operations
• Type-safe with automatic null filtering
• Familiar syntax for C# and JavaScript developers

-- Get 3 lowest HP enemies within 1000 range
local lowHpEnemies = objManager.getObjects()
    :enemies()
    :inRange(player.pos, 1000)
    :sortByHealth()
    :take(3)
    :toVector()
for _, enemy in ipairs(lowHpEnemies) do
    print(enemy.charName .. " has " .. enemy.health .. " HP")
end

-- Count enemies in AOE spell area
local spellPos = Vector3(1000, 0, 2000)
local spellRadius = 400
local enemiesInAOE = objManager.getObjects()
    :enemies()
    :alive()
    :inRange(spellPos, spellRadius)
    :count()
if enemiesInAOE >= 3 then
    -- Cast AOE spell
    player:castSpell("pos", SpellSlot.R, spellPos)
end

-- Find closest minion below 100 HP for last hitting
local lastHitTarget = objManager.getObjects()
    :minions()
    :enemies()
    :where(function(m) return m.health < 100 end)
    :sortByDistance(player.pos)
    :firstOrNull()
if lastHitTarget then
    player:attack(lastHitTarget)
end

-- Sum total AD of all enemies nearby
local totalEnemyAD = objManager.getObjects()
    :enemies()
    :heroes()
    :inRange(player.pos, 1500)
    :sum(function(e) return e.totalAttackDamage end)
if totalEnemyAD > 500 then
    print("DANGER: High enemy damage nearby!")
end

-- Check if all allies have sufficient HP
local allAlliesSafe = objManager.getObjects()
    :allies()
    :heroes()
    :all(function(a) return a:healthPercent() > 30 end)
if not allAlliesSafe then
    -- Play defensively
    print("Team low on HP - defensive mode")
end