« Plugin:Écurie » : différence entre les versions

Permet aux joueurs de mettre leurs montures en pension dans des étables gérées par des NPCs Citizens. Supporte les transferts inter-étables (''acheminements''), la tarification en écus (Banco/Vault), et expose des placeholders PlaceholderAPI.

# Déposer <code>Ecurie-&lt;version&gt;.jar</code> dans <code>plugins/</code>

# Redémarrer le serveur

# Éditer <code>plugins/Ecurie/config.yml</code> et <code>lang.yml</code>

# Créer les étables via les commandes admin (voir ci-dessous)

=== config.yml ===

   # 'sqlite' ou 'mysql'

    file: "ecurie.db"

  # Configuration MySQL / MariaDB (HikariCP)

 

   base-delay-seconds: 600    # Délai de base pour un acheminement (10 min)

  rename: 50                # Modification du registre (renommage)

   transfer-base: 20          # Coût de base d'un acheminement

  transfer-per-100: 5       # Coût additionnel par tranche de 100 blocs

   # Formule : coût total = transfer-base + (distance / 100) * transfer-per-100

  default-name: "Maître d'Écurie"

   default-skin-value: "<base64 skin>"  # Valeur de texture NameMC

  default-skin-signature: "<signature>" # Signature de la texture

  health: 20.0              # PV du compagnon fantôme en box

# Compagnon aquatique -> Écurie AQUATIQUE uniquement

# Compagnon volant -> Écurie VOLIERE uniquement

# Compagnon terrestre -> Écurie TERRESTRE/STABLE uniquement

  # Blocs de ciblage (wand) selon le type d'écurie

  STABLE: WATER_CAULDRON

=== lang.yml ===

== Commandes ==

=== Commandes joueurs ===

