What Raven ships with

Every setting in the config.json the resource ships, with the value it ships, so you can tell what you changed from what came in the box.

Last updated

Every value on this page is read out of the config.json that ships with the latest version of Raven, so it is what you have before you change anything. There are 415 settings across three sections, covering 77 detections: 64 of those ship on, 13 ship off, and 3 kick instead of ban.

At a glance

The detection tables below run one row per detection, not one row per setting. A row tells you whether the detection ships on, what a hit does, and everything else it carries. The nine detections that carry five or more settings beyond Enable and Action get a row that points at their own block further down, because a rule set is a table in its own right and does not read inside a cell.

Every detection name on this page is an anchor, so #antinoclip on the end of the address lands on AntiNoclip, and the names in the three tables that follow are links into the reference.

The detections that ship off

These 13 are switched off in the box. Some are off because they are risky to run unsupervised, and some because they only apply to certain servers. Nothing turns them on for you, so if you assumed Raven was watching for these, it is not. Detections reference says what each one catches.

Turn these on from Protection Rules in the dashboard, not by editing the file.

Two of them want work done before you switch them on. AntiScreenOcr looks for the 117 entries of its Words list on the player's own screen. EntitiesSpawnProtection ships with both of its whitelists empty, so every garage and inventory script on your server is unknown to it. Read Your first hour of tuning and Entities Spawn Protection first.

The three that kick instead of ban

Every other enabled detection ships on ban. These three ship on kick, because each has a failure mode that is far more likely to be a bad connection than a cheat. A kick costs an innocent player a reconnect. A ban costs them an appeal and costs you the time to read it.

CategoryDetections
MainHeartbeat
PlayerstatsAntiGodmode
EntitiesAntiDestroyVehicles

The five switches with no action

These are written as a plain true rather than as an object, so they have no Action and no sub-options. They cannot be set to kick, and Protection Rules shows them without an action dropdown. That is expected and not a bug. In the tables below they are the rows whose Action column is a dash.

Resources installation

Three settings. Enable lets Raven manage which of your other resources it is wired into, Automatic wires it into every one of them on start and on refresh, and WhitelistResources is the list it is kept out of, removed from any that still have it. A resource on that list never gets the protection installed, so the event and native protections do not cover it. Main Settings has the card.

SettingShips
ResourcesInstallation.Enableon
ResourcesInstallation.Automaticon
ResourcesInstallation.WhitelistResources[]

Display

Everything the resource puts on a player's screen: the wording of the connection rejected card, the support link, and the blocks for in-game notifications and admin message alerts.

SettingShips
Display.Ban.TitleConnection Rejected.
Display.Ban.MessageYou got banned for cheating by Raven Anticheat.
Display.Ban.SubTitle1Banned by:
Display.Ban.SubTitle2Ban Reason:
Display.Ban.SubTitle3Ban ID:
Display.Ban.EvidenceView evidence
Display.Ban.GlobalGLOBAL BAN
Display.Linkhttps://ravenac.net/discord
Display.Notifications.Enableon
Display.Notifications.Audienceadmins
Display.Notifications.Types.Banon
Display.Notifications.Types.Kickon
Display.Alerts.Positiontop-center
Display.Alerts.Stylebanner

Three of the defaults carry real line breaks, so they are printed in full here rather than squeezed onto one line of a table. {reason}, {banid} and {link} are filled in when the message is sent, and {link} takes the value of Display.Link above.

Display.Messages.kick
You have been kicked for cheating.
Reason: {reason}
If you believe this is a mistake, you may appeal at:
{link}.
Display.Messages.ban
You have been banned for cheating.
Reason: {reason}
Your ban id: {banid}
If you believe this is a mistake, you may appeal at: {link}.
Display.Ban.Footer
If you believe this is a mistake, you may appeal at:
{link}

Reading the detection tables

