Kitle: FiveM sunucu sahipleri ve geliştiricileri
Zorluk: Kolay → Orta
Sonuç: Discord rolleri kullanarak rol tabanlı izin listesi (isteğe bağlı kara liste ile), minimum bakım, net oyuncu geri bildirimi.
Sürümler hakkında not: Açık kaynak depo
FAXES/DiscordWhitelisttopluluk tarafından bakımı yapılmaktadır ve en son 2022'de güncellenmiştir. Hala birçok sunucuda çalışmaktadır. Bakımı yapılan ticari bir sürüm mevcuttur; destek\/SLA'ya ihtiyacınız varsa, bunu değerlendirin. Bu kılavuz ücretsiz GitHub sürümünü kapsar.
Özetle;
- Bir Discord oluşturun Bot → etkinleştir Sunucu Üyeleri Niyeti → onu Discord'nize davet edin.
- Kopyalayın: Guild (Sunucu) ID Ve Rol ID(leriniz).
- İndirmek: GitHub üzerinde FAXES\/DiscordWhitelist → içine koyun
resources/→ yapılandırınserver.js. - Eklemek
ensure DiscordWhitelistileserver.cfg(veya txAdmin'de başlatın). - Test: rol olmadan katıl (engellendi) → rol ekle → yeniden katıl (izin verildi).
İlgili eğitimler:
• FiveM Beyaz Liste — Tam Kılavuz (txAdmin, Scripts, DB)
• Discord Bağış Katmanları Nasıl Oluşturulur
Neden Discord tabanlı Beyaz Listeleme?
- Dinamik: Bir Discord rolü ekleyerek\/kaldırarak erişim izni ver\/reddet—ACE veya DB düzenlemesi yok.
- Ölçeklenebilir: Moderatörler, mobilde Discord'den erişimi yönetebilir.
- Denetlenebilir: Rol geçmişi + moderasyon günlükleri, kimin kime izin verdiğini gösterir.
Ön koşullar
- Bir Discord sunucusu (Admin/Sahip sizsiniz).
- txAdmin veya manuel kontrol ile FiveM sunucusu.
- Oyuncuların sahip olması gereken Discord masaüstü uygulaması çalışıyor bağlanırken (böylece FiveM bir
discord:tanımlayıcı ortaya çıkarır).
Adım 1 — Bir Discord Botu Oluşturun ve Niyetleri Etkinleştirin
- Git Discord Geliştirici Portalı → Yeni Uygulama → adlandırın (örneğin,
FiveMX Whitelist Bot). - Bot Ekle (Bot sekmesi) → Token'ı Sıfırla → kopyalayın Bot Token'ı (güvenli bir şekilde saklayın).
- Altında Ayrıcalıklı Ağ Geçidi Niyetleri, olanak vermek Sunucu Üyeleri Niyeti. (Varlık niyeti gerekli değildir.)
- Botu davet et Discord'nize: OAuth2 → URL Oluşturucu → Kapsamlar:
bot; İzinler: minimum (katılmak dışında hiçbiri olabilir). Oluşturulan URL'yi kullanın ve sunucunuza ekleyin.
Güvenlik: Bot Token'ını bir şifre gibi ele alın. Bunu Olumsuz Git'e göndermeyin veya ekran görüntülerinde paylaşmayın. Sızdırılırsa değiştirin.
Adım 2 — ID'lerinizi Alın (Sunucu ve Roller)
- Discord'da → Kullanıcı Ayarları → Gelişmiş → Geliştirici Modu: AÇIK.
- Sağ tıklayın sunucu adı → Sunucu Kimliğini Kopyala.
- Sunucu Ayarları → Roller → beyaz liste olarak kullanacağınız rolü sağ tıklayın (örneğin,
Whitelisted) → Rol Kimliğini Kopyala. - (İsteğe bağlı) İstediğiniz herhangi bir rol için Kimlikleri kopyalayın blacklist (örneğin,
Banned).
Bunları el altında bulundurun:
GUILD_ID = 123456789012345678WHITELIST_ROLE_IDS = ["111111111111111111", "222222222222222222"]BLACKLIST_ROLE_IDS = ["333333333333333333"]
Adım 3 — Kaynağı İndir ve Yükle
- İndirmek ZIP'den FAXES/DiscordWhitelist (GitHub).
- Sunucunuza şuraya çıkarın:
resources/[discord]/DiscordWhitelist - Klasörün en az şunları içerdiğini doğrulayın:
fxmanifest.luaserver.jspackage.json
sunucu.cfg (veya txAdmin Tarif / Başlangıç):
# Start after your identifier providers and before join‑logic that depends on it ensure DiscordWhitelist
İçinde txAdmin → Kaynaklar, işaretle DiscordWhitelist başlangıçta çalışacak şekilde (kaynakları UI üzerinden yönetiyorsanız).
Erişim stratejinizi mi planlıyorsunuz? Daha geniş rehberimizi okuyun: FiveM Beyaz Liste — Tam Kılavuz (txAdmin, Scripts, DB) alternatifler (ACE, DB, hibrit) ve ne zaman kullanılacağı hakkında.
Adım 4 — Yapılandır server.js
Açık resources/[discord]/DiscordWhitelist/server.js ve yapılandırma bloğunu ayarlayın. Dosya zaten basit bir yapılandırma nesnesi açığa çıkarıyor olabilir—değerleri buna göre ayarlayın. Tipik bir yapılandırma şuna benzer:
// DiscordWhitelist configuration — example
const config = {
botToken: "PASTE_YOUR_DISCORD_BOT_TOKEN_HERE",
guildId: "123456789012345678", // Your server (guild) ID
// Players must have at least ONE of these role IDs to join
whitelistRoles: [
"111111111111111111", // Whitelisted
// "222222222222222222", // Staff (optional)
],
// If a player has ANY of these roles, reject the connection
blacklistRoles: [
// "333333333333333333", // Banned
],
// Cache fetched role data to reduce Discord API calls (seconds)
cacheMaxTime: 90,
// Deferral messages
messages: {
noDiscord: "Open Discord and rejoin. Your Discord app must be running.",
notWhitelisted: "You are not whitelisted. Join our Discord: discord.gg/yourinvite",
blacklisted: "Access denied. Please contact staff.",
welcome: "Welcome — you are verified. Loading…"
},
};
Para kazanma ipucu: Sunucunuz avantajlar kullanıyorsa, bunu şununla eşleştirin: Discord Bağış Katmanları destekçiler/bağışçılar için rol tabanlı avantajları otomatikleştirmek.
Dosyayı kaydet.
Adım 5 — Yeniden Başlat ve Test Et
- Tekrar başlat sadece kaynak veya tüm sunucu:
txAdmin → Restart resourceveya konsolrefreshDaha sonrarestart DiscordWhitelist. - Negatif test: Bağlanmayı deneyin olmadan whiteliste rolü → erteleme mesajını görmeli ve atılmalısınız.
- Olumlu test: Kendinize whitelist rolünü verin → yeniden bağlanın → içeri alınmalısınız.
İsteğe Bağlı: Birden Çok Rol ve Personel Atlatması
- Eklemek birden fazla beyaz liste rolü birden çok kanal ağına izin vermek için (örneğin,
Donator,Police,EMS). - Eklemek kara liste rolleri whiteliste bakılmaksızın zorlu engellemeler için (örneğin,
Banned). - Şunları içerebilirsiniz: personel rolü içinde
whitelistRolesyöneticiler için erişimi doğrulamak.
Operasyonel İpuçları
- Otomasyon: Discord rol atamasını şuna bağlayın: başvuru formları veya bilet onayları (örneğin, bir bot, Google Formlar → webhook → rol ekleme).
- Oyuncu Kullanıcı Deneyimi: Bir
#how-to-whitelist✅ rol gereksinimleri ve sunucu davetiniz ile gönderi. - Ilımlılık: Rol değişikliklerini özel bir kanala kaydedin
#mod-logskanal.
Sorun giderme
“Bot çevrimdışı” veya rolleri asla güncellemez
- Token yanlış veya bot doğru sunucuya davet edilmemiş.
- Sunucu Üyeleri Niyeti etkin değil.
- Güvenlik duvarı, oyun ana bilgisayarınızdan giden HTTPS'yi engeller (Discord API'ye izin verin).
“Discord tanımlayıcısı bulunamadı” / herkes engellendi
- Oyuncular şunu çalıştırmalıdır: Discord masaüstü uygulaması FiveM'yi başlatmadan önce. Onlardan Discord'yi, sonra FiveM'yi yeniden başlatmalarını isteyin.
Rol değişiklikleri yalnızca yeniden başlatmadan sonra geçerlidir
- Azaltmak
cacheMaxTime30–60 saniyeye. - Aşırı derecede düşük ayarlayıp yine de gecikmeler görüyorsanız, hız sınırlarını kontrol edin ve sık sık yeniden başlatmaktan kaçının.
403/Sunucu üyeleri alınırken izin hatası
- Botun hedef sunucuda olduğundan emin olun Ve Sunucu Üyeleri Niyeti etkinleştirildi.
- Bot Olumsuz Üye rollerini okumak için Yönetici izinlerine ihtiyaç duyar.
Yüksek API kullanımı / hız sınırlaması
- Artır
cacheMaxTime. API çağrılarını spam yapan toplu atmalardan/yeniden başlatmalardan kaçının.
Güvenlik En İyi Uygulamaları
- Sakla Bot Token'ı sürüm kontrolünün dışında. Yapılandırmaları kendiniz barındırıyorsanız, bunları düz metin olarak Git'e işlemek yerine bir ortam değişkeninden veya server.cfg convar'ından okumayı düşünün.
- Döndür token sızdırılırsa.
- Kaynağa kimin yazma erişimi olacağını kısıtlayın.
Kaldır / Devre Dışı Bırak
- Kaldır
ensure DiscordWhitelistitibarenserver.cfg(veya txAdmin → Kaynaklar'dan devre dışı bırakın). - Klasörü şuradan kaldırın
resources/devreden çıkarıyorsanız.
SSS
Oyuncuların Discord çalıştırması gerekiyor mu?
Evet. Olmadan discord: tanımlayıcı, betik rolleri doğrulayamaz.
Hangi niyetlere ihtiyacım var?
Sadece Sunucu Üyeleri Niyeti.
Birden çok beyaz liste rolü kullanabilir miyim?
Evet. Kullanıcının sahip olması durumunda erişim verilir herhangi listelenen rollerden.
Belirli rolleri doğrudan reddedebilir miyim?
Evet. Bunları şuraya ekleyin: blacklistRoles.
Rolleri değiştirdikten sonra çalışmayı durdu.
Daha düşük cacheMaxTime, ardından tekrar test edin. Botun doğru token ve sunucu ile çevrimiçi olduğundan emin olun.
Bakımı yapılan bir sürüm var mı?
Evet. Güncelleme/destek ihtiyacınız varsa ticari, aktif olarak bakımı yapılan bir sürümü mevcuttur.
Ek — Örnek server.cfg
# Discord whitelist ensure DiscordWhitelist # (Optional) put related Discord resources here as a block # ensure discord_perms # ensure discordrolesync
Ek — Örnek Oyuncu Mesajlaşması (Ertelenmeler)
Mesajları kısa ve eyleme geçirilebilir tutun:
messages: {
noDiscord: "Open Discord and rejoin. Your Discord app must be running.",
notWhitelisted: "Not whitelisted. Apply in #how-to-whitelist → discord.gg/yourinvite",
blacklisted: "Access denied. Contact staff via ticket.",
welcome: "Verified — loading city…"
}
Değişiklik Günlüğü (Editör Odaklı)
- v1.1 — Bağış Seviyeleri, FiveM Beyaz Liste Eksiksiz Kılavuzu ve GitHub indirme bağlantılarına doğal iç bağlantılar eklendi.
- v1.0 — İlk kılavuz: bot oluşturma, niyetler, kimlikler, kurulum, yapılandırma, test etme, SSS.
