📚 Documentation NovaRedirectCommand

Version : 2026.01.21 Auteur : YoannFM Support : https://discord.gg/HtjPAfqUXu


📖 Table des matières

  1. Introduction

  2. Installation

  3. Configuration

  4. Commandes

  5. Permissions

  6. Fonctionnalités

  7. Exemples d'utilisation

  8. Système de licence

  9. Logging

  10. Dépannage

  11. API pour développeurs


🎯 Introduction

NovaRedirectCommand est un plugin Minecraft (Spigot/Paper) qui permet de créer des alias de commandesconfigurables avec redirection dynamique. Il offre une solution professionnelle pour renommer, rediriger et gérer vos commandes serveur.

Caractéristiques principales

  • Alias de commandes personnalisables : Redirigez n'importe quelle commande vers une autre

  • Tab completion intelligente : Délégation automatique ou manuelle des suggestions

  • Système de permissions : Contrôlez qui peut utiliser chaque alias

  • Protection anti-boucle : Détection automatique des redirections infinies

  • Support multi-serveurs : Compatible Bungee/Velocity (optionnel)

  • Placeholders dynamiques : {player}, {world}, {uuid}, {server}

  • Logging avancé : Traçabilité complète des redirections

  • Système de licence sécurisé : Vérification automatique avec signature JAR

  • Messages personnalisables : Support MiniMessage et couleurs legacy


📥 Installation

Prérequis

  • Serveur Minecraft : Spigot 1.16+ ou Paper 1.16+ (recommandé)

  • Java : Version 17 ou supérieure

  • Adventure API : Incluse automatiquement dans le plugin

Étapes d'installation

  1. Téléchargez le fichier JAR du plugin

  2. Placez-le dans le dossier plugins/ de votre serveur

  3. Démarrez le serveur pour générer les fichiers de configuration

  4. Configurez votre clé de licence dans config.yml

  5. Redémarrez le serveur


⚙️ Configuration

Fichier config.yml

Fichier plugin.yml

Le fichier plugin.yml est automatiquement généré. Pour ajouter de nouveaux alias, vous devez :

  1. Les déclarer dans config.yml (section aliases)

  2. Les ajouter dans plugin.yml (section commands)

  3. Redémarrer le serveur

Exemple d'ajout d'alias :


🎮 Commandes

Commande principale

/novaredirect (alias: /nrc)

Description : Commande principale du plugin pour administration

Permission : novaredirect.admin

Syntaxe :

Exemples :

Alias de commandes

Les alias sont définis dans config.yml et redirigent automatiquement vers les commandes cibles.

Exemples d'alias par défaut :


🔐 Permissions

Permissions principales

Permission
Description
Défaut

novaredirect.admin

Accès aux commandes d'administration

op

novaredirect.use.*

Accès à tous les alias

true

novaredirect.use.shinju

Utiliser l'alias /shinju

true

novaredirect.use.test

Utiliser l'alias /test

true

Configuration des permissions

Avec LuckPerms :

Dans permissions.yml (Bukkit) :


🚀 Fonctionnalités

1. Redirections simples

Redirigez une commande vers une autre.

Exemple :

Résultat : /money/economy balance

2. Redirections avec arguments

Les arguments sont automatiquement transmis à la commande cible.

Exemple :

Résultat : /pay Notch 100/economy pay Notch 100

3. Placeholders dynamiques

Utilisez des placeholders pour personnaliser les redirections.

Placeholders disponibles :

  • {player} - Nom du joueur

  • {uuid} - UUID du joueur

  • {world} - Monde actuel du joueur

  • {server} - Nom du serveur

Exemple :

Résultat : /stats (par Notch dans le monde "world_nether") → /playerstats show Notch world_nether

4. Tab completion intelligente

Tab completion manuelle

Définissez vos propres suggestions.

Résultat : Appuyez sur TAB après /warp → Affiche les suggestions

Tab completion déléguée

Si vous ne définissez pas tab-completions, le plugin délègue automatiquement à la commande cible.

5. Protection anti-boucle

Le plugin détecte automatiquement les boucles infinies.

Exemple de boucle détectée :

Message affiché : Boucle de redirection detectee (profondeur max: 5)

6. Support multi-serveurs (Bungee/Velocity)

Redirigez les joueurs vers d'autres serveurs avec une commande.

Configuration :

Résultat : /lobby → Téléporte le joueur vers le serveur "lobby" et exécute /spawn

7. Activation/Désactivation d'alias

Désactivez temporairement un alias sans le supprimer.

Message affiché : Cet alias est actuellement desactive.


💡 Exemples d'utilisation

Exemple 1 : Simplifier les commandes d'économie

Exemple 2 : Créer des alias pour les warps

Exemple 3 : Redirection avec placeholders

Exemple 4 : Multi-serveurs


🔒 Système de licence

Fonctionnement

NovaRedirectCommand utilise un système de licence sécurisé pour protéger le plugin.

Caractéristiques :

  • ✅ Vérification au démarrage du serveur

  • ✅ Vérifications périodiques (toutes les 6 heures)

  • ✅ Signature JAR obligatoire

  • ✅ Récupération automatique de l'IP publique du serveur

  • ✅ Désactivation automatique si licence invalide

