Giriş

FeloxAC, FiveM için modüler bir anti-cheat sistemidir. Client tarafı tespit modüllerini, server tarafı yetki katmanını ve bir web panelini birleştirerek sunucunu hile, injector ve ele geçirilmiş resource'lara karşı korur.

Bu dokümantasyon, FeloxAC'ı çalıştırmak ve kendi resource'larınla entegre etmek için ihtiyacın olan her şeyi kapsar:

• Kurulum — lisans, resource yerleştirme, server.cfg ve koruma kurulumu.
• Yapılandırma — tespitler, ceza modları ve hatalı banları önleyen Safe Events / Safe Scripts listeleri.
• Hatalı Banlar — neden olur ve nasıl çözülür.
• Geliştirici API (Exports) — FeloxAC'ın diğer resource'lara sunduğu tüm export'lar.
• Ban Export — banPlayer export'u detaylı olarak.
• Kullanım Örnekleri — kopyala-yapıştır entegrasyon tarifleri.

FeloxAC neleri engeller

Nasıl çalışır

1. Client tespit modülleri her oyuncuda hile davranışını izler ve sunucuya bildirir.
2. Server katmanı yetkilidir — tespitleri doğrular, yapılandırılmış cezayı (ban / kick / log) uygular ve kanıtı (ekran görüntüsü ve oyun klipleri) Discord webhook'larına kaydeder.
3. Panel, yapılandırmanın tek doğru kaynağıdır. Ayarlar çalışan sunucuna otomatik senkronize edilir ve fac reload ile anlık yenilenebilir.

Gereksinimler

Kurulum

FeloxAC kurulumu beş adımdır: lisans al, resource'u ekle, license.txt dosyanı ayarla, server.cfg'yi güncelle ve koruma kurulumunu çalıştır.

Ön koşullar

Adım 1 — Lisansını al

1. feloxac.com üzerinden bir lisans satın al.
2. Paneline gir ve Redeem Key (Anahtar Kullan) bölümüne git.
3. Create a new server (Yeni sunucu oluştur) seç; lisans anahtarını yapıştır, public sunucu IP'ni gir (sadece bir kez girilir), bir sunucu adı yaz ve Add Server'a tıkla.

Adım 2 — Resource'u ekle

1. FeloxAC resource'unu panelindeki Download sayfasından indir.
2. Sunucunun resources/ klasörüne çıkar.
3. Klasör adının FeloxAC olduğundan emin ol.

Adım 3 — license.txt'yi ayarla

1. FeloxAC klasöründeki license.txt'yi aç ve içindeki her şeyi sil.
2. Panelde Documentation → Replace license.txt'ye git.
3. Sunucunu seç, Copy license.txt Content'e tıkla ve içeriği license.txt'ye yapıştır.
4. Dosyayı kaydet.

Bu dosya API token'ını içerir. FeloxAC başlangıçta bunu okur ve sunucu IP'n için feloxac.com üzerinden doğrular.

Adım 4 — server.cfg'yi ayarla

server.cfg dosyanın üst kısmına OneSync'i ekle:

set onesync on
set onesync_population false

Bunları diğer permission satırlarının arasına ekle:

add_unsafe_child_process_permission "FeloxAC"
add_ace resource.FeloxAC command allow

Ensure satırını, diğer tüm resource'lardan önce, ensure listenin en üstüne ekle:

ensure FeloxAC

Adım 5 — Koruma kurulumunu çalıştır

Resource'u kopyalamak yeterli değil — FeloxAC'ın diğer scriptlerini koruması için kurulumu bir kez çalıştırmalısın.

1. Sunucunu başlat.
2. Live Console'u (txAdmin veya sunucu konsolu) aç ve şunu çalıştır:

   fac install smart

3. Kurulumun bitmesini bekle.
4. Sunucunu yeniden başlat. FeloxAC artık aktif.

fac install smart ne yapar

Her resource'u tarar ve FeloxAC korumasını yalnızca network event kullanan scriptlere kurar. Network event'i olmayan resource'lar (araçlar, ped'ler, haritalar, kütüphaneler) otomatik atlanır; böylece kurulum hızlı ve temiz kalır.

Diğer kurulum modları

Kurulumu doğrula

