ASPACASPACBy ASP Security

Documentation

ASP Docs

Kurulumdan cloud configuration’a, ACE’den oyun içi /asp paneline tarzı tek sayfa rehber.

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
MovementTeleport, speed, noclip, super jump
CombatHit burst, godmode sinyali, aim snap eşikleri
WeaponsGive flood, blacklist, spoof component
EntitiesSpawn flood, mass delete, model deny list
ExplosionsFlood, invisible, particle scale
EconomyPara / item spike, anti-dupe eşikleri

Nasıl çalışır?

  1. 1. Resource sunucu olaylarını izler ve shadow/enforce politikasına göre kayıt üretir.
  2. 2. Cloud sync policy + bans + extras (whitelist, safe events, rules) çeker; live heartbeat oyuncu/koordinat/log gönderir.
  3. 3. Dashboard tek kaynak: Configuration publish → resource reload / periyodik sync.

Gereksinimler

GereksinimDeğer
OneSyncAçık (zorunlu)
fx_versioncerulean
Lualua54 yes
LisansAktif AntiCheat entitlement + token
API erişimiSunucu → 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.

asp-setup
1

EXE’yi server klasörüne koy

server.cfg ve resources/ ile aynı dizin. Downloads’tan çalıştırma.

asp-setup
2

asp-setup.exe’yi aç

Sunucu yolunu otomatik bulur; yanlışsa Change ile düzelt.

asp-setup
3

Token + API base yapıştır

Dashboard lisans token’ı ve https://alanadin.com adresin.

asp-setup
4

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

  1. Dashboard’dan ZIP indir → resources/asp_anticheat
  2. server.cfg satırlarını ekle (aşağıda)
  3. Konsolda asp doctor ile 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 HMAC

Doğ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
ACENe işe yarar
asp.command.panel/asp NUI staff paneli (zorunlu)
asp.command.statusasp status
asp.command.doctorasp doctor / NUI doctor
asp.command.reloadasp reload / policy sync
asp.command.evidenceEvidence + identifier görünümü
asp.panel.kickNUI kick
asp.panel.banNUI ban/unban
asp.panel.warnNUI uyarı
asp.panel.teleportNUI goto/bring
asp.panel.moduleNUI modül / flagAction
asp.panel.identifiersOyuncu 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. 1. Panelde PIN üret
  2. 2. Oyuncuya PIN + agent linki gönder (/api/download/[pin])
  3. 3. Onaylı tarama → personel raporu

Scanner ürünü · Kapsam · Tespit sınıfları

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