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

⚔️

Gelişmiş Ceza Sistemi

Ban, Mute, Kick, Warn + Animasyonlu Ban. GUI'den doğrudan ceza uygulama

💬

Discord Webhook

Raporlar ve cezalar otomatik Discord'a bildirilir. Zengin embed, butonlar ve çoklu dil

🔔

Çoklu Bildirim

Toast, Title, ActionBar, ses efekti ve sohbet bildirimleri

Gereksinimler

Gereksinim	Minimum	Önerilen	Not
Sunucu Yazılımı	Paper 1.21	Paper 1.21.x	Sadece 1.21.x desteklenir
Java Sürümü	Java 21	Java 21	MC 1.21+ için Java 21 zorunlu
PacketEvents	2.11.2+	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	Desteklenen sürüm
1.20.x ve altı	❌ Desteklenmiyor	API uyumsuzluğu

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.

Velocity Kurulumu

Modern proxy kullanıyorsanız Velocity modülünü kullanabilirsiniz.

Velocity proxy'ye ReportSystem-Velocity.jar yükleyin

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

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

Not

Velocity modülü ceza senkronizasyonu ve rapor bildirimleri sağlar. GUI, replay ve Overwatch sistemleri Spigot tarafında çalışı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.

general.check-updates Varsayılan: true

Sunucu başlatıldığında yeni sürüm kontrolü yapar.

telemetry.enabled Varsayılan: true

Anonim kullanım istatistikleri toplar (oyuncu sayısı, rapor sayısı, TPS). İstediğiniz zaman kapatabilirsiniz.

Rapor Ayarları

reports.require-online Varsayılan: true

true = sadece çevrimiçi oyuncular raporlanabilir. false = çevrimdışı oyuncular da raporlanabilir.

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"

reports.min-reason-length / max-reason-length Varsayılan: 10 / 100

Rapor sebebinin minimum ve maksimum karakter uzunluğu.

Replay Ayarları

replay.enabled Varsayılan: true

Replay sistemini aktifleştirir/devre dışı bırakır.

replay.auto-record Varsayılan: true

Rapor oluşturulduğunda otomatik kayıt başlatır.

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).

replay.max-recordings Varsayılan: 3

Eş zamanlı maksimum kayıt sayısı. Her kayıt ~3-4 ms/tick CPU kullanır.

replay.max-file-size Varsayılan: 5 (MB)

Maksimum replay dosya boyutu. -1 = sınırsız.

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.enabled Varsayılan: true

Overwatch sistemini aktifleştirir/devre dışı bırakır.

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).

overwatch.queue.auto-add-reports Varsayılan: false

true = yeni raporlar otomatik kuyruğa eklenir. false = sadece /overwatch addqueue ile eklenir.

overwatch.queue.max-queue-size Varsayılan: 100

Kuyrukta maksimum rapor sayısı. -1 = sınırsız.

overwatch.reviewer.allow-skip Varsayılan: true

false yapılırsa inceleyiciler sadece Suçlu veya Masum seçebilir, Atla butonu devre dışı kalır.

overwatch.reviewer.review-cooldown Varsayılan: 10 (saniye)

İki inceleme arasında bekleme süresi. 0 = devre dışı.

Ö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`
`/reports`	Kendi raporlarını görüntüle	`reportsystem.view`

Alternatifler: /rapor, /raporla, /reportplayer

/reports alternatifler: /raporlar, /reportlist, /raporlistesi

Yetkili Komutları

Yetkili işlemleri (kabul, red, silme, ceza verme) komut yerine GUI üzerinden yapılır:

/reports yazarak rapor listesi GUI'sini açın

İncelemek istediğiniz rapora tıklayın

Detay ekranından: Onayla, Reddet, Replay İzle veya Oyuncuya Işınlan

Not

reportsystem.staff iznine sahip yetkililer sunucuya giriş yaptığında bekleyen rapor sayısını görür.

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 delete <id>`	Belirtilen NPC'yi sil	`reportsystem.overwatch.admin`
`/overwatch npc list`	Tüm NPC'leri listele	`reportsystem.overwatch.admin`
`/overwatch npc skin <npc> <oyuncu>`	NPC skinini değiştir	`reportsystem.overwatch.admin`
`/overwatch npc look <npc>`	NPC'yi sana baktır	`reportsystem.overwatch.admin`
`/overwatch npc move <npc>`	NPC'yi konumuna taşı	`reportsystem.overwatch.admin`
`/overwatch npc name <npc> <isim>`	NPC'yi yeniden adlandır	`reportsystem.overwatch.admin`
`/overwatch npc select <npc>`	Hızlı düzenleme için NPC seç	`reportsystem.overwatch.admin`
`/overwatch addqueue <id> [öncelik]`	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 <true\|false>`	Debug modunu aç/kapat	`reportsystem.admin`
`/reportsystem lang`	Dil ayarlarını kontrol et	`reportsystem.admin`
`/reportsystem testnotif`	Toast bildirim testi	`reportsystem.admin`
`/reportsystem checkadv`	Advancement durumunu kontrol et	`reportsystem.admin`

Alternatifler: /rs, /rsystem, /raporsistem

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.staff`	Yetkili olarak işaretlenme (giriş bildirimi alma)
`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, warn)
`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 (53+ Aksiyon Türü)