Seven categories, 77 detections, 395 settings. The conventions repeat: Enable is whether the detection runs and is the Ships column, Action is what a hit does, a Types or Methods entry is one check inside the detection, a Threshold is how many times something has to happen and a TimeWindow is the number of seconds it has to happen within, and anything named Whitelist or Blacklist is a list. A list cell shows its entries when there are few enough to read and a count when there are not.

Paths are relative to the detection. So Types.Spam.Rules.1.Threshold on AntiExplosionAi is Detections.Pyrotechnics.AntiExplosionAi.Types.Spam.Rules.1.Threshold in full, which is the form the JSON editor and Detections reference use.

Main

DetectionShipsActionEverything else it carries
AntiScreenOcroffbanWords [117 entries]
AntiNuiTamperonbanTypes.Inspector onTypes.Timeout on
ClipboardScanneronbanWords [37 entries]
HeartbeatonkickTypes.Timeout onTypes.Pulse onTypes.Advanced on
AntiStateSpoofingonbanTypes.Model onTypes.Coords onTypes.Weapon onTypes.Vehicle on
AntiExecutoronban5 settings, in its own block below
AntiLuaMenusonbanTextures [24 entries]

AntiExecutor

Five checks. Four ship on and Types.External ships off, so an external executor is not watched for until you turn that one on.

SettingShips
Types.Internalon
Types.BlockInputon
Types.Externaloff
Types.Bypasson
Types.Spoofedon

Playerstats

DetectionShipsActionEverything else it carries
AntiRagdollon--
AntiGodmodeonkickAutomatic offWhitelistZones []
AntiChangeOutfitonban-
AntiInfiniteStaminaoffban-
AntiSuperJumponban-
AntiSpeedHackoffbanTypes.Normal onTypes.Water onTypes.Climb onWhitelistZones []
AntiPedManipulationonban7 settings, in its own block below
AntiVoiceSpoofingonbanMaximum 50.0Whitelist [80, 250]
AntiClearPedTasksonbanTypes.Block offTypes.Normal onTypes.Immediately on
AntiTeleportonbanMethods.1 onMethods.2 onWhitelistZones []
AntiNocliponbanWhitelistZones []
AntiFreecamonbanWhitelistZones []
AntiSpectateonbanWhitelistZones []
AntiBlacklistPedModelonbanBlacklistModels [25 entries]WhitelistZones []
AntiBlacklistAnimationsonbanAnimations [7 entries]WhitelistZones []
AntiNightVisiononbanWhitelistZones []
AntiThermalVisiononbanWhitelistZones []

AntiPedManipulation

Six checks, all on, plus the zone whitelist, which ships empty.

SettingShips
Types.PassiveModeon
Types.PassiveModeLocalon
Types.Untargetableon
Types.NoHomingLockonon
Types.FriendlyFireBypasson
Types.TaserImmunityon
WhitelistZones[]

Resources

DetectionShipsActionEverything else it carries
AntiStartResourcesonban-
AntiStopResourcesonban-
AntiFreezeResourcesonban-
AntiHookNativesonban-
AntiTamperedEnvonban-
AntiResourcesInjectiononbanWhitelistResources []

Entities

DetectionShipsActionEverything else it carries
AntiEntityTakeOveron--
AntiRemoteAttachmenton--
AntiRemoteAttachmentV2on--
AntiControlEntityonban-
AntiDestroyVehiclesonkick-
AntiSpawnIsolatedVehicleonban-
AntiHijackVehicleonban-
AntiVehicleArmorChangeronbanWhitelistZones []
AntiVehicleEngineChangeronbanWhitelistZones []
AntiVehicleColorChangeroffbanWhitelistZones []
AntiBulletProofTiresoffban-
AntiVehiclePlateChangeronbanTypes.Text onTypes.Index onWhitelistZones []
AntiVehicleGravityChangeronban-
AntiCleanVehicleoffbanWhitelistZones []
AntiVehicleLiveryChangeronbanWhitelistZones []
AntiVehicleWindowsChangeroffbanWhitelistZones []
AntiFlipVehicleoffbanWhitelistZones []
AntiVehicleGodmodeonban-
AntiNoVehicleCollisiononban-
AntiVehicleHandlingChangeronban42 settings, in its own block below
AntiVehicleBoostonban-
EntitiesSpawnProtectionoffban12 settings, in its own block below
EntitiesSpamProtectiononban41 settings, in its own block below
EntitiesModelProtectiononbanMode blacklistModels [679 entries]

