TORVIX Dokümantasyon

Genel Bakış

TORVIX; destek talepleri, moderasyon, otomasyon, kayıt ve ekip performansını aynı Discord sunucusu bağlamında yöneten bir operasyon botudur.

İlk Kurulum

İlk destek panelini göndermeden önce aşağıdaki sırayı izleyin.

İzinler ve Roller

En sorunsuz başlangıç için botu yönetici izniyle davet edebilirsiniz. Daha sınırlı kurulumda aşağıdaki izinler gerekir.

Yetkili rolleri

Her ticket butonu veya seçim menüsü seçeneği için talebi görecek, bildirim alacak ve seçeneği kullanabilecek rolleri ayrı ayrı belirleyebilirsiniz. Bot yalnızca kendi rolünün altındaki roller üzerinde işlem yapabilir.

Panele Erişim

Discord hesabınızla giriş yaptığınızda yönetebildiğiniz ve TORVIX’in bulunduğu sunucular listelenir.

• Sunucuyu Yönet: Seçtiğiniz sunucunun yönetim panelini açar.
• Botu Sunucuya Ekle: TORVIX’in henüz bulunmadığı sunucu için Discord davet ekranını açar.
• Sunucu değiştir: Panelin sol üstündeki seçiciden diğer sunucularınıza geçebilirsiniz.
• Moderatör bağlantısı: Süreli bağlantı ilk giriş yapan Discord hesabına bağlanır; bağlantı kartında bu hesabın adı ve kimliği gösterilir. İptal edilen bağlantıyla açılmış oturumlar da geçersiz hale gelir.

Lisans ve Plan

Seçili Discord sunucusunun mevcut planı, gerçek kullanım limitleri, Premium dönemleri ve ödeme durumu bu sayfada görüntülenir.

• Yeni eklenen sunucular varsayılan olarak Ücretsiz planla başlar; Premium yalnız satın alma tamamlandığında veya geliştirici tarafından manuel tanımlandığında açılır.
• Ücretsiz plan temel ticket, hatırlatıcı, otomatik yanıt, rol paneli ve topluluk araçlarını belirlenen limitlerle içerir.
• Premium; daha yüksek kullanım limitleri, ticket transcriptleri, moderatör analizi, özel komutlar ve daha fazla sunucu yedeği kapasitesi sağlar.
• Dönem seçenekleri 1 ay 5 €, 3 ay 14,25 €, 6 ay 27 € ve 12 ay 48 € olarak gösterilir; ödeme sayfasındaki doğrulanmış nihai tutar esas alınır.
• Vergi bilgisi yalnız ödeme yapılandırmasında doğrulanmışsa panelde gösterilir.
• Kart bilgileri TORVIX'e gelmez ve güvenli ödeme sağlayıcısında işlenir.

Ticket Çalışma Alanı

Paneller, Ticket Geçmişi, Şablonlar, İstatistikler ve Ayarlar sekmeleri ticket yönetimini seçili sunucu kapsamında bir arada tutar. Aynı ayarlar Discord içindeki interaktif komut merkezleriyle de yönetilebilir.

Panel oluşturma

1. Ticket Sistemi → Paneller sayfasını açıp Yeni Panel düğmesine basın veya Discord'da /ticket-setup komutunu çalıştırın.
2. Bir veya daha fazla embed ile başlık, açıklama, görsel ve renkleri düzenleyin.
3. Buton veya seçim menüsü ekleyerek kullanıcının açabileceği talep türlerini oluşturun.
4. Her seçenek için kategori, yetkili rolleri, bildirim rolleri, gerekli roller ve karşılama mesajını belirleyin.
5. Gerekirse talep açılmadan önce yanıtlanacak en fazla 5 soru ekleyin.
6. Önizlemeyi kontrol edip paneli istediğiniz Discord kanalına yayınlayın.

Ticket içinde yönetim

Bir ticket kanalında /ticket çalıştırıldığında yalnızca komutu kullanan kişiye görünen yönetim ekranı açılır. Üstlenme, katılımcı, öncelik, yeniden adlandırma, transcript ve kapatma işlemleri bu ekrandan yapılabilir.

Deneyimli yetkililer hızlı işlemler için /claim, /unclaim, /transfer, /close, /close-request, /add, /remove, /rename, /priority ve /thread komutlarını kullanabilir. /create-ticket bir üye adına destek talebi açar.

Şablonlar ve ayarlar

Panel kartındaki Şablon düğmesi tasarımı seçili sunucunun Şablonlar sekmesine kaydeder. Destek rolleri, kategoriler ve transcript log kanalı panelden veya /ticket-setup içindeki seçim menülerinden yönetilir.