Oyuncu Aksiyonları:

Konum, yön ve hareket (her tick)
Can, absorption (altın kalpler) ve hasar
Ekipman ve envanter değişiklikleri
Animasyonlar (kılıç sallama, hasar alma)
Poz değişiklikleri (eğilme, koşma, yüzme)
Knockback/hız, ölüm ve ışınlanma
Chat mesajları ve iksir efektleri

Dünya Aksiyonları:

Blok kırma/koyma, düşen bloklar
Patlamalar, ateş, redstone, nota blokları
Tabela düzenleme, dekorasyon (tablo, item frame)
Hava durumu değişiklikleri ve ses efektleri

Oynanış Aksiyonları:

Item kullanımı (yay, kalkan, yiyecek), olta
Crafting, brewing, enchanting
Araç sürme (at, tekne), portal kullanımı
Projectile (ok, kartopu), hayvan üretme
Yakındaki oyuncular (NPC olarak)

Replay Kontrolleri

Item	Fonksiyon
⏸️ Duraklatma	Replay'i duraklat/devam ettir
⏪ Geri Sar	5 saniye geri git
⏩ İleri Sar	5 saniye ileri git
🔴 Durdur	Replay'i sonlandır
🔍 Ayarlar	Replay ayarları ve bilgi
🎯 Işınlan	Yakındaki NPC oyunculara ışınlan
🏃 Hız	Oynatma hızını değiştir (0.25x - 4x)

Ö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ındığında konsensüs sağlanır ve adminler nihai kararı verir.

İ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

Gerçek oyuncu görünümünde NPC (PacketEvents tabanlı)
Özelleştirilebilir skin (herhangi bir oyuncunun skini)
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 etkileşime girilemez

NPC Yönetimi

/overwatch npc list             # Tüm NPC'leri listele
/overwatch npc delete <id>      # Belirtilen NPC'yi sil
/overwatch npc skin <npc> <oyuncu>  # NPC skinini değiştir
/overwatch npc look <npc>       # NPC'yi sana baktır
/overwatch npc move <npc>       # NPC'yi konumuna taşı
/overwatch npc name <npc> <isim>  # NPC'yi yeniden adlandır
/overwatch npc select <npc>     # Hızlı düzenleme için NPC seç

Ceza Sistemi

Rapor incelemesi sırasında doğrudan GUI üzerinden ceza uygulayabilirsiniz.

Ceza Türleri

Tür	Açıklama	Süre
Ban	Oyuncuyu sunucudan yasaklar	Geçici veya kalıcı
Mute	Oyuncunun sohbetini kapatır	Geçici veya kalıcı
Kick	Oyuncuyu sunucudan atar	Anlık
Warn	Uyarı verir (sayaçlı)	Anlık

Hızlı Süre Seçimi

config.yml

punishments:
  durations:
    - "5m"        # 5 dakika
    - "30m"       # 30 dakika
    - "1h"        # 1 saat
    - "1d"        # 1 gün
    - "7d"        # 7 gün
    - "30d"       # 30 gün
    - "permanent" # Kalıcı

Animasyonlu Ban ⚡

Hile kullanan oyunculara görsel bir şov ile ban atın. Diğer oyuncular da bu anı görebilir.

Oyuncu yerinde dondurulur

Gökyüzünden örs düşer

Yıldırım çarpar

Özel ölüm mesajı gösterilir ve ban uygulanır

Not

Animasyonlu ban için hedef oyuncunun çevrimiçi olması gerekir.

Bildirim Sistemi

Yeni rapor oluşturulduğunda yetkililere çoklu bildirim gönderilir. Tüm bildirim türleri bağımsız olarak açılıp kapatılabilir.

