ZeroDev Sentinel dokümantasyonu

ZeroDev Sentinel: kurulum ve kullanım

ZeroDev Sentinel, FiveM için sunucu taraflı bir anti-cheat resource'udur. Sunucunun gördüklerini kaydeder, bunları kendini sade cümlelerle açıklayan kurallarla değerlendirir ve kimse cezalandırılmadan önce kanıtları staff'ınıza verir. Watch koruma seviyesinde başlar: siz başka bir şey seçene kadar sadece kayıt tutar ve kimseyi cezalandırmaz. Bu rehber, ESX, QBCore, Qbox ve standalone sunucularda 0.1.2 sürümünü kapsar.

ZeroDev Sentinel 0.1.2 için23 dk okumaGüncellendi:

1. Gereksinimler

  • OneSync açık (server.cfg içinde set onesync on). Resource, OneSync'i bağımlılık olarak bildirir; bu yüzden FXServer onu OneSync olmadan başlatmaz.
  • Node 22 script'lerini çalıştıran bir FXServer artifact'ı (güncel önerilen herhangi bir artifact; manifest node_version '22' ister). Hash'leme, sıkıştırma, dosya listeleme ve itiraz web rotasını Node yapar.
  • İsteğe bağlı: oxmysql. Onunla Sentinel kayıtlarını veritabanınızda tutar ve ilk açılışta kendi tablolarını oluşturur. İçe aktarılacak SQL dosyası yoktur. Onsuz her şey resource'un kendi key-value deposunda durur.
  • İsteğe bağlı: pma-voice, bir oyuncunun sesli sohbetini konsoldan veya tarayıcı panelinden dinlemek için.

Framework yalnızca iki şey için önemlidir: para ve item izi (hiçbir mağaza, meslek veya script'in ödemediği para ve item'lar, ödül döngüleri, rollback'ler) ve staff'ınızın kim olduğu (her framework'ün kullandığı ACE grupları). Tespit, vakalar, klipler, konsol, tarayıcı paneli, Discord ve owner desk her framework'te aynı şekilde çalışır.

2. Beş dakikada kurulum

Hiçbir şey SQL gerektirmez, ilk açılış için config düzenlemeye gerek yoktur ve başka hiçbir resource değiştirilmez.

Adım 1: Klasörü resources içine koyun

zerodev_sentinel klasörünü resources klasörünüze kopyalayın. Klasör adını aynen koruyun: guard dosyası zerodev_sentinel adresine bildirir ve klasörün adı farklıysa sentinel:guard sizi uyarır.

Adım 2: server.cfg'ye ekleyin

Depolama ve para izi açılışta onları bulabilsin diye oxmysql'den ve framework'ünüzden sonra başlatın. Framework'ünüz için tam sıra bölüm 3'tedir.

Adım 3: Sunucuyu başlatın

Konsol bir başlangıç kutusu ve tek kullanımlık bir sahip kodu yazdırır. Kutunun her satırı gerçek bir kontroldür; son satır READY ya da sorun sayısıyla birlikte NOT READY der (bölüm 15).

Adım 4: Sahip koltuğunu alın

Sunucuya girin ve sohbete /sentinel owner <code> yazın. Artık sahip koltuğu sizde (bölüm 4).

Adım 5: Owner desk'i açın

Oyunda F7'ye basın (veya F8'de sentinel:console yazın) ve OWNER'ı açın. First run sekmesi neyin bittiğini, neyin bitmediğini listeler: Discord, klip depolama, staff'ınız ve yetkileri. Her satırda bir buton vardır. Sonra birkaç gün Watch'ta oynayın, Sentinel'in bulduklarını Right now sekmesinde okuyun ve aynı desk'te koruma seviyesini Recommended'a geçirin (bölüm 6).

3. Framework'ünüz

Sentinel açılışta framework'ü ve inventory'yi kendisi bulur. Ayarlanacak bir şey yoktur. Sunucu konsolundaki sentinel:trail hangi adaptörü seçtiğini gösterir.

ESX Legacy

server.cfg
set onesync on
ensure oxmysql
ensure es_extended
# your other resources: inventory, jobs, shops ...
ensure zerodev_sentinel
  • Para ve item'lar: ESX'in kendi sunucu event'lerinden okunur (hesaba eklenen, çıkarılan veya ayarlanan para; inventory'ye eklenen veya çıkarılan item'lar; oyuncudan oyuncuya verilen item'lar, iki taraf birbirine bağlanarak). Rollback, ESX'in kendi oyuncu metotlarını kullanır ve sonucu geri okur.
  • ox_inventory ile ESX: para aynı şekilde takip edilir. Bu modda ESX'in item metotları sonuç bildirmez; bu yüzden Sentinel yalnızca geri okumaya göre karar verir.
  • Staff: admin'lerinize ACE yetkisini verin (bölüm 5). ESX'in kendi group.admin grubu, onun için satırı eklediğinizde ACE grubu olarak çalışır.

QBCore

