ReportSystem - Kapsamlı Dokümantasyon

ReportSystem Dokümantasyonu

Minecraft sunucunuz için profesyonel rapor ve moderasyon sistemi

ReportSystem, Minecraft sunucuları için geliştirilmiş kapsamlı bir oyuncu raporlama ve moderasyon eklentisidir. CS:GO'nun Overwatch sisteminden ilham alınarak tasarlanmış topluluk tabanlı inceleme sistemi, otomatik replay kayıtları ve gelişmiş ceza yönetimi özellikleri sunar.

İpucu

Bu dokümantasyon sürekli güncellenmektedir. En güncel bilgiler için Discord sunucumuzu takip edin.

Özellikler

ReportSystem'in sunduğu tüm özellikler

🎯

Gelişmiş Rapor Sistemi

GUI tabanlı kolay raporlama, kategori sistemi, öncelik seviyeleri ve cooldown yönetimi

👁️

Overwatch İnceleme

CS:GO tarzı topluluk tabanlı rapor inceleme, XP/seviye sistemi ve otomatik ceza

🎬

Replay Kayıt

Otomatik 45 saniyelik kayıtlar, yakındaki oyuncu takibi, blok/envanter kaydı

🌐

Network Desteği

BungeeCord/Velocity tam uyumlu, çapraz sunucu raporlama ve replay izleme

⚡

Ceza Entegrasyonu

LiteBans, AdvancedBan, BanManager ile tam entegrasyon

🗃️

Çoklu Veritabanı

MySQL ve SQLite desteği, otomatik tablo oluşturma

Gereksinimler

Gereksinim	Minimum	Önerilen	Not
Sunucu Yazılımı	Spigot 1.18	Paper 1.21	Paper performans için önerilir
Java Sürümü	Java 17	Java 21	MC 1.20.5+ için Java 21 zorunlu
PacketEvents	2.0+	En güncel sürüm	Zorunlu
Ceza Eklentisi	-	LiteBans	İsteğe Bağlı

Önemli

PacketEvents olmadan eklenti çalışmaz. Replay sistemi PacketEvents'e bağımlıdır.

Sürüm Uyumluluğu

MC Sürümü	Durum	Not
1.21.x	✅ Tam Destek	Önerilen sürüm
1.20.x	✅ Tam Destek	-
1.19.x	✅ Tam Destek	-
1.18.x	✅ Tam Destek	Minimum desteklenen
1.17 ve altı	❌ Desteklenmiyor	Java 17 gereksinimi

Hızlı Kurulum (Standalone)

PacketEvents Kurulumu

PacketEvents eklentisini indirip plugins klasörüne atın.

SpigotMC'den İndir →

ReportSystem Kurulumu

ReportSystem-Spigot.jar dosyasını plugins klasörüne atın.

İlk Başlatma

Sunucuyu başlatın. Yapılandırma dosyaları otomatik oluşturulacak.

Lisans Aktivasyonu

config.yml dosyasında lisans anahtarınızı girin ve sunucuyu yeniden başlatın.

config.yml

license:
  license-key: "KB-XXXX-XXXX-XXXX"

Başarılı Kurulum

Konsolda [ReportSystem] Plugin enabled successfully! mesajını görmelisiniz.

BungeeCord/Velocity Kurulumu

Proxy sunucusuna ReportSystem-BungeeCord.jar yükleyin

Tüm backend sunuculara ReportSystem-Spigot.jar yükleyin

Aynı MySQL veritabanını tüm sunucularda kullanın

Her sunucuda bungeecord.enabled: true yapın

config.yml (Her Sunucu)

bungeecord:
  enabled: true
  display-name: "Survival"  # Sunucu adı
database:
  type: mysql
  mysql:
    host: "localhost"
    port: 3306
    database: "reportsystem"
    username: "root"
    password: "şifre"

Önemli

Network modunda SQLite kullanılamaz. Tüm sunucular aynı MySQL veritabanına bağlanmalıdır.

Veritabanı Ayarları

SQLite vs MySQL

Özellik	SQLite	MySQL
Kurulum	Otomatik	Manuel veritabanı oluşturma
Network Desteği	❌ Hayır	✅ Evet
Performans	Küçük sunucular için iyi	Yüksek trafik için önerilir
Yedekleme	Dosya kopyalama	mysqldump

MySQL Bağlantı Havuzu (config.yml)

database:
  type: mysql
  mysql:
    host: "localhost"
    port: 3306
    database: "reportsystem"
    username: "root"
    password: "güçlü_şifre"
    pool:
      maximum-pool-size: 10
      minimum-idle: 2
      connection-timeout: 30000
      idle-timeout: 600000
      max-lifetime: 1800000

Genel Ayarlar

general.debug Varsayılan: false

Debug modunu aktifleştirir. Konsola detaylı loglar yazılır. Sorun giderme için kullanın.

