Discord Relay
Discord ile GameVox arasında canlı bir köprü. Discord kanallarına atılan mesajlar birkaç saniye içinde GameVox kanallarında görünür; yazarın adı ve avatarıyla birlikte, düzenlemeler, silmeler, tepkiler ve ekler de senkron kalır. GameVox → Discord sohbet aktarımıyla birleştir, köprü iki yönde de çalışsın.
Neler Aktarılır
Bir mesajın Discord'da yaptığı her şey, GameVox'ta yansıtılır
Mesajlar
Discord'daki yazarın görünen adı ve avatarıyla paylaşılır, böylece sohbet iki tarafta da doğal okunur. Normal kanallarda da duyuru kanallarında da çalışır; sunucunun takip ettiği kanallardan gelen gönderiler de dahil.
Düzenlemeler ve Silmeler
Discord'da bir mesajı düzenle, GameVox'taki kopya güncellenir; sil, yansıma kaybolur. GameVox → Discord aktarımı da açıksa GameVox'ta yapılan düzenlemeler ve silmeler Discord'daki kopyayı da yerinde günceller, "(düzenlendi)" diye kalabalık yapan tekrar gönderiler olmaz.
Tepkiler
Köprülenmiş bir mesaja iki taraftan da tepki ver. Discord tepkileri GameVox'ta tepki verenin adıyla canlı rozetler olarak görünür, GameVox'ta eklenen tepkiler de Discord'daki orijinal mesajda belirir.
Ekler ve Çıkartmalar
Görseller, dosyalar ve çıkartmalar mesajla birlikte gelir ve GameVox'ta doğrudan görüntülenir.
Geçmişi Geri Doldurma
Bir Discord kanalındaki son 500 mesaja kadarını tek tıkla GameVox'a çek, en eskisinden başlayarak.
Bağlantı Günlüğü
Botun bağlantısının zaman damgalı canlı günlüğü, doğrudan sunucu ayarlarında. Tam olarak ne zaman bağlandığını ya da neden bağlanamadığını gör.
Mesajların diğer yöne de akmasını mı istiyorsun? Aynı ayarlar sekmesinde aktarımı GameVox → Discord (Sohbet Aktarımı) ile birleştir: GameVox mesajları Discord'a gönderilir, GameVox'ta yapılan düzenlemeler veya silmeler de Discord'daki kopyayı yerinde günceller. Döngü koruması yerleşik: yansıtılan mesajlar asla yeniden aktarılmaz.
Kurulum
Yaklaşık beş dakika. Discord sunucusunda Sunucuyu Yönet ("Manage Server") iznine, GameVox sunucusunda da Sunucuyu Yönet iznine ihtiyacın var. Uygulamadaki sihirbaz da aynı adımlarda sana yol gösterir.
Botunu oluştur
Discord Developer Portal'ı aç, New Application'a bas ve bir isim ver, mesela "GameVox Relay". Bot hesabı uygulamayla birlikte oluşturulur ve üyelerin köprü olarak bu ismi görür. Her topluluk kendi botunu oluşturur, yani bot tamamen senin kontrolünde. Avatar yüklemene gerek yok: bot ilk bağlandığında GameVox relay simgesini otomatik olarak alır.
Mesajları okumasına izin ver
Uygulamanda Bot sekmesini aç ve Privileged Gateway Intents bölümüne kaydır. Message Content Intent'i aç ve kaydet.
Bot token'ını kopyala
Hâlâ Bot sekmesindeyken Reset Token'a bas ve token'ı kopyala. Discord token'ı yalnızca bir kez gösterir; kaybedersen yeniden sıfırlaman yeterli. GameVox'ta şifreli olarak saklanır ve yapıştırdıktan sonra kimseye bir daha gösterilmez.
Botu Discord sunucuna davet et
GameVox'ta Sunucu Ayarları → Discord Entegrasyonu → Discord → GameVox bölümünü aç ve token'ını sihirbazın 3. adımına yapıştır. Otomatik olarak bir davet bağlantısı çıkar: aç, Discord sunucunu seç ve Yetkilendir'e bas. Bağlantı şu izinleri verir: Kanalları Görüntüle ("View Channels"), Mesaj Geçmişini Oku ("Read Message History"), Tepki Ekle ("Add Reactions"; GameVox'ta eklenen tepkiler Discord'da görünebilsin diye) ve Webhook'ları Yönet ("Manage Webhooks"; GameVox → Discord mesaj yönünü çalıştıran izin).
Botun kanallarını görebildiğinden emin ol
Davet sunucu genelinde izinler verir, ama özel kanallar bu izinleri devralmaz. Erişimi kısıtlı her kanal için Discord'daki izin ayarlarını aç ve botu (ya da botun sahip olduğu bir rolü) Kanalı Görüntüle ("View Channel") ve Mesaj Geçmişini Oku ("Read Message History") izinleriyle ekle. Bot bir kanalı göremiyorsa o kanaldan hiçbir şey aktarılmaz ve geçmişi geri doldurma izin hatasıyla başarısız olur.
Bağlan ve doğrula
GameVox sihirbazına geri dön, Discord sunucu ID'ni yapıştır (Discord'da sunucu adına sağ tıkla → Sunucu ID'sini Kopyala; göremiyorsan Kullanıcı Ayarları → Gelişmiş altından Geliştirici Modu'nu aç) ve Bağlan ve doğrula'ya bas. GameVox bağlantıyı açar ve canlı olarak izler: birkaç saniye içinde durum yeşile döner, Relay bağlandı ve doğrulandı. Bir sorun varsa dönen bir yükleme simgesi yerine tam nedenini ve nasıl düzelteceğini görürsün.
Kanalları eşle ve geçmişi doldur
Doğrulamadan sonra kanal eşleme bölümü açılır. Her köprü için: Discord kanalına sağ tıkla → Kanal ID'sini Kopyala, yapıştır, yansıtılacağı GameVox kanalını seç ve Eşleme ekle'ye bas. Yeni mesajlar hemen akmaya başlar. Son 500 mesaja kadarını en eskisinden başlayarak çekmek için herhangi bir eşlemede Geçmişi geri doldur'a bas.
Sorun Giderme
Her hata durum kartında ve Bağlantı günlüğünde görünür. İşte her birinin anlamı
Discord bağlantıyı reddetti çünkü Message Content Intent kapalı. Developer Portal'da uygulamanı aç → Bot sekmesi → Privileged Gateway Intents → Message Content Intent'i aç → kaydet. Sonra GameVox'ta Bağlantıyı yeniden dene'ye bas; Bağlantı günlüğünde connecting → identifying → ready sırasını görürsün.
100'den az sunucuda bulunan botlar için (relay botları her zaman öyledir) bu anahtar anında ve ücretsiz çalışır, Discord incelemesi gerekmez.
Discord bot token'ını reddetti: ya yanlış yazılmış ya da sen kaydettikten sonra portalda sıfırlanmış. Bot sekmesine git, Reset Token'a bas, yeni token'ı kopyala, GameVox'ta Bot ayarları altına yapıştır ve Güncelle'ye bas. Yeni bir token otomatik olarak yeni bir bağlantı başlatır.
Bot Discord sunucunda ama o kanalı göremiyor. Bu neredeyse her zaman kanalın (ya da kategorisinin) özel olduğu anlamına gelir; özel kanallar davetten gelen sunucu geneli izinleri devralmaz.
Çözüm: Discord'da kanalın ayarlarını aç → İzinler → botu (ya da botun sahip olduğu bir rolü) ekle ve Kanalı Görüntüle ile Mesaj Geçmişini Oku izinlerini ver. Kanal izinlerini bir kategoriyle senkronize ediyorsa kategoriyi düzelt. Sonra geri doldurmayı yeniden çalıştır.
Aynı erişim kuralları canlı aktarım için de geçerli: botun göremediği bir kanal hiç olay göndermez.
Şunları sırayla kontrol et:
1. Eşlemeyi kontrol et. Discord kanal ID'si mesaj attığın kanalın ID'si olmalı. Sunucuya değil kanalın kendisine sağ tıkla, Kanal ID'sini Kopyala'yı seç ve eşleme satırıyla karşılaştır.
2. Botun kanalı görebildiğini kontrol et. Yukarıdaki 403 ile aynı erişim kuralları: kanal özelse botu kanalın izinlerine ekle.
3. Durumun READY olduğunu kontrol et. Bağlantı günlüğü bir hata gösteriyorsa önce onu düzelt. Eşlemeler yalnızca bağlantı açıkken çalışır.
4. Intent sonradan mı kaldırıldı? Aktarım çalışıyorduysa ve Developer Portal'daki değişikliklerden sonra durduysa Message Content Intent'i yeniden aç ve Bağlantıyı yeniden dene'ye bas.
Durum kartının altındaki Bağlantı günlüğü, botun bağlantısının geçtiği her durumu en yeniden eskiye kaydeder ve bizim taraftaki yeniden başlatmalardan etkilenmez:
connecting / identifying: gateway açılıyor ve bot giriş yapıyor · ready: bağlı ve aktarıyor · reconnecting: kısa bir ağ kesintisi, otomatik toparlanıyor · intent_denied / auth_failed: senin müdahalen gerekiyor (yukarıya bak) · stopped: aktarım kapatıldı ya da yeniden başlıyor.
Sağlıklı bir kurulum ready ile biter. Kırmızı olan her şey neyi düzelteceğini tam olarak söyler; düzelttikten sonra Bağlantıyı yeniden dene sen izlerken sırayı yeniden çalıştırır.
Gereksinimler
Başlamadan önce neye ihtiyacın var
- Kendi Discord botun. Developer Portal'da yaklaşık bir dakikada ücretsiz oluşturulur, kurulum sihirbazı sana yol gösterir. Topluluk başına bir bot, erişimi üzerinde tam kontrolü sende tutar.
- Discord'da Sunucuyu Yönet ("Manage Server"). Botu yansıttığın sunucuya davet etmek için gerekli.
- GameVox'ta Sunucuyu Yönet. Sunucu ayarlarındaki Discord Entegrasyonu sekmesi yalnızca sahiplere ve yöneticilere açıktır.
- Discord Geliştirici Modu, sunucu ve kanal ID'lerini kopyalamak için: Kullanıcı Ayarları → Gelişmiş → Geliştirici Modu.
Topluluğunu Birbirine Bağla
Topluluğun taşınırken sohbeti tek bir yerde tut. Aktarımı beş dakikada kur.