txAdmin ile FiveM Discord Whitelist: Tam Kurulum Rehberi
txAdmin ile FiveM whitelist'in tek bir Discord rolüne dayanabilir: @Whitelist rolü olan oyuncular girer, diğer herkes kapıda reddedilir. Yetkililerin kabul ettiğinde bu rolü veren bir başvuru botu ekle; bir oyuncuyu whitelist'e almak için başvurusunu kabul etmek yeter. Kopyalanacak lisans yok, konsol komutu yok.
Toscio, txAdmin'in Discord rolüyle whitelist'iyle çalışır: kabulde verilen rol oyuncuyu içeri alır. Bu rehber sıfırdan ilk kabul edilen başvuruna kadar yaklaşık 15 dakika sürer.
Nasıl çalışır?
Üç parça, her birinin tek bir işi var:
| Parça | Ne yapar |
|---|---|
| @Whitelist rolü | FiveM sunucunun anahtarı |
| Toscio | Başvuruları Discord'da alır ve yetkililer kabul edince rolü verir |
| txAdmin | Rolü her bağlantıda kontrol eder ve rolü olmayan oyuncuları reddeder |
Oyuncu için: Discord'una katılır, Başvur'a tıklar, whitelist formunu doldurur, "başvurun kabul edildi" DM'ini alır, FiveM'i başlatır ve bağlanır. Ekibinden kimsenin txAdmin'i açması gerekmedi.
Bu rehber, güncel FXServer sürümleriyle gelen txAdmin 8 menülerini takip ediyor. Seçenek adları sürümden sürüme biraz değişebilir.
Başlamadan önce
İhtiyacın olanlar:
- txAdmin çalışan bir FiveM sunucusu ve ayarları değiştirebilen bir txAdmin hesabı;
- Discord'unda Sunucuyu Yönet izni;
- ID kopyalamak için Discord Geliştirici Modu: Kullanıcı Ayarları → Gelişmiş → Geliştirici Modu.
1. @Whitelist rolünü oluştur
- Discord'unda Sunucu Ayarları → Roller → Rol Oluştur yolunu aç.
- Adını Whitelist koy (ya da WL, Vatandaş… adın önemi yok).
- Role sağ tıkla ve Rol ID'sini Kopyala'yı seç. Bu numarayı bir kenara not et.
Sesli mülakat ya da bir ziyaretçi aşaması mı yürütüyorsun? Bir de @Kayıtsız rolü oluştur: Toscio başvuru kabul edilince onu alabilir.
2. txAdmin'in Discord botunu oluştur
txAdmin'in oyuncularının rollerini okumak için kendi botuna ihtiyacı var. Bu Toscio değil: sadece txAdmin'in kullandığı kendi botun.
- Discord Developer Portal'a git ve New Application'a tıkla. Ona sunucunun adını ver.
- Bot sekmesinde Reset Token'a tıkla ve token'ı kopyala. Asla paylaşma: botun tam kontrolünü verir.
- Yine Bot sekmesinde Server Members Intent'i aç ve kaydet. O olmadan txAdmin rolleri göremez.
- OAuth2 → URL Generator'da bot kapsamını işaretle, oluşan bağlantıyı aç ve botu Discord sunucuna ekle.
txAdmin'de Discord ayarlarını kaydetmek başarısız olursa ya da takılırsa, sebep neredeyse her zaman Server Members Intent'tir.
3. Botu txAdmin'e bağla
- txAdmin'de Settings'i, ardından Discord sekmesini aç.
- Discord Bot'u aç.
- Token'ı Token alanına yapıştır.
- Guild/Server ID alanına Discord sunucunun ID'sini yapıştır (sunucu adına sağ tıkla, Sunucu ID'sini Kopyala).
- Kaydet.
4. txAdmin'i Discord rolüyle whitelist'e geçir
- Yine Settings içinde Whitelist sekmesini aç.
- Allowlist Mode altında Discord Server Roles'ü seç.
- Allowlisted Discord Roles alanına @Whitelist rolünün ID'sini yapıştır. Virgülle ayırarak birkaç tane ekleyebilirsin (örneğin @Whitelist ve @Yetkili).
- Allowlist Instructions alanında reddedilen oyunculara nasıl başvuracaklarını söyle, örneğin: "discord.gg/sunucun adresine katıl ve #whitelist-başvuru kanalından başvur."
- Kaydet.
Artık txAdmin rolü olmayan her oyuncuyu reddeder. Denemeden önce rolü kendine ve yetkililerine ver.
5. Başvuruları Toscio ile al
Geriye sadece rolü otomatik vermek kaldı.
- Toscio'yu Discord'una ekle.
- Sunucu Ayarları → Roller bölümünde Toscio rolünü @Whitelist'in üstüne sürükle. Discord bir botun sadece kendi rolünün altındaki rolleri vermesine izin verir.
/toscio setupkomutunu şunlarla çalıştır:template: RP Whitelist;channel: oyuncuların başvuracağı yer, örneğin#whitelist-başvuru;staff-channel: whitelist ekibin için gizli bir kanal, örneğin#wl-başvuruları;role: @Whitelist;staff-role: varsa whitelist yetkili rolün.
Toscio Başvur butonlu paneli yayınlar ve başvuruların nereye düşeceğini onaylar. İlk formun 14 gün ücretsiz Premium ile gelir, kredi kartı gerekmez: tüm sorularıyla tam whitelist.
Sorularını seçmek için 53 FiveM whitelist başvuru sorusuna göz at, sonra formu form düzenleyicide düzenle. Form ayarlarında @Kayıtsız rolünün kabulde alınmasını da sağlayabilirsin.
6. Tüm akışı dene
İkinci bir Discord hesabıyla ya da bir arkadaşınla:
- Başvur'a tıkla, whitelist'i doldur ve gönder.
#wl-başvurularıkanalında başvuru kartındaki Kabul et'e tıkla.- Hesabın @Whitelist rolünü ve onay DM'ini aldığını kontrol et.
- Discord masaüstü uygulamasını aç, FiveM'i başlat ve bağlan: içeri girersin.
- Rolü al ve tekrar dene: txAdmin seni talimat mesajınla reddeder.
Yetkililerin ne görür?
Her başvuru; cevaplar, Discord hesap yaşı ve oyuncunun sunucuna ne zaman katıldığı bilgisiyle yetkili kanalına düşer, ayrıca üç buton:
- Kabul et: Toscio @Whitelist rolünü verir ve oyuncuya kendi dilinde DM atar. Hemen bağlanabilir.
- Reddet: oyuncu neyi geliştirmesi gerektiğini bilsin diye bir sebeple. 24 saatlik bekleme süresi (ayarlanabilir) spam yeniden başvuruları durdurur.
- Mülakat: oyuncuyla gizli bir alt başlık açılır. Yazılı olarak ek sorular sormak için birebir.
Oyuncuları içeri almadan önce sesli mülakat mı yapıyorsun? Form düzenleyicide kesin kabulden önceki aşamayı aç ve adını "Mülakat" koy. Karttaki yeşil düğme Onayla → Mülakat olur: oyuncu bir @Mülakat rolü ve saati içeren bir DM alır, mülakat uzarsa yetkililerin bir hatırlatma alır. Sonrasında Kabul et @Whitelist rolünü verir ve @Mülakat rolünü alır. Aşama ücretsiz.
Sık görülen hatalar
| Mesaj ya da belirti | Sebep | Çözüm |
|---|---|---|
| "You do not have the discord identifier" | FiveM oyuncunun Discord hesabını bulamıyor | FiveM'i başlatmadan önce Discord masaüstü uygulamasını (tarayıcıyı değil) aç |
| "You are required to join our Discord server" | Oyuncu txAdmin'de ayarlı Discord'da değil | Guild/Server ID'yi ve oyuncunun doğru sunucuya katıldığını kontrol et |
| "You do not have a allowlisted role" | Oyuncuda rol yok ya da yapıştırılan ID yanlış | Whitelist sekmesindeki rol ID'sini kontrol et |
| Toscio'da kabul başarısız | Toscio rolü @Whitelist'in altında | Sunucu Ayarları → Roller bölümünde Toscio rolünü yukarı taşı |
| txAdmin Discord ayarlarını kaydetmiyor | Eksik intent | Developer Portal'da Server Members Intent'i aç |
Oyuncu başvurduğu Discord hesabını kullanmalı: txAdmin, bilgisayarında açık olan Discord hesabının rolünü kontrol eder.
Peki lisans whitelist'i?
txAdmin bir de Approved License modu sunar: her oyuncunun txAdmin'in Allowlist sayfasında bir istek ID'siyle elle onaylanması gerekir. Çalışır, ama ekibinden birinin, başvurusunu okumanın üstüne bunu her oyuncu için yapması gerekir.
Discord rolüyle karar ve erişim aynı şeydir. Rolü almak erişimi kaldırır, yetkililerini ikinci bir rolle whitelist'e alabilirsin ve tüm whitelist geçmişi Discord'da kalır.
Daha ileri gitmek
- Ban itirazları: Discord'undan banlanan bir oyuncu artık başvuramaz. Web formu ve ban itirazlarıyla bir web sayfasından itiraz eder, yetkililerin kabul ederse Toscio banını kaldırır.
- Yetkili oylaması (Premium): birkaç whitelist yetkilisi her başvuruya oy verir, yeterli oy toplanınca Toscio karar verir.
- Kural testi: geçme eşiği olan 3 ya da 4 puanlı seçmeli soru (RDM, NLR, metagaming…). Kalan oyuncu otomatik reddedilir ve puanını alır, doğru cevapları asla görmez. Ücretsiz.
- CAD/MDT'ne webhook (Premium): alınan, aşamaya geçen, kabul edilen ya da reddedilen her başvuru, seçtiğin https adresine imzalı JSON olarak gönderilir (CAD/MDT, tablo, script). Toscio'nun oyun içi bir FiveM kaynağı yok: olayı kendi aracın alır ve onunla istediğini yapar.
- Discord'a katılmadan önce başvuru (Premium): txAdmin oyuncunun Discord'unda olmasını şart koşar. Henüz sunucuda olmayanlara açık web formuyla oyuncu sitenden başvurur; kabul edilince Discord'una tek tıkla, @Whitelist rolüyle katılır ve FiveM'e bağlanabilir.
- Birden fazla form: sivil whitelist, polis, EMS, yetkili… her birinin kendi rolü ve kanalıyla. Bkz. FiveM whitelist sayfası.
FiveApply ile kararsız mısın? Toscio mu FiveApply mı karşılaştırmasına bak.
Sorular
Discord ile FiveM whitelist nasıl kurulur?
txAdmin'de Discord botunu etkinleştir (Discord sekmesi), sonra Whitelist sekmesinde “Discord Server Roles” modunu seç ve @Whitelist rolünün ID'sini yapıştır. Sadece Discord'unda bu role sahip oyuncular bağlanabilir. Toscio gibi bir başvuru botu, yetkililerin başvuruyu kabul ettiğinde rolü verir.
Oyuncu neden “You do not have the discord identifier” hatası alıyor?
FiveM, oyuncunun Discord hesabını bulamadı. Oyuncunun FiveM'i başlatmadan önce Discord masaüstü uygulamasını (tarayıcı sürümünü değil) açması, sonra yeniden bağlanması gerekir.
txAdmin'in Toscio'nun yanında kendi Discord botuna ihtiyacı var mı?
Evet. txAdmin oyuncuların rollerini okumak için Discord Developer Portal'da oluşturulan kendi botunu kullanır. Toscio başvuruları yönetir ve rolü verir. İkisi birbirine karışmadan yan yana çalışır.
Birini whitelist'ten nasıl çıkarırım?
Discord'da @Whitelist rolünü al. txAdmin rolü her bağlantıda kontrol eder; bir sonraki denemesinde reddedilir.
Discord rolüyle whitelist ESX ve QBCore ile çalışır mı?
Evet. txAdmin kontrolü oyuncu bağlanırken, framework devreye girmeden önce yapar. ESX, QBCore, Qbox ya da özel bir framework'te aynı şekilde çalışır.