• status çalıştır (veya txAdmin'e bak) — FeloxAC resource listesinde görünmeli.
• Sunucu konsolu FeloxAC'ın başlangıç ve lisans doğrulama sonucunu yazar.
• Bağlanan oyuncular loglanır (giriş/çıkış), bağlantı loglaması açıksa.

Sorun giderme

Lisans geçersiz / oyuncular atılıyor

• license.txt'nin panelindeki token ile birebir aynı olduğunu doğrula.
• Sunucunun public IP'sinin lisansa kayıtlı IP ile eşleştiğini doğrula.
• Sunucunun https://feloxac.com'a erişebildiğinden emin ol (firewall / hosts dosyasını kontrol et). FeloxAC fail-closed'dur — lisansı doğrulayamazsa tasarım gereği durur ve oyuncuları atar.

fac komutu bulunamıyor

• FeloxAC resource'unun çalıştığını doğrula (status).
• Komut öneki fac'tir, feloxac değil. Config'de CommandPrefix'i değiştirdiysen kendi önekini kullan.

Kurulumdan sonra tespitler çalışmıyor

• ensure FeloxAC'ın ensure satırlarının en üstünde olduğunu doğrula.
• OneSync'in açık olduğunu doğrula (set onesync on).
• Sunucu build'inin 14317+ olduğunu doğrula.
• fac install smart'ı tekrar çalıştır ve yeniden başlat.

Yapılandırma

FeloxAC, panel üzerinden yapılandırılır. Her şey panelden yapılır — toggle'lar, dropdown'lar ve liste ("chip") girişleri — yani ham config dosyalarını elle düzenlemezsin.

Değişiklikler çalışan sunucuna otomatik senkronize edilir. Anında uygulamak için:

fac reload

Panel nasıl çalışır

• Toggle'lar bir tespiti açar veya kapatır.
• Dropdown'lar bir tespitin eylemini seçer (Ban / Kick / Log).
• Listeler (chip) birden çok değer tutar — Safe Events, Safe Scripts ve white/black listeler gibi. Bir öğe eklemek için "New item, press enter to add…" kutusuna yaz ve Enter'a bas. Kaldırmak için chip'in üzerindeki ✕'e tıkla.

Bölümlere genel bakış

Ceza modları (Ban / Kick / Log)

Safe Events — event kaynaklı hatalı banları durdur

Yeri: Settings → Safe Events listesi.

Bazı meşru scriptler bir network event üzerinden silah verir veya oyuncuyu ışınlar. O event bir tespiti tetiklerse dürüst oyuncular hatalı banlanır. Sorunlu event adını Safe Events'e ekle; FeloxAC o event için silah-verme / teleport tespitini atlar.

Nasıl eklenir: event adını Safe Events kutusuna yaz ve Enter'a bas — örneğin job:teleportToWork veya police:warpToStation. Listede chip olarak görünür.

Event adını nasıl bulursun:

• Tespit logu / Discord kanıtına bak — tetikleyen event, ban detaylarında yer alır.
• Ya da scriptin kaynağında, ışınlarken veya silah verirken tetiklediği TriggerServerEvent / TriggerClientEvent adına bak.

Safe Scripts — bir resource'un tamamına güven

Yeri: Settings → Safe Scripts listesi.

Safe Events tek bir event'i izin verirken, Safe Scripts bir resource'un tamamına güvenir. Bir resource meşru şekilde oyuncu ışınlıyor veya silah veriyorsa ve her event'i tek tek eklemek istemiyorsan buraya ekle — örneğin meslek sistemleri, kiralama sistemleri, admin menüleri veya silah dükkanları.

Nasıl eklenir: resource adını Safe Scripts kutusuna yaz ve Enter'a bas (örneğin my-rental-system). Eşleşme büyük/küçük harf duyarsızdır.

Ignored Scripts — bir resource'u tamamen hariç tut

Yeri: Settings → Ignored Scripts listesi.

Ignored Scripts, bir resource için tüm FeloxAC kontrollerini kapatır — silahlar, entity'ler, event'ler, her şey. Yalnızca tamamen güvendiğin ama anti-cheat ile uyumsuz olan bir resource için kullan.

Hangisini kullanmalıyım?

White list & black list'ler

Entity'ler ve silahlar aynı chip girişlerini kullanır. Bir model adı veya hash (ya da silah adı) yaz ve Enter'a bas.

Önemli tespit toggle'ları

Main

Weapons

Entities

Hatalı Banlar

Neredeyse her hatalı ban bir obje, araç veya ped'den gelir. Büyük çoğunlukla yanlış olan tespit değildir — şu iki şeyden biridir:

1. Anti-cheat tam kurulmamıştır (koruma kurulumu hiç çalıştırılmamıştır), ya da
2. Sunucu temelleri doğru ayarlanmamıştır (OneSync / lisans), ya da
3. Meşru bir resource aynı entity'yi sürekli spawn ediyordur ve sadece whiteliste alınması gerekir.

Adım 1 — Önce kurulumunu kontrol et

Hatalı banların çoğu, temeller doğru olduğu anda kaybolur:

• OneSync AÇIK — set onesync on
• OneSync population KAPALI — set onesync_population false (en çok unutulan komut budur)
• Ücretli bir FiveM (Keymaster) hesabın var — ücretsiz / lisanssız kurulumlar tespit sorunlarına yol açar
• Kurulumu çalıştırdın — fac install smart, ardından sunucuyu yeniden başlattın

Bunlardan biri eksikse, whiteliste bir şey eklemeden önce düzelt ve tekrar test et.

Ped kaynaklı hatalı banlar

Oyuncular bir ped'den hatalı banlanıyorsa, neredeyse her zaman şunlardan biridir:

• OneSync açık değildir
• Ücretli FiveM Keymaster hesabı yoktur
• onesync_population, false yapılmamıştır (unutulan komut)
• fac install smart çalıştırılmamıştır

Önce bunları düzelt. Ban hep aynı ped'den geliyorsa, o ped meşrudur — modelini White Listed Peds listesine ekle.

Obje kaynaklı hatalı banlar

• Anti-cheat genel olarak objelerden banlıyorsa, büyük ihtimalle fac install smart çalıştırılmamıştır, yani koruma hiç kurulmamıştır. Çalıştır ve yeniden başlat.
• Ban hep aynı objeden geliyorsa, o obje meşrudur — White Listed Objects listesine ekle.

Araç kaynaklı hatalı banlar

• fac install smart'ın çalıştırıldığından ve sunucunun yeniden başlatıldığından emin ol.
• Belirli, meşru bir araç sürekli işaretleniyorsa White Listed Vehicles listesine ekle.

Bir model nasıl whiteliste alınır

Whiteliste alma, panelden chip girişleriyle yapılır:

• White Listed Peds — ped'ler için
• White Listed Objects — objeler için
• White Listed Vehicles — araçlar için

Modeli (ad veya hash) "New item, press enter to add…" kutusuna yaz ve Enter'a bas. Ardından uygulamak için fac reload çalıştır (veya yeniden başlat).

Entity değil de script kaynaklıysa

Hatalı ban, oyuncu ışınlayan veya silah veren bir resource'tan kaynaklanıyorsa (spawn edilen bir entity'den değil), bunun yerine Safe Events veya Safe Scripts kullan — bkz. Yapılandırma.