Talep Geçmişi ve Transcriptler

Talep Geçmişi, açık kanalları ve kapanmış transcriptleri aynı çalışma alanında gösterir.

Filtreler

• Açık, işlemde ve çözülmüş durumlar
• Kullanıcı, kanal veya talep numarasıyla arama
• Açılış ve çözülme zamanına göre sıralama

Transcript içeriği

Mesaj metinleri, kullanıcılar, zamanlar, düzenlemeler, görseller, dosya ekleri, embedler ve tepkiler okunabilir biçimde saklanır. Canlı taleplerde Discord kanalına, kapanmış taleplerde transcript sayfasına gidilir.

Ticaret Sistemi Botu

Üyelerin standart biçimde ilan gönderebilmesi için ayrı bir panel ve kayıt akışı sağlar. İlan Ayarları, Uyarı Ayarları ve Kayıtlar aynı çalışma alanında bulunur.

1. İlan Ayarları bölümünden ilan mesajlarının yayınlanacağı kanalı seçip kaydedin.
2. İsterseniz Her İlanda Rolü Etiketle ayarını açın. TORVIX sunucu dili Türkçeyse Ticaret, İngilizceyse Trade rolünü hazırlar ve yeni ilanlarda etiketler.
3. Butonlu ilan panelini üyelerin kullanacağı Discord kanalına gönderin.
4. Uyarı Ayarları bölümünden yasak ilan uyarı kanalını, metnini, sayım penceresini, yaptırım eşiğini ve mute/ban işlemini belirleyin.
5. Yasak bir ilanı Kayıtlar bölümündeki Uyar düğmesiyle işaretleyin.

Üyeler paneli hangi kanalda kullanırsa kullansın hazırlanan ilan seçilen ilan yayın kanalına gönderilir. Bildirim rolü açık olduğunda sunucu yönetiminin bu rolü verdiği üyeler her yeni ilanda bildirim alır. Rol silinirse TORVIX sonraki ilanda yeniden oluşturur. Uyarı hedef kullanıcı etiketlenerek seçilen uyarı kanalına gönderilir. Aynı kullanıcı belirlenen süre içinde eşik kadar uyarı aldığında seçiminize göre süreli susturulur veya banlanır. Sunucu sahibi ve yöneticiler otomatik yaptırımdan muaftır.

Discord’dan hızlı gönderim için !ilanpaneli, $ilanpaneli veya !ilanmesaji kullanılabilir.

İçerik Koruması

Küfür, özel ifadeler, bağlantılar, büyük harf kullanımı, spam, tekrar mesaj, yoğun etiketleme, Discord davetleri ve dolandırıcılık içerikleri için kurallar oluşturabilirsiniz.

1. Discord'da /protection komutunu çalıştırın. Kontrol merkezi yalnızca size görünür.
2. Filters bölümünden etkin kuralları çoklu seçim menüsüyle belirleyin.
3. Enforcement bölümünden uyarı, timeout ve ban eşiklerini yapılandırın.
4. Exemptions ve Logging bölümlerinden muaf rolleri ve kayıt kanalını seçin.

Discord'da yapılan değişiklikler web paneldeki İçerik Koruması ayarlarına, panelde yapılan değişiklikler de /protection ekranına anında yansır.

Seviye Sistemi

Metin XP, uygun Discord mesajlarından; ses XP ise uygun bir ses veya stage kanalında geçirilen etkin süreden kazanılır. Metin ve ses ilerlemesi ayrı tutulur, genel sıralamada birlikte hesaplanır.

1. Web paneldeki Seviye Sistemi çalışma alanını veya Discord'daki özel /leveling kontrol merkezini açın.
2. XP miktarlarını, bekleme sürelerini, günlük sınırları ve rol/kanal filtrelerini belirleyin.
3. Seviye mesajlarını, rol ödüllerini, kredi/rozet ödüllerini ve log kanalını yapılandırın.
4. Geçmiş ve istatistik bölümlerinden gerçek XP olaylarını inceleyin.

/rank seçilen üyenin metin, ses ve toplam XP kartını; /leaderboard sunucu sıralamasını gösterir. Karmaşık ayarlar /leveling içindeki butonlar, seçim menüleri ve formlarla yapılır.

Çekilişler

/giveaway, yalnızca komutu kullanan yöneticiye görünen tam çekiliş merkezini açar. Ayrı başlat, bitir veya yeniden seç komutları yerine tüm akış aynı ekranda tamamlanır.