AntiVehicleHandlingChanger

Forty-one checks, one for each handling value, plus the zone whitelist, which ships empty. Six of the checks ship on: Types.Mass, Types.Acceleration, Types.DriveInertia, Types.TopSpeed, Types.Brakes and Types.Traction. The rest ship off.

SettingShips
Types.Masson
Types.Dragoff
Types.Buoyancyoff
Types.CentreOfMassoff
Types.InertiaMultiplieroff
Types.DriveBiasoff
Types.Gearsoff
Types.Accelerationon
Types.DriveInertiaon
Types.ShiftUpoff
Types.ShiftDownoff
Types.TopSpeedon
Types.Brakeson
Types.BrakeBiasoff
Types.Handbrakeoff
Types.Steeringoff
Types.Tractionon
Types.TractionMinoff
Types.TractionLateraloff
Types.TractionSpringoff
Types.LowSpeedTractionLossoff
Types.Camberoff
Types.TractionBiasoff
Types.TractionLossoff
Types.Suspensionoff
Types.SuspensionCompressionoff
Types.SuspensionReboundoff
Types.SuspensionUpperoff
Types.SuspensionLoweroff
Types.SuspensionRaiseoff
Types.SuspensionBiasoff
Types.AntiRolloff
Types.AntiRollBiasoff
Types.RollCentreFrontoff
Types.RollCentreRearoff
Types.CollisionDamageoff
Types.WeaponDamageoff
Types.DeformationDamageoff
Types.EngineDamageoff
Types.PetrolTankoff
Types.Oiloff
WhitelistZones[]

EntitiesSpawnProtection

Twelve settings, and the detection itself ships off. Types.Pickups and Types.Objects are a single switch each, Types.Peds and Types.Vehicles each carry two methods on top of their switch, and both whitelists ship empty. Entities Spawn Protection is the page to read before you switch it on.

SettingShips
Debugoff
RemoveNPCs.Enableoff
Types.Pickups.Enableon
Types.Peds.Enableon
Types.Peds.Methods.Normalon
Types.Peds.Methods.Aion
Types.Vehicles.Enableon
Types.Vehicles.Methods.Normalon
Types.Vehicles.Methods.Aion
Types.Objects.Enableon
WhitelistModels[]
WhitelistResources[]

EntitiesSpamProtection

The largest detection in the file. Three entity families, each with its own switch and its own four numbered rules, which is twelve independent counters.

SettingShips
Types.Peds.Enableon
Types.Vehicles.Enableon
Types.Objects.Enableon
WhitelistModels[]
WhitelistResources[]
The switches and the two whitelists.
RuletypeThresholdTimeWindow
Types.Peds.Rules.1normal1510
Types.Peds.Rules.2deleted255
Types.Peds.Rules.3nearplayer1010
Types.Peds.Rules.4hidden105
Types.Vehicles.Rules.1normal2010
Types.Vehicles.Rules.2deleted155
Types.Vehicles.Rules.3nearplayer1010
Types.Vehicles.Rules.4launched75
Types.Objects.Rules.1normal2510
Types.Objects.Rules.2deleted105
Types.Objects.Rules.3nearplayer105
Types.Objects.Rules.4stacked105
The twelve rules, four per family.

Events

DetectionShipsActionEverything else it carries
AntiPlaysoundon--
AntiFireEventonbanTypes.Block onTypes.Distance.Enable onTypes.Distance.Maximum 128.0
AiClientEventsProtectionoffbanBlockedEvents []WhitelistEvents [ox_lib:cache:coords]WhitelistResources []
AiServerEventsProtectiononbanBlockedEvents [helpCode]WhitelistEvents [3 entries]WhitelistResources []