Geliştirici API (Exports)

FeloxAC, kendi resource'larının oyuncu banlayıp/atmasını, oyuncu durumunu okumasını ve bir eylemin meşru olduğunu (admin teleport, heal, silah verme vb.) anti-cheat'e bildirmesini sağlayan export'lar sunar.

Tüm export'lar FeloxAC resource'u üzerinden çağrılır:

exports['FeloxAC']:exportName(args)

Server export'ları

Moderasyon

-- Oyuncuyu 1 saat banla (3600 saniye)
exports['FeloxAC']:banPlayer(source, 'Aimbot', { by = 'Admin' }, 3600)

-- ID ile ban kaldır
exports['FeloxAC']:unbanPlayer('BAN-ID-BURAYA', 'Itiraz kabul edildi', 'HeadAdmin')

Oyuncu durumu

Yapılandırma

Meşru-eylem işaretleyicileri (server)

Bunlar, scriptinin yaptığı bir eylemin kasıtlı olduğunu FeloxAC'e bildirir; böylece tespit tetiklenmez. Güvenlik bypass'ı değildir — izni belirli bir eyleme kapsar.

-- Admin, oyuncuyu hatalı ban olmadan ışınlar
exports['FeloxAC']:markExternalTeleport(target)
SetEntityCoords(GetPlayerPed(target), x, y, z)

Client export'ları

Meşru-eylem işaretleyicileri (client)

Godmode / oyuncu durumu (client)

Silahlar & hasar (client)

Entity, kamera & kanıt (client)

Ban Export

banPlayer export'unu, herhangi bir server tarafı scriptten oyuncu banlamak için kullan — admin menün, özel bir tespit, bir rapor sistemi vb. Ban, FeloxAC'ın dahili olarak kullandığı pipeline üzerinden uygulanır; böylece ban listene kaydedilir, panele senkronize edilir ve Discord'a loglanır.

İmza

exports['FeloxAC']:banPlayer(source, reason, details, duration)

Döner: cezanın uygulanıp uygulanmadığını belirten bir boolean.

Örnekler

Kalıcı ban

