Kurulum

WardenGuard iki parçadan oluşur: Minecraft sunucunuzda çalışan plugin ve onu uzaktan yöneten web paneli. Plugin panele dışarı doğru şifreli bir WebSocket bağlantısı açar; sunucunuzda port açmanız gerekmez.

Gereksinimler

İstemci tarafında 1.8.9'dan 1.21'e kadar sürümler (ViaVersion ile) desteklenir.

1. Plugin'i kurun

1. WardenGuard.jar dosyasını sunucunuzun plugins/ klasörüne koyun.
2. Sunucuyu bir kez başlatıp durdurun; plugins/WardenGuard/config.yml oluşturulur.

2. Panelde sunucu ekleyin

1. Kayıt olun veya giriş yapın.
2. Sunucular → Sunucu Ekle ile bir isim verin.
3. Açılan pencerede gösterilen anahtarı kopyalayın. Anahtar yalnızca bir kez gösterilir; kaybederseniz "Anahtarı yenile" ile yenisini üretebilirsiniz.

3. Sunucuyu bağlayın

Sunucu konsolunda veya oyunda (OP olarak) panelin verdiği komutu çalıştırın:

/wac web connect wg_srv_...

Plugin anahtarı config.yml içindeki web.token alanına kaydeder ve hemen bağlanır; yeniden başlatma gerekmez. Birkaç saniye içinde panelde sunucunuz Çevrimiçi görünür ve canlı akış başlar. Durumu /wac web status, gidiş-dönüş süresini /wac web test ile görebilirsiniz.

Kendi kurulumunuzu kullanıyorsanız adresi config.yml içinde değiştirin:

web:
  url: "wss://api.ornek.com/v1/agent"

Network (Bungee / Velocity)

Her backend sunucuya plugin'i ayrı ayrı kurun ve her birine ayrı anahtar verin. Proxy'yi de bir sunucu olarak ekleyebilirsiniz. Ardından Sunucular → Sunucu grupları bölümünden proxy'yi ve arkasındaki sunucuları gruplayarak network haritasını görün.

Kendi sunucunuzda barındırma

Panelin tamamı Docker ile kurulabilir. Veritabanı olarak Supabase (yönetilen PostgreSQL) kullanılır:

cp .env.example .env   # Supabase bağlantı adreslerini ve APP_ENCRYPTION_KEY değerini girin
docker compose up -d --build

migrate servisi veritabanı şemasını otomatik uygular; caddy otomatik TLS sertifikası alır.