Tür	Açıklama	Config
Toast	Sağ üst köşede başarım tarzı popup	Otomatik
Title	Ekranın ortasında büyük başlık	`reports.notifications.title-enabled`
Action Bar	Hotbar üstünde kayan metin	`reports.notifications.actionbar-enabled`
Ses	Bildirim sesi (özelleştirilebilir)	`reports.notifications.sound-enabled`
Sohbet	Detaylı rapor bilgisi	`reports.notifications.notify-staff`

Bir yetkili sunucuya giriş yaptığında, bekleyen rapor sayısı otomatik olarak gösterilir.

Discord Webhook

Raporlar, cezalar ve rapor kapanışları otomatik olarak Discord kanalınıza bildirilir.

Kurulum

Discord sunucunuzda bir kanal seçin

Kanal Ayarları → Entegrasyonlar → Webhook Oluştur

Webhook URL'sini kopyalayıp config.yml'e yapıştırın

config.yml

discord-webhook:
  enabled: true
  url: "https://discord.com/api/webhooks/123456789/abcdefghijklmnop"
  avatar-url: "https://i.imgur.com/4M34hi2.png"
  add-buttons: true
  include-server-name: true

  events:
    new-report: true      # Yeni rapor
    report-closed: true   # Rapor kabul/red
    punishment: true      # Ceza uygulandığında

Özellikler

🎨

Zengin Embed

Renkli embed mesajları — her olay türü için farklı renkler

🔘

İnteraktif Butonlar

Tıklanabilir butonlarla rapor detaylarına erişim

🌍

Çoklu Dil

Mesajlar eklenti dil ayarına göre Türkçe veya İngilizce gönderilir

Anti-Cheat Entegrasyonu

ReportSystem, anti-cheat eklentileriyle entegre çalışarak hile tespit edildiğinde otomatik kayıt + rapor + Overwatch kuyruğu oluşturur. Manuel /report komutuna gerek kalmadan hileciler otomatik olarak kayıt altına alınır.

Akıllı Puanlama Sistemi

Her anti-cheat flag'i bir süphe puanı biriktirir. Puan eşiğe ulaştığında kayıt başlar. Tek bir flag kayıt başlatmaz — bu sayede sahte pozitifler filtrelenir. Puan her 60 saniyede yarıya düşer.

🛡️

Polar Anti-Cheat

Cloud ML destekli tespit. 4 sinyal dinlenir: Detection, Cloud ML, Mitigation, Punishment. KillAura, Aim Assist gibi gelişmiş hileleri ML ile tespit eder.

🔥

Vulcan Anti-Cheat

Paket tabanlı tespit. 35+ check tipi desteklenir: KillAura, Flight, Speed, Scaffold ve daha fazlası. Flag ve Punishment eventleri dinlenir.

👁️

Grim AntiCheat

Ücretsiz ve açık kaynak. Movement, reach ve scaffold tespitinde en iyilerden. Prediction tabanlı fizik simülasyonu ile çalışır. FlagEvent ve CommandExecuteEvent dinlenir.

Nasıl Çalışır?

1. Anti-cheat bir oyuncuyu şüpheli olarak işaretler (flag)

2. Her flag süphe puanı biriktirir (KillAura: +0.40, Flight: +0.15, Cloud ML: +0.50)

3. Puan eşiği aşılınca otomatik 30 saniyelik kayıt başlar

4. Rapor oluşturulur, Overwatch kuyruğuna eklenir ve Discord webhook bildirimi gönderilir

Yapılandırma

Polar Anti-Cheat

polar:
  enabled: false
  suspicion-threshold: 1.0    # Süphe puanı eşiği (0.5=hassas, 1.0=dengeli, 1.5=tutucu)
  cooldown-seconds: 300       # Aynı oyuncu için bekleme süresi
  max-auto-recordings: 5      # Maksimum eş zamanlı kayıt
  recording-duration: 30      # Kayıt süresi (saniye)
  add-to-overwatch: true      # Overwatch kuyruğuna ekle

Vulcan Anti-Cheat

vulcan:
  enabled: false
  suspicion-threshold: 1.0
  cooldown-seconds: 300
  max-auto-recordings: 5
  recording-duration: 30
  add-to-overwatch: true

Grim AntiCheat

grim:
  enabled: false
  suspicion-threshold: 1.0
  cooldown-seconds: 300
  max-auto-recordings: 5
  recording-duration: 30
  add-to-overwatch: true

Önemli

Polar: PolarLoader eklentisi yüklü olmalıdır.
Vulcan: Vulcan eklentisi yüklü olmalı ve config.yml'de settings.enable-api: true ayarlanmalıdır.
Grim: GrimAC eklentisi yüklü olmalıdır (ücretsiz, açık kaynak).
Tüm entegrasyonlar opsiyoneldir — anti-cheat yüklü değilse eklenti normal çalışmaya devam eder.