-- duration verilmezse config'deki BanDuration kullanılır (varsayılan: kalıcı)
exports['FeloxAC']:banPlayer(source, 'Hile')

-- Veya açıkça belirt
exports['FeloxAC']:banPlayer(source, 'Hile', nil, -1)

Geçici ban

-- 1 gün banla (86400 saniye)
exports['FeloxAC']:banPlayer(source, 'Toksik davranis', { by = 'Moderator' }, 86400)

Zengin detaylı ban

exports['FeloxAC']:banPlayer(source, 'Para exploiti', {
    by       = 'AutoDetect',
    amount   = 500000,
    resource = GetCurrentResourceName(),
}, -1)

Admin komutundan ban

RegisterCommand('myban', function(src, args)
    local target = tonumber(args[1])
    local reason = table.concat(args, ' ', 2)
    if not target or reason == '' then
        return print('Kullanim: myban [id] [sebep]')
    end
    exports['FeloxAC']:banPlayer(target, reason, { by = GetPlayerName(src) }, -1)
end, true) -- kisitli komut

Başka bir resource'tan event ile ban

-- Diger resource'unda (server tarafi)
RegisterNetEvent('myac:ban', function(targetId, reason, seconds)
    exports['FeloxAC']:banPlayer(targetId, reason, { by = 'myac' }, seconds or -1)
end)

İlgili export'lar

Kullanım Örnekleri

En yaygın entegrasyonlar için kopyala-yapıştır kalıplar. Tüm export'lar FeloxAC resource'u üzerinden çağrılır.

Hatalı ban olmadan admin teleport

Oyuncuyu taşımadan hemen önce teleport'u meşru olarak işaretle.

Server tarafı:

RegisterCommand('tp', function(src, args)
    local target = tonumber(args[1]) or src
    exports['FeloxAC']:markExternalTeleport(target)
    -- ... teleport'unu yap (hedefin ped'ine SetEntityCoords) ...
end, true)

Client tarafı (yerel ışınlıyorsan):

exports['FeloxAC']:markExternalTeleport()
SetEntityCoords(PlayerPedId(), x, y, z, false, false, false, false)

Hatalı ban olmadan admin heal / revive

-- Client tarafi, heal/revive'dan once
exports['FeloxAC']:markExternalHeal()
SetEntityHealth(PlayerPedId(), 200)

-- Revive'dan sonra
exports['FeloxAC']:playerRevived()

Güvenilir bir scriptten silah verme

En temiz yol, resource'unu panelde Safe Scripts listesine eklemektir; böylece silah vermeleri her zaman güvenilir sayılır (bkz. Yapılandırma).

Bunun yerine client kodundan eylem başına izin için:

exports['FeloxAC']:giveWeapon(GetHashKey('weapon_pistol'), 'my-weapon-shop')

Kendi tespitinden bir hileciyi banla

-- Server tarafi
if isCheating then
    exports['FeloxAC']:banPlayer(source, 'Ozel tespit: para exploiti', {
        by = GetCurrentResourceName(),
    }, -1)
end

Tüm detaylar için Ban Export bölümüne bak.

Tehdit puanına göre içerik kısıtla

-- Server tarafi: yuksek tehditli oyunculara hassas eylemi reddet
local score = exports['FeloxAC']:getThreatScore(source) or 0
if score > 75 then
    TriggerClientEvent('chat:addMessage', source, { args = { 'System', 'Islem gecici olarak kullanilamiyor.' } })
    return
end

İstek üzerine kanıt topla

-- Server tarafi: supheli oyuncunun ekran goruntusunu al ve Discord'a gonder
exports['FeloxAC']:screenshot(source, 'https://discord.com/api/webhooks/...')

-- Son ~10 saniyelik oyununu al
exports['FeloxAC']:captureLastSeconds(source, 'https://discord.com/api/webhooks/...')

Meslek / kiralama scriptinden hatalı banları düzelt

Bir scriptin belirli bir event'i oyuncuları ışınlıyor veya eşya veriyor ve hatalı bana neden oluyorsa, yalnızca o event'i panelde Safe Events listesine ekle (event adını yaz, Enter'a bas). Resource'un tamamı güveniliyorsa bunun yerine Safe Scripts kullan.

Anti-cheat'in güvendiği entity'ler oluştur

-- Client tarafi
local veh = exports['FeloxAC']:CreateVehicle(GetHashKey('adder'))

-- Server tarafi
local ent = exports['FeloxAC']:CreateEntity(GetHashKey('prop_barrier_work05'))

Değişikliklerden sonra config'i yenile

exports['FeloxAC']:ReloadConfiguration()

Veya konsoldan:

fac reload