Yetkili Rolleri ve Komut Erişimi

Yetkili rolleri, ekibinde kimin CXA komutlarını ve oyun içi paneli kullanabileceğini ve orada neler yapabileceğini belirler. Örneğin bir moderatör oyuncuları atıp izleyebilirken ban yetkisini yalnızca adminlere verebilirsin. Roller hiçbir zaman anticheat'in birini kontrol etmesini engellemez; bunun için Yetkili Muafiyeti vardır.

Roller Muafiyet Değildir

Yetkili rolü olan bir oyuncu yine her tespit tarafından kontrol edilir. Bir yetkilinin hiç kontrol edilmemesi gerekiyorsa onu ayrıca Yetkili Muafiyeti ayarına da ekle.

Nasıl Çalışır

  • Roller Config.Permissions.Roles içinde tanımlanır. Varsayılan olarak üç rol vardır: owner, admin ve moderator. Kendi rollerini de ekleyebilirsin.
  • Her rolün bir görünen adı (Label) ve üç tür kuralı vardır: ACE izinleri (Aces), framework grupları (FrameworkGroups) ve tanımlayıcılar (Identifiers).
  • Kurallarından herhangi biri eşleşen oyuncu o rolü alır. Bir oyuncunun aynı anda birden fazla rolü olabilir.
  • Config.Permissions.Commands içindeki her komutun bir adı, bir Konsol anahtarı, bir Oyun içi anahtarı ve bir rol listesi vardır. Oyun içinde bir yetkilinin komutu kullanabilmesi için Oyun içi açık olmalı ve yetkilide listedeki rollerden en az biri bulunmalıdır.
  • Config.Permissions.Menu içinde oyun içi panelin her işleminin kendi rol listesi vardır.
  • Bir oyuncunun rolleri Config.Permissions.CacheSeconds süresi boyunca (varsayılan 30 saniye) önbellekte tutulur.
  • Rolü olan herkes ve yönetici ACE iznine (cxa.admin) sahip herkes, tespit uyarılarını sohbette alır.

Panelde Kurulum

Panelde Yapılandırma → Yetkili rolleri & komutlar bölümünü aç. Bölümde üç grup vardır:

GrupOrada neyi düzenlersin
Yetkili rolleriRoller, ACE izinleri, framework grupları ve yetkililer; ayrıca Rol önbelleği süresi
KomutlarKomut yetkileri tablosu: her komut için ad, Konsol, Oyun içi ve roller
Oyun içi panelPanel yetkileri tablosu (her işlem bir satır, her rol bir sütun) ve paneli açan Varsayılan tuş

İşin bitince Değişiklikleri kaydet'e tıkla. Sunucun yeni yapılandırmayı bir dakika içinde alır ve anticheat'i yeniden yükler; adı değiştirilen komutlar da bu sırada yeniden kaydedilir.

Yönetici uyarıları başka bir bölümdedir: Yapılandırma → Yetkili & Bypass → Yönetici. Aşağıdaki Yönetici Uyarıları bölümüne bak.

Yetkili Rolleri

Varsayılan Roller

Rol anahtarıGörünen adACE izniFramework gruplarıYetkililer
ownerOwnercxa.role.ownergodyok
adminAdmincxa.role.adminadmin, superadminyok
moderatorModeratorcxa.role.moderatormodyok

Bir rolü açmak için Yetkili rolleri içinde üzerine tıkla. Rolde dört alan vardır:

Paneldeki alanAnahtarNe yapar
Görünen adLabelOyun içi panelin üst kısmında görünen ad, örneğin Admin.
ACE izinleriAcesBu ACE izinlerinden birine sahip oyuncu rolü alır.
Framework grupları (ESX grup / QB izin)FrameworkGroupsBu ESX gruplarından birinde olan ya da bu QBCore/Qbox izinlerinden birine sahip oyuncu rolü alır.
Yetkililer (identifier)IdentifiersBu tanımlayıcılardan birine sahip oyuncular rolü alır, örneğin discord:123456789012345678.

Aynı roller config.lua dosyasında:

