Skip to content

Installation

Installation

Dependencies

Before installing, make sure ox_lib is present and started on your server. It is a hard dependency.

Steps

  1. Place the bupa-animpos folder inside your resources directory (for example resources/[bupa]/bupa-animpos).
  2. Ensure the resource in your server.cfg after ox_lib.
  3. Set Config.Framework in config.lua to match your server.
  4. (Optional) Configure ACE permissions if you use Config.Permission.Type = 'ace'.
  5. Set your language with the ox:locale convar.
  6. Restart the server.

server.cfg — ensure order

ox_lib must start before BUPA AnimPos.

server.cfg
ensure ox_lib
ensure bupa-animpos

Framework

Open config.lua and set the framework value. This drives which core resource is loaded and which metadata restrictions apply.

config.lua
Config.Framework = 'qbox'   -- qbox / qbcore / esx / standalone
ℹ

On standalone and esx, framework metadata restrictions (dead / last stand / handcuffed) are skipped — only the native checks (vehicle / falling / swimming) apply.

ACE permission (only if Type = 'ace')

If you enable permissions with Type = 'ace', grant the ACE object defined in Config.Permission.Ace (default animpos.use) to the principals that should be allowed. Add the line to your server.cfg or a permissions config.

server.cfg
# allow a whole group
add_ace group.admin animpos.use allow

# or allow a specific principal
add_ace identifier.license:xxxxxxxxxxxxxxxx animpos.use allow

Language

Set the active language globally via the ox:locale convar. It must be a setr (replicated) convar so the client can read it.

server.cfg
setr ox:locale "tr"

Available codes: en, tr, de, fr, es, pt, ru. See the Localization page for details.

PreviousBUPA AnimPosNext Usage & Controls