Minecraft Servers (Paper, Velocity & Bungee)

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

Vorschau

In-Game-Kick-Bildschirm	Konsolenwarnung

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.

Welches soll ich herunterladen?

Schnelleinrichtung (60 Sekunden)

1. Holen Sie sich einen kostenlosen API-Schlüssel unter: ProxyTracer.com/dashboard
2. Laden Sie das richtige JAR für Ihr Setup aus Releases herunter.
3. Legen Sie das JAR in das Verzeichnis plugins/ Ihres Servers und starten Sie es einmal.
4. Stellen Sie Ihren API-Schlüssel direkt im Spiel oder über die Konsole ein:

   /proxytracer set your_api_key_here

   (Dies schreibt den Schlüssel automatisch in Ihre Konfigurationsdatei und lädt das Plugin neu)..
5. Überprüfen Sie die Verbindung, indem Sie Folgendes ausführen: /proxytracer status

Konfiguration

mode: "block"          # Action when proxy detected: block | warn | log
 
api:
  base-url: "https://api.proxytracer.com/v1"
  key: "proxy_your_key_here"
  on-error: "allow"    # Fail-open policy if API goes offline: allow | block | warn
  timeout-ms: 2000
 
notifications:
  in-game: false       # Send colored in-game chat messages to staff (proxytracer.notify)
 
cache:
  enabled: true
  ttl-minutes: 1440    # Cache IP check result for 24 hours
  max-entries: 10000
 
discord:
  enabled: false
  webhook-url: ""
  notify-blocked: true

Befehle & Berechtigungen

Allen Befehlen ist /proxytracer vorangestellt:

• /proxytracer notify <on|off|toggle> — In-Game farbige Chat-Nachrichten für das Personal umschalten.
• /proxytracer notify add|remove|list [spieler] — Personal-Benutzernamen hinzufügen/entfernen/auflisten, die In-Game-Benachrichtigungen erhalten dürfen (automatisch in config.yml gespeichert).
• /proxytracer set <api_key> — API-Schlüssel direkt festlegen, in config.yml speichern und neu laden.
• /proxytracer status — Überprüfen Sie den Konfigurationsstatus, die API-Anmeldeinformationen und den Status der In-Game-Benachrichtigung.
• /proxytracer check <ip> — Fragen Sie manuell eine IP-Adresse ab.
• /proxytracer cache clear — Löschen Sie den lokalen IP-Cache.
• /proxytracer reload — Laden Sie die Konfigurationsdatei neu.
• /proxytracer whitelist name add|remove|list [spieler] — Spieler von Überprüfungen befreien.
• /proxytracer whitelist ip add|remove|list [ip] — Netzwerk-IPs von Überprüfungen befreien.

Berechtigungen:

• proxytracer.admin — Zugriff auf Neulade-, Status- und Verwaltungsbefehle.
• proxytracer.bypass — Spieler mit dieser Berechtigung umgehen die Überprüfungsanforderungen vor der Anmeldung.
• proxytracer.notify — Mitarbeiter erhalten Warnungen im Spiel, wenn ein VPN-Benutzer protokolliert oder gewarnt wird.

(Hinweis: Standardmäßig sind diese Berechtigungen nur Serverbetreibern (OPs) zugewiesen. Um diese Berechtigungen anderen Spielern oder Mitarbeitergruppen zu gewähren, verwenden Sie ein Berechtigungsmanager-Plugin wie LuckPerms)..

Kompatibilität & Anforderungen

• Java Version: Java 17 oder höher (vollständig getestet auf Java 17, 21 und 22). Das Plugin wird für Java 17 kompiliert.
• Server Software Support: Paper / Spigot / Purpur (1.13 bis 1.21.x), Velocity (3.x) und BungeeCord / Waterfall (moderne Builds).
• API Access: Ein kostenloser oder kostenpflichtiger API-Schlüssel, der unter proxytracer.com registriert ist.

Fehlerbehebung der echten IP

Wenn in Ihren Protokollen angezeigt wird, dass sich jeder beitretende Spieler über 127.0.0.1 verbindet, kann die ProxyTracer API sie nicht scannen. Dies weist darauf hin, dass Ihr Hosting-Netzwerklayout oder Ihr Frontend-Proxy die eingehenden Spieler-IPs maskiert.

Wie man es behebt

1. Für Proxy-Netzwerke (Velocity / Bungee): Stellen Sie ProxyTracer nur auf dem Gateway-Proxy (Velocity/Bungee) bereit. Stellen Sie sicher, dass die Weiterleitung von Spielerinformationen 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 gemeinsam genutzte Hosts (z. B. TickHosting-Panel-Proxys): Wenn Ihr Host Verbindungskopfzeilen über das Proxy-Protokoll weiterleitet, aktivieren Sie es in Ihrer Paper-Konfiguration (proxies.proxy-protocol: true in config/paper-global.yml) und starten Sie es neu. Warnung: Schalten Sie dies nicht ein, es sei denn, Ihr Host unterstützt dies ausdrücklich; Wenn Sie es falsch konfigurieren, können keine Spieler mehr beitreten.

Preise & Kontingente

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

- Kostenlose Stufe: 100 Überprüfungen/Monat für kleine SMPs und Entwicklung.
- Starter (3 €/Monat): Perfekt für wachsende öffentliche Server.
- Pro (9 €/Monat) / Scale (39 €/Monat): Für etablierte Netzwerke gedacht.

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