Config.Permissions = {
    CacheSeconds = 30,                       -- Bir oyuncunun rollerinin önbellekte kalma süresi
    Roles = {
        owner = {
            Label = 'Owner',
            Aces = { 'cxa.role.owner' },
            FrameworkGroups = { 'god' },     -- ESX grupları / QB izinleri
            Identifiers = {},                -- örn. 'discord:123456789012345678'
        },
        admin = {
            Label = 'Admin',
            Aces = { 'cxa.role.admin' },
            FrameworkGroups = { 'admin', 'superadmin' },
            Identifiers = {},
        },
        moderator = {
            Label = 'Moderator',
            Aces = { 'cxa.role.moderator' },
            FrameworkGroups = { 'mod' },
            Identifiers = {},
        },
    },
}

Lisansın aktifken panelde kaydettiğin değerler config.lua dosyasındakilerin yerine geçer.

Kendi Rolünü Eklemek

  1. Yetkili rolleri içinde "Yeni rol anahtarı, örn. support" alanına bir anahtar yaz, örneğin support.
  2. Rol ekle'ye tıkla. Yeni rol Support görünen adını ve cxa.role.support ACE iznini alır.
  3. Rolü aç ve framework gruplarını ya da yetkilileri ekle.
  4. Role Komutlar bölümünden komutlar, Oyun içi panel bölümünden panel işlemleri ver.
  5. Değişiklikleri kaydet'e tıkla.

Rol anahtarlarında küçük harf, rakam ve _ kullanılır; anahtar bir harfle başlar ve en fazla 24 karakterdir. En fazla 20 rolün olabilir.

Bir rolü silmek için rolü aç ve Rolü sil'e tıkla. Önce rolü tüm komutlardan ve panel işlemlerinden kaldır; yoksa kaydederken Kick bilinmeyen rol kullanıyor: support. gibi bir hata görürsün.

Örnek 1: Tek Bir Admin Grubu

En basit kurulum, bir ACE grubuna admin rolünü verir ve yetkililerini o gruba ekler. Bu satırları server.cfg dosyasına, ensure cxa-anticheat satırının altına ekle:

# "group.admin" ACE grubu CXA admin rolünü alır
add_ace group.admin cxa.role.admin allow

# Yetkililerin, her kişi için bir satır
add_principal identifier.fivem:1234567 group.admin
add_principal identifier.discord:123456789012345678 group.admin

Aynısını server.cfg kullanmadan da yapabilirsin: panelde admin rolünü aç ve fivem:1234567 ile discord:123456789012345678 değerlerini Yetkililer (identifier) alanına ekle.

Örnek 2: Birden Fazla Yetkili Seviyesi

Birkaç seviyesi olan bir ekipte her CXA rolüne kendi ACE grubunu ver ve üst grupların alttakileri add_principal ile miras almasını sağla. Miras, group.owner üyesinin group.admin ve group.moderator gruplarının tüm izinlerine de sahip olması demektir.

# Her CXA rolü için bir ACE grubu
add_ace group.owner cxa.role.owner allow
add_ace group.admin cxa.role.admin allow
add_ace group.moderator cxa.role.moderator allow

# Miras: sahipler aynı zamanda admin, adminler aynı zamanda moderatördür
add_principal group.owner group.admin
add_principal group.admin group.moderator

# Yetkililer
add_principal identifier.fivem:1234567 group.owner
add_principal identifier.discord:123456789012345678 group.admin
add_principal identifier.license:1234567890abcdef1234567890abcdef12345678 group.moderator

Bu satırlarla sahip üç rolün hepsine, admin admin ve moderator rollerine, moderatör ise yalnızca moderator rolüne sahip olur. Oyun içi panel, oyuncunun sahip olduğu tüm rolleri üst kısımda gösterir.

Tam İzin Ver

ACE izinleri bir ağaç gibi çalışır: add_ace group.admin cxa allow, cxa. ile başlayan tüm izinleri verir. Buna anticheat'i o grup için kapatan cxa.bypass da dahildir. Her zaman cxa.role.admin gibi tam rol iznini ver.

Komut Yetkileri

Paneldeki Komutlar bölümü her komutu bir satırda şu sütunlarla gösterir: Komut, Ad, Konsol, Oyun içi ve Roller.

