SAFScriptsDocs

Installation

SAF Anticheat is coming soon. These docs describe the build that will ship.

On this page

Requirements

  • OneSync. The server events the checks use only exist with OneSync.
  • Any framework: Qbox, QBCore, ESX, ND Core, ox_core or standalone, detected on its own.
  • Optional: oxmysql for bans and cases. Tables are made on start. Without it, they are kept in bans.json and cases.json in the resource folder.
  • Optional: screenshot-basic for screenshots.

Steps

  1. Put the saf-anticheat folder in your resources folder.
  2. Add it to server.cfg, after your framework and oxmysql:
    server.cfg
    ensure saf-anticheat
  3. Give your staff the panel and alerts:
    server.cfg
    add_ace group.admin ac.staff allow
    add_ace group.admin ac.kick allow
    add_ace group.admin ac.ban allow
    add_ace group.superadmin ac.ip allow
    add_ace group.superadmin ac.exempt allow
  4. Add the engine settings to server.cfg.
  5. Set Config.Discord.Webhook for logs and Config.Screenshots.Webhook for screenshots. Empty turns them off.
  6. Turn on shadow mode for the first week: Config.ShadowMode = true. See Rollout.
  7. Start the server.

The console prints the framework, the storage it uses, how many events the firewall watches, which engine settings are missing, and whether automatic bans are on.

Permissions

ACEGives
ac.staffOpen the panel, see players, flags and cases, get alerts, mark cases, screenshot, warn, spectate, goto, bring, clear a score, see the checks screen
ac.kickKick from the panel
ac.banBan and unban, from the panel and with acban / acunban
ac.ipSee IP addresses
ac.exemptSet a player to log-only for their session

Framework admin groups in Config.AdminGroups (god, admin, superadmin) get every permission. To map permissions differently, see Permissions or replace Bridge.Can in Custom servers.

Updating

Replace every file except your custom/ folder. Keep your config changes in custom/shared/ so an update doesn't undo them. See Custom servers.

SAF Scripts by San Andreas' Finest StoreDiscordsupprot@safrp.org

Not affiliated with or endorsed by Rockstar Games, Take-Two Interactive or Cfx.re.