FiniAC Documentation

Appearance

Installation ​

FiniAC is designed for simplicity - just drag and drop the resource into your server, add a few lines to your config, and you're protected. No complex setup, no lengthy configuration files, just straightforward installation that gets you up and running in minutes.

Installation Steps ​

1. Download FiniAC ​

Download the latest version of FiniAC from the Server page.

2. Extract the Resource ​

Extract the contents of the zip file into your FiveM resources folder.

Important

If you're installing on a remote server, upload the entire zip archive to the server and extract it there. Do not extract locally and upload individual files as this can cause permission issues and corruption.

Renaming the Resource

The FiniAC folder can be renamed to anything you prefer (e.g., anticheat, ac, finiac). If you rename it, make sure to update the resource name in the following steps.

3. Configure server.cfg ​

Add the following lines to your server.cfg:

ini
# Ensure FiniAC resource starts
ensure FiniAC

# Grant FiniAC command permissions
add_ace resource.FiniAC command allow

Resource Name

If you renamed the FiniAC folder, replace FiniAC with your chosen name in both lines above.

Example for renamed resource:

ini
ensure anticheat
add_ace resource.anticheat command allow

4. Add Authorised IP Address ​

  1. Navigate to the Server page on the FiniAC web panel
  2. Add your game server's IP address under Authorised IPs

Finding the correct IP:

  • If your server has a single public IP, use that IP address
  • If your server uses multiple IPs or a reverse proxy, add the IP address used for outgoing connections
  • To find your outgoing IP, search "what is my ip" from your server's browser or terminal

5. Start Your Server ​

Start your FiveM server and verify that FiniAC loads successfully.

Check the console for:

ini
[FAC] [INFO] Anti-cheat server initialised
[FAC] [INFO] Anti-cheat config received

If you see these messages, FiniAC is installed correctly and ready to use.

Post-Installation ​

Configure Detection Settings ​

  1. Log in to the FiniAC web panel
  2. Navigate to your server's Config page
  3. Review and customize detection settings, blacklisted weapons and other options
  4. Save your configuration

Test the Installation ​

  1. Join your server
  2. Check the Live Logs page
  3. Verify you see connection logs
  4. Check the Apollo Players tab to see real-time player information

Troubleshooting ​

FiniAC Not Starting ​

Issue: FiniAC resource fails to start or shows errors in console.

Solutions:

  1. Verify the resource name in server.cfg matches the folder name
  2. Check that add_ace resource.FiniAC command allow is present in server.cfg
  3. Ensure you extracted the full zip archive on the server
  4. Check file permissions - the resource folder should be readable by the FiveM server

Resource file is invalid ​

Issue: [FAC] Resource file is invalid, aborting AC loading... error in console.

Solutions:

  1. Download and extract the FiniAC resource again
  2. Make sure no other resource, such as another anti-cheat, is injecting into FiniAC
    • Check the last modified dates in the FiniAC resource folder
  3. Ensure the resource is not being committed to the server's Git repository
  4. If you are moving the FiniAC files to a server over an FTP program like WinSCP or FileZilla, make sure to use Binary transfer mode

Players Not Showing in Logs ​

Issue: Players connect but don't appear in logs or Apollo.

Solutions:

  1. Verify FiniAC is actually running (ensure FiniAC in server.cfg)
  2. Check console for any FiniAC error messages by searching for [FAC]
  3. Run fini in your txAdmin console
    • Verify you see [FAC] [WARN] Command not found
    • If you see No such command fini., then FiniAC has not started correctly
  4. Try restarting the FiniAC resource: ensure FiniAC in server console and monitor for errors