KomutVarsayılan adKonsolOyun içiVarsayılan roller
Oyun içi panelcxaHayırEvetowner, admin, moderator
Oyuncu banlacxabanEvetEvetowner, admin
Identifier banlacxabanofflineEvetEvetowner, admin
Ban açcxaunbanEvetEvetowner, admin
Ban detayıcxabaninfoEvetEvetowner, admin, moderator
Oyuncu atcxakickEvetEvetowner, admin, moderator
Ekran görüntüsücxascreenshotEvetEvetowner, admin, moderator
Banları yenilecxareloadEvetEvetowner
Config senkronize etcxasyncEvetEvetowner
Event Guard eklecxainjectEvetSadece konsolyok
Event Guard kaldırcxauninjectEvetSadece konsolyok

Her sütunun işlevi:

  • Ad: oyuncuların ve konsolun yazdığı komut. Yalnızca harf, rakam ve _ kullan; en fazla 32 karakter olsun ve aynı adı iki kez kullanma. cxaban komutunu staffban yapmak için buraya staffban yaz. Başka hiçbir resource'un kullanmadığı adlar seç.
  • Konsol: komutu sunucu konsolunda kullanılabilir yapar. Kapalıyken konsol This command can only be used in-game. cevabını verir.
  • Oyun içi: komutu seçili rollerden birine sahip oyuncular için oyun içinde açar. Kapalıyken oyuncular This command can only be used from the server console. cevabını alır.
  • Roller: komutu oyun içinde kullanabilecek roller. Bu rollerden birine sahip olmayan oyuncular You do not have permission to use this command. cevabını alır.

Sohbetteki cevaplar sunucunun dil ayarını izler. Dil Türkçeyse oyuncular bu mesajları Türkçe görür, örneğin "Bu komutu kullanma yetkin yok.".

Bir komutu tamamen kapatmak için Ad alanını boşalt. Panel alanda "kapalı" gösterir ve komut hiç kaydedilmez.

cxainject ve cxauninject resource'larının fxmanifest.lua dosyalarını düzenlediği için yalnızca sunucu konsolundan veya web panelinden çalışır. Oyun içi sütunlarında kilit simgesi görünür ve onlara rol verilemez.

Tüm komutları, parametrelerini ve mesajlarını Konsol ve Sohbet Komutları sayfası anlatır.

-- Config.Permissions içinde. Name '' bir komutu kapatır.
Commands = {
    Menu = { Name = 'cxa', Console = false, InGame = true, Roles = { 'owner', 'admin', 'moderator' } },
    Ban = { Name = 'cxaban', Console = true, InGame = true, Roles = { 'owner', 'admin' } },
    OfflineBan = { Name = 'cxabanoffline', Console = true, InGame = true, Roles = { 'owner', 'admin' } },
    Unban = { Name = 'cxaunban', Console = true, InGame = true, Roles = { 'owner', 'admin' } },
    BanInfo = { Name = 'cxabaninfo', Console = true, InGame = true, Roles = { 'owner', 'admin', 'moderator' } },
    Kick = { Name = 'cxakick', Console = true, InGame = true, Roles = { 'owner', 'admin', 'moderator' } },
    Screenshot = { Name = 'cxascreenshot', Console = true, InGame = true, Roles = { 'owner', 'admin', 'moderator' } },
    Reload = { Name = 'cxareload', Console = true, InGame = true, Roles = { 'owner' } },
    Sync = { Name = 'cxasync', Console = true, InGame = true, Roles = { 'owner' } },
    Inject = { Name = 'cxainject', Console = true, InGame = false, Roles = {} },     -- Sadece konsol
    Uninject = { Name = 'cxauninject', Console = true, InGame = false, Roles = {} }, -- Sadece konsol
},

Oyun İçi Panel Yetkileri

Paneldeki Oyun içi panel bölümü her işlemi bir satırda, her rolü bir sütunda gösterir. Bir işlemi o role açmak için kutuyu işaretle. Rol adının altındaki tümü ve hiç bağlantıları o sütunun tamamını işaretler veya temizler.