1. Create Giveaway düğmesine basıp ödül, açıklama, süre ve kazanan sayısını forma girin.
2. Hedef kanalı ve isteğe bağlı gerekli rolü Discord seçim menülerinden seçin.
3. Gerçek mesaj görünümünü özel önizlemede kontrol edin.
4. Publish Giveaway ile yayınlayın veya düzenlemeye geri dönün.

Manage Active Giveaways aktif çekilişleri isim, kanal ve kalan süreyle listeler; buradan erken bitirme yapılabilir. Reroll Giveaway tamamlanan çekilişte yeni kazanan seçer.

• Bir kullanıcı yalnızca bir kez katılabilir ve katılımını geri çekebilir.
• Bot hesapları ve sunucudan ayrılan üyeler kazanamaz.
• Rol şartları katılımda ve sonuç seçiminde yeniden doğrulanır.
• Katılım düğmeleri ve bitiş zamanı bot yeniden başlasa da korunur.

Öneri Sistemi

Üyelerin fikirlerini standart bir formda toplar, oylarla sıralar ve yetkili kararını aynı Discord mesajında yayınlar.

1. Üyeler /suggest komutuyla yalnızca kendilerine görünen gönderim formunu açar.
2. Yöneticiler /suggestions ile kurulum, bekleyen öneriler ve değerlendirme araçlarını açar.
3. Öneri kanalını, katılım rolünü, bekleme süresini ve anonim modu yapılandırın.
4. Bekleyen önerileri Discord butonlarından veya web panelden onaylayın ya da reddedin.

Her kullanıcı öneri başına tek oy kullanabilir ve oyunu değiştirebilir. Oylar, kararlar ve kalıcı butonlar bot yeniden başladıktan sonra korunur.

Anketler

/poll, soru ve seçeneklerin özel formdan girildiği interaktif anket merkezini açar. Kanal, süre ve seçim davranışı Discord bileşenleriyle belirlenir.

1. Create Poll düğmesini seçin.
2. Soru, açıklama ve seçenekleri forma yazın.
3. Hedef kanalı, süreyi ve tek/çoklu seçim davranışını belirleyin.
4. Önizlemeyi kontrol edip anketi yayınlayın.

Aynı merkezden aktif anketler görüntülenebilir ve erken sonuçlandırılabilir. Oylar kullanıcı başına saklanır; kullanıcı seçimini değiştirebilir ancak ikinci kez sayılmaz.

Karşılama ve Otomatik Rol

Yeni üye katılma ve ayrılma olaylarını; hoş geldin mesajı, özel mesaj, otomatik rol ve üye log kanalıyla yönetir.

1. Web panelde Karşılama ve Otorol sayfasını veya Discord'da /welcome komutunu açın.
2. Karşılama ve ayrılma kanallarını, mesajları ve otomatik rolleri seçin.
3. Özel /welcome ekranından temel kurulumu, durum kontrolünü ve güvenli test mesajını çalıştırın.
4. Gelişmiş embed, görsel ve yeni üye güvenliği seçeneklerini web panelden tamamlayın.

Mesajlarda {mention}, {user}, {username}, {display_name}, {server}, {member_count}, {user_id} ve {account_created} alanları kullanılabilir.

Çevrimiçi Durum Rolü

/status-role, çevrimiçi üyelerde tutulacak rolün kurulum ve durum ekranını özel olarak açar. Bu özellik için Discord çevrimiçi durum erişimi gerekir.

Otomatik Yanıtlar

Belirli bir kelime veya ifade görüldüğünde botun otomatik cevap vermesini sağlar. Tetikleyici kelime veya ifadeyi belirleyin, botun vereceği yanıtı yazın ve otomatik yanıtı aktif edin. Kullanıcı belirlediğiniz ifadeyi kullandığında Torvix, hazırladığınız mesajı otomatik olarak gönderir.

• Tam eşleşme: Mesaj yalnızca tetikleyiciden oluşmalıdır.
• İçeriyor: Tetikleyici mesajın herhangi bir yerinde bulunabilir.
• Kanal kapsamı: Kural tüm kanallarda veya seçilen tek kanalda çalışabilir.

Panelde yapılan değişiklikler en fazla yaklaşık 20 saniye içinde botun canlı önbelleğine yansır.

Özel Komutlar

Komut adını ve botun vereceği yanıtı belirleyin. Özel komutlar ! veya $ ön ekiyle kullanılır. Kullanıcı oluşturduğunuz komutu yazdığında Torvix, hazırladığınız yanıtı otomatik olarak gönderir. Örnek: !kurallar veya $kurallar.

• Özel komutlar ! ve $ önekleriyle çalışır; Discord’un / listesinde yalnızca TORVIX’in yerleşik komutları gösterilir.
• Yetki “Herkes” veya “Yönetici” olarak ayarlanabilir.
• Mevcut komut Çoğalt ile kopyalanıp düzenlenebilir.

