Exporturi

BUPA AnimPos expune trei exporturi de client pentru ca alte resurse să poată controla instrumentul programatic. Toate rulează sub numele resursei bupa-animpos.

Open

Deschide instrumentul. Aceasta rulează pipeline-ul complet de verificare — deja în uz, cooldown, permisiuni, restricții de stare și hook-ul Config.CanUse — exact ca și cum jucătorul ar folosi comanda sau tasta atribuită. Returnează true dacă instrumentul s-a deschis efectiv, false în caz contrar.

local opened = exports['bupa-animpos']:Open()
if opened then
    print('Positioning mode started')
end

Close

Solicită închiderea instrumentului dacă acesta este activ în prezent. Aceasta se comportă ca și cum s-ar apăsa anulare — personajul este readus la poziția și orientarea inițiale.

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

IsActive

Returnează o valoare booleană care indică dacă modul de poziționare este în prezent deschis pentru jucătorul local.

if exports['bupa-animpos']:IsActive() then
    -- e.g. block another interaction while the tool is open
end

Example — pair with an emote menu

-- After playing an emote, let the player nudge it into place
RegisterCommand('fixpos', function()
    if not exports['bupa-animpos']:IsActive() then
        exports['bupa-animpos']:Open()
    end
end)

Related — the CanUse config hook

Dincolo de exporturi, Config.CanUse este un hook pe partea de client care rulează la fiecare încercare de deschidere (inclusiv prin Open()). Returnează false pentru a bloca și, opțional, un mesaj sub formă de șir de caractere care va fi afișat jucătorului. Acesta este locul ideal pentru logica de restricționare specifică serverului (luptă, daune, stări customizate).

Config.CanUse = function()
    -- return false, 'You cannot do this right now!'
    return true
end