İşlem (anahtar)Paneldeki adıVarsayılan roller
PlayersOyuncu listesini görowner, admin, moderator
IdentifiersIdentifierları görowner, admin
Spectateİzleowner, admin, moderator
GotoYanına gitowner, admin, moderator
BringYanına çekowner, admin, moderator
FreezeDondurowner, admin, moderator
ReviveCanlandır / iyileştirowner, admin
MessageÖzel mesajowner, admin, moderator
ScreenshotEkran görüntüsüowner, admin, moderator
KickAtowner, admin, moderator
BanBanlaowner, admin
BansBanları inceleowner, admin, moderator
UnbanBan açowner, admin

Paneli açabilmek için bir oyuncunun Oyun içi panel komutunun (cxa) rollerinden birine ve en az bir izinli işleme sahip olması gerekir. Oyuncu işlemlerine oyuncu listesinden ulaşılır; bu yüzden oyuncu işlemi olan her role Players işlemini de ver.

Aynı gruptaki Varsayılan tuş, paneli açan isteğe bağlı bir tuş belirler, örneğin F10. Paneli yalnızca komutla açmak için boş bırak. Her işlemi Oyun İçi Panel (/cxa) sayfası anlatır.

Yönetici Uyarıları

Bir tespit tetiklendiğinde CXA çevrimiçi her yetkiliye sohbette uyarı gönderebilir. Burada yetkili; yetkili rolü olan herkes ve yönetici ACE iznine sahip herkes demektir. İşaretlenen oyuncu uyarıyı asla almaz.

Output
[CXA] John (ID: 12) flagged for Noclip [kick]

(Sunucunun dili Türkçeyse uyarı [CXA] John (ID: 12) şüpheli bulundu: Yasadışı noclip kullanımı [kick] gibi görünür.)

Bunu Yapılandırma → Yetkili & Bypass → Yönetici bölümünden ayarla:

SeçenekAnahtarVarsayılanNe yapar
Yönetici ACE izniConfig.Admin.AcePermission'cxa.admin'Bu ACE iznine sahip oyuncular yetkili rolü olmasa da uyarı alır. Hiçbir komutu açmaz.
Oyun içi uyarılarConfig.Admin.InGameAlertstrueHer tespitte çevrimiçi yetkililere sohbet uyarısı gönderir.
Uyarı bekleme süresiConfig.Admin.AlertCooldown10Aynı oyuncu ve aynı tespit için iki uyarı arasındaki saniye (0 ile 600 arası).
Uyarı ön ekiConfig.Admin.AlertPrefix'[CXA]'Sohbetteki uyarıların ve komut cevaplarının başındaki metin (en fazla 24 karakter).

Cezası none olan tespitler sessizce engeller ve uyarı göndermez. Yardımcıların hiçbir komut almadan uyarıları görmesini istiyorsan onlara yalnızca yönetici ACE iznini ver:

# Yardımcılar tespit uyarılarını sohbette görür ama hiçbir CXA komutu almaz
add_ace group.helper cxa.admin allow

Sunucu sağlığı ayarlarında Oyun içi yönetici uyarıları açıksa sunucu sağlığı uyarıları da yetkililere sohbette ulaşır. Bkz. Sunucu Sağlığı.

Öneriler

Önerilir:

  • Herkese işini yapabileceği en düşük rolü ver.
  • Büyük ekiplerde miraslı ACE grupları kullan; böylece birini terfi ettirmek tek bir add_principal satırı olur.
  • Küçük ekiplerde Yetkililer (identifier) alanını kullan; herkesi panelde görürsün.
  • Banları yenile ve Config senkronize et komutlarını sahibe bırak.
  • Oyuncu işlemi olan her role Players işlemini de ver.

Kaçın:

  • Kalıcı kararlarda muhakemesine güvenmediğin moderatörlere Banla ve Ban aç yetkisi vermekten.
  • add_ace ... cxa allow kullanmaktan, çünkü bu cxa.bypass iznini de verir.
  • Rolleri ve muafiyeti karıştırmaktan: rol birinin araçları kullanmasını sağlar, muafiyet ise anticheat'in onu kontrol etmesini durdurur.

