DiscordPunishBot - Minecraft Ceza Sistemi

📋 Genel Bakış

DiscordPunishBot, Minecraft sunucunuz için Discord entegrasyonlu gelişmiş bir ceza sistemidir. Bu plugin, Discord üzerinden slash komutları kullanarak oyuncuları cezalandırmanıza olanak tanır.

Kolay Kullanım

Discord üzerinden basit slash komutları ile ceza işlemleri

Gelişmiş Entegrasyon

Discord ve Minecraft arasında sorunsuz iletişim

Detaylı İstatistikler

Ceza istatistiklerini takip edebilme imkanı

✨ Yeni Özellikler (v1.1.0)

🆕 Yeni Ceza Türleri

Mute (Susturma): Oyuncuları belirli süreler için susturma
Ban (Yasaklama): Kalıcı yasaklama
Kick (Atma): Sunucudan atma
TempBan (Geçici Yasaklama): Belirli süre için yasaklama
Jail (Hapis): Oyuncuları hapse atma
Warn (Uyarı): Uyarı sistemi

🔧 Gelişmiş Özellikler

Cooldown Sistemi: Spam önleme için bekleme süreleri
Günlük Limit Sistemi: Günlük ceza limitleri
Detaylı İstatistikler: Her ceza türü için ayrı istatistikler
Gelişmiş Discord Entegrasyonu: Renkli embed'ler ve thumbnail'lar
Çoklu Veritabanı Desteği: SQLite ve MySQL

🚀 Kurulum

1. Gereksinimler

Minecraft Server: 1.20+ (Spigot/Paper)
Java: 17+
Discord Bot Token: Discord Developer Portal
EssentialsX: Ceza komutları için

2. Plugin Kurulumu

DiscordPunishBot.jar dosyasını plugins/ klasörüne kopyalayın
Sunucuyu yeniden başlatın
plugins/DiscordPunishBot/config.yml dosyasını düzenleyin

3. Discord Bot Kurulumu

Discord Developer Portal'a gidin
Yeni bir uygulama oluşturun
Bot sekmesine gidin ve bot oluşturun
Token'ı kopyalayın
OAuth2 > URL Generator ile bot'u sunucunuza ekleyin

4. Konfigürasyon

discord:
  token: "YOUR_BOT_TOKEN_HERE"
  guild-id: "YOUR_GUILD_ID_HERE"
  log-channel-id: "LOG_CHANNEL_ID_HERE"
  roles:
    mute: "MUTE_ROLE_ID"
    ban: "BAN_ROLE_ID"
    kick: "KICK_ROLE_ID"
    tempban: "TEMPBAN_ROLE_ID"
    jail: "JAIL_ROLE_ID"
    warn: "WARN_ROLE_ID"

📖 Komutlar

Minecraft Komutları

/ceza <oyuncu>

Oyuncunun ceza geçmişini görüntüle

/dpunish reload

Konfigürasyonu yeniden yükle

/dpunish info

Plugin bilgilerini göster

/dpunish test <database|discord>

Bağlantıları test et

/dpunish stats

Genel istatistikleri göster

Discord Slash Komutları

/mute <oyuncu> [sebep]

Oyuncuyu sustur

/ban <oyuncu> [sebep]

Oyuncuyu yasakla

/kick <oyuncu> [sebep]

Oyuncuyu at

/tempban <oyuncu> [sebep]

Geçici yasaklama

/jail <oyuncu> [sebep]

Oyuncuyu hapse at

/warn <oyuncu> [sebep]

Uyarı ver

/ceza <oyuncu>

Ceza geçmişini görüntüle

🎯 Ceza Türleri ve Sebepleri

Mute (Susturma)

Ağır Küfür 7 saat
Spam 3 saat
Reklam 12 saat
Küfür 2 saat
Hakaret 5 saat
Flood 1 saat

Ban (Yasaklama)

Hile/Cheat Kalıcı
Griefing Kalıcı
Duping Kalıcı
Exploit Kullanımı Kalıcı
DDoS Teşebbüsü Kalıcı

Kick (Atma)

Uyarı Kick Anlık
Spam Kick Anlık
Flood Kick Anlık

TempBan (Geçici Yasaklama)

Troll 3 gün
Spam TempBan 1 gün
Küfür TempBan 7 gün
Griefing TempBan 14 gün
Hile TempBan 30 gün

Jail (Hapis)

Küfür Hapis 2 saat
Spam Hapis 1 saat
Griefing Hapis 6 saat
Troll Hapis 4 saat

Warn (Uyarı)

Uyarı Kalıcı
İlk Uyarı Kalıcı
Son Uyarı Kalıcı

⚙️ Gelişmiş Ayarlar

Cooldown Sistemi

settings:
  cooldowns:
    enabled: true
    mute: 30      # 30 saniye
    ban: 60       # 60 saniye
    kick: 15      # 15 saniye
    tempban: 45   # 45 saniye
    jail: 30      # 30 saniye
    warn: 10      # 10 saniye

Bu ayarlar, her ceza türü için komutlar arasındaki minimum bekleme süresini belirler.

Günlük Limit Sistemi

settings:
  daily-limits:
    enabled: true
    mute: 50      # Günlük 50 mute
    ban: 20       # Günlük 20 ban
    kick: 100     # Günlük 100 kick
    tempban: 30   # Günlük 30 tempban
    jail: 40      # Günlük 40 jail
    warn: 200     # Günlük 200 warn

Bu ayarlar, günlük olarak uygulanabilecek maksimum ceza sayılarını belirler.

📊 İstatistikler

Plugin aşağıdaki istatistikleri tutar:

Toplam ceza sayısı

Ceza türlerine göre dağılım

Günlük ceza sayısı

Benzersiz cezalandırılan oyuncu sayısı

Aktif ceza sayısı

Örnek İstatistik Görünümü

Ceza Türü	Toplam	Bugün	Aktif
Mute	142	5	3
Ban	28	1	28
Kick	89	7	0
Toplam	259	13	31

🔧 Sorun Giderme

Yaygın Sorunlar

1. Bot bağlanmıyor

Token'ın doğru olduğundan emin olun
Bot'un sunucuda olduğunu kontrol edin
Gerekli izinlerin verildiğini kontrol edin

2. Komutlar çalışmıyor

Role ID'lerin doğru olduğunu kontrol edin
Bot'un gerekli izinlere sahip olduğunu kontrol edin

3. Veritabanı hatası

SQLite için dosya izinlerini kontrol edin
MySQL için bağlantı bilgilerini kontrol edin

Test Komutları

/dpunish test database  # Veritabanı bağlantısını test et
/dpunish test discord   # Discord bağlantısını test et

📝 Changelog

v1.1.0 Yeni Özellikler ve Geliştirmeler

✅ 6 yeni ceza türü eklendi
✅ Cooldown sistemi eklendi
✅ Günlük limit sistemi eklendi
✅ Gelişmiş istatistik sistemi
✅ Renkli Discord embed'leri
✅ Çoklu veritabanı desteği
✅ Hata yönetimi iyileştirildi

v1.0.0 İlk Sürüm

✅ Temel ceza sistemi
✅ Discord entegrasyonu
✅ SQLite desteği

🤝 Destek

Discord

Melüt

GitHub

amhunter1

Hata Bildirimi

GitHub üzerinden bildirin

📄 Lisans

Bu proje MIT lisansı altında lisanslanmıştır.

MIT License

Copyright (c) 2025 Melüt

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.