Basics

Actions, modes & numbers

Everything that is the same for all detections: what LOG and BAN mean, the Enforcement switch, and the values that show up on many of them.

Action on a detection

LOG

Written to the panel. Nothing happens to the player.

BLOCK

The thing was stopped (explosion cancelled, entity not created), the player stays.

KICK

The player is removed from the server after about 3 seconds (time for the screenshot). They can join again.

BAN

A ban is created with a 6-digit Ban ID and the player is removed. One player gets one ban: more hits while they are leaving do not create more bans.

Enforcement switch

Log only

Every detection only logs, whatever its own row says. Use it while you set ByteAC up.

Custom

Every detection does exactly what its own row on the Protection page says (Off, Log, Kick or Ban).

Off (per row)

The check does not run and nothing is written.

Server, client, both

Server

The server measures it from what it sees itself (positions, damage events, entities). The player cannot hide or fake it.

Client

The ByteAC script inside the player's game reports it. Good signal, but a cheat that replaces the client could hide it. These records carry source: client.

Both

Checked in both places. The record's source field says which one fired.

Values that appear on many detections

source

"client" or "server": which side measured it.

target / victim / blamed

In-game server ID (the number next to a player's name, e.g. #55) of the other player who was affected, at that moment. IDs are given out again after a player leaves, so check the time.

weapon / held

GTA weapon hash. 2725352035 = fists (WEAPON_UNARMED). The same hash can appear as a negative number. Use Hash lookup.

model

GTA model hash of a vehicle, ped or object. Use Hash lookup or search the model name in your server files.

coords

[x, y, z] in metres, rounded. x/y can be pasted into the Live map.

damage

Damage of one hit in GTA health points. A living player has health from 101 (down) to 200 (full) plus up to 100 armor.

distance

Metres.

seconds / silentFor

Seconds.

count / perSecond / perMinute / per10s

How many in the time window the limiter uses.

_ev

Internal: one-time upload ticket for the screenshot. Never shown in the panel.

Screenshots (evidence)

Kicks, bans and the serious detections take a picture of the player's game view and attach it to the detection and to the ban. At most one picture per player per minute. Staff bans from the panel take one too before the player is removed. Turn it off with "Take screenshot as evidence" under Settings.

Making a script legit: exports.ByteAC:Allow

When one of your scripts does something that looks like a cheat (teleport into an interior, heal, give a weapon), call this right before it. Server side: exports.ByteAC:Allow(source, "teleport", 5). Client side: exports.ByteAC:Allow("camera", 5). The last number is seconds.

teleport

Anti teleport, speed hack, super jump (server).

noclip

Anti noclip.

invisible

Anti invisibility.

godmode / heal

Anti invincibility, health regeneration.

weapon

Weapon not in inventory.

plate

Anti plate changer.

model

Anti model change.

camera

Anti freecam, memory aimbot (client).

ragdoll

Anti no-ragdoll (client).

spectate / vision / stamina / vehspeed / textures

Spectate, night vision, stamina, vehicle speed, cheat traces (client).

Explosion types

The type number on explosion detections.