betterMcCommands/GEMINI.md

📜 Instructions & Consignes du Projet - betterMcCommands

Ce document consigne les directives d'architecture, règles de développement et spécifications fonctionnelles du projet betterMcCommands.

---

🎯 1. Vision du Projet

betterMcCommands est une bibliothèque Java conçue pour créer, structurer et gérer des commandes Minecraft de façon hautement dynamique, typée et événementielle.

---

📐 2. Règles & Standards de Développement

🔹 Conception du Code

• Méthodes & Logique Métier d'Abord : L'arbre de commande, le parsing des arguments et le système d'événements doivent être totalement découplés du moteur Bukkit/Paper pour permettre une testabilité unitaire à 100%.
• Dynamisme & Modularité : Injection sans déclaration plugin.yml, enregistrement et dé-enregistrement à chaud.
• Documentation Obligatoire : Chaque classe et méthode doit comporter une Javadoc détaillée explicitant son rôle, ses paramètres (@param), sa valeur de retour (@return) et ses exceptions (@throws).
• Gestion des Textes & Couleurs : Intégration native de Kyori Adventure & MiniMessage avec compatibilité pour les codes couleur legacy.

---

🗂️ 3. Organisation des Packages

fr.luc.bettermccommands/
 ├── BetterMcCommands.java              (Manager principal & Façade d'accès)
 ├── api/                               (Interfaces et contrats publics)
 │    ├── Command.java
 │    ├── CommandNode.java
 │    ├── CommandContext.java
 │    ├── CommandExecutor.java
 │    ├── CommandSenderType.java
 │    ├── CommandResult.java
 │    └── suggestion/
 │         ├── Suggestion.java
 │         └── SuggestionProvider.java
 ├── builder/                           (Fluent Builder DSL)
 │    ├── AbstractCommandBuilder.java
 │    ├── CommandBuilder.java
 │    └── SubCommandBuilder.java
 ├── argument/                          (Système d'arguments typés)
 │    ├── CommandArgument.java
 │    ├── ArgumentType.java
 │    ├── Arguments.java
 │    ├── type/
 │    │    ├── StringArgument.java
 │    │    ├── IntegerArgument.java
 │    │    ├── DoubleArgument.java
 │    │    ├── BooleanArgument.java
 │    │    ├── EnumArgument.java
 │    │    ├── PlayerArgument.java
 │    │    ├── OfflinePlayerArgument.java
 │    │    ├── WorldArgument.java
 │    │    ├── LocationArgument.java
 │    │    └── DurationArgument.java
 │    └── registry/
 │         └── ArgumentTypeRegistry.java
 ├── event/                             (Moteur d'événements & Lifecycle)
 │    ├── CommandEvent.java
 │    ├── CancellableCommandEvent.java
 │    ├── CommandPreExecuteEvent.java
 │    ├── CommandPostExecuteEvent.java
 │    ├── CommandPermissionDeniedEvent.java
 │    ├── CommandSyntaxErrorEvent.java
 │    ├── CommandArgumentParseException.java
 │    ├── CommandTabCompleteEvent.java
 │    ├── CommandCooldownEvent.java
 │    ├── CommandEventListener.java
 │    ├── CommandEventManager.java
 │    └── annotation/
 │         └── CommandEventHandler.java
 ├── cooldown/                          (Gestionnaire de Cooldowns)
 │    └── CooldownManager.java
 ├── platform/                          (Ponts plateformes)
 │    ├── CommandPlatformAdapter.java
 │    └── paper/
 │         ├── PaperCommandMapInjector.java
 │         └── PaperCommandWrapper.java
 └── demo/                              (Exemples & Démonstrations)
      ├── DemoPlugin.java
      └── commands/
           ├── DemoBaseCommand.java
           └── DemoListener.java