This is an unofficial SA-MP Clientside Anticheat (SAMPCAC) documentation repository. All rights belong to the author 0xCAC and are provided here for informational purposes only. The official https://SAMPCAC.xyz/docs site has been unavailable for a long time and this repository was created to help you with development. There is no source code here, only binaries and documentation!
Brand new clientside anticheat for SA-MP, designed to detect and report cheaters to the server they are connected to. SAMPCAC is aiming to be a replacement for old heavy, unstable anticheat softwares.
NO CRASHES Crashes are annoying, aren't they?
That's why our software is carefully tested before it gets released, so our users won't (or shouldn't) experience any issues.
LIGHTWEIGHT AND FAST
We know how important is that 90+ FPS in top corner for you, so SAMPCAC developers are constantly trying their best to keep that number unchanged.
COMMUNITY-DRIVEN
SAMPCAC is a mod by players for ehm... players AND servers. We listen to all our users' suggestions and we are open to discussions.
MODULAR ANTICHEAT
SAMPCAC is pretty much fully toggleable from serverside. See sampcac.inc for a list of detected cheats.
- You don't want your players use macros? Enable macro reporting!
- You don't want your players abuse C-Bug or see radar blips? Disable them!
- You don't want your players use m0d_s0beit_sa? Well, this mod is disabled by default and can't be enabled :(
- Not enough protections? Detect many more specific cheats using CAC_ReadMemory.
- Require all players have SAMPCAC installed? Load sampcac_only.amx.
- Configure cheat detection? (MUST BE LOADED) Load sampcac_base.amx and edit sampcac_base.ini.
- Disable certain glitches? (eg: C-Bug) Load sampcac_glitch.amx and edit sampcac_glitch.ini.
- Toggle game options? (eg: inf. sprint or manual gun reloading) Load and configure sampcac_gameoption.amx.
- Monitor modded resources? (eg: skins or transparent textures) Load and configure sampcac_gameresource.amx.
Note for server owners: SAMPCAC won't take any action against cheaters by itself, you have to explicitly script these actions. Fortunately, server package comes with 6 filterscripts ready to take care of it for yourself. See above. For further information, check out SAMPCAC documentation here!
This repo contains all information needed to set up and run a SAMPCAC protected server.
- Download the latest SAMPCAC server package;
- Copy its full content in the root of SA-MP server, respecting the directory layout;
- Open server.cfg and append to plugins line:
- sampcac_server.so (for Linux servers);
- sampcac_server.dll (for Windows servers);
- Now, add the following filterscripts:
- sampcac_base (WARNING: SAMPCAC won't take any action against cheaters without this filterscripts loaded!);
- sampcac_glitch (allows you to disable certain GTA:SA glitches (like C-Bug));
- sampcac_gameoption (allows you to toggle certain options (like vehicle blips on radar));
- sampcac_gameresource (allows you to detect game modifications (like modified skins));
- sampcac_only (only clients with SAMPCAC installed can join your server);
- sampcac_versioncheck (warn players that they're using an outdated version of SAMPCAC client before kicking them); (for more information regarding filterscripts, see filterscripts article);
- Head to scriptfiles and edit sampcac_base.ini, sampcac_glitch.ini, sampcac_gameoption.ini and sampcac_gameresource.ini according to your needs;
- Start the server!
Check out sample filterscripts and sampcac.inc source code for more implementation details.
This filterscript is responsible for handling cheat reports coming from SAMPCAC plugin.
IMPORTANT: MUST BE LOADED! unless you write your own cheat handler
Configuration: scriptfiles/sampcac_base.ini
[aimbot_1] # cheat name as defined in "sampcac_base.pwn"
status=on # detection status: [on/off]
action=kick # action to be taked on detection: [warning/kick/ban]
[screenshot] # cheat name as defined in "sampcac_base.pwn"
status=on # should players get punished for taking too many screenshots?
max_screenshots=1 # how many screenshots may a player take
reset_time=1000 # players can take screenshots again after this time (in ms) has passed
action=warning # action to be taked on screenshot spam: [warning/kick/ban]
[macro_key_detection] # enable/disable certain macro key detections (see sampcac_base.ini for more information)
Edit without restart: All you have to do is edit scriptfiles/sampcac_base.ini and use /rcon reloadfs sampcac_base while logged in as RCON.
This filterscript is responsible for disabling certain GTA:SA glitches.
Configuration: scriptfiles/sampcac_glitch.ini
NOTE: Default configuration disables C-Bug, Fast Sprint and Fast Fire.
NOTE: For further documentation, see GTA:SA glitch natives.
[glitch] # this is the default configuration
quick_reload=on # I guess it's pretty straight-forward and doesn't need any explanation
fast_fire=off
fast_move=on
c_bug=off
fast_sprint=off
quick_stand=on
Edit without restart: All you have to do is edit scriptfiles/sampcac_glitch.ini and use /rcon reloadfs sampcac_glitch while logged in as RCON.
This filterscript is responsible for toggling certain game options.
Configuration: scriptfiles/sampcac_gameoption.ini
NOTE: See sampcac.inc for a full list of toggleable game options.
NOTE: For further documentation, see game option natives.
[gameoption] # this is the default configuration
vehicle_blips=on # I guess it's pretty straight-forward and doesn't need any explanation
manual_reloading=on
drive_on_water=off
fireproof=on
sprint=all_surfaces
infinite_sprint=on
infinite_oxygen=on
infinite_ammo=off
night_vision=off
thermal_vision=off
Edit without restart: All you have to do is edit scriptfiles/sampcac_gameoption.ini and use /rcon reloadfs sampcac_gameoption while logged in as RCON.
This filterscript is responsible for detecting game modifications.
Configuration: scriptfiles/sampcac_gameresource.ini
NOTE: Currently, only peds, vehicles, weapons, object models and ped.ifp modifications are detectable.
NOTE: For further documentation, see game resource checks natives.
[gamemodels]
# disabled = no reports regarding modded game models
# only_if_modded = will notify the server only once if player got modded game models (good for saving bandwidth)
# full = detailed report about the mod: model id, component (dff, txd, anim or ped.ifp) and modded file checksum (not recommended when players have a lot of mods)
type=full
# possible values: warning kick ban
action=warning
# adjust following options in order to enable/disable specific game models reports
skins=on
vehicles=off
weapons=off
# "others" means everything else that is not stated above (eg: buildings, fences, streets etc)
others=on
ped_ifp=on
Edit without restart: All you have to do is edit scriptfiles/sampcac_gameresource.ini and use /rcon reloadfs sampcac_gameresource while logged in as RCON.
Only clients with SAMPCAC installed can join your server.
Configuration: no configuration needed
Disable without restart: Use /rcon unloadfs sampcac_only while logged in as RCON.
Warn players that they're using an outdated version of SAMPCAC client before kicking them.
Configuration: no configuration needed
Disable without restart: Use /rcon unloadfs sampcac_versioncheck while logged in as RCON.
Checks the client version and displays messages about the need to update or install anti-cheat.
(This is an improved version of the sampcac_versioncheck.pwn script)
Configuration: no configuration needed
Working examples of using the memory read function. sampcac_memread_example
Configuration: no configuration needed
SAMPCAC requirements SA-MP Client version 0.3.7 R1.
The most common problems and their solutions:
- SAMPCAC installer gives Windows version mismatch error
Download sampcac_client.asi separately, or run the installer in Windows XP compatibility mode (Service pack 3).
- After connecting not reaching the skin selection, crash with format codes 0x06XXXXXXX where X are arbitrary characters
Reinstall the SA-MP client through the original installer (not by changing the files)
- Error when clicking "Connect" button in SA-MP client. 0x0040fB80 or similar.
Install sa-mp 0.3.7 client again and change version of GTA_SA.exe to US 1.0
- Black screen.
Delete the gta_sa.set file from the GTA San Andreas User Files folder
- 0x0059F8B4
Crash occurs when the client cannot load any object on the server from samp.img. Reinstall the client and try running SA:MP as an administrator.
- The game does not start on Windows10 / Windows11 (no crash)
On a Windows 10 system, the old DirectPlay must be enabled. To do this, go to "Control Panel » Programs » Uninstall Programs » Turn Windows features on or off" and check "Legacy Components and DirectPlay".
- SA-MP Clientside Anticheat cannot run under a Virtual Machine.