Serveurs Minecraft (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 lors de la détection d'un proxy : block | warn | log
 
api:
  base-url: "https://api.proxytracer.com/v1"
  key: "proxy_your_key_here"
  on-error: "allow"    # Politique fail-open si l'API est hors ligne : allow | block | warn
  timeout-ms: 2000
 
notifications:
  in-game: false       # Envoyer des messages de discussion en jeu colorés au personnel (proxytracer.notify)
 
cache:
  enabled: true
  ttl-minutes: 1440    # Mettre en cache le résultat de la vérification IP pendant 24 heures
  max-entries: 10000
 
discord:
  enabled: false
  webhook-url: ""
  notify-blocked: true

Commandes & Permissions

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

• /proxytracer notify <on|off|toggle> — Active ou désactive les notifications de chat pour le staff.
• /proxytracer notify add|remove|list [player] — Ajouter, supprimer ou lister les membres du staff autorisés à recevoir les notifications (enregistré dans config.yml).
• /proxytracer set <api_key> — Définit la clé API directement, l'enregistre dans config.yml et recharge.
• /proxytracer status — Vérifie l'état de la configuration, les identifiants API et l'état des notifications.
• /proxytracer check <ip> — Interroge manuellement une adresse IP.
• /proxytracer cache clear — Vide le cache IP local.
• /proxytracer reload — Recharge le fichier de configuration.
• /proxytracer whitelist name add|remove|list [player] — Exempte des joueurs des vérifications.
• /proxytracer whitelist ip add|remove|list [ip] — Exempte des adresses IP 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