Hatırlatıcılar

Belirli kanallara tek seferlik veya tekrarlanan mesaj gönderir.

Tek seferlik

Saat, zaman dilimi ve haftanın günleri seçilir. Mesaj uygun ilk zaman aralığında gönderilir.

Tekrarlanan

Dakika veya saat aralığı belirlenir. İsteğe bağlı başlangıç ve bitiş zamanı ile yalnızca seçilen günlerde çalıştırılır.

• Test mesajı gönder: Kaydetmeden önce hedef kanalda sonucu kontrol eder.
• Çoğalt: Hatırlatıcının pasif bir kopyasını oluşturur.
• Aktif/Pasif: Ayarı silmeden çalışmasını durdurur.

Yeni Hatırlatıcı düğmesinin altındaki Tekrar Koruması kanal bazlı çalışır. Aynı kanala herhangi bir hatırlatıcı gönderildikten sonra belirlediğiniz sayıda yeni kullanıcı mesajı oluşmadan o kanaldaki başka bir hatırlatıcı gönderilmez. Bot mesajları sayılmaz ve ayar sunucudaki tüm hatırlatıcılara uygulanır.

Moderasyon Komutları

Günlük moderasyon işlemleri hızlı İngilizce slash komutlarıyla yapılır.

/protection otomatik içerik kurallarını özel kontrol merkezinde yönetir. Bot tarafından yapılan moderasyon işlemleri moderatör, sebep, hedef ve zaman bilgileriyle Denetim Kaydı'na eklenir.

Kanala Özel Süreli Susturma

Bir kullanıcıyı sunucunun tamamında değil, yalnızca seçilen sohbet kanalında belirli süreyle susturur.

• Mesaj gönderme, tepki ekleme ve thread kullanımı engellenir.
• Önceki kullanıcı kanal izinleri kaydedilir ve süre bitince geri yüklenir.
• Bot yeniden başlasa bile aktif süreler korunur.

Moderatör Takibi

Moderatör takibi ve performans raporları tek çalışma alanında yönetilir.

1. Moderatör Takibi → Ayarlar kategorisinden kullanıcı adı, görünen ad, etiket, Discord kullanıcı ID’si veya takip edilecek rolleri ekleyin.
2. Takip edilecek bir veya birden fazla kanalı seçin. Hiç kanal seçilmezse tüm uygun kanallar izlenir.
3. İstatistikler kategorisinden 7, 30, 90 gün veya tüm zamanlar raporunu açın.

Kartlarda mesaj sayısı, aktif gün, günlük ortalama, ekip payı, yoğun saat, kelime ve dosya sayıları gösterilir.

Kayıtlar ve Loglar

Log Yönetimi sayfasında Discord olay loglarını tek tek açıp kapatabilir ve her olay grubu için hedef kanalı seçebilirsiniz. Yeni sunucularda sistem varsayılan olarak kapalıdır.

Discord içinden yönetim

/logs, yalnızca komutu kullanan yöneticiye görünen kurulum, durum ve test ekranını açar. Setup All Channels TORVIX LOGS kategorisi altında giriş, çıkış, mesaj, ticket, moderasyon, yetki, üye, kanal, ses, sunucu ve davet log kanallarını oluşturur veya mevcut olanları yeniden kullanır. Test Logging kanal bağlantılarını ve gönderim izinlerini doğrular.

Kanal oluşturuldu satırındaki Ayarlar düğmesi, kanal oluşturma/silme kişi filtresini açar. Rol oluşturuldu satırındaki küçük Ayarlar düğmesi de TORVIX’in yeni üyelere verdiği otomatik rollerin yetki loguna dahil edilip edilmeyeceğini gösterir. Filtreye eklenen hesapların kanal olayları loglanmaz. Her olayın kanal alanında kayıtlı gerçek seçim gösterilir; bir kanal atanmadıysa Kanal seçilmedi yazısı görünür. Sorumlu yetkilinin belirlenebilmesi için TORVIX'te Denetim Kayıtlarını Görüntüle izni bulunmalıdır.

Mesaj kayıtları, Denetim Kaydı, Ticaret Kayıtları ve Ticket Geçmişi uzun listeleri sayfalara böler; filtreler sayfa değiştirirken korunur.

Veri Saklama İşlemleri

Saklama süresi kontrolleri arka planda yapılır ve tek başına İşlemler listesini doldurmaz. Yalnızca süresi dolan kayıtlar gerçekten arşive taşındığında işlem oluşturulur; tamamlanan işlem taşınan kayıt sayısını belirtir.

