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.
• ACE Yetkileri — server.cfg üzerinden yetkili izinleri: her admin menü özelliği, bypass ve komutlar ayrı ACE nesnesi olarak.
• 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

İki yol var. Tek tıklık kurulum programı her şeyi senin yerine yapar; ya da aşağıdaki beş adımlık manuel yolu izlersin: lisans al, resource'u ekle, license.txt dosyanı ayarla, server.cfg'yi güncelle ve koruma kurulumunu çalıştır.

Hızlı yol — tek tıklık kurulum programı

feloxac-setup.exe aşağıdaki 2–5. adımları otomatikleştirir: resource'u çıkarır, API token'ından license.txt'yi yazar, server.cfg'yi ayarlar ve üçüncü parti export'ları ile guard'ları enjekte eder. Sunucunun çalıştığı makinede lokal olarak çalışır. Programı ve kuracağın sunucunun API token'ını panelindeki Download sayfasından alırsın.

1

feloxac-setup.exe'yi server.cfg ile aynı klasöre koy

Programı sunucu klasörüne at — server.cfg ve resources/ ile aynı klasör. İndirilenler klasöründen çalıştırma.

2

Programı aç

feloxac-setup.exe'ye çift tıkla. Sunucu klasörünü kendisi bulur; yanlış yolu gösterirse Change ile düzelt.

3

API token'ını yapıştır

Sunucunun token'ını panelden kopyala ve FELOXAC API TOKEN alanına yapıştır.

4

INSTALL'a bas

FeloxAC'yi çıkarır, license.txt'yi yazar, server.cfg'yi ayarlar ve export'ları ekler. Bitince sunucunu yeniden başlat — fac install smart yazmana gerek yok.

Elle yapmayı tercih ediyorsan manuel yol aşağıda.

Ön koşullar

Adım 1 — Lisansını al

1. feloxac.com üzerinden bir lisans satın al.
2. Lisansın ödemeden sonra otomatik aktif olur — anahtar girmen gerekmez.
3. Paneline gir ve Lisans sayfasına geç. Sunucularım altında public sunucu IP'ni (connect adresindeki IP) gir ve Sunucuyu ekle ve token'ı al'a tıkla. API token'ın hemen orada görünür.

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

Yetkili izinleri (ACE) — isteğe bağlı

Yetkili izinleri (admin menüsü, bypass, komutlar) server.cfg üzerinden de verilir. Kendi bölümü var: ACE Yetkileri.

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.

ACE Yetkileri

Yetkili izinleri doğrudan server.cfg içinden, FiveM'in ACE sistemiyle verilebilir — txAdmin ve diğer resource'ların için zaten kullandığın add_ace / add_principal satırlarıyla. Oyun içi /fac admin menüsünün her parçasının kendi yetkisi var; yani bir moderatöre troll seçenekleri ve araç spawn vermeden ban ve kick verebilirsin.

Tüm yetkiler

Nesneler hiyerarşiktir, tıpkı FiveM'in kendi command / command.kick yapısı gibi: FeloxAC.AdminMenu izni altındaki her şeyi açar; daha özel bir deny, daha geniş bir allow'u ezer.

AdminMenu — oyun içi /fac menüsü

Bypass

Commands

Kısayol — bir gruba hepsini ver

Her nesneyi tek tek yazmak zorunda değilsin. Kategoriyi ver, o gruptaki herkes tamamını alır:

add_ace group.admin FeloxAC.AdminMenu allow

Aynı gruptan tek bir özelliği daha özel bir deny ile geri al:

add_ace group.mod FeloxAC.AdminMenu allow
add_ace group.mod FeloxAC.AdminMenu.Troll deny
add_ace group.mod FeloxAC.AdminMenu.CarSpawn deny

Örnek server.cfg

# FELOXAC YETKILERI server.cfg icinde
# add_ace [principal] [object] [allow|deny]      -> bir gruba / kimlige nesne verir (veya reddeder)
# add_principal [child_principal] [parent_principal] -> bir kimligi gruba koyar
# Her FiveM kimligi olur: discord, steam, license, fivem, ip, xbl, live.
# Kimlikleri txAdmin > Players'ta veya FeloxAC paneli > Players'ta bulursun.

# SUPER ADMINLER
add_principal identifier.discord:123456789012345678 group.superadmin