server.cfg
set onesync on
ensure oxmysql
ensure qb-core
ensure qb-inventory      # or ox_inventory
# your other resources ...
ensure zerodev_sentinel
  • Para: QBCore'un para değişikliği event'inden okunur (ekleme, çıkarma ve ayarlama, sebebiyle birlikte). Aynı anda gerçekleşen bir kayıp ve eşit bir kazanç transfer olarak bağlanır, çünkü QBCore'un kendine ait bir transfer event'i yoktur.
  • Item'lar: ox_inventory ile item'lar onun hook'ları üzerinden takip edilir. qb-inventory ile item değişiklikleri takip edilmez (listener payload'ı belgelenmemiştir), ancak bir rollback item'ları yine de qb-inventory'nin belgelenmiş export'larıyla taşıyabilir.
  • Staff: QBCore'un yetki grupları ACE gruplarıdır (group.admin, group.god). Bölüm 5'teki ACE satırlarını ekleyin.

Qbox

server.cfg
set onesync on
ensure oxmysql
ensure ox_lib
ensure qbx_core
ensure ox_inventory
# your other resources ...
ensure zerodev_sentinel
  • Para: Qbox'un para değişikliği event'inden okunur; bakiyeler qbx_core'un kendi export'larıyla geri okunur. Çevrimdışı bir karakter için (citizen id ile) değiştirilen para event tetiklemez, bu yüzden izde yer almaz.
  • Item'lar: Qbox ox_inventory kullanır ve Sentinel item'larını ox_inventory'nin hook'ları üzerinden takip eder. Framework parasını temsil eden item'lar framework kısmına bırakılır.
  • Staff: QBCore'daki gibi ACE grupları.

Standalone (framework yok)

server.cfg
set onesync on
ensure zerodev_sentinel
  • Para ve item izi dışında her şey çalışır: hareket, dünya, event'ler, yem event'leri, godmode, state bag'ler, silahlar, vakalar, klipler, replay, konsol, panel, Discord, roller ve banlar.
  • ox_inventory varsa ve framework yoksa item'lar ox_inventory üzerinden takip edilir.
  • Depolama: key-value deposu ya da önce başlatırsanız oxmysql.

Çalıştığını kontrol etme

  • sentinel:health: başlangıç kutusu yeniden. Her satır gerçek bir kontroldür; READY hiçbir şeyin eksik olmadığı anlamına gelir.
  • sentinel:diag: depolamanın, adaptörlerin ve seviyenin neden seçildiği, sayaçlarıyla her kural ve en son kararlar.
  • sentinel:trail: kullanımdaki para ve item adaptörü ile bir oyuncunun son değişiklikleri.

Otomatik depolama modunda Sentinel oxmysql'i yalnızca oxmysql zaten başlamışsa kullanır (oxmysql başlarken 15 saniyeye kadar bekler); oxmysql daha sonra başlarsa key-value deposunu kullanır.

4. İlk çalıştırma: sahip koltuğu

İlk açılış, sunucu konsoluna 30 dakika geçerli tek kullanımlık bir kod yazdırır (sentinel:owner code yenisini yazdırır). Sunucuya girin ve /sentinel owner <code> yazın: koltuk hesabınıza bağlanır ve kod geçersiz olur.

Anahtarları, koruma seviyesini, rolleri ve yetkileri yalnızca sahip koltuğu değiştirebilir. Koltuğu başka bir hesaba taşımanız gerekirse sunucu konsolundaki sentinel:owner reset onu boşaltır.

5. Staff ve yetkiler

Owner desk'te STAFF: çevrimiçi bir oyuncu seçin, bir rol seçin, GRANT'e basın. Dört rol hazır gelir:

Rol Kutudan çıktığı haliyle yapabilecekleri
Destek vakaları görme, şikâyetleri ele alma, görev haritası
Moderator Support gibi, artı replay'ler, kick ve karantina
Admin Moderator gibi, artı ifşa, aklama, canlı izleme, ban talepleri, itirazlar
Senior admin Admin gibi, artı hemen geçerli olan bir ban

Yetkileri siz seçersiniz. Her rol, değiştirebileceğiniz bir anahtar listesidir. Bir kopyadan kendi rollerinizi oluşturun (örneğin "Trial mod"), istediğiniz rolü yeniden adlandırın ve birine rolünü değiştirmeden fazladan bir anahtar verin ya da birini geri alın. Tehlikeli olarak işaretlenen anahtarlar (anında ban, sesli sohbeti dinleme, ayarlar, staff yönetimi) ikinci bir basış ister. Her değişiklik staff kaydına yazılır; böylece kimin neyi değiştirdiğini her zaman görürsünüz.

ACE, onu zaten kullanan sunucularda çalışmaya devam eder ve her kontrolde okunur:

server.cfg
add_ace group.admin sentinel.admin allow
add_ace group.moderator sentinel.staff allow
add_principal identifier.fivem:1234567 group.admin
Yetki Verdiği rol
sentinel.admin Admin (sahip koltuğu alınana kadar Senior admin) ve oyundaki her sentinel:* komutu
sentinel.staff Moderator; hareket kuralları bir staff üyesinin kendi hareketini açıklanmış sayar

Bazı komutlar (sentinel:audit, sentinel:case, sentinel:replay, sentinel:save) kısıtlı olarak kayıtlıdır: oyunda ayrıca command.<name> gerektirirler. Yaygın add_ace group.admin command allow satırı bunu karşılar. Sunucu konsolu her komutu çalıştırabilir.

6. Koruma seviyesi

