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.Rolesiçinde tanımlanır. Varsayılan olarak üç rol vardır:owner,adminvemoderator. 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.Commandsiç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.Menuiçinde oyun içi panelin her işleminin kendi rol listesi vardır.- Bir oyuncunun rolleri
Config.Permissions.CacheSecondssü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:
| Grup | Orada neyi düzenlersin |
|---|---|
| Yetkili rolleri | Roller, ACE izinleri, framework grupları ve yetkililer; ayrıca Rol önbelleği süresi |
| Komutlar | Komut yetkileri tablosu: her komut için ad, Konsol, Oyun içi ve roller |
| Oyun içi panel | Panel 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 ad | ACE izni | Framework grupları | Yetkililer |
|---|---|---|---|---|
owner | Owner | cxa.role.owner | god | yok |
admin | Admin | cxa.role.admin | admin, superadmin | yok |
moderator | Moderator | cxa.role.moderator | mod | yok |
Bir rolü açmak için Yetkili rolleri içinde üzerine tıkla. Rolde dört alan vardır:
| Paneldeki alan | Anahtar | Ne yapar |
|---|---|---|
| Görünen ad | Label | Oyun içi panelin üst kısmında görünen ad, örneğin Admin. |
| ACE izinleri | Aces | Bu ACE izinlerinden birine sahip oyuncu rolü alır. |
| Framework grupları (ESX grup / QB izin) | FrameworkGroups | Bu ESX gruplarından birinde olan ya da bu QBCore/Qbox izinlerinden birine sahip oyuncu rolü alır. |
| Yetkililer (identifier) | Identifiers | Bu 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
- Yetkili rolleri içinde "Yeni rol anahtarı, örn. support" alanına bir anahtar yaz, örneğin
support. - Rol ekle'ye tıkla. Yeni rol
Supportgörünen adını vecxa.role.supportACE iznini alır. - Rolü aç ve framework gruplarını ya da yetkilileri ekle.
- Role Komutlar bölümünden komutlar, Oyun içi panel bölümünden panel işlemleri ver.
- 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.adminAynı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.moderatorBu 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.
| Komut | Varsayılan ad | Konsol | Oyun içi | Varsayılan roller |
|---|---|---|---|---|
| Oyun içi panel | cxa | Hayır | Evet | owner, admin, moderator |
| Oyuncu banla | cxaban | Evet | Evet | owner, admin |
| Identifier banla | cxabanoffline | Evet | Evet | owner, admin |
| Ban aç | cxaunban | Evet | Evet | owner, admin |
| Ban detayı | cxabaninfo | Evet | Evet | owner, admin, moderator |
| Oyuncu at | cxakick | Evet | Evet | owner, admin, moderator |
| Ekran görüntüsü | cxascreenshot | Evet | Evet | owner, admin, moderator |
| Banları yenile | cxareload | Evet | Evet | owner |
| Config senkronize et | cxasync | Evet | Evet | owner |
| Event Guard ekle | cxainject | Evet | Sadece konsol | yok |
| Event Guard kaldır | cxauninject | Evet | Sadece konsol | yok |
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.cxabankomutunustaffbanyapmak için burayastaffbanyaz. 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 |
|---|---|---|
Players | Oyuncu listesini gör | owner, admin, moderator |
Identifiers | Identifierları gör | owner, admin |
Spectate | İzle | owner, admin, moderator |
Goto | Yanına git | owner, admin, moderator |
Bring | Yanına çek | owner, admin, moderator |
Freeze | Dondur | owner, admin, moderator |
Revive | Canlandır / iyileştir | owner, admin |
Message | Özel mesaj | owner, admin, moderator |
Screenshot | Ekran görüntüsü | owner, admin, moderator |
Kick | At | owner, admin, moderator |
Ban | Banla | owner, admin |
Bans | Banları incele | owner, admin, moderator |
Unban | Ban 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.
[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çenek | Anahtar | Varsayılan | Ne yapar |
|---|---|---|---|
| Yönetici ACE izni | Config.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ılar | Config.Admin.InGameAlerts | true | Her tespitte çevrimiçi yetkililere sohbet uyarısı gönderir. |
| Uyarı bekleme süresi | Config.Admin.AlertCooldown | 10 | Aynı oyuncu ve aynı tespit için iki uyarı arasındaki saniye (0 ile 600 arası). |
| Uyarı ön eki | Config.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 allowSunucu 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_principalsatı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
Playersişlemini de ver.
Kaçın:
- Kalıcı kararlarda muhakemesine güvenmediğin moderatörlere Banla ve Ban aç yetkisi vermekten.
add_ace ... cxa allowkullanmaktan, çünkü bucxa.bypassiznini 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ı
- Konsol ve Sohbet Komutları her komutu, parametrelerini ve birebir mesajlarını anlatır.
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.cfgiç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.
/cxaiç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ç.
cxainjectvecxauninjectoyun 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
adminveyasuperadmin. - Framework'ünün
server.cfgiçindecxa-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