Minecraft Servers (Paper, Velocity & Bungee)

Stoppez les connexions VPN et proxy avant qu'ils ne rejoignent votre monde de jeu.

Aperçu

Écran d'expulsion en jeu	Alerte d'avertissement de la console

Pourquoi ProxyTracer ?

• Détection en temps réel: Vérifications précises par rapport aux bases de données résidentielles et VPN publiques constamment mises à jour de ProxyTracer.
• Multiplateforme native: Intégrations dédiées pour les serveurs uniques (Paper/Spigot) et les réseaux multi-serveurs (Velocity ou BungeeCord/Waterfall).
• Performances rapides: La mise en cache en mémoire intégrée économise les crédits de l'API et garantit une connexion instantanée des joueurs de retour.
• Liste blanche intelligente: Commandes de contournement de la liste blanche pour les noms de joueurs et les adresses IP de réseau approuvés.
• Alertes Discord: Enregistrez les connexions VPN bloquées directement sur vos canaux de personnel.
• Écran d'expulsion de marque: Invite les joueurs avec un message de blocage professionnel citant proxytracer.com.

Lequel dois-je télécharger ?

Configuration rapide (60 secondes)

1. Obtenez une clé API gratuite sur : ProxyTracer.com/dashboard
2. Téléchargez le fichier jar correct pour votre configuration à partir de Releases.
3. Placez le jar dans le répertoire plugins/ de votre serveur et démarrez-le une fois.
4. Définissez votre clé API directement dans le jeu ou via la console :

   /proxytracer set your_api_key_here

   (Cela écrit automatiquement la clé dans votre fichier de configuration et recharge le plugin)..
5. Vérifiez la connexion en exécutant : /proxytracer status

Configuration

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

Commandes & Permissions

Toutes les commandes sont préfixées avec /proxytracer :

• /proxytracer notify <on|off|toggle> — Activer/désactiver les messages de chat colorés en jeu pour le personnel.
• /proxytracer notify add|remove|list [joueur] — Ajouter/supprimer/lister les noms d'utilisateur du personnel autorisés à recevoir des notifications en jeu (sauvegardé automatiquement dans config.yml).
• /proxytracer set <api_key> — Définissez la clé API directement, en l'enregistrant dans config.yml et en la rechargeant.
• /proxytracer status — Vérifier l'état de la configuration, les informations d'identification de l'API et l'état des notifications en jeu.
• /proxytracer check <ip> — Interrogez manuellement une adresse IP.
• /proxytracer cache clear — Effacez le cache IP local.
• /proxytracer reload — Rechargez le fichier de configuration.
• /proxytracer whitelist name add|remove|list [player] — Exempter les joueurs des vérifications.
• /proxytracer whitelist ip add|remove|list [ip] — Exempter les adresses IP du réseau des vérifications.

Permissions:

• proxytracer.admin — Accès au rechargement, au statut et aux commandes d'administration.
• proxytracer.bypass — Les joueurs avec cette permission contournent les exigences de vérification avant la connexion.
• proxytracer.notify — Le personnel reçoit des avertissements en jeu lorsqu'un utilisateur VPN est consigné ou averti.

(Remarque : par défaut, ces autorisations ne sont attribuées qu'aux opérateurs de serveur (OPs). Pour accorder ces autorisations à d'autres joueurs ou groupes de personnel, utilisez un plugin de gestionnaire d'autorisations comme LuckPerms)..

Compatibilité et exigences

• Version Java: Java 17 ou supérieur (entièrement testé sur Java 17, 21 et 22). Le plugin est compilé en ciblant Java 17.
• Prise en charge du logiciel serveur: Paper / Spigot / Purpur (1.13 à 1.21.x), Velocity (3.x), et BungeeCord / Waterfall (versions modernes).
• Accès API: Une clé API gratuite ou payante enregistrée sur proxytracer.com.

Dépannage de l'adresse IP réelle

Si vos journaux indiquent que chaque joueur rejoignant se connecte à partir de 127.0.0.1, l'API ProxyTracer ne peut pas les analyser. Cela indique que l'architecture de votre réseau d'hébergement ou que votre proxy frontal masque les adresses IP des joueurs entrants.

Comment résoudre

1. Pour les réseaux proxy (Velocity / Bungee): Déployez ProxyTracer uniquement sur le proxy de la passerelle (Velocity/Bungee). Assurez-vous que le transfert des informations du joueur est actif (player-info-forwarding-mode = "modern" dans velocity.toml ou ip_forward: true dans config.yml de Bungee) afin que les nœuds de jeu backend reçoivent l'adresse IP réelle.
2. Pour les hôtes partagés (par exemple, les proxys du panneau TickHosting): Si votre hôte transmet les en-têtes de connexion via le protocole proxy, activez-le dans votre configuration Paper (proxies.proxy-protocol: true dans config/paper-global.yml) et redémarrez. Avertissement : ne l'activez pas à moins que votre hôte ne le prenne explicitement en charge ; le configurer de manière incorrecte empêchera tous les joueurs de se joindre.

Tarification et quotas

Les plugins ProxyTracer Minecraft sont 100 % gratuits. La détection nécessite une connexion à l'API ProxyTracer:

- Plan gratuit: 100 requêtes/mois pour les petits SMPs et le développement.
- Starter (3 €/mois): Parfait pour les serveurs publics en croissance.
- Pro (9 €/mois) / Scale (39 €/mois): Destiné aux réseaux établis.

Créez votre clé et sélectionnez un plan : ProxyTracer