# ADMINLER
add_principal identifier.discord:234567890123456789 group.admin
add_principal identifier.license:1a21a2380bca020822ad301eb4e579e00a7063f3 group.admin

# MODERATORLER
add_principal identifier.discord:345678901234567890 group.mod

# SUPER ADMINLERE VERILEN YETKILER
add_ace group.superadmin FeloxAC.AdminMenu allow
add_ace group.superadmin FeloxAC.Commands allow
add_ace group.superadmin FeloxAC.Bypass allow

# ADMINLERE VERILEN YETKILER
add_ace group.admin FeloxAC.AdminMenu allow
add_ace group.admin FeloxAC.AdminMenu.Admins deny

# MODERATORLERE VERILEN YETKILER
add_ace group.mod FeloxAC.AdminMenu.Players allow
add_ace group.mod FeloxAC.AdminMenu.Tools allow
add_ace group.mod FeloxAC.AdminMenu.Monitor allow
add_ace group.mod FeloxAC.AdminMenu.Bans allow
add_ace group.mod FeloxAC.AdminMenu.Kicks allow
add_ace group.mod FeloxAC.AdminMenu.Messages allow
add_ace group.mod FeloxAC.AdminMenu.Lookup allow
add_ace group.mod FeloxAC.AdminMenu.Logbook allow

Hangisini kullanmalıyım — ACE mi panel mi?

• Panel (Admins sayfası) — kişi bazlı, dosyaya dokunmadan her an değiştirilebilir, sunucuya canlı senkronlanır. Günlük yetkili yönetimi için en iyisi.
• ACE (server.cfg) — grup bazlı, diğer sunucu yetkilerinle aynı yerde durur, panel değişikliklerinden etkilenmez. Sunucu sahipleri ve her yetkiyi server.cfg'de tutan sunucular için en iyisi.
• İkisi aynı anda kullanılabilir. İkisine de sahip olan kişi ikisinin birleşimini alır.

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.

Ban sebebi → ne düzeltilir

Banda veya tespit logunda yazan sebebi bul, karşısındaki çözümü uygula.

Illegal Object Spawn Detected

Bir resource, anti-cheat'in tanımadığı bir obje spawn etti. Obje meşruysa ve hep aynı objeyse whiteliste al:

• Config → Entities → White Listed Objects — model adını veya hash'ini yaz, Enter'a bas.
• Enable Objects White List'in AÇIK olduğundan emin ol, kapalıysa liste dikkate alınmaz.
• Uygulamak için fac reload çalıştır (veya yeniden başlat).

Exceeded Object / Vehicle / Ped Spawn Rate

Bu bir hız limiti, model sorunu değil: bir script 5 saniye içinde limitin izin verdiğinden fazla entity spawn etti. Config → Entities altından limiti yükseltebilir veya limiter'ı kapatabilirsin:

• Objeler — Objects Limit In5 Seconds / Enable Objects Limiter
• Araçlar — Vehicles Limit In5 Seconds / Enable Vehicles Limiter
• Ped'ler — Peds Limit In5 Seconds / Enable Peds Limiter

Önce limiti yükselt. Bir limiter'ı yalnızca meşru bir resource gerçekten toplu spawn yapıyorsa kapat (harita yükleyiciler, garajlar, etkinlik scriptleri).

Illegal Vehicle Spawn Detected

Bu neredeyse her zaman, aracı spawn eden resource'ta FeloxAC include'unun kurulu olmadığı anlamına gelir. Include olmadan spawn imzasız gelir ve anti-cheat onu enjekte edilmiş bir spawn'dan ayıramaz.

• Aracı hangi resource'un spawn ettiğini bul ve include'un o resource'ta kurulu olduğundan emin ol.
• fac install smart çalıştır ve sunucuyu yeniden başlat — uygun resource'lara include'u enjekte eder.

Resource Injection Detected

Tespitin detay satırını oku — hangi çözümü kullanacağını o söyler:

• Detayda bir event adı varsa → o event'i Config → Main → Safe Events'e ekle.
• Detayda @@Script/test.lua gibi bir dosya yolu varsa → Config → Main → Anti Resource Injection Safe List'e ekle, ama @@ olmadan: Script/test.lua yaz.

Girdiler callsite yolunun alt dizisi (substring) olarak eşleşir, yani muafiyetin genişliğini sen seçersin:

• my-resource/client/cl-garage.lua — sadece o dosyayı muaf tutar (tercih edilen).
• my-resource — o resource'taki tüm dosyaları muaf tutar (çok daha geniş; mecbur kalmadıkça kullanma).

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')

-- Banlamak yerine at
exports['FeloxAC']:kickPlayer(source, 'Cok uzun AFK', { by = 'Admin' })

-- Bir bani sorgula, sonra sunucudaki tum banlari kaldir
local found, banData = exports['FeloxAC']:getBanInfo('BAN-ID-BURAYA')
if found then print(banData.reason) end
exports['FeloxAC']:unbanAllPlayers('HeadAdmin')

-- Kaniti dogrudan Discord webhook'una gonder
exports['FeloxAC']:screenshot(source, 'https://discord.com/api/webhooks/...')
exports['FeloxAC']:captureLastSeconds(source, 'https://discord.com/api/webhooks/...')

Oyuncu durumu

-- FeloxAC'in bagli bir oyuncu hakkinda bildigi her sey
local ids    = exports['FeloxAC']:getPlayerIdentifiers(source)
local tokens = exports['FeloxAC']:getPlayerTokens(source)
local score  = exports['FeloxAC']:getThreatScore(source)
local played = exports['FeloxAC']:getPlayTime(source)

print(ids.license, ids.discord, #tokens, score, played)

-- FeloxAC'in zaten muaf tuttugu oyuncuda kendi admin kontrolunu atla
if exports['FeloxAC']:hasBypass(source) then return end

Yapılandırma

-- Config degisikliklerini resource'u yeniden baslatmadan uygula (fac reload ile ayni)
if exports['FeloxAC']:ReloadConfiguration() then
    print('FeloxAC config yeniden yuklendi')
end

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)

-- Server scriptinden oyuncuya can bas
exports['FeloxAC']:markExternalHeal(target)

-- Meslek scripti silah veriyor: kaydet, yoksa possession taramasi banlar
local weapon = GetHashKey('weapon_pistol')
exports['FeloxAC']:registerLegalWeapon(target, weapon)

-- ...silahi geri alinca kaydi da dusur
exports['FeloxAC']:unregisterLegalWeapon(target, weapon)
exports['FeloxAC']:clearLegalWeapons(target)   -- ya da hepsini birden dusur

-- Ped model degisimi (kiyafet menusu, meslek kiyafeti). nil = mevcut modeli kabul et.
exports['FeloxAC']:registerLegalPedModel(target, 'a_m_y_business_01')

-- Parkur / minigame super jump. durationMs MILISANIYE cinsindendir.
exports['FeloxAC']:registerLegalSuperJump(target, 30000)
exports['FeloxAC']:unregisterLegalSuperJump(target)   -- erken bitir

-- Kendi admin menunun noclip'i. SERVER tarafinda, kendi yetki kontrolunden SONRA cagir.
-- durationMs MILISANIYE cinsindendir (varsayilan 30000, tavan 600000 = 10 dakika).
exports['FeloxAC']:registerLegalNoclip(target)          -- noclip acilirken
exports['FeloxAC']:registerLegalNoclip(target, 60000)   -- ...ya da daha uzun pencere iste
exports['FeloxAC']:unregisterLegalNoclip(target)        -- noclip kapanirken

-- Megafon / telsiz. Yapiskan: her true'yu bir false ile esle.
exports['FeloxAC']:markVoiceOverrideActive(target, true)
exports['FeloxAC']:markVoiceOverrideActive(target, false)

-- Server-side spawn: ya onayli olarak yarat, ya da elindeki handle'i isaretle
local veh = exports['FeloxAC']:CreateEntity(GetHashKey('adder'))
exports['FeloxAC']:MarkServerEntity(veh, GetHashKey('adder'))

Bypass & teşhis (server)

-- Freeroam / etkinlik bolgesi: tespitleri kaldir, sonra MUTLAKA geri koy
exports['FeloxAC']:toggleBypass(target, true)
-- ...
exports['FeloxAC']:toggleBypass(target, false)

-- Daha guvenlisi: kendiliginden biten pencere. duration SANIYE (tavan 43200 = 12 saat).
exports['FeloxAC']:tempBypass(target, 60)

