🚀 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.0+ 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/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.18 - 1.21+
Java Sürümü
Java 17 veya üzeri
📦
Sunucu Yazılımı
Paper/Spigot
🔧
Bağımlılıklar
PacketEvents 2.0+
💾
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

language: "tr" # tr veya en
bungeecord: false # BungeeCord/Velocity kullanıyorsanız true yapın
debug: false

# Rapor Ayarları
reports:
  cooldown-seconds: 60
  auto-close-days: 30
  notify-staff: true
# Veritabanı Ayarları
database:
  type: "mysql" # mysql veya sqlite
  host: "localhost"
  port: 3306
  database: "reportsystem"
  username: "root"
  password: "password"
  pool-size: 10
  use-ssl: false
# Replay Kayıt Ayarları

replay:
  enabled: true
  duration-seconds: 45 # Kayıt süresi (saniye)
  auto-delete-days: 7 # Otomatik silme (gün)
  save-blocks: true
  save-entities: true
  max-tracked-players: 50
# Overwatch Sistemi

overwatch:
  enabled: true
  min-reports: 3
  auto-assign: true
  xp-rewards:
    correct: 10
    incorrect: -5
  ranks:
    bronze: 0
    silver: 100
    gold: 500

🌐 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-Bungee.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 17 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. auto-clean özelliğini aktif edin
2. clean-after-days değerini düşürün
3. Compression özelliğinin aktif olduğundan emin olun
4. Duration süresini kısaltabilirsiniz (örn: 30 saniye)
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