Minecraft-Server (Paper, Velocity & Bungee)

Stoppen Sie VPN- und Proxy-Verbindungen, bevor sie Ihrer Spielwelt beitreten.

Vorschau

In-Game Kick-Bildschirm	Konsolen-Warnhinweis

Warum ProxyTracer?

• Echtzeiterkennung: Genaue Überprüfungen anhand der ständig aktualisierten privaten und öffentlichen VPN-Datenbanken von ProxyTracer.
• Multi-Platform Native: Dedizierte Integrationen für Einzelserver (Paper/Spigot) und Multiserver-Netzwerke (Velocity oder BungeeCord/Waterfall).
• Schnelle Leistung: Eingebautes In-Memory-Caching spart API-Credits und stellt sicher, dass zurückkehrende Spieler sofort eine Verbindung herstellen.
• Smart Whitelist: Whitelist-Bypass-Befehle für vertrauenswürdige Spielernamen und Netzwerk-IPs.
• Discord-Warnungen: Protokollieren Sie blockierte VPN-Verbindungen direkt in Ihren Mitarbeiterkanälen.
• Branded Kick Screen: Fordert Spieler mit einer professionellen Blockmeldung auf, die sich auf proxytracer.com bezieht.

Welche JAR-Datei soll ich installieren?

Schnelleinrichtung (60 Sekunden)

1. Holen Sie sich einen kostenlosen API-Schlüssel unter: ProxyTracer.com/dashboard
2. Laden Sie die korrekte .jar für Ihr Setup von den Releases herunter.
3. Legen Sie die jar-Datei in das Verzeichnis plugins/ Ihres Servers und starten Sie ihn einmal.
4. Setzen Sie Ihren API-Schlüssel direkt im Spiel oder über die Konsole:

   /proxytracer set your_api_key_here

   (Dadurch wird der Schlüssel automatisch in Ihre Konfigurationsdatei geschrieben und das Plugin neu geladen).
5. Überprüfen Sie die Verbindung, indem Sie Folgendes ausführen: /proxytracer status

Konfigurationsbeispiel

mode: "block"          # Aktion bei erkanntem Proxy: block | warn | log
 
api:
  base-url: "https://api.proxytracer.com/v1"
  key: "proxy_your_key_here"
  on-error: "allow"    # Fail-Open-Richtlinie, wenn die API offline geht: allow | block | warn
  timeout-ms: 2000
 
notifications:
  in-game: false       # Farbige In-Game-Chat-Nachrichten an das Team senden (proxytracer.notify)
 
cache:
  enabled: true
  ttl-minutes: 1440    # Ergebnis der IP-Prüfung für 24 Stunden zwischenspeichern
  max-entries: 10000
 
discord:
  enabled: false
  webhook-url: ""
  notify-blocked: true

Befehle & Berechtigungen

Allen Befehlen wird /proxytracer vorangestellt:

• /proxytracer notify <on|off|toggle> — Schaltet farbige Chat-Benachrichtigungen für das Server-Team um.
• /proxytracer notify add|remove|list [player] — Hinzufügen, Entfernen oder Auflisten von Team-Mitgliedern, die Benachrichtigungen erhalten dürfen (wird in config.yml gespeichert).
• /proxytracer set <api_key> — Setzt den API-Schlüssel direkt, speichert ihn in config.yml und lädt neu.
• /proxytracer status — Prüft Konfigurationsstatus, API-Zugangsdaten und den Benachrichtigungsstatus.
• /proxytracer check <ip> — Fragt eine IP-Adresse manuell ab.
• /proxytracer cache clear — Leert den lokalen IP-Cache.
• /proxytracer reload — Lädt die Konfigurationsdatei neu.
• /proxytracer whitelist name add|remove|list [player] — Nimmt Spieler von Überprüfungen aus.
• /proxytracer whitelist ip add|remove|list [ip] — Nimmt Netzwerk-IPs von Überprüfungen aus.

Berechtigungen:

• proxytracer.admin — Zugriff auf Reload-, Status- und Administrationsbefehle.
• proxytracer.bypass — Spieler mit dieser Berechtigung umgehen Prüfanforderungen während des Pre-Logins.
• proxytracer.notify — Das Team erhält In-Game-Warnungen, wenn sich ein VPN-Benutzer anmeldet oder gewarnt wird.

(Hinweis: Standardmäßig sind diese Berechtigungen nur den Server-Operatoren (OPs) zugewiesen. Um diese Berechtigungen anderen Spielern oder Teamgruppen zuzuweisen, verwenden Sie ein Berechtigungs-Manager-Plugin wie LuckPerms).

Kompatibilität & Anforderungen

• Java-Version: Java 17 oder höher (vollständig getestet mit Java 17, 21 und 22). Das Plugin ist auf Java 17 ausgerichtet.
• Server-Software-Unterstützung: Paper / Spigot / Purpur (1.13 bis 1.21.x), Velocity (3.x) und BungeeCord / Waterfall (Moderne Builds).
• API-Zugriff: Ein kostenloser oder kostenpflichtiger API-Schlüssel, registriert auf proxytracer.com.

Fehlerbehebung: Probleme mit echten IPs (127.0.0.1)

Wenn Ihre Logs zeigen, dass sich jeder beitretende Spieler von 127.0.0.1 verbindet, kann die ProxyTracer-API diese nicht scannen. Dies bedeutet, dass Ihr Hosting-Netzwerk-Layout oder der Front-End-Proxy die eingehenden Spieler-IPs maskiert.

Lösung:

1. Für Proxy-Netzwerke (Velocity / Bungee): Setzen Sie ProxyTracer nur auf dem Gateway-Proxy (Velocity/Bungee) ein. Stellen Sie sicher, dass die Spieler-Info-Weiterleitung aktiv ist (player-info-forwarding-mode = "modern" in velocity.toml oder ip_forward: true in Bungees config.yml), damit die Backend-Spielknoten die echte IP erhalten.
2. Für Shared-Hosts (z. B. TickHosting Panel-Proxys): Wenn Ihr Host Verbindungsheader über das Proxy-Protokoll weiterleitet, aktivieren Sie es innerhalb Ihrer Paper-Konfiguration (proxies.proxy-protocol: true in config/paper-global.yml) und starten Sie neu. Warnung: Schalten Sie dies nicht ein, es sei denn, Ihr Host unterstützt dies explizit; eine falsche Konfiguration wird alle Spieler am Beitritt hindern.

Preise & API-Kontingente

Die ProxyTracer-Minecraft-Plugins sind zu 100 % kostenlos. Die Erkennung erfordert eine Verbindung zur ProxyTracer-API:

- Kostenlos: 100 Checks/Monat für kleine SMPs und Entwicklungszwecke.
- Starter (3 €/Monat): Perfekt für wachsende öffentliche Server.
- Pro (9 €/Monat) / Scale (39 €/Monat): Konzipiert für etablierte Netzwerke.

Erstellen Sie Ihren Schlüssel & wählen Sie einen Plan: ProxyTracer