Documentation
Common issues
Troubleshooting installation, config sync, dashboard, and keys.
Installation & startup
Anti-Cheat not starting
Ensure you put your license key in auth.lua. On the dashboard go to Redeem → Your keys, copy the key linked to this server, then open the auth.lua file inside the EZAC resource folder and set Key = "your-key-here". Check the server console for Lua errors and ensure OneSync is enabled.
Configuration not applying
Ensure your server has a key redeemed and linked. In the dashboard, select the server under My Servers and confirm a key is shown under Redeem → Your keys for that server. The dashboard pushes config automatically when the key is linked — make sure the key in auth.lua matches the key linked to this server so the resource can receive updates.
Resource fails to start (Lua errors)
Ensure the EZAC folder is in resources and auth.lua exists with valid syntax. Check the server console for the exact error. OneSync must be enabled in your server configuration.
Dashboard & keys
Key invalid or already used
Keys are one per server. Copy the full key from the Redeem page (Your keys). If you already redeemed this key for another server, generate a new key from your Tebex order (Step 1: Get key from Tebex order) and then in Step 2 select this server and redeem the new key.
Cannot see Configuration or Download
Redeem a key for the server first. On the Redeem page, create a server if needed (Step 2 → Create New Server), then get a key from your Tebex order (Step 1) and redeem it for that server (Step 2). Until a key is linked to the server, Configuration and Download are locked.
No servers in the list
Servers are created on the Redeem page. Go to Redeem → Step 2 and click Create New Server. After creating a server, you can redeem a key for it in Step 2.
Whitelist & staff
Whitelist and staff are managed through the dashboard. Go to Dashboard → Admins, select your server, and add admins by Discord ID. Grant In-game admin menu (staff) so they are treated as staff and whitelisted in-game. You do not need to edit auth.lua for dashboard-managed staff.
Players list empty
The dashboard player list is filled by the EZAC resource (live sync every few seconds) and by txAdmin player data when present. EZAC automatically finds and loads txData/default/data/playersDB.json on start and every 60 seconds — no extra setup. If you see no players:
- Ensure the server is running and EZAC is started with a valid key in
auth.lua. - With
EZAC_AUTH.Debug = truein auth.lua, check the server console for "Players sync POST returned status …" — a non-200 code means the dashboard URL or key may be wrong.
If you use a custom txData path, ensure playersDB.json is at txData/<profile>/data/playersDB.json relative to your server root (where FXServer runs). EZAC derives the server root from the resource path.
Support
Join our Discord at discord.gg/ezac for help, key redemption, and setup — use Get Support in the docs sidebar or top bar. For false bans and tuning detections, see Common false bans.