{| class="wikitable"

| <code>/ecurie gui [dialog/inventory]</code> || Modifie le type d'interface préféré du joueur (sauvegardé en PDC) || <code>ecurie.use</code>

=== Commandes d'administration ===

{| class="wikitable"

| <code>/ecurie create &lt;nom&gt; [type]</code> || Crée une étable dans la sélection wand et scanne automatiquement les boxes. Types : <code>STABLE</code>, <code>RELAY</code>, <code>TERRESTRE</code>, <code>AQUATIQUE</code>, <code>VOLIERE</code>. || <code>ecurie.admin</code>

| <code>/ecurie horse free &lt;horse_id&gt;</code> || Supprime définitivement un compagnon de la base de données || <code>ecurie.admin</code>

| <code>/ecurie horse orphans</code> || Liste tous les compagnons orphelins (sans écurie suite à une suppression) || <code>ecurie.admin</code>

| <code>/ecurie reload</code> || Recharge les fichiers de configuration <code>config.yml</code> et de traduction <code>lang.yml</code> || <code>ecurie.admin</code>

== Permissions ==

| <code>ecurie.admin</code> || Accès complet aux commandes d'administration <code>/ecurie</code> || op

| <code>ecurie.use</code> || Interaction avec les NPCs Maître d'Écurie et utilisation de <code>/ecurie gui</code> || true

# '''Construire l'étable''' — poser le bloc cible dans chaque stalle (ex: <code>WATER_CAULDRON</code> pour TERRESTRE, <code>PRISMARINE</code> pour AQUATIQUE).

# '''Activer le wand''' : <code>/ecurie wand on</code> → clic gauche (point A) + clic droit (coin B) pour délimiter la région

# '''Créer et scanner''' : <code>/ecurie create &lt;nom&gt; [type]</code> — crée l'étable ET enregistre automatiquement les boxes détectées.

# '''Lier un NPC''' : placer un Citizens devant l'étable, s'en approcher à &lt; 5 blocs : <code>/ecurie setnpc &lt;stable_id&gt;</code> (le nom et le skin par défaut sont appliqués automatiquement).

Le joueur interagit via clic droit sur le '''Maître d'Écurie''' (NPC Citizens de l'étable). Le plugin propose deux types d'interfaces, configurables librement par chaque joueur (préférence persistante) :

* '''Dialog (par défaut)''' : Fenêtre de dialogue textuelle native (Paper 1.21.6+). Immersif et orienté RPG.

* '''Inventory''' : Inventaire classique sous forme de coffre.

=== Mettre en pension ===

# Amener le compagnon à côté ou le monter

# Cliquer '''Mettre en pension''' dans la GUI

# '''Si le compagnon n'a pas de nom custom''' (nom générique ou absent) → une enclume s'ouvre pour le nommer

# '''Si le compagnon a déjà un nom custom''' → mise en pension directe sans nommage

# Coût : <code>prices.store</code> en sols

=== Reprendre un compagnon ===

# Cliquer '''Reprendre un compagnon'''

# Choisir le compagnon dans la liste

# Coût : <code>prices.retrieve</code> en sols

=== Demander un acheminement ===

L'acheminement peut être initié depuis l'écurie de départ ou d'arrivée :

* '''Depuis l'écurie d'origine (envoi sortant) :''' Cliquer '''Demander un acheminement''', sélectionner le compagnon, puis choisir l'écurie de destination.

* '''Depuis l'écurie d'arrivée (rapatriement entrant) :''' Cliquer '''Demander un acheminement''', le plugin liste vos compagnons situés dans d'autres étables. Cliquer sur l'un d'eux lance directement le rapatriement.

* '''Calcul de distance :''' Le délai et le coût s'ajustent dynamiquement selon la distance réelle (calculée en blocs 3D) entre les deux étables (base + ajustement par tranche de 100 blocs).

=== Modifier le registre ===

# Cliquer '''Modifier le registre'''

# Choisir le compagnon dans la liste

# Une enclume s'ouvre pré-remplie avec le nom actuel — modifier ou confirmer

# Coût : <code>prices.rename</code> en sols (défaut 50)

=== Mes compagnons ===

Vue globale de tous les compagnons du joueur, toutes étables confondues.

| <code>%ecurie_horses_count%</code> || Nombre de compagnons en pension du joueur

| <code>%ecurie_horse_name_&lt;n&gt;%</code> || Nom du n-ième compagnon (1-indexé, trié par nom)

| <code>%ecurie_horse_stable_&lt;n&gt;%</code> || Nom de l'étable du n-ième compagnon

| <code>%ecurie_horse_health_&lt;n&gt;%</code> || Santé (ex : <code>18.0/20.0</code>)

* '''Stockage''' : SQLite embarqué (local) ou base de données MySQL / MariaDB via HikariCP.

* '''Compagnons fantômes''' : entités invulnérables, sans gravité ni IA, représentant le compagnon en box. Toute monte ou interaction est strictement bloquée. Spawné à côté du bloc de box (pas dessus).

* '''Affichage du nom''' : Le nom du compagnon (ligne 1, blanc) et le pseudo du propriétaire (ligne 2, gris italique) s'affichent via un '''TextDisplay''' passager, nettoyé automatiquement lors du despawn.

* '''Palefrenier''' : NPC Citizens temporaire spawné uniquement pendant l'animation de départ ou d'arrivée d'un acheminement. Nom et skin configurables dans <code>groom</code> (config.yml).

* '''Typage des écuries (RPG)''' : Les familiers aquatiques ne peuvent aller que dans une écurie <code>AQUATIQUE</code>. Les familiers volants dans une <code>VOLIERE</code>. Les familiers terrestres dans une <code>TERRESTRE</code> ou <code>STABLE</code>. Les restrictions sont activables via l'option <code>restrict-stable-types</code>.

* '''MyPet''' : Le plugin révoque automatiquement le MyPet lors de la mise en pension (via <code>/petsendaway</code>) pour éviter les doublons dans le monde, et restaure correctement ses états.

| 1.0.3 || 2026-05-19 || Nommage : skip enclume si compagnon déjà nommé au stockage ; fix renommage (slot résultat pré-rempli)

| 1.2.0 || 2026-06-11 || Architecture GUI hybride : API native Paper Dialog (1.21.6+) en interface par défaut, InventoryFramework en fallback. Choix joueur via <code>/ecurie gui</code> sauvegardé par PDC. Affichage des tarifs et gestion asynchrone sécurisée.

| 1.3.0 || 2026-06-12 || Terminologie RP : "Mettre en pension", "Acheminement", "Compagnon" ; séparation Maître d'Écurie (interface) / Palefrenier (animation) avec skins distincts ; TextDisplay remplace ArmorStand passager pour les noms en box ; correction spawn fantôme à côté du cauldron (non dessus).

| 1.4.0 || 2026-06-13 || Ajout de la commande /ecurie tp, support de MySQL / MariaDB via HikariCP, correction de la persistance de l'activité MyPet, et restrictions par type d'écurie.