general.language Varsayılan: "en"

Kullanılacak dil dosyası. Mevcut: tr (Türkçe), en (İngilizce)

general.date-format Varsayılan: "dd/MM/yyyy HH:mm:ss"

Tarih formatı. Java SimpleDateFormat formatını kullanır.

Rapor Ayarları

reports.cooldown Varsayılan: 60 (saniye)

Bir oyuncunun iki rapor arasında beklemesi gereken süre. 0 = devre dışı.

reportsystem.cooldown.bypass izni ile atlanabilir.

reports.global-rate-limit Varsayılan: 5

Dakika başına maksimum rapor sayısı. Spam koruması için. -1 = sınırsız.

reports.max-reports-per-player Varsayılan: 3

Bir oyuncunun aynı kişiyi kaç kez raporlayabileceği. -1 = sınırsız.

reports.auto-close-days Varsayılan: 30

Kaç gün sonra açık raporlar otomatik kapatılır. -1 = devre dışı.

reports.categories Liste

Rapor kategorileri. GUI'de seçim olarak görünür.

categories:
  - "Hile"
  - "Hakaret/Küfür"
  - "Spam"
  - "Griefing"
  - "Bug Abuse"
  - "Diğer"

Replay Ayarları

replay.recording-duration Varsayılan: 45 (saniye)

Her replay kaydının süresi. Daha uzun süreler daha fazla veri demektir.

replay.auto-delete-days Varsayılan: 7

Replay kayıtları kaç gün sonra silinir.

7 = 7 günden eski kayıtlar silinir
30 = 30 gün sakla
-1 = Asla silme (dikkat: disk dolabilir!)

replay.quality.tps Varsayılan: 20

Kayıt kalitesi. 20 = Tam kalite, 10 = Yarı kalite (daha az veri)

replay.quality.nearby-radius Varsayılan: 50

Yakındaki oyuncuların kaydedileceği mesafe (blok).

Disk Kullanımı

Ortalama 45 saniyelik bir kayıt 50-200 KB yer kaplar. Günde 100 rapor ≈ 10-20 MB/gün.

Overwatch Ayarları

overwatch.min-reviewers Varsayılan: 3

Bir rapor için karar verilmeden önce gerekli minimum inceleme sayısı.

overwatch.consensus-threshold Varsayılan: 70.0

Otomatik ceza için gerekli "Suçlu" oyu yüzdesi. %70 = 3 kişiden 2'si suçlu derse ceza uygulanır.

overwatch.auto-ban-duration-days Varsayılan: 30

Konsensüs sağlandığında otomatik ban süresi (gün).

overwatch.npc.hologram-update-interval Varsayılan: 30

NPC hologramlarının istatistik güncelleme sıklığı (saniye).

Ödül Ayarları

XP Ayarları

Ayar	Varsayılan	Açıklama
`overwatch.xp.guilty-innocent-xp`	15	Suçlu/Masum oyu için XP
`overwatch.xp.skip-xp`	5	Atla oyu için XP
`overwatch.xp.bronze-xp`	0	Bronze rütbe için gereken XP
`overwatch.xp.silver-xp`	500	Silver rütbe için gereken XP
`overwatch.xp.gold-xp`	1000	Gold rütbe için gereken XP
`overwatch.xp.diamond-xp`	2500	Diamond rütbe için gereken XP
`overwatch.xp.xp-per-level`	100	Seviye başına gereken XP

Ödül Komutları

config.yml

overwatch:
  rewards:
    enabled: true

    # Her inceleme sonrası
    on-review-complete:
      - "give %player% diamond 1"
      - "eco give %player% 100"

    # Sadece Suçlu/Masum oyları için
    on-guilty-innocent:
      - "give %player% emerald 1"

    # Seviye atlama ödülü
    on-level-up:
      - "broadcast &e%player% &7Overwatch seviye &e%level% &7oldu!"
      - "give %player% diamond 5"

    # Rütbe atlama ödülleri
    on-rank-up:
      bronze:
        - "broadcast &c%player% &lBRONZE &7rütbesine ulaştı!"
      silver:
        - "give %player% iron_ingot 32"
      gold:
        - "give %player% gold_ingot 32"
      diamond:
        - "give %player% diamond 64"

Placeholders

%player% Oyuncu | %verdict% Karar | %xp% XP | %level% Seviye | %rank% Rütbe

Oyuncu Komutları

Komut	Açıklama	İzin
`/report <oyuncu>`	Bir oyuncuyu raporla (GUI açar)	`reportsystem.report`
`/report <oyuncu> <sebep>`	Direkt sebep ile raporla	`reportsystem.report`
`/reports`	Kendi raporlarını görüntüle	`reportsystem.view`

Alternatifler: /rapor, /raporla, /reportplayer