Weapons

DetectionShipsActionEverything else it carries
AntiNoReloadoffban-
AntiInfiniteAmmooffban-
AntiSpoofBulletShotonban-
AntiAimbotonban-
AntiAimAssistoffban-
AntiSilentAimonban-
AntiMagicBulletonban-
AntiGiveWeaponsonbanTypes.Ped offTypes.Player on
AntiRemoveWeaponsonbanTypes.Ped offTypes.Player on
AntiSpawnWeaponsonbanWhitelistWeapons []AddonWeapons []
AntiBlacklistWeaponsonbanBlacklistWeapons [12 entries]
AntiNoRecoilonbanWhitelistWeapons []WhitelistZones []
AntiDamageExploitsonban-
AntiSpoofedDamageonbanMethods.1 onMethods.2 on
AntiBlockedDamageonbanMethods.1 onMethods.2 onMethods.3 on
AntiSpamDamageonban15 settings, in its own block below

AntiSpamDamage

Five rules and nothing else. Rules 1 and 2 both count plain damage events, at one second and at three, and rules 3 and 4 count distinct victims and kills instead. Rule 5 has the pattern type, which counts different players hit in a row on the same bone or for the same damage amount. This detection takes up to ten rules. Every other rules list stops at five.

RuletypeThresholdTimeWindow
Rules.1normal151
Rules.2normal503
Rules.3victims105
Rules.4kills1010
Rules.5pattern55

Pyrotechnics

Three detections carrying 60 settings between them, because each one is a set of named checks with its own whitelist plus a spam check with its own rules. The category table is short, and the detail is in the three blocks below it.

AntiExplosionAi

Six named checks on top of the Types.CancelAllExplosions switch, each with its own WhitelistExplosions list, and Types.Fake is the only one that ships with an entry in it.

SettingShips
Types.CancelAllExplosionson
Types.Fake.Enableon
Types.Fake.WhitelistExplosions["11"]
Types.Invisible.Enableon
Types.Invisible.WhitelistExplosions[]
Types.Scale.Enableon
Types.Scale.Maximum1.0
Types.Scale.WhitelistExplosions[]
Types.NoAudio.Enableon
Types.NoAudio.WhitelistExplosions[]
Types.Shake.Enableon
Types.Shake.Maximum3.0
Types.Shake.WhitelistExplosions[]
Types.Spam.Enableon
Types.Spam.WhitelistExplosions[]
The checks and their explosion whitelists.
RuletypeThresholdTimeWindow
Types.Spam.Rules.1normal105
Types.Spam.Rules.2cluster64
Types.Spam.Rules.3spread85
The three spam rules.

AntiParticleAi

Two named checks on top of the Types.CancelAllParticles switch, with the scale cap at 1.0 and both whitelists empty.

SettingShips
Types.CancelAllParticleson
Types.Scale.Enableon
Types.Scale.Maximum1.0
Types.Scale.WhitelistParticles[]
Types.Spam.Enableon
Types.Spam.WhitelistParticles[]
The checks and their particle whitelists.
RuletypeThresholdTimeWindow
Types.Spam.Rules.1normal155
Types.Spam.Rules.2cluster84
Types.Spam.Rules.3spread125
The three spam rules.

AntiProjectileAi

Two named checks on top of the Types.CancelAllProjectiles switch, with the distance cap at 100 and both whitelists empty.

SettingShips
Types.CancelAllProjectileson
Types.Distance.Enableon
Types.Distance.Maximum100
Types.Distance.WhitelistWeapons[]
Types.Spam.Enableon
Types.Spam.WhitelistWeapons[]
The checks and their weapon whitelists.
RuletypeThresholdTimeWindow
Types.Spam.Rules.1normal205
Types.Spam.Rules.2cluster154
Types.Spam.Rules.3spread205
The three spam rules.