-- Bu event adi FeloxAC'in korumali listesinde mi?
if exports['FeloxAC']:IsEventProtected('myresource:giveMoney') then
    print('zaten korumali')
end

Client export'ları

Client export'ları birer işaretleyicidir: scriptinin birazdan yapacağı şeyin meşru olduğunu FeloxAC'a bildirirler. banPlayer, kickPlayer, screenshot ve captureLastSeconds dışında hiçbiri işi senin yerine yapmaz. Kalıp her zaman aynı — önce işaretle, sonra native'i çağır:

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

Meşru-eylem işaretleyicileri (client)

-- Asagidaki her isaretleyici ayni kalibi izler: once isaretle, sonra native'i cagir.
exports['FeloxAC']:hasTeleported()          -- markExternalTeleport() ile ayni isaretleyici
SetEntityCoords(PlayerPedId(), x, y, z, false, false, false, false)

exports['FeloxAC']:healthRefilled()         -- markExternalHeal() ile ayni isaretleyici
SetEntityHealth(PlayerPedId(), 200)

exports['FeloxAC']:playerRevived()
exports['FeloxAC']:resettedStamina()        -- ~10 sn'lik pencere acar
exports['FeloxAC']:hasAddedAmmo()           -- ~5 sn'lik pencere acar

-- Uygulamadan once ped modelini bildir (isim ya da hash). Cagri bir resource'tan
-- geldiyse true doner; tekrar tazelemeler 60 sn'de bire sinirlidir.
exports['FeloxAC']:hasChangedPedModel('a_m_y_business_01')
SetPlayerModel(PlayerId(), GetHashKey('a_m_y_business_01'))

-- Ekran klavyesinden hemen once
exports['FeloxAC']:displayInputBox()
DisplayOnscreenKeyboard(1, 'FMMC_KEY_TIP8', '', '', '', '', '', 30)

-- Kelepce / tasima / cutscene / safezone. durationMs varsayilan 5000, tavan 60000.
exports['FeloxAC']:allowImmortalityFlags(10000)

-- Tamirci scripti araci tamir ediyor
exports['FeloxAC']:MarkVehicleRepair()
SetVehicleFixed(veh)

Godmode / oyuncu durumu (client)

Bunlar tek seferlik işaretleyici değil, durum anahtarıdır: neyi açtıysan onu geri kapatman gerekir.

-- admin görünmez olup geri dönüyor
exports['FeloxAC']:isVisible(false)
SetEntityVisible(PlayerPedId(), false, false)
-- ...
exports['FeloxAC']:isVisible(true)
SetEntityVisible(PlayerPedId(), true, false)

-- Diger anahtarlar da ayni ac/kapa disiplinini izler
exports['FeloxAC']:proofsEnabled(false)
exports['FeloxAC']:canBeDamaged(false)
exports['FeloxAC']:isInvincible(true)
SetEntityInvincible(PlayerPedId(), true)
-- ...actigin her seyi geri birak
SetEntityInvincible(PlayerPedId(), false)
exports['FeloxAC']:isInvincible(false)
exports['FeloxAC']:canBeDamaged(true)
exports['FeloxAC']:proofsEnabled(true)

-- Ragdoll ve spectate de ayni sekilde bildirilir
exports['FeloxAC']:canRagdoll(false)
exports['FeloxAC']:setSpectatorMode(true)

Silahlar & hasar (client)

Bunların hiçbiri kendi başına silah vermez, almaz ya da hasar değiştirmez — scriptinin birazdan yapacağı şeyi whiteliste alırlar. Önce export'u, sonra native'i çağır.

kind şu string'lerden biridir (büyük/küçük harf farketmez): weaponDamage, meleeDamage, vehicleDamage, weaponDefense, weaponDefense2, meleeDefense.

local weapon = GetHashKey('weapon_pistol')

-- silah ver
exports['FeloxAC']:giveWeapon(weapon, 'my-weapon-shop')
GiveWeaponToPed(PlayerPedId(), weapon, 250, false, true)

-- geri al
exports['FeloxAC']:removeWeapon(weapon)
RemoveWeaponFromPed(PlayerPedId(), weapon)

-- silah başına hasar çarpanı
exports['FeloxAC']:setDamageModifier(weapon, 1.5)
SetWeaponDamageModifier(weapon, 1.5)