Yetkili Komutları

Komut	Açıklama	İzin
`/reports all`	Tüm raporları listele	`reportsystem.view.all`
`/reports <id>`	Belirli raporu görüntüle	`reportsystem.view.all`
`/reports accept <id>`	Raporu kabul et	`reportsystem.manage`
`/reports reject <id>`	Raporu reddet	`reportsystem.manage`
`/reports delete <id>`	Raporu sil	`reportsystem.delete`

Overwatch Komutları

Komut	Açıklama	İzin
`/overwatch`	Overwatch ana menüsünü aç	`reportsystem.overwatch`
`/overwatch stats`	Kendi istatistiklerini gör	`reportsystem.overwatch`
`/overwatch leaderboard`	Lider tablosunu gör	`reportsystem.overwatch`
`/overwatch npc create <isim>`	Overwatch NPC oluştur	`reportsystem.overwatch.admin`
`/overwatch npc remove`	Yakındaki NPC'yi sil	`reportsystem.overwatch.admin`
`/overwatch npc list`	Tüm NPC'leri listele	`reportsystem.overwatch.admin`
`/overwatch queue add <id>`	Raporu kuyruğa ekle	`reportsystem.overwatch.admin`

Alternatifler: /ow, /overwatchsystem

Admin Komutları

Komut	Açıklama	İzin
`/reportsystem reload`	Yapılandırmayı yeniden yükle	`reportsystem.admin`
`/reportsystem stats`	Sistem istatistiklerini gör	`reportsystem.admin`
`/reportsystem info`	Plugin bilgilerini gör	`reportsystem.admin`
`/reportsystem debug`	Debug modunu aç/kapat	`reportsystem.admin`

Alternatifler: /rs, /rsystem

Temel İzinler

İzin	Açıklama	Varsayılan
`reportsystem.report`	Rapor oluşturma yetkisi	Herkes
`reportsystem.view`	Kendi raporlarını görüntüleme	Herkes
`reportsystem.cooldown.bypass`	Cooldown'u atlama	OP
`reportsystem.exempt`	Raporlanamaz olma	OP

Moderatör İzinleri

İzin	Açıklama
`reportsystem.view.all`	Tüm raporları görüntüleme
`reportsystem.notify`	Yeni rapor bildirimi alma
`reportsystem.manage`	Raporları kabul/reddetme
`reportsystem.punish`	Ceza verme (ban, mute, kick)
`reportsystem.overwatch`	Overwatch sistemini kullanma

LuckPerms Örnek

Konsol Komutları

/lp creategroup moderator
/lp group moderator permission set reportsystem.view.all true
/lp group moderator permission set reportsystem.notify true
/lp group moderator permission set reportsystem.manage true
/lp group moderator permission set reportsystem.overwatch true

Admin İzinleri

İzin	Açıklama
`reportsystem.*`	Tüm izinler (wildcard)
`reportsystem.admin`	Admin komutları (reload, stats)
`reportsystem.delete`	Rapor silme yetkisi
`reportsystem.overwatch.admin`	Overwatch admin (NPC, kuyruk)

Replay Sistemi

Nasıl Çalışır?

Oyuncu rapor edildiğinde sistem son 45 saniyeyi kaydeder

Kayıt sıkıştırılarak veritabanına kaydedilir

Yetkili raporu incelediğinde replay NPC olarak oynatılır

İzleyici tüm hareketleri görebilir

Kaydedilen Veriler

Oyuncu konumu ve yönü (her tick)
Envanter değişiklikleri
Blok kırma/koyma
Saldırı animasyonları
Sürme (at, tekne vb.)
Yakındaki oyuncular (50 blok içinde)
Chat mesajları

Replay Kontrolleri

Item	Fonksiyon
⏸️ Duraklatma	Replay'i duraklat/devam ettir
⏪ Geri Sar	10 saniye geri git
⏩ İleri Sar	10 saniye ileri git
🔴 Durdur	Replay'i sonlandır
🏃 Hız	Oynatma hızını değiştir (0.5x - 2x)

Önemli

Replay izlerken başka oyuncular sizi göremez ve dünyayla etkileşime giremezsiniz.

Overwatch Sistemi

Nedir?

Overwatch, CS:GO'dan esinlenen topluluk tabanlı bir rapor inceleme sistemidir. Güvenilir oyuncular raporları inceler ve oy verir. Yeterli "Suçlu" oyu alınırsa otomatik ceza uygulanır.

İnceleme Süreci

Oyuncu Overwatch NPC'sine sağ tıklar

Sistem kuyruktan rastgele bir rapor atar

İnceleyici replay'i izler

Karar verir: Suçlu, Masum veya Atla

XP kazanır ve rütbe ilerler

Rütbe Sistemi

