Instalare Fundamentala

Urmează acești pași pentru o integrare corectă pe server.

Thunder Shell Anticheat este proiectat să funcționeze pe game build-uri specifice, utilizând ox_lib pentru o interfață rapidă și performantă.

  1. Asigură-te că serverul rulează pe game build 3095 sau 3570 (v. ghidul Cfx.re).
  2. Asigură-te că folosești cea mai recentă versiune de artifacts FiveM.
  3. Descarcă resursa tsac din assets pe portalul cfx.re.
  4. Descarcă ultima versiune a resursei ox_lib de pe GitHub.
  5. Creează un folder de categorie (ex: [ac]) în folderul tău de resurse.
  6. Adaugă resursa anticheat tsac și dependența ox_lib în interiorul acestuia.
⚠️ Atenție Critica: Nu modifica numele resursei tsac. Acest lucru poate duce la erori de licență și detecții eșuate. Hackerii nu pot face nimic chiar dacă cunosc numele resursei.
  1. Asigură-te că folderul adăugat anterior este pornit primul în server.cfg: 
    ensure [ac]
ensure [resources]
🛑 Entitlements Error: Dacă primești eroarea: "You lack the entitlements required to use tsac", licența FiveM a serverului nu este pe același cont cfx.re ca și resursa TSAC.
  1. (Opțional) Pentru securitate suplimentară, adaugă în server.cfg: 
    sv_pureLevel 1 # dezactivează citizen modificat
add_ace resource.tsac command allow # permisiuni comenzi

Introducere v3.5

Bun venit în documentația oficială Thunder Shell.

Thunder Shell Anticheat este cea mai puternică soluție de securitate standalone pentru FiveM, oferind protecție avansată împotriva amenințărilor actuale, cu un impact minim asupra performanței serverului.

Utilizați meniul din stânga pentru a naviga prin secțiuni.

Întrebări Frecvente

Răspunsuri rapide la cele mai comune întrebări.

Instalarea este simplă și durează mai puțin de 5 minute. Poți urmări ghidul pas cu pas pe pagina noastră de Documentație.

Da! Thunder Shell Anticheat este complet compatibil cu ESX, QBCore, vRP precum și cu servere Custom/Standalone.

Oferim un trial gratuit de 7 zile pentru serverele de testare. Contactează-ne pe Discord pentru activare.

Configurare (cfg)

Setările de bază ale resursei, într-un singur fișier.

Setările se află în fișierul de configurare al resursei tsac. Mai jos ai un exemplu cu opțiunile principale:

Config = {}
Config.Framework  = 'vrp'      -- 'esx' | 'qbcore' | 'qbox' | 'vrp' | 'standalone'
Config.PunishMode = 'log'      -- 'ban' | 'kick' | 'log'
Config.BanMessage = 'Ai fost banat de Thunder Shell Anticheat.'
Config.Webhook    = ''         -- URL webhook Discord pentru log-uri
  • Framework – framework-ul serverului: esx, qbcore, qbox, vrp sau standalone.
  • PunishMode – ce se întâmplă la o detecție: ban, kick sau doar log (recomandat la primele teste).
  • BanMessage – mesajul afișat jucătorului sancționat.
  • Webhook – linkul Discord pentru log-uri (vezi secțiunea Webhooks).
ℹ️ Notă: numele opțiunilor din exemplu sunt orientative. Verifică fișierul de configurare din resursa ta și repornește resursa (restart tsac) după orice modificare.

Webhooks (logs)

Primește detecțiile și sancțiunile direct pe Discord.

Poți trimite log-urile într-un canal Discord folosind un webhook:

  1. În Discord: Setări canal → Integrări → Webhooks → Webhook nou.
  2. Copiază URL-ul webhook-ului.
  3. Lipește-l în configurare, la opțiunea Webhook.
  4. Repornește resursa cu restart tsac și verifică dacă apare mesajul de test.
Config.Webhook = 'https://discord.com/api/webhooks/ID/TOKEN'
⚠️ Atenție: nu da URL-ul webhook-ului nimănui. Oricine îl are poate scrie în canalul tău. Dacă a fost expus, șterge-l și creează unul nou.

Anti Aimbot

Detecție în timp real pentru auto-țintire și silent aim.

Modulul analizează comportamentul de țintire al jucătorilor și blochează tiparele nenaturale, fără impact vizibil asupra performanței.

  • Detectează auto-țintirea (aim lock) și silent aim.
  • Acțiunea (ban, kick sau log) se alege din PunishMode.
  • Fiecare detecție apare în panoul live și, dacă e setat, pe Discord.
Recomandare: la început rulează în modul log, verifică detecțiile, apoi activează sancționarea automată.

Anti Trigger Event

Protecție împotriva exploatării și injectării de server events.

Un trigger event abuziv permite unui cheater să ceară de pe server bani, iteme sau permisiuni. Modulul verifică evenimentele primite și le blochează pe cele suspecte.

  • Blochează evenimentele apelate din executori externi.
  • Evenimentele sigure ale resurselor tale rămân neafectate.
  • Detecțiile sunt logate cu numele evenimentului și al jucătorului.
Dacă o resursă legitimă este blocată din greșeală, adaug-o în sistemul Whitelist.

Sistem Whitelist

Exclude resurse sau jucători de încredere din verificări.

Whitelist-ul este util pentru staff și pentru resursele care folosesc evenimente neobișnuite. Exemplu de configurare:

Config.Whitelist = {
  identifiers = { 'license:xxxxxxxxxxxxxxxxxxxxxxxx' },  -- staff
  resources   = { 'resursa_ta' },                        -- resurse de încredere
}
  • Adaugă doar ce este strict necesar; fiecare intrare reduce nivelul de protecție.
  • Identifică jucătorii după identifier-ul de licență, nu după nume.
  • Repornește resursa după modificarea listei.
⚠️ Atenție: nu pune în whitelist conturi sau resurse pe care nu le controlezi complet.