Minecraft Sunucuları (Paper, Velocity ve Bungee)

VPN ve proxy bağlantılarını oyun dünyanıza katılmadan önce durdurun.

Önizleme

Oyun İçi Atılma Ekranı (Kick Screen)	Konsol Uyarı Bildirimi

Neden ProxyTracer?

• Gerçek Zamanlı Algılama: ProxyTracer'ın sürekli güncellenen konut (residential) ve genel VPN veritabanlarına karşı kesin denetimler.
• Çoklu Platform Desteği: Tekil sunucular (Paper/Spigot) ve çok sunuculu ağlar (Velocity veya BungeeCord/Waterfall) için özel entegrasyonlar.
• Yüksek Performans: Yerleşik bellek içi önbellek API kredilerinden tasarruf sağlar ve tekrar bağlanan oyuncuların anında giriş yapmasını garantiler.
• Akıllı Beyaz Liste: Güvenilir oyuncu adları ve ağ IP'leri için kontrolleri atlama (whitelist bypass) komutları.
• Discord Uyarıları: Engellenen VPN girişlerini doğrudan yetkili/personel kanallarınıza kaydedin.
• Özel Atılma Ekranı (Kick Screen): Oyunculara proxytracer.com referanslı profesyonel bir engelleme mesajı gösterir.

Hangi .jar dosyasını kurmalıyım?

Hızlı Kurulum (60 Saniye)

1. Şu adresten ücretsiz bir API anahtarı edinin: ProxyTracer.com/dashboard
2. Kurulumunuz için doğru .jar dosyasını Releases sayfasından indirin.
3. .jar dosyasını sunucunuzun plugins/ dizinine yerleştirin ve sunucuyu bir kez başlatın.
4. API anahtarınızı doğrudan oyun içinden veya sunucu konsolundan ayarlayın:

   /proxytracer set your_api_key_here

   (Bu komut anahtarı otomatik olarak yapılandırma dosyanıza kaydeder ve eklentiyi yeniden yükler).
5. Bağlantıyı şu komutla doğrulayın: /proxytracer status

Yapılandırma Özeti

mode: "block"          # Proxy algılandığında yapılacak eylem: block | warn | log
 
api:
  base-url: "https://api.proxytracer.com/v1"
  key: "proxy_your_key_here"
  on-error: "allow"    # API çevrimdışı olursa fail-open politikası: allow | block | warn
  timeout-ms: 2000
 
notifications:
  in-game: false       # Yetkililere renkli oyun içi sohbet mesajları gönderin (proxytracer.notify)
 
cache:
  enabled: true
  ttl-minutes: 1440    # IP kontrol sonucunu 24 saat boyunca önbelleğe alın
  max-entries: 10000
 
discord:
  enabled: false
  webhook-url: ""
  notify-blocked: true

Komutlar ve İzinler

Tüm komutlar /proxytracer ön ekiyle başlar:

• /proxytracer notify <on|off|toggle> — Yetkililer için oyun içi renkli sohbet bildirimlerini açar/kapatır.
• /proxytracer notify add|remove|list [player] — Oyun içi bildirim alacak yetkili kullanıcıları ekler/kaldırır/listeler (config.yml dosyasına kaydedilir).
• /proxytracer set <api_key> — API anahtarını doğrudan ayarlar, config.yml dosyasına kaydeder ve yeniden yükler.
• /proxytracer status — Yapılandırma durumunu, API kimlik bilgilerini ve oyun içi bildirim durumunu kontrol eder.
• /proxytracer check <ip> — Bir IP adresini manuel olarak sorgular.
• /proxytracer cache clear — Yerel IP önbelleğini temizler.
• /proxytracer reload — Yapılandırma dosyasını yeniden yükler.
• /proxytracer whitelist name add|remove|list [player] — Belirtilen oyuncuları kontrollerden muaf tutar.
• /proxytracer whitelist ip add|remove|list [ip] — Belirtilen IP adreslerini kontrollerden muaf tutar.

İzinler:

• proxytracer.admin — Yeniden yükleme, durum ve yönetim komutlarına erişim sağlar.
• proxytracer.bypass — Bu izne sahip oyuncular giriş öncesi kontrol gereksinimlerinden muaf tutulur.
• proxytracer.notify — Bir VPN kullanıcısı tespit edildiğinde yetkililer oyun içi bildirim alır.

(Not: Varsayılan olarak bu izinler yalnızca sunucu Operatörlerine (OP) atanır. Bu izinleri diğer oyunculara veya yetkili gruplarına vermek için LuckPerms gibi bir izin yöneticisi eklentisi kullanın).

Uyumluluk ve Gereksinimler

• Java Sürümü: Java 17 veya üzeri (Java 17, 21 ve 22 sürümlerinde kapsamlı olarak test edilmiştir). Eklenti Java 17 hedefiyle derlenmiştir.
• Sunucu Yazılımı Desteği: Paper / Spigot / Purpur (1.13 - 1.21.x), Velocity (3.x) ve BungeeCord / Waterfall (Güncel sürümler).
• API Erişimi: proxytracer.com üzerinde kayıtlı ücretsiz veya ücretli bir API anahtarı.

Sorun Giderme: Gerçek IP Sorunları (127.0.0.1)

Günlükleriniz sunucuya bağlanan her oyuncunun 127.0.0.1 adresinden geldiğini gösteriyorsa, ProxyTracer API bu adresleri doğru tarayamaz. Bu durum, barındırma ağ düzeninizin veya ön uç (front-end) proxy'nizin gelen oyuncu IP'lerini maskelediğini gösterir.

Nasıl Düzeltilir:

1. Proxy Ağları İçin (Velocity / Bungee): ProxyTracer'ı yalnızca ağ geçidi proxy'sine (Velocity/Bungee) kurun. Backend oyun sunucularının gerçek IP'yi alabilmesi için oyuncu bilgisi iletiminin aktif olduğundan emin olun (velocity.toml içinde player-info-forwarding-mode = "modern" veya Bungee'nin config.yml dosyasında ip_forward: true).
2. Paylaşımlı Barındırma Sunucuları İçin (ör. TickHosting panel proxy'leri): Sunucu sağlayıcınız bağlantı başlıklarını Proxy Protocol üzerinden iletiyorsa, Paper yapılandırmanızda bu özelliği aktif edin (config/paper-global.yml içinde proxies.proxy-protocol: true) ve sunucuyu yeniden başlatın. Uyarı: Sunucu sağlayıcınız açıkça desteklemediği sürece bu ayarı açmayın; yanlış yapılandırma tüm oyuncuların sunucuya bağlanmasını engeller.

Fiyatlandırma ve API Kotaları

ProxyTracer Minecraft eklentileri %100 ücretsizdir. Tespit işlemleri ProxyTracer API bağlantısı gerektirir:

- Ücretsiz Plan: Küçük SMP sunucuları ve geliştirme için ayda 100 kontrol.
- Starter (3€/ay): Büyüyen halka açık sunucular için idealdir.
- Pro (9€/ay) / Scale (39€/ay): Yerleşik ve büyük sunucu ağları için uygundur.

Anahtarınızı oluşturun ve bir plan seçin: ProxyTracer