Rütbe	Gereken XP	Renk
🥉 Bronze	0 XP	Bronz
🥈 Silver	500 XP	Gümüş
🥇 Gold	1000 XP	Altın
💎 Diamond	2500 XP	Elmas

NPC Sistemi

NPC Oluşturma

/overwatch npc create Overwatch-1

Baktığınız yerde bir Overwatch NPC'si oluşturur.

NPC Özellikleri

Korsan kaptan kafası ile görünür
Hologram istatistikleri gösterir
Sağ tıklandığında Overwatch menüsü açılır
Sunucu restart'ında otomatik geri yüklenir
Kırılamaz ve eşyaları alınamaz

NPC Yönetimi

/overwatch npc list      # Tüm NPC'leri listele
/overwatch npc remove    # Yakındaki NPC'yi sil

Ceza Eklentileri

ReportSystem aşağıdaki ceza eklentileriyle tam uyumlu çalışır:

✅

LiteBans

Önerilen ceza eklentisi. Tam entegrasyon.

✅

AdvancedBan

Tam entegrasyon desteği.

✅

BanManager

Tam entegrasyon desteği.

Otomatik Algılama

Herhangi bir yapılandırma gerekmez. Eklenti otomatik olarak yüklü ceza eklentisini algılar.

PlaceholderAPI

PlaceholderAPI yüklüyse aşağıdaki placeholderlar kullanılabilir:

Placeholder	Açıklama
`%reportsystem_reports_total%`	Toplam rapor sayısı
`%reportsystem_reports_pending%`	Bekleyen rapor sayısı
`%reportsystem_player_reports%`	Oyuncunun aldığı rapor sayısı
`%reportsystem_overwatch_xp%`	Overwatch XP'si
`%reportsystem_overwatch_rank%`	Overwatch rütbesi
`%reportsystem_overwatch_reviews%`	Yapılan inceleme sayısı

Sıkça Sorulan Sorular

PacketEvents olmadan çalışır mı?

Hayır. Replay sistemi PacketEvents'e bağımlıdır. Eklenti başlamaz.

Replay kayıtları ne kadar yer kaplar?

Ortalama 45 saniyelik kayıt 50-200 KB. Günde 100 rapor ≈ 10-20 MB.

Replay kayıtları ne zaman silinir?

replay.auto-delete-days ayarına göre. Varsayılan 7 gün.

İki kişi aynı replay'i izleyebilir mi?

Evet. Her izleyici kendi NPC'lerini görür, birbirlerini etkilemezler.

Overwatch NPC sunucu restart'ında kaybolur mu?

Hayır. NPC'ler veritabanına kaydedilir ve otomatik yeniden oluşturulur.

Replay'deki oklar/potionlar gerçek oyuncuları etkiler mi?

Hayır. Replay projectile'ları hasarsız ve etkisizdir.

Sorun Giderme

Eklenti başlamıyor

PacketEvents yüklü mü kontrol edin
Java sürümünü kontrol edin (minimum Java 17)
Konsol loglarını inceleyin

Replay oynatılmıyor

replay.auto-record: true kontrol edin
Replay süresi dolmuş olabilir (auto-delete-days)
/rs debug ile debug modunu açın

Veritabanı bağlantı hatası

MySQL bilgilerini kontrol edin
Veritabanının var olduğundan emin olun
Firewall ayarlarını kontrol edin

Destek

💬

Discord Sunucusu

7/24 topluluk desteği ve anlık yardım

Discord'a Katıl

🐛

Hata Bildirimi

Bir hata buldunuz mu? Discord'da #bug-report kanalından bildirin.

Teşekkürler

ReportSystem'i tercih ettiğiniz için teşekkür ederiz!

Kapsamlı Rehber

ReportSystem Dokümantasyonu

Özellikler

Gereksinimler

Sürüm Uyumluluğu

Hızlı Kurulum (Standalone)

PacketEvents Kurulumu

ReportSystem Kurulumu

İlk Başlatma

Lisans Aktivasyonu

BungeeCord/Velocity Kurulumu

Veritabanı Ayarları

SQLite vs MySQL

Genel Ayarlar

Rapor Ayarları

Replay Ayarları

Overwatch Ayarları

Ödül Ayarları

XP Ayarları

Ödül Komutları

Oyuncu Komutları

Yetkili Komutları

Overwatch Komutları

Admin Komutları

Temel İzinler

Moderatör İzinleri

LuckPerms Örnek

Admin İzinleri

Replay Sistemi

Nasıl Çalışır?

Kaydedilen Veriler

Replay Kontrolleri

Overwatch Sistemi

Nedir?

İnceleme Süreci

Rütbe Sistemi

NPC Sistemi

NPC Oluşturma

NPC Özellikleri

NPC Yönetimi

Ceza Eklentileri

PlaceholderAPI

Sıkça Sorulan Sorular

Sorun Giderme

Destek