Giriş
ASP AntiCheat, FiveM için modüler sunucu tarafı koruma sistemidir. Tespit modülleri, cloud policy sync, web dashboard ve oyun içi /asp NUI paneli birlikte çalışır.
Bu docs şunları kapsar:
- Kurulum — lisans token, asp-setup.exe, server.cfg
- ACE — staff panel ve komut yetkileri
- Configuration — cloud modül eşikleri, shadow, publish
- Live panel — oyuncular, harita, konsol, event log
- Exports & Scanner — entegrasyon ve PIN tarama
Neye karşı korur?
| Kategori | Örnekler |
|---|---|
| Movement | Teleport, speed, noclip, super jump |
| Combat | Hit burst, godmode sinyali, aim snap eşikleri |
| Weapons | Give flood, blacklist, spoof component |
| Entities | Spawn flood, mass delete, model deny list |
| Explosions | Flood, invisible, particle scale |
| Economy | Para / item spike, anti-dupe eşikleri |
Nasıl çalışır?
- 1. Resource sunucu olaylarını izler ve shadow/enforce politikasına göre kayıt üretir.
- 2. Cloud sync policy + bans + extras (whitelist, safe events, rules) çeker; live heartbeat oyuncu/koordinat/log gönderir.
- 3. Dashboard tek kaynak: Configuration publish → resource reload / periyodik sync.
Gereksinimler
| Gereksinim | Değer |
|---|---|
| OneSync | Açık (zorunlu) |
| fx_version | cerulean |
| Lua | lua54 yes |
| Lisans | Aktif AntiCheat entitlement + token |
| API erişimi | Sunucu → ASP web (asp_api_base) |
Kurulum
İki yol var. asp-setup.exe tek tıkta resource + token + cfg yazar; veya manuel ZIP + server.cfg.
Hızlı yol — asp-setup.exe
Dashboard → İndirmeler: token üret, EXE + ZIP indir. Setup dosyasını server.cfg ile aynı klasöre koy.
EXE’yi server klasörüne koy
server.cfg ve resources/ ile aynı dizin. Downloads’tan çalıştırma.
asp-setup.exe’yi aç
Sunucu yolunu otomatik bulur; yanlışsa Change ile düzelt.
Token + API base yapıştır
Dashboard lisans token’ı ve https://alanadin.com adresin.
INSTALL → restart
Resource çıkarılır, cfg yazılır, bridge enjekte edilir. Sunucuyu restart et.
Sadece üçüncü parti export yenilemek için Add exports only. Windows SmartScreen imzasız uyarı verebilir: Ek bilgi → Yine de çalıştır.
Manuel yol
- Dashboard’dan ZIP indir →
resources/asp_anticheat server.cfgsatırlarını ekle (aşağıda)- Konsolda
asp doctorile doğrula
ensure asp_anticheat
set onesync on
set asp_api_base "https://YOUR_DOMAIN"
set asp_license_token "asp_lic_…"
# set asp_policy_secret "…" # opsiyonel HMACDoğrulama
asp doctor— lisans, policy, API- Dashboard Players / Console — live sync birkaç saniye içinde dolar
- Oyun içi
/asp(ACE gerekir)
ACE Yetkileri
Staff paneli ve konsol komutları FiveM ACE ile ayrılır. Web panel yetkileri ayrıdır; ACE sunucu tarafı güvendir.
add_ace group.admin asp.command.panel allow
add_ace group.admin asp.command.status allow
add_ace group.admin asp.command.doctor allow
add_ace group.admin asp.command.reload allow
add_ace group.admin asp.command.evidence allow
add_ace group.admin asp.panel.kick allow
add_ace group.admin asp.panel.ban allow
add_ace group.admin asp.panel.warn allow
add_ace group.admin asp.panel.teleport allow
add_ace group.admin asp.panel.module allow
add_ace group.admin asp.panel.identifiers allow
add_principal identifier.license:XXXX group.admin| ACE | Ne işe yarar |
|---|---|
| asp.command.panel | /asp NUI staff paneli (zorunlu) |
| asp.command.status | asp status |
| asp.command.doctor | asp doctor / NUI doctor |
| asp.command.reload | asp reload / policy sync |
| asp.command.evidence | Evidence + identifier görünümü |
| asp.panel.kick | NUI kick |
| asp.panel.ban | NUI ban/unban |
| asp.panel.warn | NUI uyarı |
| asp.panel.teleport | NUI goto/bring |
| asp.panel.module | NUI modül / flagAction |
| asp.panel.identifiers | Oyuncu identifier listesi |
Configuration
Dashboard → Configuration (veya AntiCheat). Sol kategoriler: Global, Movement, Entity, Weapon, Explosion, Economy, Combat, Anti-Dupe, Trust, Events.
Shadow default
İlk kurulumda log-only; false positive’i kes.
Publish
Policy version artar; resource sync ile çeker.
Presets
Hızlı başlangıç eşikleri; sonra ince ayar.
Trust whitelist, safe events, custom rules ve model deny listeleri extras olarak sync edilir; resource runtime’da shadow-aware uygular.
Live Panel & /asp
Resource periyodik POST /api/license/live ile oyuncu (id, ping, coords), event ring ve console ring gönderir. Dashboard sayfaları bunu okur.
Web dashboard
- Players / Lookup — online liste
- Harita — GTA bounds noktaları
- Live Monitor — oyuncu snapshot (kamera stream yok)
- Konsol / Event Log / Analitik / Kicks
In-game
/asp
NUI: online özet, doctor, reload. ACE asp.command.panel gerekir.
False Bans
Varsayılan shadow açıktır: tespitler loglanır, kick/ban uygulanmaz. Canlıya almadan önce Discord/event log’u birkaç gün izle.
- Teleport/heal için framework bridge:
markLegalTeleport/markLegalHeal - Economy spike için
noteEconomyDelta/markLegalMoney - Trust whitelist ile staff/test hesaplarını muaf tut
- flagAction: log → kick → ban sırasıyla yükselt; min confidence’ı agresif tutma
Developer API (Exports)
exports['asp_anticheat']:banPlayer(src, reason, hours?)
exports['asp_anticheat']:kickPlayer(src, reason)
exports['asp_anticheat']:unbanPlayer(identifier)
exports['asp_anticheat']:getBanInfo(identifier)
exports['asp_anticheat']:getThreatScore(src)
exports['asp_anticheat']:markLegalTeleport(src, ms?)
exports['asp_anticheat']:markLegalHeal(src, ms?)
exports['asp_anticheat']:markLegalMoney(src, amount?)
exports['asp_anticheat']:noteEconomyDelta(src, amount, reason?)
exports['asp_anticheat']:markServerEntity(entity)
exports['asp_anticheat']:reloadConfiguration()
exports['asp_anticheat']:isRunning()Konsol: asp status|version|doctor|reload|evidence. Oyuncu bare /asp → NUI.
Scanner
Windows agent ile onaylı istemci taraması. AntiCheat’ten ayrı ürün / entitlement.
- 1. Panelde PIN üret
- 2. Oyuncuya PIN + agent linki gönder (
/api/download/[pin]) - 3. Onaylı tarama → personel raporu
Troubleshooting
Lisans geçersiz / sync yok
Token, asp_api_base ve sunucunun HTTPS erişimini kontrol et. asp doctor çıktısına bak.
Dashboard Players boş
Resource çalışıyor mu? Live push için lisans aktif olmalı. Birkaç saniye bekle / LiveRefresh.
/asp açılmıyor
asp.command.panel ACE ver. Resource 0.4+ ve ui_page yüklü olmalı.
Tespit gelmiyor
Modül enabled mi? Shadow log’larda görünür. onesync on ve ensure sırasını doğrula.
Destek: Discord