Inicio
// SETUP_GUIDE

Plugin installation

Setup paso a paso, configuración, cvars y endpoints públicos.

Requirements

  • Server with ReHLDS + AMX Mod X 1.9+
  • ReChecker module in addons/rechecker/
  • AMXX sockets module (to talk to the central server)
  • API key — request it from the admin panel after registering your server

1. Download the plugin

The foxac.amxx binary is downloaded from My licenses (Download plugin button on each license). For security it isn't distributed publicly here.

cp foxac.amxx cstrike/addons/amxmodx/plugins/ echo "foxac.amxx" >> cstrike/addons/amxmodx/configs/plugins.ini

On first server start the plugin auto-creates cstrike/addons/amxmodx/configs/FoxAntiCheat/ with foxac.cfg (template with your API key) and foxac_local.log.

2. Paste your API key

Get your API key in My licenses. Edit cstrike/addons/amxmodx/configs/FoxAntiCheat/foxac.cfg:

foxac_api_key   "tu_api_key_aqui"

Restart the server. The plugin validates the license against /api/public/license/validate and, if everything is fine, downloads the signatures and goes live.

3. (Optional) Bans mini-site

From My licenses → Bans mini-site you can customize community name, colors, logo, background, servers and socials, then download a PHP ZIP ready to upload. It connects to the same database and always shows up-to-date bans.

4. How a ban appears

When a player is detected or one already banned joins the network, the plugin notifies via three channels at once:

  • HUD — large message for 6s with nick, reason and severity.
  • Chat (say) — [FoxAC] Player X banned. Reason: Y in color.
  • Console — server console log, client consoles and amxmodx_logs.

5. Auto-ban on connect

With foxac_check_on_connect 1, as soon as a player authorizes their SteamID the plugin checks /api/public/bans/check?steamid=. If they are banned anywhere on the network, they get an immediate kick with the original reason and an announcement to the room.

Available CVars

CVarDefaultDescription
foxac_enabled1Enables the plugin
foxac_api_key""Server license (protected)
foxac_check_on_connect1Kick on connect if already banned
foxac_hud_color"255 60 60"HUD RGB color

Ban policy

SeverityDuration
LOW1 hour
MEDIUM1 day
HIGH7 days
CRITICALPermanent

Public endpoints

  • GET /api/public/license/validatehandshake from the plugin
  • GET /api/public/rechecker.inisignatures for ReChecker
  • GET /api/public/bans/check?steamid=global ban lookup
  • POST /api/public/reportreport a detection