-- ...ve buff bitince
exports['FeloxAC']:removeDamageModifier(weapon)
SetWeaponDamageModifier(weapon, 1.0)

-- oyuncu geneli melee buff (spor salonu, PD, safezone...)
exports['FeloxAC']:setPlayerDamageModifier('meleeDamage', 1.8)
SetPlayerMeleeWeaponDamageModifier(PlayerId(), 1.8)

exports['FeloxAC']:removePlayerDamageModifier('meleeDamage')
SetPlayerMeleeWeaponDamageModifier(PlayerId(), 1.0)

-- Tum silah whitelist kayitlarini birden dusur
exports['FeloxAC']:removeAllWeapons()
RemoveAllPedWeapons(PlayerPedId(), true)

-- Admin araci bir senaryo / animasyon oynatiyor
exports['FeloxAC']:markToolScenario('WORLD_HUMAN_WELDING', 'my-admin-menu')

-- setNewDamage, setDamageModifier'in eski adi -- davranisi birebir ayni
exports['FeloxAC']:setNewDamage(weapon, 1.5)
SetWeaponDamageModifier(weapon, 1.5)

Entity, kamera & kanıt (client)

exports['FeloxAC']:CreateVehicle(GetHashKey('adder'))
local veh = CreateVehicle(GetHashKey('adder'), x, y, z, heading, true, false)

exports['FeloxAC']:ChangeVehiclePlate(veh, 'FELOX01')
SetVehicleNumberPlateText(veh, 'FELOX01')

-- Ped ve obje de tipki arac gibi bildirilir
exports['FeloxAC']:CreatePed(GetHashKey('a_m_y_business_01'))
local ped = CreatePed(4, GetHashKey('a_m_y_business_01'), x, y, z, heading, true, false)

exports['FeloxAC']:CreateObject(GetHashKey('prop_barrier_work05'))
local obj = CreateObject(GetHashKey('prop_barrier_work05'), x, y, z, true, true, false)

-- Texture dictionary'yi adiyla whitelist'le
exports['FeloxAC']:allowTexture('mpleaderboard')

-- Mesru freecam / admin kamerasi
local cam = CreateCam('DEFAULT_SCRIPTED_CAMERA', true)
exports['FeloxAC']:createCam(cam)
-- ...isin bitince
exports['FeloxAC']:destroyCam(cam)
DestroyCam(cam, false)
exports['FeloxAC']:destroyCams()   -- ya da tum handle'lari birden dusur

-- Girdiyi kilitleyen admin araci: arac acik kaldikca cagirmaya devam et
exports['FeloxAC']:disableCamControls()
exports['FeloxAC']:disableAllControls()

Araç değiştiricileri (client)

Scriptin araç fiziğini meşru şekilde değiştirdiğinde bunları çağır; speed-hack katmanı yeni değerleri bayrak atmak yerine referans olarak benimser.

SetVehicleCheatPowerIncrease(veh, 1.6)
exports['FeloxAC']:newCheatPowerIncrease(1.6)
exports['FeloxAC']:registerLegalSpeedModifier()

-- Maksimum hiz ve yercekimi de ayni sekilde bildirilir
SetVehicleMaxSpeed(veh, GetVehicleModelMaxSpeed(GetEntityModel(veh)) * 1.4)
exports['FeloxAC']:newTopSpeedModifier(1.4)   -- 1.1 ve altindaki degerler 1.1 sayilir

SetGravityLevel(2)
exports['FeloxAC']:newGravity(30.0)           -- 25.0 altindaki degerler 25.0 sayilir
exports['FeloxAC']:registerLegalSpeedModifier()

Moderasyon & teşhis (client)

local alive, lastHeartbeat, lastLoopTime = exports['FeloxAC']:isRunning()
if not alive then print('FeloxAC calismiyor') end

exports['FeloxAC']:banPlayer('Ozel client tespiti', { by = 'my-resource' }, -1)

-- Bunun yerine yerel oyuncuyu at
exports['FeloxAC']:kickPlayer('Ozel client tespiti', { by = 'my-resource' })

-- Bir event'i tetiklemeden once adini kontrol et
if exports['FeloxAC']:IsEventProtected('myresource:giveMoney') then
    print('bu event FeloxAC tarafindan korunuyor')
end

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