Rol Panelleri

Üyelerin yöneticiyi beklemeden izin verilen rolleri Discord butonları veya seçim menüleriyle almasını ve kaldırmasını sağlar.

Nasıl Kullanılır?

1. Web panelde Rol Panelleri sayfasını açın veya Discord'da /role-panel çalıştırın.
2. Panel adını, açıklamasını ve kullanıcıların seçebileceği rolleri ekleyin.
3. Panel davranışını belirleyin, hedef kanalı seçin ve yalnızca size görünen önizlemeyi kontrol edin.
4. Paneli yayınlayın; mevcut panelleri aynı interaktif merkezden düzenleyin veya kaldırın.

Örnek

🎮 Oyuncu Rolü — Rolü almak veya kaldırmak için butona tıklayın.

Normal üyeler rol almak için slash komutu kullanmaz; yayınlanan paneldeki buton veya seçim menüsünü kullanır. Bot yalnızca panelde tanımlanan rolleri verir. Yönetilen roller, @everyone ve botun en yüksek rolünün üzerindeki roller reddedilir.

Bot Kişiselleştirme

Sunucuya özel takma ad, avatar, banner ve hakkında metni ayarlanabilir. Global Discord bot hesabı değişmez; seçilen sunucudaki görünüm güncellenir. Kaydet ve Uygula düğmesine basılması İçerik Kuralları ile Kullanım Koşulları’nın kabulü anlamına gelir.

Sunucu Yedekleri

Yönetici olduğunuz bir Discord sunucusunun yapısal şablonunu oluşturup yine yönetici olduğunuz başka bir sunucuya uygulayabilirsiniz. Yedek kaydı, kaynak sunucunun yedekleme anındaki profil görselini de kartında saklar.

1. Sunucu Yedekleri sayfasını açın.
2. Kaynak sunucuyu seçip yedeği oluşturun; bu işlem kendi düğmesiyle doğrudan başlatılır ve ayrıca genel bir kaydetme onayı istemez.
3. Sağ üstteki İşlemler göstergesi tamamlandığını bildirdikten sonra kayıtlı yedek listede görünür.
4. Yönetebildiğiniz hedef sunucuyu seçip Yedeği Uygula düğmesine basın.

Resmî Komut Rehberi

TORVIX'in resmî slash komut adları İngilizcedir. İnteraktif komutlar yalnızca komutu kullanan kişiye görünen kontrol merkezi açar; hızlı işlem komutları tek bir görevi doğrudan uygular.

Eski metin komutları

Aşağıdaki sınırlı sayıdaki eski komut ! önekiyle çalışmaya devam eder. Yeni özelliklerde slash komutlarını tercih edin.

Sorun Giderme

Panel mesajı Discord kanalına gelmiyor

1. Panelde doğru sunucunun seçili olduğunu kontrol edin.
2. Hedef kanalın aynı sunucuya ait olduğundan emin olun.
3. Botta Kanalı Gör, Mesaj Gönder ve Bağlantı Yerleştir izinlerini doğrulayın.
4. sağ üstteki İşlemler panelinde başarısız işlem ve açıklama olup olmadığına bakın.

Slash komut görünmüyor

Yeni komutların Discord’da görünmesi kısa bir süre alabilir. Discord’u yenileyin; sorun sürerse !senkronize komutunu kullanın.

Discord girişi başarısız

Discord hesabınızla yeniden giriş yapın, sunucuda yönetici olduğunuzu ve TORVIX’in sunucuda bulunduğunu kontrol edin. Sorun devam ederse destek ekibine ulaşın.

Bot komut çalıştırmıyor

Bot rolünün hedef kullanıcının rolünden yukarıda olduğunu ve gerekli kanal/rol izinlerinin verildiğini doğrulayın.

Görsel mesaj boş görünüyor

Görsel veya dosya içeren yeni kayıtlar Resim ya da Ek olarak görünür.

Sık Sorulan Sorular

Panel İşlemlerini Takip Etme

Uzun süren işlemler ayrı bir menü yerine panelin sağ üstündeki İşlemler düğmesinden izlenir. Sayaç aktif işlem sayısını, açılır panel ise seçili sunucunun aktif işlemlerini ve son 10 sonucunu gösterir.

• İlerleme bilgisi bulunan işlemlerde yüzde çubuğu otomatik güncellenir.
• Tamamlanan veya başarısız olan işlemler sayfa yenilenmeden bildirilir.
• Başarısız ve yeniden çalıştırılması güvenli işlemler Tekrar Dene ile yeniden sıraya alınabilir.