Puanlama Tablosu

Check Tipi	Puan	Açıklama
Cloud Combat Behavior	+0.50	ML tabanlı KillAura/Aimbot tespiti (sadece Polar)
Auto Clicker	+0.45	Otomatik tıklama tespiti
KillAura	+0.40	Savaş hilesi tespiti
Scaffold	+0.35	Otomatik blok yerleştirme
Reach	+0.30	Uzun menzil hilesi
Flight	+0.15	Uçma hilesi (setback ile engellenir)
Speed	+0.10	Hız hilesi
Movement	+0.05	Hareket anomalisi (düşük puan — geçici lag olabilir)

Ceza Eklentileri

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

✅

LiteBans

Önerilen ceza eklentisi. Tam entegrasyon.

✅

AdvancedBan

Tam entegrasyon desteği.

🔧

Dahili Sistem

Harici eklenti olmadan kendi ceza sistemiyle çalışır.

Otomatik Algılama

BungeeCord/Velocity proxy modunda eklenti otomatik olarak yüklü ceza eklentisini algılar. Standalone modda dahili ceza sistemi kullanılır.

PlaceholderAPI

ReportSystem, PlaceholderAPI ile tam entegre çalışır. Aşağıdaki placeholder'ları scoreboard, tab, hologram ve diğer eklentilerde kullanabilirsiniz.

Gereksinim

PlaceholderAPI eklentisinin sunucunuzda kurulu olması gerekir. Otomatik olarak algılanır.

Rapor Placeholder'ları

Placeholder	Açıklama
`%reportsystem_reports%`	Oyuncuya açılan toplam rapor sayısı
`%reportsystem_trust_level%`	Hesap durumu seviyesi (Mükemmel, İyi, Orta, Kötü, Kritik)
`%reportsystem_trust_points%`	İhlal puanı (zamanla azalır)

Overwatch Placeholder'ları

Placeholder	Açıklama
`%reportsystem_overwatch_rank%`	Overwatch rütbesi (BRONZE, SILVER, GOLD, DIAMOND)
`%reportsystem_overwatch_level%`	Overwatch seviyesi
`%reportsystem_overwatch_xp%`	Toplam XP
`%reportsystem_overwatch_reviews%`	Toplam inceleme sayısı
`%reportsystem_overwatch_accuracy%`	Doğruluk oranı (50+ inceleme sonrası)

Kullanım Örneği

# Scoreboard örneği (TAB, Featherboard vb.)
Raporlar: %reportsystem_reports%
Hesap Durumu: %reportsystem_trust_level%
OW Rütbe: %reportsystem_overwatch_rank%
OW Seviye: %reportsystem_overwatch_level%

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 21)
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

Performans Ayarları

performance.async-database Varsayılan: true

Veritabanı işlemlerini asenkron çalıştırır. TPS'e sıfır etki. Kapatmayın.

performance.cache.enabled Varsayılan: true

Raporları bellekte önbelleğe alır. GUI açılışlarında cache kullanılır.

performance.cache.max-size / expiry Varsayılan: 100 / 10 dakika

Bellekte tutulacak maksimum rapor sayısı ve önbellek geçerlilik süresi.

Performans İpuçları

replay.max-recordings: 3 — Eş zamanlı kayıtları sınırlayın
nearby-player-tracking.interval-ticks: 3 — Varsayılan dengeyi koruyun
nearby-player-tracking.movement-threshold: 0.05 — %40-60 daha az veri
performance.async-database: true — Asenkron veritabanını açık tutun

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

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 (53+ Aksiyon Türü)

Replay Kontrolleri

Overwatch Sistemi

Nedir?

İnceleme Süreci

Rütbe Sistemi

NPC Sistemi

NPC Oluşturma

NPC Özellikleri

NPC Yönetimi

Ceza Sistemi

Ceza Türleri

Hızlı Süre Seçimi

Animasyonlu Ban ⚡

Bildirim Sistemi

Discord Webhook

Kurulum

Özellikler

Anti-Cheat Entegrasyonu

Nasıl Çalışır?

Yapılandırma

Polar Anti-Cheat

Vulcan Anti-Cheat

Grim AntiCheat

Puanlama Tablosu

Ceza Eklentileri

PlaceholderAPI

Rapor Placeholder'ları

Overwatch Placeholder'ları

Kullanım Örneği

Sıkça Sorulan Sorular

Sorun Giderme

Performans Ayarları

Destek