Modified Game Files
Some cheats are not menus but edited game files. GTA V keeps its data in RPF archives, and illegal RPF mods change values inside them: weapon damage and recoil, reload speed, running and strafing speed, fall damage or punch damage. FiveM's pure mode can block every modified file, but it also blocks legal graphics, sound and visual mods. CXA finds the illegal edits without pure mode, so your players can keep their graphics packs.
The Scan Learns From Your Players
CXA decides what is normal by comparing players with each other. On a new server it needs a few players with clean game files online at the same time before it can judge anyone. Read The Learned Baseline to see what that means for small servers.
How It Works
Two checks work together. Both compare each player with the rest of your server, because a modified file makes one player different from everybody else.
- Game data scan (
Integrity) reads gameplay values from the player's game and compares them with the values of the other players. - Animation timing (
Timing) measures how fast a player reloads, runs and strafes and compares it with everyone else.
Related detections catch the effects of other popular RPF mods directly: wall shots, no fall damage, one punch, infinite stamina and instant vehicle exits. See Related Detections.
Game Data Scan
20seconds after a player spawns (First scan delay), and then every10minutes (Scan interval), the player's game reads a fixed set of values:- For a list of common weapons: damage, clip size, recoil, fire rate, spread and recoil recovery.
- The size of the two default player models.
- For a list of common vehicles: top speed, acceleration, braking and traction.
- The server sorts the values by game build and compares each one with the same value from the other players.
- When at least Minimum players (
6) have reported a value and at least Majority share (0.7, so 70%) of them agree, that value counts as normal. - If a player differs from the normal value in at least Mismatches to act (
2) values, CXA applies the punishment as Modified game files (illegal RPF) (ModifiedGameFiles).
The log lists every value that did not match, with the normal value in brackets, for example:
[CXA] John (ID: 12) -> Modified game files (illegal RPF) [ban] mismatches: 2, values: w:WEAPON_PISTOL:recoil=0.000 (0.300); w:WEAPON_PISTOL:spread=0.000 (1.500)The values in this example are made up. w: is a weapon value, v: a vehicle value and p: a player model value.
Animation Timing
- The player's game measures every reload, except for shotguns and reloads that were interrupted by sprinting, ragdolling or a vehicle.
- It also measures running, sprinting and strafing speed (moving while aiming), only on foot and on flat ground.
- Once there are enough measurements (Reloads per weapon
4for each weapon, and enough speed samples), the game sends the results to the server, at most every two and a half minutes when they change. - The server takes the median value of the players on the same game build as normal. It needs at least Minimum players (
3) players for that. - A reload shorter than Reload ratio (
0.65) of the normal time is Fast reload (illegal RPF) (FastReload). Running faster than Sprint ratio (1.2) times normal is Fast run (illegal RPF) (FastRun). Strafing faster than Strafe ratio (1.25) times normal is Strafe boost (illegal RPF) (FastStrafe). - A value must be suspicious in Confirmations (
2) reports in a row before CXA acts.
Bypassed staff are never judged, and their timing data is not used to work out what is normal.
The Learned Baseline
A live comparison needs several players online at the same time. To protect small servers and quiet hours, CXA remembers the normal values it has seen.
- Learn normal values (
LearnBaseline, on by default) stores every trusted value indata/integrity.jsoninside thecxa-anticheatfolder. The file is saved every 10 minutes and when the anticheat stops. - With fewer players online than a live comparison needs, CXA compares against the stored value instead, so even a single player can be checked.
- If at least 3 players online share the same value, CXA does not flag them based on the stored value alone. This keeps a change that affects many players at once from being treated as cheating.
- Values are stored per game build and per data fingerprint. The data fingerprint is a checksum of the data files (such as
weapons.metaorhandling.meta) that your resources load. When you add, remove or change such a resource, the fingerprint changes and CXA starts learning fresh for the new set, so your own weapon or vehicle edits are never treated as cheats. - The same setting controls learning for Animation timing.
What This Means for Small Servers
Until CXA has seen at least 6 players at once (3 for Animation timing), it has nothing to compare against, and the scan stays quiet. Once it has learned the normal values, they protect you even when only one player is online. The comparison always follows the majority: if most of your players run the same modified file, that file becomes the normal value.
To start learning from scratch, stop the server and delete data/integrity.json.
Configuration
Open Configuration → Game files (RPF) in the panel.
Game Data Scan Settings
| Option | Key | Default | What it does |
|---|---|---|---|
| Enabled (switch) | Config.GameFiles.Integrity.Enabled | true | Turns the game data scan on or off |
| Punishment | Punishment | ban | What happens to a player with modified values |
| Ban duration | BanDuration | 0 | Hours, 0 = permanent |
| Screenshot | Screenshot | true | Attaches a screenshot to the log |
| Minimum players | MinSamples | 6 | Players needed before a live value is trusted as normal |
| Majority share | MajorityShare | 0.7 | Share of players that must agree on a value |
| Mismatches to act | MinMismatches | 2 | Different values needed before acting |
| Learn normal values | LearnBaseline | true | Keeps trusted values in data/integrity.json |
| First scan delay | FirstReportDelay | 20 s | Time after spawning before the first scan |
| Scan interval | ReportInterval | 10 min | Time between two full scans |
Animation Timing Settings
| Option | Key | Default | What it does |
|---|---|---|---|
| Enabled (switch) | Config.GameFiles.Timing.Enabled | true | Turns animation timing on or off |
| Punishment | Punishment | ban | What happens to a player who is too fast |
| Ban duration | BanDuration | 0 | Hours, 0 = permanent |
| Screenshot | Screenshot | true | Attaches a screenshot to the log |
| Fast reload | FastReload | true | Checks reload times |
| Reload ratio | ReloadRatio | 0.65 | Flags reloads shorter than this share of the normal time |
| Fast run | FastRun | true | Checks running and sprinting speed |
| Sprint ratio | SprintRatio | 1.2 | Flags running this many times faster than normal |
| Strafe boost | FastStrafe | true | Checks moving speed while aiming |
| Strafe ratio | StrafeRatio | 1.25 | Flags strafing this many times faster than normal |
| Minimum players | MinPlayers | 3 | Players with data needed before a live normal value is trusted |
| Reloads per weapon | MinSamples | 4 | Reloads of one weapon a player needs before being judged |
| Confirmations | ConfirmReports | 2 | Reports in a row that must agree before acting |
Screenshots also need Configuration → System → Screenshots and the screenshot-basic resource. See Screenshots.
Pure Mode (Optional)
Pure mode is FiveM's own setting for modified game files, the sv_pureLevel convar (a server setting in server.cfg). You do not need it: CXA finds illegal RPFs by itself. Use it only if you want to block more than CXA does.
sv_pureLevel | What players may have |
|---|---|
0 or not set | Any modified files. CXA's scan does the work |
1 | Only audio and graphics mods |
2 | No modified files at all |
| Option | Key | Default | What it does |
|---|---|---|---|
| Required pure level | Config.GameFiles.RequiredPureLevel | 0 | The pure level you expect. 0 = off, which is recommended |
| Raise automatically | Config.GameFiles.AutoSetPureLevel | false | Raises sv_pureLevel when the anticheat starts if server.cfg sets it lower |
The panel places both under Configuration → Game files (RPF) → Pure mode (optional). If you want pure mode, set it in server.cfg as well, so it is active from the first second after a restart:
# Optional: only audio and graphics mods may join
sv_pureLevel 1Related Detections
These detections catch the effect of popular RPF mods directly, without comparing players.
| Detection | Key | Where it runs | Default | What it catches |
|---|---|---|---|---|
| Wall shot | WallShot | Client (the shooter's game) | ban | 4 hits within 120 seconds on players or peds at least 6 m away that are fully behind solid walls |
| No fall damage | NoFallDamage | Client | ban | 2 falls of at least 15 m within 10 minutes without losing any health |
| One punch | OnePunch | Server | ban | A punch that deals more than Max punch damage (100). With Block the damage on, the hit is cancelled |
| Infinite stamina | InfiniteStamina | Client | kick | Stamina that never changes during sprints of 25 seconds, 2 times in a row |
| Instant vehicle exit | FastVehicleExit | Client | kick | Leaving a vehicle in less than 300 ms, or at more than 15 m/s without ragdolling, 3 times in a row |
You find them here in the panel:
- Wall shot and No fall damage: Configuration → Client detections.
- One punch: Configuration → Server detections.
- Infinite stamina and Instant vehicle exit: Configuration → Game files (RPF).
Wall shot draws lines from the shooter's head to the victim's head, spine and pelvis. A hit only counts when the map blocks all three lines; vehicles and props do not count as walls.
Anti Strafe
Anti strafe (Config.Client.AntiStrafe) is not a detection but a protection. When a player changes direction more than Direction changes per second (4) times while aiming, the game holds their movement in one direction for Hold time (250 ms). This stops left-right spamming (ADAD) in gunfights. It is on by default and is under Configuration → System → Client.
ScriptHookV
ScriptHookV loads .asi trainers such as Menyoo into the game. FiveM only lets them join when sv_scriptHookAllowed is on. Block ScriptHookV (Config.Network.BlockScriptHook, on by default) keeps that convar off. If your server.cfg turned it on, CXA turns it off again when it starts and prints:
[CXA] sv_scriptHookAllowed was on, ScriptHookV mod menus could join. CXA turned it off, also remove it from server.cfg.Remove the sv_scriptHookAllowed line from server.cfg after you see this message. The setting is under Configuration → Network & rules → Network hardening, see Network Convars.
Console Messages
When the anticheat starts, the console tells you which mode protects you against modified game files:
| Message | When you see it |
|---|---|
[CXA] Illegal RPF scanner active without pure mode (sv_pureLevel 0), legal graphics mods can still join. | Required pure level is 0. This is the normal case |
[CXA] Pure mode (sv_pureLevel) is 1, modified game files cannot join. | Required pure level is above 0 and sv_pureLevel is high enough |
[CXA] sv_pureLevel is 0, required 1. Players with illegal RPF mods can join! Add: sv_pureLevel 1 to server.cfg and restart. | Required pure level is above 0, but sv_pureLevel is lower and could not be raised. Shown in yellow and also sent to the Admin Discord channel |
[CXA] sv_pureLevel raised to 1 for new connections. Add it to server.cfg so it also applies right after a restart. | Raise automatically was on and CXA raised the level |
The numbers in these lines show your own values. The first two lines only appear when Startup message is on in Configuration → General.
Recommendations
Recommended:
- Keep Required pure level at
0. CXA's scan catches illegal RPFs and your players keep their graphics mods. - Leave Learn normal values on, so the scan also works with few players online.
- Keep Screenshot on for these detections, so you can review a ban later.
- Let scripts that make a player faster on purpose, for example a drug effect, pause
Timingfor that player withPauseDetection(src, 'Timing', seconds).
Avoid:
- Lowering Minimum players or Majority share far below the defaults. With fewer players, a single cheater has more weight in what counts as normal.
- Raising the ratios of Animation timing so far that a real speed boost no longer stands out.
- Turning on pure level
2without warning your players. It blocks every modified file, graphics mods included.
Related Features
Detections & Punishments
- All game file detections use the same punishments, cooldowns and alerts as every other detection.
- See Detections & Punishments.
Bypass & Pause Exports
PauseDetection(src, 'Timing', seconds)pauses the timing measurements for one player.- Use it for scripts that change reload or running speed on purpose.
- See Bypass & Pause Exports.
Network Convars
- Block ScriptHookV keeps
.asitrainers out. - See Network Convars.
Screenshots
- Game data scan and Animation timing attach a screenshot by default.
- See Screenshots.
Common Problems
An Honest Player Was Banned for "Modified game files"
What you see: A player says they only use a graphics mod, but they were banned with Modified game files (illegal RPF).
How to fix it:
- Read the
valuesfield of the log. It shows which weapon or vehicle values differed and what the normal value was. - Ask the player which mods they use. Some packs that are sold as graphics mods also change weapon or vehicle files.
- If you are not sure, remove the ban, set Punishment to
logfor a while and watch whether the same values come back. - Raise Mismatches to act if single values cause bans on your server.
The Scan Never Flags Anyone
What you see: No Modified game files logs at all, even when you test with a known modified file.
How to fix it:
- Make sure enough players were online at the same time for CXA to learn normal values:
6for the game data scan,3for animation timing. - Check that Learn normal values is on and that
data/integrity.jsonexists in thecxa-anticheatfolder. - Test with a player who is not bypassed. Bypassed staff are never judged.
- Wait for the scan: the first one runs
20seconds after spawning, the next ones every10minutes.
Players Get "Fast run" While a Script Speeds Them Up
What you see: Players are flagged with Fast run (illegal RPF) after a script gave them a speed boost.
How to fix it:
- Let the script call
PauseDetection(src, 'Timing', seconds)for the duration of the effect. - If the boost is permanent for some players, raise Sprint ratio or turn off Fast run.
Players With Graphics Mods Cannot Join
What you see: Players with legal graphics mods are rejected when they connect.
How to fix it:
- Look for
sv_pureLevelinserver.cfg. Level2blocks every modified file; level1allows audio and graphics mods. - Set Required pure level to
0and remove thesv_pureLevelline if you want all graphics mods to join. CXA's scan keeps catching illegal RPFs. - If Raise automatically is on, CXA raises the level again on every start. Turn it off.
"sv_pureLevel is 0, required 1"
What you see: The console prints sv_pureLevel is 0, required 1. Players with illegal RPF mods can join! Add: sv_pureLevel 1 to server.cfg and restart.
How to fix it:
- You set Required pure level above
0in the panel. Either addsv_pureLevelwith that level toserver.cfgand restart, or set Required pure level back to0. - The warning only means pure mode is not active. CXA's game file scan keeps running either way.
© 2026 CodeXart Studios · CXA Anticheat