Owner desk'te tek bir anahtar (OWNER, PROTECTION), ayrıca sunucu konsolunda sentinel:level ve Config.Protection ayarı (config/config.lua içinde). Desk'te ayarladığınız değer kaydedilir ve yeniden başlatmadan sonra config satırının önüne geçer.

  • Watch: her kural izler ve ne yapacağını yazar; kimse uyarılmaz ve kimseye bir şey olmaz. Bu sırada Sentinel sunucunuzda neyin normal olduğunu öğrenir: event gözlemcisi (her event'in sıklığı ve şekli) ve giriş kontrolü yalnızca Watch'ta öğrenir; entity, çatışma ve para sınırları temiz oyundan öğrenmeye devam eder.
  • Recommended: her kural canlıdır. Staff kanıtlarla birlikte uyarı alır ve bir vaka açılır. Sentinel asla kendi başına ceza vermez; kararı staff'ınız verir.
  • Strict: Recommended gibi; ayrıca yüksek bir skor, staff bakana kadar oyuncuyu karantinaya alır. Kanıt seviyesindeki bir tespit (Tier A: tetiklenen bir yem event'i, sahte bir istek) ayrıca ban wave için bir banı sıraya koyar.

Anahtarın altında desk, her kuralı durumu ve bu durumun nereden geldiğiyle listeler. Sunucunuz gerektiriyorsa tek bir kuralı orada Live veya Shadow'a sabitleyin (örneğin kendi script'lerinizden birini sürekli işaretleyen bir kural); bir state satırı (Config.Rules içinde) onu config dosyasında sabitler ve desk'in önüne geçer.

Mantıklı bir sıra:

  1. Birkaç günlük normal oyun boyunca Watch.
  2. Kuralların ne yapacağını okuyun: Right now sekmesi, sentinel:diag rules (shadow sütunu bir kuralın kaç kez puan vereceğini sayar) ve sentinel:diag decisions 100.
  3. Güvendiğiniz birini işaretleyen her kuralı Shadow'a sabitleyin ve bize bildirin.
  4. Recommended'a geçin. Staff artık vakaları ve kanıtları görür; kimse otomatik olarak cezalandırılmaz.
  5. Recommended'ın size gösterdiklerine güvendiğinizde Strict.

İstediğiniz zaman geri dönmek için: desk'te Watch ya da sentinel:level watch.

7. Staff konsolu (F7)

Oyun içinde F7'ye basın (ya da F8'e sentinel:console yazın). Her oyuncu tuşu oyunun ayarlarından değiştirebilir (Key Bindings, FiveM). Esc kapatır.

  • Right now sunucunuzda ne olduğunu sade bir dille söyler: kim tehdit gibi görünüyor ve neden, ne kanıtlandı, ne açıklandı (bir revive, bir script'in kendi ışınlaması) ve neyin size ihtiyacı var. Önemli olan her oyuncuya bir satır düşer: ne yaptığı, bunun muhtemelen ne olduğu, Sentinel'in ne kadar emin olduğu (Unusual, Suspicious, Very likely, Proven), Sentinel'in zaten ne yaptığı ve tek bir sonraki adım.
  • Case files: önce açık vakalar; her birinde bulgu, kanıtlar, ekran klipleri, mühür (vakanın hash zincirinin hâlâ doğrulanıp doğrulanmadığı) ve REVEAL, QUARANTINE, CLEAR ve BAN tuşları (CLEAR ve BAN ikinci bir basış ister).
  • Duty map: adanın 3D modelinde çevrimiçi oyuncular. Arazi, ilk staff üyesinin oyunuyla ölçülür ve data/map/ içinde tutulur.
  • Play replay konsolu kapatır ve olayı özel bir dünyada tekrar oynatır; dönmek için Backspace'e basın.
  • Owner (yalnızca sahip koltuğu): First run, Protection, Keys, Staff, Internal affairs ve Server check.

Oyun içinde yazılan komutlar F8'e eğik çizgisiz, sohbete ise eğik çizgiyle yazılır (/sentinel:diag).

8. Tarayıcı paneli

Oyunda olmadığınız zamanlar için aynı masa bir web tarayıcısında:

  • sunucu PC'sinde: http://127.0.0.1:<port>/zerodev_sentinel/panel/ (port sunucu portunuzdur, varsayılan 30120)
  • başka bir yerden: http://<server address>:<port>/zerodev_sentinel/panel/, ya da bunun önündeki kendi HTTPS adresiniz

Giriş yapma. Tek kullanımlık bir kod kullanın: oyun içinde /sentinel panel yazın (kod yalnızca size gösterilir, bir kez ve 5 dakika boyunca çalışır) ya da sunucu konsolunda sentinel:panel <id or account> komutunu çalıştırın. Bir oturum 8 saat sürer; SIGN OUT ve END ALL MY SESSIONS onu sonlandırır. Rolünüz ve anahtarlarınız tarayıcıda oyun içindekiyle birebir aynı şekilde geçerlidir.

Canlı izleme. Canlı izleme anahtarı olan staff, çevrimiçi herhangi bir oyuncunun ekranını panelden veya konsoldan izleyebilir. Save to case'e basmadığınız sürece diskte hiçbir şey tutulmaz.

Dinleme. O oyuncunun sesli sohbetini dinlemek için dinleme anahtarı (varsayılan olarak yalnızca sahip) ve pma-voice gerekir. Ses kendi oyununuzdan çalar, bu yüzden aynı sunucuda oyun içinde olun.

Her canlı izleme ve her dinleme staff kaydına ve oyuncunun vakasına yazılır; oyunculara ilk girişlerinde staff'ın izleyip dinleyebileceği söylenir (kayıt bildirimi, Config.Notice).

9. Vakalar, karantina, kick, ban ve itirazlar

Bir şey bulunduğunda Right now oyuncuyu sade bir dille adlandırır: ne yaptığı, Sentinel'in ne kadar emin olduğu ve bu konuda ne yaptığı. Kanıtları (konumlar, SHA-256 ile mühürlenmiş ekran klipleri, 3D tekrar) görmek için vakayı açın ve tuşları kullanın:

  • REVEAL: oyuncunun identifier'larını gösterir.
  • QUARANTINE: staff bakana kadar oyuncuyu gerçek dünyadan özel bir routing bucket'a taşır. sentinel:release <server id> onu geri getirir.
  • CLEAR: hile yok; vakayı kapatır ve sıradaki banını durdurur.
  • KICK: oyuncunun okuduğu bir sebeple sunucudan atar.
  • BAN: bir itiraz koduyla, ban wave üzerinden.

Ban wave. Konsolda basılan bir BAN dahil tüm banlar ban wave için sıraya alınır ve yalnızca Strict'te, varsayılan olarak 2 ila 24 saat sonra rastgele bir zamanda uygulanır (Config.Actions). sentinel:wave bunları listeler, sentinel:wave now <account> birini hemen uygular, sentinel:wave cancel <account> iptal eder.

İtirazlar. Banlanan oyuncu ret mesajında bir itiraz kodu görür (8 harf ve rakam). İtiraz etmek için sunucuya giremez, bu yüzden itiraz size oyunun dışından ulaşır:

  1. Staff'ınız üzerinden. Oyuncu kodu staff'ınıza gönderir (bir Discord ticket'ı, e-posta). Bir staff üyesi bunu sentinel:appeal <code> <text> ile kaydeder.
  2. Web rotası üzerinden. Sentinel sunucunuzun kendi adresinde yanıt verir: http://<server address>:<port>/zerodev_sentinel/appeal. Yalnızca JSON { "code": "...", "text": "...", "contact": "optional" } içeren bir POST kabul eder (text 10 ila 2000 karakter); yani oyuncuları göndereceğiniz bir sayfa değil, web sitenizdeki bir form içindir. Kabul edilen her istek, kod bir banla eşleşse de eşleşmese de aynı yanıtı alır: 202 "received". Tek bir adresten (10 dakikada 5) veya toplamda (dakikada 30) çok fazla istek 429 alır. Kendi HTTPS reverse proxy'nizin arkasındaysa, limitlerin ziyaretçinin adresini sayması için set sentinel_http_proxy true ayarlayın.

Ret metni nereye itiraz edileceğini söylemez. Oyunculara kurallarınızda söyleyin ya da Config.Bans.message içine kendi bağlantınızla kendi metninizi yazın (%s kalsın, koda dönüşür), örneğin 'You are banned. Appeal at discord.gg/yourserver with code %s'.

Staff konsolda ya da sentinel:decide <case or code> accept|reject [note] ile karar verir. Accept o hesabın veya vakanın tüm aktif banlarını kaldırır ve sıradaki bir wave banını iptal eder; reject banı korur. Karar kesindir ve vaka günlüğüne yazılır. sentinel:appeals açık olanları listeler.

10. Şikâyetler ve internal affairs

Oyuncu şikâyetleri. Herhangi bir oyuncu, bir oyuncuyu veya bir staff üyesini şikâyet etmek için /report <server id> <what happened> yazar. Her iki oyuncunun çevresindeki son iki dakika bir vakaya kaydedilir. Staff bir şikâyeti işlem yapıldı, ihlal yok, kanıt yok veya mükerrer olarak kapatır. Staff hakkındaki şikâyetler yalnızca sahibe gider.

Internal affairs (yalnızca sahip, owner desk'te): her staff üyesinin ne yaptığı ve nelere bakılması gerektiği (kendine verilen yetkiler, çatışmada gizlenme, vakasız banlar, oyunculara ışınlanmalar). Haftalık bir adalet raporu data/reports/ içine yazılır; sentinel:staff report onu hemen yazar. Staff kaydındaki hiçbir şey staff'ı cezalandırmaz.

11. Bir resource'u korumak

Hiçbir kurulum olmadan Sentinel, oyuncuların script'lerinize gönderebildiği her event'i gözlemler ve oyuncuyu değerlendirir. Başka bir resource'un handler'ının çalışmasını durduramaz. Kötü bir çağrıyı script çalışmadan önce durdurmak için guard'ı o script'e ekleyin.

  1. sentinel:audit, başlatılmış her resource'un client'ların tetikleyebildiği event'lerini, handler'larının ne yaptığına göre derecelendirerek listeler (örneğin tutarını client'ın seçtiği parayı veren bir handler). Önce hangi resource'ları koruyacağınıza karar vermek için kullanın.
  2. sentinel:guard <resource>, eklenecek satırı ve resource'un server_scripts bölümünün nasıl görüneceğini yazdırır. Guard satırı ilk server script olmalıdır. Komut yalnızca yazdırır; hiçbir dosyayı değiştirmez.

lua server_scripts { '@zerodev_sentinel/guard/guard.lua', 'server/main.lua' }

  1. O resource'u yeniden başlatın. sentinel:guard <resource> artık "guarded since ..." der. Tek başına sentinel:guard korunan her resource'u listeler.
  2. sentinel:patch ile kural ekleyin. Bir resource'un kuralları olana kadar guard'ı her çağrıyı geçirir; karantinadaki oyunculardan gelen çağrılar hariç, bunları her guard düşürür. Örnek: 10 saniyede en fazla 3 satın alma, en fazla 32 karakterlik bir item adı ve 1 ile 10 arasında bir miktar; reddedilen bir çağrı kanıt sayılır ("hard": true):

text sentinel:patch myshop myshop:buy {"args":[{"type":"string","maxLen":32},{"type":"number","int":true,"min":1,"max":10}],"rate":3,"window":10000,"hard":true}

Bir framework callback'i için event olarak callback:<name> yazın: sentinel:patch es_extended callback:esx:getPlayerNames {"args":[{"type":"table","maxItems":4}]}. sentinel:patch <resource> bir resource'un kurallarını listeler; sentinel:patch <resource> <event> off birini kaldırır.

Guard asla dosya düzenlemez ve bir handler'ın aldığını asla değiştirmez. guard/guard.lua içinde sade, okunabilir Lua'dır.

12. Discord ve klip depolama anahtarları

En kolay yol owner desk, KEYS: her değeri yapıştırın ve SAVE'e basın. Anahtarlar yalnızca sunucuda tutulur; desk ve her yanıt yalnızca "set" der ve bir anahtarı bir daha asla göstermez.

Desk'teki satır Ne olduğu Ya da server.cfg'de (set kullanın, asla setr değil)
Discord bot token'ı discord.com/developers'ta oluşturduğunuz, sunucunuza davet edilmiş bir bot set sentinel_discord_token "..."
Discord sunucu ID'si sunucunuza sağ tıklayın, Copy Server ID (geliştirici modu açık) set sentinel_discord_guild "..."
Uyarı kanalı ID'si vakaların, staff'ınız için butonlarla paylaşıldığı yer set sentinel_discord_channel "..."
İtiraz kanalı ID'si itirazların paylaşıldığı yer set sentinel_discord_appeals "..."
FiveManage anahtarı fivemanage.com'dan bir medya anahtarı; klipler oraya yüklenir set sentinel_fivemanage_key "..."
Klip webhook'u FiveManage yerine: klipleri alan bir Discord webhook'u set sentinel_clip_webhook "..."
Klip depolama fivemanage, discord, off veya otomatik (ayarlanmış ilk seçenek) set sentinel_clip_storage "..."

server.cfg'deki bir anahtar desk'e üstün gelir ve desk bunu belirtir. Discord butonları konsoldaki rollerin ve anahtarların aynısına uyar. Bunların hiçbiri olmadan vakalar ve klipler sunucunuzda kalır (data/), konsol ve panel de onları gösterir.

Daha basit webhook uyarıları hâlâ çalışır: set sentinel_webhook "https://discord.com/api/webhooks/<id>/<token>" ya da sunucu konsolunda sentinel:webhook set <url>. sentinel:webhook test bir test mesajı gönderir; sentinel:webhook URL'yi asla yazdırmadan durumu gösterir; sentinel:webhook clear kayıtlı olanı kaldırır.

13. Her kural neyi yakalar

Her kural tetiklendiğinde ne gördüğünü ve neyi elediğini söyleyen sade bir cümle yazar. Bir kural birinin aleyhine sayılmadan önce Sentinel onu açıklayabilecek sebepleri kontrol eder (bir respawn, bir revive, bir staff işlemi, oyuncuları taşıyan veya onlara ödeme yapan kendi script'lerinizden biri). Açıklanan bir bulgu kaydedilir ve asla puanlanmaz.

  • Tier A kanıttır: yalnızca bir hilenin yaptığı bir şey (gerçek hiçbir script'in çağırmadığı bir yem event'i, sahte bir istek).
  • Tier B güçlüdür: bir staff üyesi bakmalıdır. Tek başına, yalnızca iki farklı aile hemfikir olduğunda veya aynısı tekrarlandığında vaka açar.
  • Tier C zayıftır: skora eklenir ve asla tek başına harekete geçmez.

Hareket

Kural Yakaladığı Açıklayan Tier
teleport İki örnek arasında 150 m'den fazla (veya mümkün olanın 3x'i) bir sıçrama spawn, respawn veya revive, routing bucket değişikliği, staff, script'inizin teleport event'i B
foot_speed Yaya olarak 1.5 s boyunca 12 m/s'nin üzerinde koşma; düşmüyor, ragdoll değil spawn, respawn, staff, script'iniz B
air_float Dondurulmuşken hareket etme (noclip); yere inmeden "düşme" (fly); oyun oyuncunun hareketsiz durduğunu söylerken koordinatlara göre hızlı hareket etme (speed menüleri) spawn, respawn, staff, script'iniz B
foot_rise Yaya olarak 3 s boyunca 4 m/s'den hızlı dümdüz yukarı tırmanma spawn, respawn, staff, script'iniz B
vehicle_speed Sınıfının sunucunuzda ulaştığı en yüksek hızın 1.3x'ini aşan bir araç staff, script'iniz B

Dünya

Kural Yakaladığı Açıklayan Tier
entity_blocked Engellediğiniz bir modeli spawn etme onu spawn eden script'leriniz B
entity_rate / entity_model_rate Dakikada, oyuncuların ve script'lerin yaptığından çok daha fazla entity (veya tek bir model) spawn etme spawn yapan script'leriniz B
entity_untrusted Onları spawn eden bir script olmadan bir client tarafından oluşturulan entity'ler spawn yapan script'leriniz B
entity_disguised Tek bir oyuncunun çevresinde aynı ambient ped modelinin ani yığılması (spawn'larını trafik gibi gizleyen bir menü) spawn, respawn, bucket değişikliği B
explosion_weapon / explosion_rate / explosion_hidden / world_distance Eldeki silahın yapamayacağı patlamalar, çok fazla patlama, görünmez patlamalar veya oyuncudan uzaktaki patlamalar script'lerinizin patlamaları B
projectile_weapon / projectile_rate Silahın atamayacağı projectile'lar veya çok fazlası B
ptfx_rate Parçacık efekti flood'ları (yaygın bir crash ve lag saldırısı) B
fire_rate Herhangi bir silahın izin verdiğinden daha hızlı başlatılan yangınlar B

Çatışma

Kural Yakaladığı Tier
damage_plausibility Silahın mümkün olan değerinin üzerinde hasar B
hit_range Silahın menzilinin ötesinden isabetler B
shot_rate / kill_rate Silahtan daha hızlı ateş etme; dakika başına kill sayısının sunucunuzun çok üzerinde olması B
silent_aim Oyuncunun nişan almadığı yere tekrar tekrar gelen isabetler B
aim_stats / aim_stats_backed 30+ çatışma boyunca sunucunuzdaki oyuncuların çok dışında kalan headshot oranı ve snap açıları C (başka bir aileyle B)
esp_los_backed Tanıkların duvar arkasında gizli olduğunu bildirdiği oyunculara tekrar tekrar nişan alma C'den B'ye

Event'ler ve istekler

Kural Yakaladığı Tier
bait_event Gerçek hiçbir script'in kullanmadığı, yerleştirilmiş bir event'i çağırma (hile menüleri bunları tarar ve tetikler) A
bait_statebag / statebag_write Yalnızca sunucunun yazması gereken state bag'leri yazma (kendini admin yapma, godmode bayrakları) veya aşırı büyük olanlar A / B
events_before_ready / _trap Oyuncu daha spawn bile olmadan gönderilen event'ler (girişten önce enjekte edilmiş) B / A
event_rate / event_shape Normalden çok daha hızlı çağrılan ya da argümanları sunucunuzun normal çağrılarına benzemeyen bir event B
event_flood 10 s içinde 500+ çağrı; FiveM'in kendi overflow kick'inde en çok çağrılan event'ler listelenir B
guard_rule / guard_hard Korunan bir event'e koyduğunuz bir kuralı çiğneme (miktar, hız, mesafe) B / A

Ekonomi

Kural Yakaladığı Tier
money_nowhere / item_nowhere Hiçbir mağazanın, mesleğin veya script'in vermediği para veya item'lar (dev event'leri, sızmış mağaza satışları) B
economy_repeat 30 s içinde 10 kez ödenen bir ödül veya meslek event'i (döngüde çağırarak farm yapma) B
money_jump / money_rate Ani bir bakiye sıçraması veya sunucunuzun çok üzerinde bir kazanç hızı B
economy_trap Gerçek hiçbir mesleğin ödemediği, yerleştirilmiş bir ödülü alma A
weapon_not_owned Envanterin hiç vermediği bir silahı taşıma B

Oyuncunun oyunu (tanık)

Kural Yakaladığı Tier
godmode Sunucu oyuncuyu 30 s boyunca ölümsüz okur (ortak bir güvenli bölge değil) B
witness_backed Oyundan gelen, sunucunun kendi görüşüyle desteklenen işaretler (godmode, görünmezlik, çarpışma yok) B
witness_bait Oyunun, bilmemesi gereken bir kontrole yanıt vermesi A
witness_tamper Sentinel'in oyundaki kendi kontrolleri hook'landı veya değiştirildi B

Kimlik ve dosyalar

Kural Yakaladığı Tier
ban_fingerprint Banlı bir oyuncunun yeni bir hesapla geri dönmesi (donanım token'ları, identifier'lar, tarayıcı parmak izi) A / flag
young_account Yepyeni bir hesap (yalnızca ağırlık ekler) C
scanner_error / too_large Script tarayıcısının okuyamadığı resource'lar veya bakmaya değer aşırı büyük dosyalar info

Hiçbir kuralın vaat etmedikleri

Sentinel, sunucunun görebildiğini ve oyuncunun oyununun bildirdiğini değerlendirir. Oyuncunun PC'sindeki diğer programları okumaz ve hiçbir anti-cheat her hilenin yakalanacağını vaat edemez. Her bulgu kanıtıyla birlikte gelir, böylece staff'ınız gerçeklere göre karar verir.

14. Komutlar ve yapılandırma

Her komut komutlar sayfasında, her config anahtarı da yapılandırma sayfasında yer alır; ikisi de doğrudan resource'un kendisinden üretilir. En çok kullandıklarınız:

Komut Ne yapar
/sentinel owner <code> konsoldaki kodla oyun içinde sahip koltuğunu alır
/sentinel panel tarayıcı paneli için tek kullanımlık giriş kodu (yalnızca staff)
/report <server id> <what happened> herhangi bir oyuncu bir oyuncuyu veya bir staff üyesini şikâyet eder
sentinel:health başlangıç kutusu yeniden
sentinel:diag Sentinel'in neye karar verdiği ve neden
sentinel:level watch\|recommended\|strict koruma seviyesini değiştirir ve kaydeder
sentinel:wave ban wave için sıraya alınmış banlar
sentinel:appeals açık itirazlar
sentinel:audit başlatılmış her resource'un riskli event'leri
sentinel:guard <resource> bir resource'u koruyan satır
sentinel:advisor sunucunuzda değiştirmeye değer FiveM ayarları

config/ içindeki config dosyaları (config.lua, protection.lua, watch.lua) ve config/locales/ içindeki çeviriler size açıktır; bridge/ içindeki framework adaptörleri ve guard/ içindeki guard dosyası da öyle. Bunları geçerli Lua olarak tutun ve bir değişiklikten sonra zerodev_sentinel resource'unu yeniden başlatın. İlk başlatma için config düzenlemesi gerekmez.

15. Başlangıç kutusu ve sıkılaştırma danışmanı

Depolama hazır olduktan bir an sonra Sentinel sunucu konsoluna bir kutu yazdırır. FAIL satırı Sentinel'in düzgün çalışamadığı anlamına gelir; WARN satırı daha azıyla çalıştığı anlamına gelir (örneğin digest'siz kanıt). sentinel:health ile istediğiniz zaman yeniden yazdırın.

Satır Neyi kontrol eder OK olmadığında
Build fxmanifest.lua'daki sürüm ve build etiketi. -
OneSync onesync convar'ı. Sentinel konumları, entity'leri ve oyun event'lerini OneSync üzerinden okur. server.cfg'ye set onesync on yazın
Çalışan kopyalar Klasörünün adı ne olursa olsun, resource'un kaç kopyasının başlatıldığı. 1 olmalıdır. Sentinel'in tek bir kopyasını tutun; diğer klasörü durdurun
Depolama Hangi depolamanın seçildiği (mysql veya kvp) ve hazır olup olmadığı. sentinel:diag storage çıktısına bakın
Kanıt klasörü Resource içindeki data/archive'da bir test yazması ve okuması. Sentinel resource'unun içinde data/archive klasörünü oluşturun ve sunucunun oraya yazabildiğinden emin olun
SHA-256 node/util.js'in yanıt verip vermediği; her kanıt parçasının parmak izini o çıkarır. kanıtlar digest'siz kaydedilir; konsolda bir Node hatası olup olmadığına bakın
Koruma Koruma seviyesi, modu ve nereden geldiği. -
Kurallar Kaç kuralın live, kaçının shadow'da olduğu. -

Başlangıç kutusundan sonra danışman, sunucunuzda değiştirmeye değer FiveM ayarlarını yazdırır (Config.Advisor.atStartup = false ile yalnızca sentinel:advisor komutunda yazdırır). Her ayar için mevcut değeri, önerilen değeri, neyi engellediğini, neyi bozabileceğini ve kopyalanacak satırı gösterir. Değerleri yalnızca okur; server.cfg'yi asla değiştirmez. Bir satırı kalıcı yapmadan önce sunucunuzda test edin.

16. Diller ve neyin kaydedildiği

Oyuncu ve staff metinleri config/locales/<code>.lua dosyalarından gelir; bu build'de 25 dil var. Config.Locale dili seçer; Config.GameLanguage = true ile, oyunu GTA'nın sunduğu bir dilde çalışan oyuncu, oyuna girdiğinde Sentinel'i o dilde okur.

Sentinel her oyuncu için yaklaşık son iki dakikanın konumlarını ve event'lerini bellekte tutar (Config.Recorder) ve bunları data/archive/ içindeki bir arşive, bir vaka açıldığında ya da staff sentinel:save kullandığında yazar. Bir inceleme sırasında şüphelinin oyunundan ekran klipleri ister (20 saniyelik parçalar) ve bunları data/clips/ içinde saklar. FiveM'in sunucuya verdiği identifier'ları (bir IP adresi kaydedilir ama varsayılan olarak asla bir bağlantıyı reddetmek için kullanılmaz) ve Discord çalışıyorsa Discord ID'sini saklar. Her oyuncu ilk girişinde kendi dilinde, sunucunun oyunu kaydettiğini ve staff'ın izleyip dinleyebileceğini bildiren kısa bir bildirim alır (Config.Notice = false bunu kapatır; o zaman bunu kurallarınızda söyleyin). Gizlilik politikanızda da belirtin.

Eski arşivler ve klipler bu build'de otomatik silinmez: artık ihtiyacınız kalmadığında data/archive/ ve data/clips/ klasörlerini kendiniz temizleyin.

oxmysql ile Sentinel'in kayıtları zds_account, zds_ban, zds_setting, zds_pair, zds_exemption, zds_case, zds_schema, zds_report ve zds_trail tablolarındadır. oxmysql olmadan aynı kayıtlar resource'un key-value deposunda durur (zds: ile başlayan anahtarlar). Banlar her zaman key-value deposuna yansıtılır, böylece veritabanı kapalıyken de uygulanmaya devam eder.

17. Güncelleme

Yeni sürümler aynı Keymaster asset'ine yayınlanır. Sentinel kanıtlarını kendi klasörünün içinde tutar, bu yüzden onu değiştirmeden önce:

  1. zerodev_sentinel klasörünün config/ ve data/ klasörlerini (arşivler, klipler, raporlar, öğrenilmiş baseline'lar) ve oxmysql kullanıyorsanız zds_ tablolarını yedekleyin.
  2. Sunucuyu durdurun, zerodev_sentinel klasörünü yenisiyle değiştirin (klasör adını koruyun) ve data/ klasörünüzü geri koyun. Değiştirdiğiniz ayarları, eski dosyaları üzerlerine kopyalamak yerine yeni config dosyalarına taşıyın.
  3. Sunucuyu başlatın ve başlangıç kutusunu okuyun (sentinel:health).

Güncellemeden önce yeni sürümün sürüm notlarını değişiklik günlüğünde okuyun.

18. Kaldırma

  1. Koruduğunuz her resource'tan guard satırını kaldırın (sentinel:guard bunları listeler) ve o resource'ları yeniden başlatın. Bunu ilk önce yapın: klasör gittiğinde guard dosyası da gider.
  2. server.cfg'den ensure zerodev_sentinel satırını ve sentinel.admin / sentinel.staff satırlarını kaldırın, ardından resource'u durdurun. sentinel:lockdown entity lockdown'ı değiştirdiyse, Sentinel'i durdurmak orijinal modu geri getirir.
  3. zerodev_sentinel klasörünü silin. Bu, tüm arşivler, klipler ve raporlarla birlikte data/ klasörünü de kaldırır; saklamak istediğiniz her şeyi önce dışarı kopyalayın.
  4. oxmysql kullanıyorsanız, banları ve vakaları artık istemiyorsanız bölüm 16'da listelenen zds_ tablolarını drop edin. Key-value kayıtları sunucunun deposunda resource'un adı altında kalır ve o olmadan hiçbir şey yapmaz.

Sentinel yalnızca kendi klasörüne, kendi veritabanı tablolarına ve kendi key-value deposuna yazar. Başka resource'ları veya server.cfg'yi düzenlemez.

Sık sorulan sorular

Sentinel kendi başına birini banlar veya kickler mi?

Watch veya Recommended'da hayır. Watch ile başlar; burada yalnızca ne yapacağını kaydeder. Recommended'da staff kanıtları alır ve karar verir. Yalnızca Strict'te yüksek bir skor, staff bakana kadar oyuncuyu karantinaya alır ve kanıt seviyesindeki bir bulgu ban wave için bir banı sıraya koyar.

Veritabanına ihtiyacım var mı?

Hayır. oxmysql ile Sentinel kayıtlarını veritabanınızda tutar ve ilk başlatmada kendi tablolarını oluşturur; içe aktarılacak SQL dosyası yoktur. oxmysql olmadan her şey resource'un kendi key-value deposunda durur.

QBCore ve Qbox'ta çalışır mı?

Evet. Tespit, vakalar, klipler, konsol, tarayıcı paneli, Discord ve owner desk her framework'te aynıdır. Para ve item izinin ESX, QBCore, Qbox ve ox_inventory için kendi adaptörü vardır.

Admin'lerime nasıl erişim veririm?

Owner desk'te, STAFF: çevrimiçi bir oyuncu seçin, bir rol seçin, GRANT'e basın. Ya da ACE kullanmaya devam edin: sentinel.admin Admin, sentinel.staff Moderator verir.

Banlanan bir oyuncu itiraz edebilir mi?

Evet. Ret mesajı bir itiraz kodu gösterir. Oyuncu bunu staff'ınıza gönderir, onlar da sentinel:appeal ile kaydeder; ya da web siteniz bunu Sentinel'in itiraz rotasına gönderir. Staff bunu konsolda veya sentinel:decide ile kabul ya da reddeder.

Oyuncunun PC'sindeki hile programlarını görebilir mi?

Hayır. Sentinel, sunucunun görebildiğini ve oyuncunun oyununun bildirdiğini değerlendirir. Oyuncunun PC'sindeki diğer programları okumaz.

Sesli sohbeti dinleme hazır mı?

pma-voice ve dinleme anahtarı (varsayılan olarak yalnızca sahip) gerekir; ses kendi oyununuzdan çalar.

Oyuncular ne görür?

İlk girişlerinde, kendi dillerinde, sunucunun oyunu kaydettiğini ve staff'ın izleyip dinleyebileceğini bildiren kısa bir bildirim (Config.Notice). Temiz bir oyuncu için başka hiçbir şey değişmez.

İngilizceden çevrilmiştir. Buradaki herhangi bir bilgi İngilizce sayfayla çelişirse İngilizce sayfa geçerlidir. English