Arma 3 BattlEye Filter Reference & Builder

False-positive kicks from ACE3, CBA, or TFAR? This reference covers all 21 BattlEye filter files, decodes the seven action codes, and gives you an exception builder so you can whitelist mod variables without gutting your security.

Action Codes

Each filter rule starts with one of these codes. Higher numbers are more aggressive.

Code Effect
1 Log to log file only — silent detection, no disruption to players.
2 Log to console only — visible in server console, no persistent log.
3 Log to log file and console — maximum visibility without kicking anyone.
4 Kick player silently — no logging. Avoid; produces no evidence trail.
5 Kick and log to file — recommended default for most kick-worthy rules.
6 Kick and log to console.
7 Kick and log to file and console — most restrictive; reserve for high-value.
Rule syntax: 5 keyword — kick anyone triggering "keyword"  |  5 "phrase with spaces" — quotes for phrases  |  5 "bad" !"allowed" — ! prefix whitelists an exception

Filter Files (21 files)

File Controls
scripts.txt SQF script execution via execVM / call — broadest net; catches most exploit scripts. No regex support.
createvehicle.txt CfgVehicles classnames spawned via createVehicle — prevents spawning restricted objects.
setpos.txt setPos / setPosATL / setPosASL calls — blocks illegal teleportation of objects or players.
setdamage.txt setDamage calls — prevents damage manipulation on vehicles or players.
addbackpackcargo.txt addBackpackCargo / addBackpackCargoGlobal calls — blocks unauthorized backpack injection into containers.
addmagazinecargo.txt addMagazineCargo / addMagazineCargoGlobal calls — blocks ammunition injection into containers.
addweaponcargo.txt addWeaponCargo / addWeaponCargoGlobal calls — blocks weapon injection into containers.
publicvariable.txt publicVariable variable name sent to all clients — monitor for exploit broadcast variable names.
publicvariableval.txt publicVariable value content — second-pass filter on what is actually being broadcast to clients.
setvariable.txt setVariable variable name on any object (JIP-safe) — covers a common RCE vector used by cheaters.
setvariableval.txt setVariable value content — second-pass filter on what value is being assigned to an object variable.
remoteexec.txt remoteExec / remoteExecCall function names — the primary RCE vector in Arma 3; most critical file to configure.
mpeventhandler.txt addMPEventHandler event names — monitors multiplayer event handlers added at runtime.
attachto.txt attachTo calls — prevents attaching objects to players for griefing or exploit chains.
deletevehicle.txt deleteVehicle calls — prevents unauthorized deletion of vehicles or mission-critical objects.
selectplayer.txt selectPlayer calls — guards against identity or character switching exploits.
remotecontrol.txt remoteControl calls — prevents unauthorized remote control of another unit's actions.
teamswitch.txt teamSwitch calls — blocks unauthorized faction or side switching mid-mission.
waypointcondition.txt addWaypoint condition field content — prevents injecting SQF code into AI waypoint conditions.
waypointstatement.txt addWaypoint statement field content — prevents injecting SQF code into AI waypoint action statements.
additemcargo.txt addItemCargo / addItemCargoGlobal calls — blocks injecting generic items (vests, uniforms, gear) into containers.

scripts.txt does not support regex — use plain string matching only. All other files support regular expressions.

Exception Builder

Select the filter file triggering the false positive, enter the variable or keyword being flagged, and copy the exception line.

Enter a keyword above to generate the exception line.

Community Starter Pack

Common exceptions for ACE3, CBA_A3, and TFAR. Copy the block for the relevant file into your BattlEye folder.

File: remoteexec.txt — Whitelist ACE3 remote execution functions to prevent false-positive kicks during medical, explosives, and interaction systems.

13 exception lines 
// ACE3 — add to remoteexec.txt
!5 "ace_common_fnc_remoteExecute"
!5 "ace_medical_fnc_handleDamage"
!5 "ace_medical_fnc_setUnconscious"
!5 "ace_medical_fnc_treatment"
!5 "ace_medical_fnc_addToTriageCard"
!5 "ace_explosives_fnc_setFuseParameters"
!5 "ace_interaction_fnc_showMouseHint"
!5 "ace_cargo_fnc_loadItem"
!5 "ace_cargo_fnc_unloadItem"
!5 "ace_repair_fnc_repairVehicle"
!5 "ace_dragging_fnc_dropObject"
!5 "ace_respawn_fnc_notifyRespawn"
Private Arma 3 hosting

Run your own Arma 3 server.

Rent a private Arma 3 server on real hardware — full control-panel access, your mods, your configs, your rules. It's your server; run it your way.

Rent a Arma 3 server Real hardware · Full control panel · 98% SLA

Don't want to run it yourself? Our managed services & consulting team will set it up and keep it running for you — game servers, Windows, Linux, and cloud, from 10+ years of MSP work.