txAdmin'yi Discord'ye bağlamak için özel bir Discord uygulaması ve botu oluşturun, yalnızca ihtiyaç duyduğu izinlerle doğru sunucuya davet edin, bot belirtecini txAdmin'nin Discord ayarlarına kopyalayın ve durum mesajları ile role dayalı erişimi ayrı özellikler olarak yapılandırın. Belirteci gizli tutun: botu kimlik doğrulaması yapar ve asla ekran görüntülerinde, istemci dosyalarında veya genel bir depoda görünmemelidir.
12 Ağustos 2026 tarihinde resmi Cfx.re txAdmin belgeleri, Discord'nin uygulama kurulumu Ve OAuth2 belgeleri. Etiketler txAdmin sürümleri arasında hareket edebilir, bu nedenle kurulu sürümünüzün gösterdiği ayarları kullanın.
Dört hareketli parçayı ayırın
| Parça | Amaç | Tipik hata |
|---|---|---|
| Discord uygulaması ve botu | txAdmin tarafından kullanılan kimlik | Yanlış uygulama, devre dışı bırakılmış bot veya yeniden oluşturulmuş jeton |
| Sunucu durumu | Seçilen bir kanalda durumu yayınlar veya günceller | Yanlış kanal veya görüntüleme/gönderme/gömme izinleri eksik |
| Roller veya beyaz liste | Haritalar Discord üyelik/rolleri yapılandırılmış erişim kuralına | Yanlış sunucu/rol kimliği, rol hiyerarşisi veya üye niyet gereksinimi |
| txAdmin izinleri | FiveM sunucusunu kimlerin yönetebileceğini kontrol eder | txAdmin haklarını otomatik olarak vermek için varsayılan Discord rolü |
Bunları tek bir özellik olarak ayıklamayın. Önce botun çevrimiçi olduğunu kanıtlayın, ardından bir kanala erişebildiğini kanıtlayın, ardından durum davranışını ekleyin ve yalnızca o zaman isteğe bağlı rol veya beyaz liste mantığını test edin.
Adım 1: özel bir Discord uygulaması oluşturun
- Discord Geliştirici Portalı'nı açın ve bu sunucu için yeni bir uygulama oluşturun.
- Uygulamaya bir bot ekleyin.
- Personelin Üretim ile hazırlık aşamasını ayırt edebilmesi için net bir ad verin.
- Güvenli bir şekilde saklamaya hazır olduğunuzda jetonu oluşturun veya sıfırlayın.
Bot jetonu gizlidir, uygulama kimliği veya genel anahtar değildir. Eğer açığa çıkarsa, Discord'de sıfırlayın ve txAdmin'yi hemen güncelleyin. Değiştirme işlemini yalnızca jeton için tasarlanmış sunucu tarafı ayarında saklayın.
Adım 2: botu minimum izinlerle davet edin
Uygulama için Discord’nin OAuth2 kurulum akışını kullanın ve mevcut kurulumun gerektirdiği bot kapsamını seçin. Durum güncellemesinin gerektiği yerlerde, seçilen kanalı görüntüleme, mesaj gönderme, bağlantı yerleştirme ve mesaj geçmişini okuma gibi özelliklere yeten en küçük kanal izinleriyle başlayın. Resmi entegrasyon açıkça gerektirmedikçe ve nedenini incelemediyseniz Yönetici'den kaçının.
Mümkün olduğunda, botu özel bir durum veya yönetim kanalına kısıtlayın. Davet ettikten sonra, amaçlanan Discord sunucusunda göründüğünü onaylayın. Çevrimdışı olarak listelenmesi, txAdmin belirteçle başarıyla oturum açana kadar beklenir.
Adım 3: botu txAdmin'de yapılandırın
txAdmin'yi yetkili bir yönetici olarak açın ve kurulu sürümünüzdeki Discord entegrasyon ayarlarını bulun. Belirteci tırnak işareti veya ekstra boşluk olmadan belirteç alanına yapıştırın. txAdmin'nin sağladığı girişleri kullanarak amaçlanan Discord sunucusunu ve kanalını seçin. Kaydedin, ardından arayüz bunu gerektiriyorsa yalnızca bileşeni veya sunucuyu yeniden başlatın.
Eğer FiveM tarafını sıfırdan oluşturuyorsanız, önce FiveM sunucu kurulum yolunu kullanın. Discord, sağlıksız bir FXServer'ı veya ulaşılamayan bir txAdmin örneğini onaramaz.
Durum mesajlarını ayrı olarak yapılandırın
Durum özelliğini etkinleştirin ve botun gönderi yapabileceği bir kanal seçin. Özel metin veya yerleştirmeler eklemeden önce düz bir test güncellemesiyle başlayın. FiveM sunucusu başladığında, durduğunda veya oyuncu sayısını değiştirdiğinde, txAdmin sürümünüz tarafından belgelenen davranışa göre mesajın değiştiğini onaylayın.
Bot oturum açar ancak hiçbir durum görünmüyorsa, seçilen kanal kimliğini ve kanala özgü geçersiz kılmaları kontrol edin. Sunucu genelinde bir rol göndermeye izin verirken, kanal geçersiz kılma bunu reddedebilir. Ayrıca, belirteci tekrar tekrar yeniden oluşturmak yerine Discord API yanıtı için txAdmin'nin konsol/günlük çıktısını inceleyin.
Rolleri veya beyaz liste kurallarını ayrı ayrı yapılandırın
Rol tabanlı erişim, entegrasyonun beklediği tam Discord sunucu ve rol tanımlayıcılarını gerektirir. Kimlikleri kopyalamak için Discord'nin geliştirici modunu etkinleştirin, mevcut kurulum sizden bunları istediğinde. Rol adları kararlı tanımlayıcılar değildir ve iki rol benzer bir ada sahip olabilir.
Gerekli role sahip bir hesapla ve sahip olmayan bir hesapla test edin. Rolü kaldırın ve yeniden ekleyin, yeniden bağlanın ve entegrasyon üyeliği yenilediğinde onaylayın. Bir Discord rolünün otomatik olarak txAdmin yönetici izinleri verdiğini varsaymayın; txAdmin'nin kendi izin modeli, belgelenmiş özellik açıkça eşlemediği sürece ayrı bir kontrol olarak kalır.
Token'ı ve izin sınırını koruyun
- Token'ı asla Discord sohbetine, başkalarının görebileceği bir destek bileti veya istemci tarafı bir kaynağa yapıştırmayın.
- Bunu Git'e kaydetmeyin veya genel bir ekran görüntüsünde saklamayın.
- Hem Discord Geliştirici Portalı uygulamasına hem de txAdmin ayarlarına erişimi sınırlayın.
- Maruz kaldıktan sonra veya erişimi olan bir yönetici ayrıldığında token'ı sıfırlayın.
- Bot'un sunucu ve kanal izinlerini periyodik olarak gözden geçirin.
Sorun giderme kontrol listesi
| Belirti | Kontrol etmek |
|---|---|
| Bot çevrimdışı kalıyor | Token doğru bota ait, boşluk içermiyor, sıfırlanmamış ve txAdmin günlükleri bir giriş denemesi gösteriyor |
| Bot çevrimiçi ancak gönderi yapamıyor | Seçilen kanal, görüntüleme/gönderme/göme izinleri ve kanal geçersiz kılmaları |
| Durum asla güncellenmiyor | Durum özelliği etkin, doğru kanal, txAdmin/FXServer durumu ve entegrasyon günlüğü |
| Rol üyesi reddedildi | Doğru sunucu/rol kimliği, rol gerçekten atandı, yenileme/yeniden bağlama davranışı ve gerekli üye amacı |
| Yetkisiz üye kabul edildi | Yedek erişim kuralları, birden fazla izin verilen rol ve sunucu tarafı izin yapılandırması |
| Bir jeton sıfırlamasından sonra durdu | txAdmin hala eski jetona sahip; yenisini kaydedin ve gerektiği gibi yeniden başlatın |
Son doğrulama
- Bot, jeton hataları olmadan temiz bir yeniden başlatmanın ardından oturum açar.
- Yalnızca amaçlanan kanalda durum gönderileri.
- Minimum bot rolü, daha geniş sunucu ayrıcalıkları olmadan mesajı güncelleyebilir.
- İzin verilen test kullanıcısı rol/whitelist kuralını geçer.
- İzin verilmeyen test kullanıcısı aynı kuralı geçemez.
- Ne Discord erişimi ne de gizli bir UI düğmesi txAdmin'in kendi yönetici izinlerini geçersiz kılar.
Bu kontroller bağımsız olarak geçtiğinde, entegrasyonun bakımı daha kolay olur: tek bot kimliği, tek korumalı sır, dar kapsamlı kanal erişimi ve durum, whitelist ve yönetim için açık kurallar.