Configuration de la licence

  1. Obtenez votre clé auprès de NovaDev

  2. Ajoutez-la dans config.yml :

  1. Redémarrez le serveur

Vérification de la licence

La licence est vérifiée via un backend sécurisé HTTPS.

Informations envoyées :

Messages de licence

Licence valide :

Licence invalide :

Dépannage licence

Problème : "Serveur de licence injoignable"

Causes possibles :

  • Pare-feu bloquant les connexions HTTPS sortantes

  • Serveur backend temporairement hors ligne

  • Problèmes de connexion Internet

Solution :

  1. Vérifiez votre connexion Internet

  2. Autorisez les connexions HTTPS vers 65.108.237.43:6459

  3. Contactez le support si le problème persiste

Problème : "JAR non signé"

Cause : Le fichier JAR a été modifié ou corrompu

Solution :

  1. Retéléchargez le plugin depuis la source officielle

  2. Ne modifiez pas le fichier JAR

  3. Vérifiez l'intégrité du fichier


📊 Logging

Configuration du logging

Fichiers de log

Les logs sont stockés dans : plugins/NovaRedirectCommand/logs/

Nom du fichier : novaredirect_YYYY-MM-DD.log

Exemple : novaredirect_2026-01-21.log

Format des logs

Types de logs

Type
Description
Exemple

INFO

Informations générales

Démarrage, configuration

REDIRECT

Redirections de commandes

/shinju/points

TAB

Tab completions

Suggestions affichées

ERROR

Erreurs

Commande invalide

WARN

Avertissements

Alias inconnu


🔧 Dépannage

Problème : L'alias ne fonctionne pas

Symptômes :

  • La commande n'est pas reconnue

  • Message : "Unknown command"

Solutions :

  1. Vérifiez que l'alias est déclaré dans config.yml ET plugin.yml

  2. Vérifiez que enabled: true

  3. Redémarrez le serveur (pas seulement /reload)

  4. Vérifiez les permissions

Problème : Tab completion ne fonctionne pas

Solutions :

  1. Ajoutez des suggestions manuelles dans config.yml :

  1. Vérifiez que la commande cible a bien un TabCompleter

  2. Activez le log des tab completions pour debug :

Problème : Message "Boucle de redirection détectée"

Cause : Vous avez créé une boucle infinie de redirections

Solution : Vérifiez vos alias et supprimez la boucle.

Exemple de boucle :

Problème : Les placeholders ne fonctionnent pas

Solutions :

  1. Utilisez exactement : {player}, {world}, {uuid}, {server}

  2. Vérifiez qu'un joueur exécute la commande (pas la console)

  3. Les placeholders sont sensibles à la casse

Problème : Encodage de caractères

Symptômes :

  • Caractères bizarres dans la console : é, è, etc.

Solution :

  • Le plugin utilise maintenant uniquement des caractères ASCII

  • Si vous modifiez les fichiers, n'utilisez pas d'accents

  • Encodage recommandé : UTF-8 sans BOM


👨‍💻 API pour développeurs

Dépendance Maven

Ajoutez le plugin comme dépendance :

Accéder à l'API

Classes principales

NovaRedirectCommand (Classe principale)

RedirectManager

MessageUtil

LogManager

Événements personnalisés

Vous pouvez écouter les événements de commandes pour détecter les redirections :


📞 Support et contact

Support officiel

  • Discord : https://discord.gg/HtjPAfqUXu

  • Développeur : YoannFM / NovaDev

Faire un don

Si vous appréciez ce plugin, vous pouvez soutenir le développeur :

  • PayPal : https://www.paypal.me/YoannFM

Signaler un bug

Pour signaler un bug :

  1. Rejoignez le Discord

  2. Fournissez :

    • Version du plugin

    • Version de Spigot/Paper

    • Version de Java

    • Fichier config.yml

    • Logs d'erreur

    • Description détaillée du problème

Demande de fonctionnalité

Pour demander une nouvelle fonctionnalité :

  1. Rejoignez le Discord

  2. Décrivez clairement la fonctionnalité souhaitée

  3. Expliquez le cas d'usage


📄 Licence

NovaRedirectCommand est un plugin propriétaire développé par NovaDev.

© 2026 NovaDev - Tous droits réservés

Une licence valide est requise pour utiliser ce plugin en production.


🔄 Changelog

Version 2026.01.21

Ajouté :

  • ✅ Récupération automatique de l'IP publique réelle du serveur

  • ✅ Système de fallback multi-services pour la détection d'IP

  • ✅ Logs détaillés lors de la vérification de licence

Corrigé :

  • ✅ Problème d'encodage UTF-8 (caractères accentués)

  • ✅ Bordures Unicode cassées dans la console

  • ✅ IP publique envoyée au backend (0.0.0.0 → IP réelle)

Amélioré :

  • ✅ Affichage de la commande /nrc plus propre

  • ✅ Gradients de couleur sur les liens Discord et PayPal

Version 2026.01.19-2

  • Version initiale avec système de licence

  • Système de redirection de commandes

  • Tab completion dynamique


Documentation générée le 21 janvier 2026 Version du plugin : 2026.01.21

Mis à jour