Overrides

handle:OverrideValue(value, priority?) forces a control to act as if it has a certain value, without changing what the user sees in the menu. Whatever the user picked still shows in the UI; the rest of Limerence reads your value instead. Use this when you want to temporarily turn a feature on or off (or push a slider somewhere) without fighting the user’s own setting.

The higher the priority, the more it wins. Default is 0.
Multiple overrides can be active at once. When the highest-priority one is released, the next-highest takes over.
A bolt icon appears next to the control’s name while any override is active. Hovering it tells the user which script is doing it (“My Script is overriding this value.”).

Also documented on ElementHandle.

OverrideHandle

The handle you get back lets you change or undo the override.

override:Release()              -- undo the override
override:IsReleased()           -- true if already released
override:GetValue()             -- current forced value
override:SetValue(newValue)     -- change the forced value
override:GetPriority()          -- current priority
override:SetPriority(newPrio)   -- change the priority

On unload

You don’t have to call :Release() yourself. Every override you make is released automatically when your script unloads.

Example

local trigger = api.ui.find("legitbot.trigger.enabled")
local force = trigger:OverrideValue(true, 50)

-- Later, when your condition expires:
force:Release()

Example: change priority based on game state

local fovEl = api.ui.find("legitbot.aim.fov")
local fovOverride = fovEl:OverrideValue(180, 10)

-- Boost the priority while some flag is true, then drop it back when false.
local active = false
api.utility.connect(SomeSignal, function(state)
    if state and not active then
        fovOverride:SetPriority(100)
        active = true
    elseif not state and active then
        fovOverride:SetPriority(10)
        active = false
    end
end)

-- No need to clean up, it's released for you when the script unloads.

Getting started

Concepts

OverrideHandle

On unload

Example

Example: change priority based on game state

​OverrideHandle

​On unload

​Example

​Example: change priority based on game state

OverrideHandle

On unload

Example

Example: change priority based on game state