Anti-cheat (bs_guard)

bs_guard is detection only. It logs to MySQL and tells staff. It never kicks, bans, cancels events or deletes entities. You decide. I did it this way because an auto-ban on a false positive costs you a player for good.

Ensure it after bs_core, bs_admin, bs_inventory and bs_config.

Where things are

• Config: bs_guard/config/config_guard.lua. Most thresholds are also in F1, category Anti-cheat (marked (F1) in the file).
• Table: bs_guard_log (migration 028_guard_log.sql). Rows older than Guard.Alerts.keepDays (30) are pruned at start.
• Staff UI: F10 > GUARD tab. Recent detections with player, check, details, confidence. Buttons SPECTATE / GOTO / COPY. /guardspec stops spectating.
• Online staff get a toast when confidence >= Guard.Alerts.minConfidence (50). Same player + same check only once per cooldownMs (30 s), repeats are counted.

Checks

Check	How	Main keys
teleport	position jump in one 1 s sample	Movement.teleportDist (150)
speed	m/s on foot, vehicle, aircraft, N strikes in a row	onFootMax 13, vehicleMax 85, airMax 150, speedStrikes 3
superjump	rise in one sample on foot	jumpRise 5
noclip	rising on foot several samples in a row	noclipRise, noclipStrikes
godmode	hits that don’t lower health/armour, health > 200, armour > 100	Guard.God.*
weapon	holding a weapon you don’t have as an item	Guard.Weapons.*
explosion / ptfx	rate per client	Explosions.maxPerWindow 6, ptfxPerWindow 25
entity	script-created vehicles/peds/objects per client	Entities.maxVehicles 4, maxPeds 45, maxObjects 60
eventspam	net events per client per 10 s	Guard.Events.defaultLimit 40
money	cash+bank gain per minute
items	item gains per minute (opt-in from other resources)

Staff are exempt (bs.admin, bs.superadmin, bs.guard.bypass), plus anything in Guard.Settings.whitelist. Movement and weapon checks skip the first joinGraceMs (20 s) after join, spawn and resource restart.

False positives you will see

• Speed: cars flying off ramps, long falls.
• Noclip: elevators, cable car.
• Teleport: any script that teleports a player without telling bs_guard.
• Money: staff giving money.

Read the confidence and details before you act. If one check is noisy, raise its threshold in F1.

If you add a teleport

Any server-side teleport you write (jail, events, your own scripts) must call exports.bs_guard:Allow(src, 'teleport', ms) before it moves the player, or every use will get flagged. bs_medical, bs_admin and bs_multichar already do.