⚡ Marvel Rivals - Lua API Documentation

-- Default hero script
-- This script is called every frame (60-144+ times per second)
function on_game_tick(ctx, helpers, config)
    -- ctx: Game state (player info, enemies, abilities, etc.)
    -- helpers: Utility functions (UseAbility, CountEnemiesInFOV, etc.)
    -- config: Your script configuration values

    return true
end

function on_game_tick(ctx, helpers, config)
    if ctx.has_aimbot_target then
        local target = helpers.GetAimbotTarget()
        if target and helpers.IsLookingAt(target.actor_state, 5) then
            if helpers.CanDoAction() then
                helpers.UseAbility(helpers.PRIMARY_ATTACK)
            end
        end
    end
    return true
end

function on_game_tick(ctx, helpers, config)
    -- Count enemies in FOV within 20 meters
    local enemies = helpers.CountVisibleEnemiesInFOV(200, 20)

    -- Use ultimate if 3+ enemies nearby
    if enemies >= 3 and helpers.CanDoAction() then
        -- Check if ultimate is ready
        if ctx.abilities[7] and ctx.abilities[7][1] then
            local ult = ctx.abilities[7][1]
            if ult.can_activate and not ult.is_blocked then
                helpers.UseAbility(helpers.ULTIMATE)
            end
        end
    end

    return true
end

function on_game_tick(ctx, helpers, config)
    -- Check if player has damage buff
    local has_damage_buff = false
    for _, buff in ipairs(ctx.local_player.buffs) do
        if buff.hash == 123456 then -- Replace with actual buff hash
            has_damage_buff = true
            break
        end
    end

    -- Hold primary attack while buffed
    if has_damage_buff then
        helpers.PressKey(helpers.PRIMARY_ATTACK)
    else
        helpers.ReleaseKey(helpers.PRIMARY_ATTACK)
    end

    return true
end

function on_game_tick(ctx, helpers, config)
    if not helpers.CanDoAction() then
        return true
    end

    local target = helpers.GetClosestVisibleEnemy()
    if not target then
        return true
    end

    -- Combo conditions:
    -- 1. Enemy within 15 meters
    -- 2. Enemy health below 50%
    -- 3. Looking at enemy
    if target.distance_meters < 15 and
       target.health_percentage < 50 and
       helpers.IsLookingAt(target.actor_state, 10) then

        -- Execute combo: E -> Shift -> LMB
        helpers.UseAbility(helpers.ABILITY_1)
    end

    return true
end

function on_game_tick(ctx, helpers, config)
    -- Find low health enemies in range
    local low_health_enemies = {}

    for _, actor in ipairs(ctx.actors) do
        if actor.is_alive and
           not actor.is_same_team and
           actor.is_visible and
           actor.distance_meters < 20 and
           actor.health_percentage < 30 then

            table.insert(low_health_enemies, actor)
        end
    end

    -- If we found low health targets, prioritize them
    if #low_health_enemies > 0 and helpers.CanDoAction() then
        helpers.UseAbility(helpers.MELEE_ATTACK)
    end

    return true
end

-- FVector is a table with X, Y, Z components
local pos = actor.world_position
local x = pos.X
local y = pos.Y
local z = pos.Z