Influence

api.ragebot.addTargetFilter(
    fn: (player: Player, info: RagebotTargetFilterInfo) -> boolean,
    priority: number?
): RegistrationHandle

api.ragebot.addShotGate(
    fn: (shot: RagebotShotGateInfo) -> boolean,
    priority: number?
): RegistrationHandle

api.ragebot.forceTarget(
    player: Player | string | number,
    durationSec: number?
): ForceTargetHandle?

api.ragebot.clearForcedTarget(): ()

api.ragebot.clearInFlight(player: Player?): ()

api.ragebot.setStrafeOverride(
    fn: (strafe: RagebotStrafeInfo) -> (CFrame | Vector3)?,
    priority: number?
): RegistrationHandle

{
    cframe = CFrame.new(...),           -- the strafe CFrame so far (after the built-in orbit + higher-priority overrides already ran lower in the chain)
    position = Vector3.new(...),        -- cframe.Position, for convenience
    targetPosition = Vector3.new(...),  -- the enemy you're orbiting (nil if unknown); a Vector3 return auto-faces this
    origin = Vector3.new(...),          -- your real HumanoidRootPart position this tick
    isVoid = false,                     -- true on the built-in void-spam tick (you can ignore it and do your own)
    distance = 20,                      -- the Strafe Distance slider
    height = 0,                         -- the Strafe Height slider
    dt = 0.0167,                        -- frame delta
    angle = 1.57,                       -- current built-in orbit angle (radians)
    player = somePlayer,                -- the target Player (nil if unknown)
    time = os.clock(),
}

handle:Release()           -- undo the registration
handle:IsReleased()        -- true if already released
handle:GetPriority()       -- current priority

handle:Release()           -- stop forcing
handle:IsReleased()        -- true if already released
handle:GetPlayer()         -- the player being forced

-- Don't shoot friends
api.ragebot.addShotGate(function(shot)
    return shot.player == nil or shot.player.Name ~= "FriendName"
end)

-- Only rage a VIP for 5 seconds
local handle = api.ragebot.forceTarget("EnemyName", 5)
-- handle:Release() to cancel early

-- Custom void spam (Rivals): every ~0.1s flick to a far void position, else keep the default strafe
if api.ragebot.setStrafeOverride then
    local lastFlick = 0
    local voiding = false
    api.ragebot.setStrafeOverride(function(strafe)
        if strafe.time - lastFlick >= 0.1 then
            lastFlick = strafe.time
            voiding = not voiding
        end
        if voiding then
            -- huge position; the override keeps your facing toward the target
            return Vector3.new(1e6, strafe.position.Y, 1e6)
        end
        return nil -- keep the built-in orbit
    end)
end

-- Tight overhead orbit (Rivals): ignore the built-in shape, orbit a fixed radius above the enemy
if api.ragebot.setStrafeOverride then
    api.ragebot.setStrafeOverride(function(strafe)
        local t = strafe.targetPosition
        if not t then return nil end
        local r = 12
        return Vector3.new(
            t.X + math.cos(strafe.angle) * r,
            t.Y + 8,
            t.Z + math.sin(strafe.angle) * r
        )
    end, 10)
end