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

  1. 20 seconds after a player spawns (First scan delay), and then every 10 minutes (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.
  2. The server sorts the values by game build and compares each one with the same value from the other players.
  3. 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.
  4. 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:

Output
[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

  1. The player's game measures every reload, except for shotguns and reloads that were interrupted by sprinting, ragdolling or a vehicle.
  2. It also measures running, sprinting and strafing speed (moving while aiming), only on foot and on flat ground.
  3. Once there are enough measurements (Reloads per weapon 4 for 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.
  4. 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.
  5. 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).
  6. 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 in data/integrity.json inside the cxa-anticheat folder. 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.meta or handling.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

OptionKeyDefaultWhat it does
Enabled (switch)Config.GameFiles.Integrity.EnabledtrueTurns the game data scan on or off
PunishmentPunishmentbanWhat happens to a player with modified values
Ban durationBanDuration0Hours, 0 = permanent
ScreenshotScreenshottrueAttaches a screenshot to the log
Minimum playersMinSamples6Players needed before a live value is trusted as normal
Majority shareMajorityShare0.7Share of players that must agree on a value
Mismatches to actMinMismatches2Different values needed before acting
Learn normal valuesLearnBaselinetrueKeeps trusted values in data/integrity.json
First scan delayFirstReportDelay20 sTime after spawning before the first scan
Scan intervalReportInterval10 minTime between two full scans

Animation Timing Settings

OptionKeyDefaultWhat it does
Enabled (switch)Config.GameFiles.Timing.EnabledtrueTurns animation timing on or off
PunishmentPunishmentbanWhat happens to a player who is too fast
Ban durationBanDuration0Hours, 0 = permanent
ScreenshotScreenshottrueAttaches a screenshot to the log
Fast reloadFastReloadtrueChecks reload times
Reload ratioReloadRatio0.65Flags reloads shorter than this share of the normal time
Fast runFastRuntrueChecks running and sprinting speed
Sprint ratioSprintRatio1.2Flags running this many times faster than normal
Strafe boostFastStrafetrueChecks moving speed while aiming
Strafe ratioStrafeRatio1.25Flags strafing this many times faster than normal
Minimum playersMinPlayers3Players with data needed before a live normal value is trusted
Reloads per weaponMinSamples4Reloads of one weapon a player needs before being judged
ConfirmationsConfirmReports2Reports 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_pureLevelWhat players may have
0 or not setAny modified files. CXA's scan does the work
1Only audio and graphics mods
2No modified files at all
OptionKeyDefaultWhat it does
Required pure levelConfig.GameFiles.RequiredPureLevel0The pure level you expect. 0 = off, which is recommended
Raise automaticallyConfig.GameFiles.AutoSetPureLevelfalseRaises 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 1

These detections catch the effect of popular RPF mods directly, without comparing players.

DetectionKeyWhere it runsDefaultWhat it catches
Wall shotWallShotClient (the shooter's game)ban4 hits within 120 seconds on players or peds at least 6 m away that are fully behind solid walls
No fall damageNoFallDamageClientban2 falls of at least 15 m within 10 minutes without losing any health
One punchOnePunchServerbanA punch that deals more than Max punch damage (100). With Block the damage on, the hit is cancelled
Infinite staminaInfiniteStaminaClientkickStamina that never changes during sprints of 25 seconds, 2 times in a row
Instant vehicle exitFastVehicleExitClientkickLeaving 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:

Output
[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:

MessageWhen 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 Timing for that player with PauseDetection(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 2 without warning your players. It blocks every modified file, graphics mods included.

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

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 values field 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 log for 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: 6 for the game data scan, 3 for animation timing.
  • Check that Learn normal values is on and that data/integrity.json exists in the cxa-anticheat folder.
  • Test with a player who is not bypassed. Bypassed staff are never judged.
  • Wait for the scan: the first one runs 20 seconds after spawning, the next ones every 10 minutes.

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_pureLevel in server.cfg. Level 2 blocks every modified file; level 1 allows audio and graphics mods.
  • Set Required pure level to 0 and remove the sv_pureLevel line 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 0 in the panel. Either add sv_pureLevel with that level to server.cfg and restart, or set Required pure level back to 0.
  • The warning only means pure mode is not active. CXA's game file scan keeps running either way.

© 2026 CodeXart Studios · CXA Anticheat