Exports

BUPA AnimPos exponerar tre client-exports så att andra resurser kan styra verktyget programmatiskt. Alla körs under resursnamnet bupa-animpos.

Open

Öppnar verktyget. Detta kör hela verifieringskedjan — redan-används, cooldown, behörighet, tillståndsbegränsningar och Config.CanUse-hooken — exakt som om spelaren använde kommandot eller tangentbindningen. Returnerar true om verktyget faktiskt öppnades, false annars.

local opened = exports['bupa-animpos']:Open()
if opened then
    print('Positioneringsläget har startats')
end

Close

Begär att verktyget ska stängas om det för närvarande är aktivt. Detta fungerar som att trycka på avbryt — karaktären återställs till sin ursprungliga position och riktning.

exports['bupa-animpos']:Close()

IsActive

Returnerar ett boolskt värde som indikerar om positioneringsläget för närvarande är öppet för den lokala spelaren.

if exports['bupa-animpos']:IsActive() then
    -- t.ex. blockera en annan interaktion medan verktyget är öppet
end

Exempel — kombinera med en emotemeny

-- Efter att ha spelat upp en emoten, låt spelaren finjustera den på plats
RegisterCommand('fixpos', function()
    if not exports['bupa-animpos']:IsActive() then
        exports['bupa-animpos']:Open()
    end
end)

Relaterat — konfigurationshooken CanUse

Utöver exports är Config.CanUse en klientbaserad hook som körs vid varje försök att öppna (inklusive via Open()). Returnera false för att blockera och valfritt en meddelandesträng för att visa spelaren. Detta är den avsedda platsen för serverspecifik begränsningslogik (strid, skada, anpassade tillstånd).

Config.CanUse = function()
    -- return false, 'Du kan inte göra detta just nu!'
    return true
end