🚀 KURULUM

Kurulum Rehberi

ReportSystem'i sunucunuza kurmanın adım adım kılavuzu

⚡ Hızlı Başlangıç

5 dakikada ReportSystem'i kurun ve kullanmaya başlayın!

1

PacketEvents'i İndirin

PacketEvents 2.11.2+ sürümünü indirin ve plugins klasörüne atın

$ wget https://github.com/retrooper/packetevents/releases/latest
2

ReportSystem'i Yükleyin

ReportSystem JAR dosyasını plugins klasörüne kopyalayın

$ cp ReportSystem-1.0.0.jar ./plugins/
3

Sunucuyu Başlatın

İlk başlatmada yapılandırma dosyaları otomatik oluşacak

$ java -Xmx2G -jar server.jar
4

Yapılandırmayı Düzenleyin

config.yml dosyasını düzenleyerek veritabanı ayarlarını yapın

$ nano plugins/ReportSystem-Spigot/config.yml
5

Yeniden Başlatın

Değişikliklerin aktif olması için sunucuyu tamamen yeniden başlatın (reload kullanmayın!)

$ stop
$ java -Xmx2G -jar server.jar

📋 Gereksinimler

🎮
Minecraft Sürümü
1.21.x
Java Sürümü
Java 21 veya üzeri
📦
Sunucu Yazılımı
Paper/Spigot
🔧
Bağımlılıklar
PacketEvents 2.11.2+
💾
RAM
Minimum 2GB
🗄️
Veritabanı
MySQL/SQLite
⚠️
Önemli: PacketEvents olmadan eklenti çalışmayacaktır! Kurulumdan önce PacketEvents'in yüklü olduğundan emin olun.

Opsiyonel Bağımlılıklar

🏷️
PlaceholderAPI
Placeholder desteği
💰
Vault
Ekonomi entegrasyonu
🔨
LiteBans
Ceza entegrasyonu
AdvancedBan
Ceza entegrasyonu

⚙️ Yapılandırma

Genel
Veritabanı
Replay Sistemi
Overwatch
# Genel Ayarlar
general:
  language: "tr" # tr veya en
  debug: false

bungeecord:
  enabled: false

# Rapor Ayarları
reports:
  cooldown: 60
  auto-close-days: 30
  max-reports-per-player: 3
# Veritabanı Ayarları
database:
  type: "mysql" # mysql veya sqlite
  mysql:
    host: "localhost"
    port: 3306
    database: "reportsystem"
    username: "root"
    password: "password"
    pool:
      maximum-pool-size: 10
# Replay Kayıt Ayarları

replay:
  enabled: true
  auto-record: true
  recording-duration: 45 # saniye
  max-recordings: 3
  auto-delete-days: 7
  quality:
    record-nearby-players: true
    nearby-radius: 50
# Overwatch Sistemi

overwatch:
  enabled: true
  min-reviewers: 3
  consensus-threshold: 70.0
  xp:
    guilty-innocent-xp: 15
    skip-xp: 5
    bronze-xp: 0
    silver-xp: 500
    gold-xp: 1000
    diamond-xp: 2500

🌐 BungeeCord/Velocity Kurulumu

💡
Bilgi: BungeeCord/Velocity kurulumu için hem proxy hem de backend sunuculara eklentiyi yüklemeniz gerekir.
1

Proxy'ye Yükleyin

ReportSystem-BungeeCord.jar dosyasını BungeeCord/Velocity plugins klasörüne atın

2

Backend Sunuculara Yükleyin

Tüm Spigot/Paper sunuculara ReportSystem-Spigot.jar dosyasını yükleyin

3

MySQL Yapılandırması

Tüm sunucular aynı MySQL veritabanını kullanmalıdır

4

Config'i Güncelleyin

Tüm Spigot sunucularda config.yml'de bungeecord: true yapın

5

Test Edin

Farklı sunuculardan /report komutu ile rapor oluşturun ve /reports ile kontrol edin

🚀
Velocity: Velocity proxy için de aynı adımlar geçerlidir. ReportSystem-Velocity.jar dosyasını kullanın.

🔧 Sorun Giderme

Eklenti başlamıyor, ne yapmalıyım? +
1. PacketEvents'in yüklü olduğundan emin olun
2. Java sürümünüzün 21 veya üzeri olduğunu kontrol edin
3. Konsol loglarını kontrol edin
4. config.yml dosyasında syntax hatası olmadığından emin olun
Veritabanı bağlantı hatası alıyorum +
1. MySQL sunucusunun çalıştığından emin olun
2. Kullanıcı adı ve şifrenizi kontrol edin
3. Veritabanının oluşturulduğundan emin olun
4. Firewall ayarlarını kontrol edin
Replay kayıtları çok yer kaplıyor +
1. replay.auto-delete-days değerini düşürün (varsayılan: 7)
2. replay.max-file-size limitini ayarlayın (varsayılan: 5 MB)
3. replay.recording-duration süresini kısaltın (örn: 30 saniye)
4. replay.max-recordings eş zamanlı kayıt sayısını sınırlayın
BungeeCord'da senkronizasyon çalışmıyor +
1. Tüm sunucuların aynı MySQL veritabanını kullandığından emin olun
2. config.yml'de bungeecord: true ayarlandığını kontrol edin
3. Proxy ve backend versiyonlarının uyumlu olduğunu kontrol edin
4. Farklı sunuculardan rapor oluşturup /reports ile test edin

🎯 İlk Çalıştırma

Tebrikler! ReportSystem başarıyla kuruldu. İlk çalıştırmada yapmanız gerekenler:
1

İzinleri Ayarlayın

LuckPerms veya başka bir izin eklentisi ile reportsystem.* izinlerini verin

2

Rapor Kategorilerini Kontrol Edin

Config.yml dosyasında önceden tanımlı kategoriler bulunur (Hile, Trolleme, Hakaret vb.)

3

Moderatörleri Atayın

reportsystem.overwatch iznini moderatörlere verin

4

Test Raporu Oluşturun

/report komutu ile test amaçlı bir rapor oluşturun

5

Overwatch ile Replay İzleyin

/overwatch komutu ile raporları inceleyin ve replay kayıtlarını izleyin

6

Ceza Sistemini Kontrol Edin

LiteBans/AdvancedBan entegrasyonunu test edin

🚀 Sonraki Adımlar

Kurulum tamamlandı! Şimdi neler yapabilirsiniz:

📖
Dokümantasyon
Detaylı kullanım kılavuzunu okuyun
📝
Değişiklikler
Son güncellemeleri kontrol edin
💬
Discord
Topluluğumuza katılın