İlgili Özellikler

Yetkili Muafiyeti

  • Yetkili Muafiyeti, CXA'nın bir kişiyi kontrol etmesini durdurmanın tek yoludur.
  • Varsayılan muafiyet framework grupları varsayılan rol gruplarıyla çakışır; bu yüzden ESX ve QBCore adminlerinde varsayılan olarak ikisi de vardır.

Oyun İçi Panel (/cxa)

  • Oyun içi panel her yetkiliye yalnızca rollerinin izin verdiği işlemleri gösterir.
  • Yanına git, yanına çek, izle, dondur ve canlandır sırasında ilgili kontrolleri duraklatır; böylece muafiyeti olmayan yetkililer de onu kullanabilir.

Konsol ve Sohbet Komutları

Ekip Erişimi ve Uzaktan İşlemler

  • Web paneli erişimi oyun içi rollerden ayrıdır. Ekip Erişimi codexart.net hesaplarına lisansına erişim verir.
  • Uzaktan İşlemler, web sitesindeki ekip rolüne göre bazı komutları tarayıcıdan çalıştırır.

Sık Karşılaşılan Sorunlar

"You do not have permission to use this command."

Ne görürsün: Bir yetkili bir komut ya da /cxa yazıyor ve sohbette bu cevabı alıyor. (Bu komutu kullanma yetkin yok.)

Nasıl düzeltilir:

  • Oyuncunun, Komutlar bölümünde o komut için listelenen rollerden birine sahip olduğunu kontrol et.
  • Rolün kuralının gerçekten eşleştiğini kontrol et: server.cfg içindeki ACE satırı, framework grubunun tam adı ya da Yetkililer alanındaki tanımlayıcı.
  • Roller 30 saniye önbellekte tutulur. Bekle ya da oyuncudan yeniden bağlanmasını iste.
  • /cxa için oyuncunun Oyun içi panel bölümünde en az bir işleme de sahip olması gerekir.

"This command can only be used from the server console."

Ne görürsün: Bir komut konsolda çalışıyor ama oyun içinde çalışmıyor. (Bu komut sadece sunucu konsolundan kullanılabilir.)

Nasıl düzeltilir:

  • Komutlar bölümünde komutun Oyun içi seçeneğini aç ve en az bir rol seç.
  • cxainject ve cxauninject oyun içinde her zaman bu cevabı verir. Onları sunucu konsolundan veya web panelinden çalıştır.

Kaydederken "bilinmeyen rol kullanıyor" Hatası

Ne görürsün: Panel kaydetmeyi reddediyor ve Kick bilinmeyen rol kullanıyor: support. gibi bir mesaj gösteriyor.

Nasıl düzeltilir:

  • Bir komut veya panel işlemi artık var olmayan bir rolü hâlâ listeliyor. Rolü o satırdan kaldır ya da rolü tekrar ekle.

Adını Değiştirdiğim Komut Çalışmıyor

Ne görürsün: Bir komutun adını değiştirdin ama yeni ad oyun içinde tanınmıyor.

Nasıl düzeltilir:

  • Değişiklikleri kaydet'e tıkladığından emin ol. Sunucu bir dakika içinde anticheat'i yeniden yükler ve yeni adı kaydeder.
  • Adın yalnızca harf, rakam ve _ içerdiğini kontrol et.
  • Komutlar yalnızca anticheat çalışırken vardır. Lisans doğrulanmadıysa hiçbir CXA komutu kaydedilmez. Bkz. Lisans ve Sunucu IP'si.

Framework Grupları Tanınmıyor

Ne görürsün: Framework'ündeki admin grubunda olan oyuncular CXA rolünü almıyor.

Nasıl düzeltilir:

  • Framework'ündeki grubun tam adını kontrol et, örneğin ESX'te admin veya superadmin.
  • Framework'ünün server.cfg içinde cxa-anticheat'ten önce başladığından emin ol.
  • Standalone sunucularda framework grubu yoktur. Bunun yerine ACE izinlerini veya tanımlayıcıları kullan.

© 2026 CodeXart Studios · CXA Anticheat