« 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.

Prérequis

Dépendance	Rôle	Type
PaperMC 1.21.x	Serveur	Obligatoire
Vault	API économie	Optionnel (fallback si Banco absent)
Banco	Économie item-based (écus)	Optionnel (recommandé)
Citizens	NPCs d'interface	Optionnel
PlaceholderAPI	Placeholders	Optionnel
MyPet	Détection familiers	Optionnel

Le plugin charge sans aucune de ces dépendances optionnelles.

Installation

Déposer Ecurie-<version>.jar dans plugins/
Redémarrer le serveur
Éditer plugins/Ecurie/config.yml et lang.yml
Créer les étables via les commandes admin (voir ci-dessous)

Configuration

config.yml

database:
  # 'sqlite' ou 'mysql'
  type: "sqlite"
  
  # Configuration SQLite
  sqlite:
    file: "ecurie.db"
    
  # Configuration MySQL / MariaDB (HikariCP)
  mysql:
    host: "localhost"
    port: 3306
    database: "ecurie"
    username: "root"
    password: "password"
    pool:
      maximum-pool-size: 10
      minimum-idle: 2

# Interface GUI par défaut (modifiable par joueur via /ecurie gui)
# 'dialog'    = Interface textuelle native Paper (1.21.6+, recommandé)
# 'inventory' = Menu d'inventaire classique
gui-type: "dialog"

transfer:
  base-delay-seconds: 600    # Délai de base pour un acheminement (10 min)
  delay-per-100-blocks: 30   # Délai additionnel par 100 blocs de distance
  animation-distance: 15.0   # Distance (blocs) pour l'animation de départ/arrivée

# Tarifs des services en écus/sols (0 = gratuit)
prices:
  store: 10                  # Mise en pension
  retrieve: 5                # Récupération d'un compagnon
  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

# NPC "Maître d'Écurie" : PNJ d'interface lié à l'étable (via /ecurie setnpc)
npc:
  default-name: "Maître d'Écurie"
  default-skin-value: "<base64 skin>"   # Valeur de texture NameMC
  default-skin-signature: "<signature>" # Signature de la texture
  animation:
    enabled: false           # Animation périodique du bras (secouage)
    delay-ticks: 300

# NPC "Palefrenier" : PNJ temporaire, spawné uniquement pour l'animation de départ/arrivée
groom:
  default-name: "Palefrenier"
  default-skin-value: "<base64 skin>"
  default-skin-signature: "<signature>"

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

# Si vrai, restreint le stockage et le transfert selon le type du compagnon et de l'écurie
# Compagnon aquatique -> Écurie AQUATIQUE uniquement
# Compagnon volant -> Écurie VOLIERE uniquement
# Compagnon terrestre -> Écurie TERRESTRE/STABLE uniquement
restrict-stable-types: true

box-blocks:
  # Blocs de ciblage (wand) selon le type d'écurie
  STABLE: WATER_CAULDRON
  TERRESTRE: WATER_CAULDRON
  AQUATIQUE: PRISMARINE
  VOLIERE: DAYLIGHT_DETECTOR

lang.yml

Tous les messages joueurs. Supporte les balises MiniMessage (<red>, <gold>, etc.). Variables disponibles selon le message : {name}, {amount}, {dest}, {time}, {count}, {stable_id}, {n}, {x}, {y}, {z}.

Commandes

Commandes joueurs

Commande	Description	Permission
`/ecurie gui [dialog/inventory]`	Modifie le type d'interface préféré du joueur (sauvegardé en PDC)	`ecurie.use`

Commandes d'administration

Commande	Description	Permission
`/ecurie wand [on/off]`	Active ou désactive le wand (bâton de sélection pour délimiter les étables)	`ecurie.admin`
`/ecurie create <nom> [type]`	Crée une étable dans la sélection wand et scanne automatiquement les boxes. Types : `STABLE`, `RELAY`, `TERRESTRE`, `AQUATIQUE`, `VOLIERE`.	`ecurie.admin`
`/ecurie delete <id>`	Supprime l'étable spécifiée (rend ses compagnons orphelins)	`ecurie.admin`
`/ecurie setnpc <stable_id>`	Lie le NPC Citizens le plus proche (≤5 blocs) à l'étable en lui attribuant son nom/skin par défaut	`ecurie.admin`
`/ecurie list`	Liste toutes les étables enregistrées	`ecurie.admin`
`/ecurie tp <stable_id/nom>`	Téléporte le joueur en face du NPC de l'étable spécifiée (sécurité anticollision intégrée)	`ecurie.admin`
`/ecurie box scan <stable_id>`	Relance la détection des blocs cibles (box) dans la sélection wand pour cette étable	`ecurie.admin`
`/ecurie box list <stable_id>`	Liste les coordonnées de toutes les boxes de l'étable spécifiée	`ecurie.admin`
`/ecurie box delete <box_id>`	Supprime définitivement la box spécifiée	`ecurie.admin`
`/ecurie show [on/off]`	Active ou désactive l'affichage de particules colorées sur les blocs de box (vert=libre, rouge=occupé)	`ecurie.admin`
`/ecurie horse free <horse_id>`	Supprime définitivement un compagnon de la base de données	`ecurie.admin`
`/ecurie horse orphans`	Liste tous les compagnons orphelins (sans écurie suite à une suppression)	`ecurie.admin`
`/ecurie horse reassign <horse_id> <stable_id>`	Réassigne un compagnon orphelin à une box libre de l'étable spécifiée	`ecurie.admin`
`/ecurie reload`	Recharge les fichiers de configuration `config.yml` et de traduction `lang.yml`	`ecurie.admin`

Les blocs cibles de boxes détectés par défaut selon le type d'écurie sont :

STABLE / TERRESTRE : WATER_CAULDRON
AQUATIQUE : PRISMARINE
VOLIERE : DAYLIGHT_DETECTOR

Permissions

Permission	Description	Défaut
`ecurie.admin`	Accès complet aux commandes d'administration `/ecurie`	op
`ecurie.use`	Interaction avec les NPCs Maître d'Écurie et utilisation de `/ecurie gui`	true

Workflow admin — Créer une étable

Étapes

Construire l'étable — poser le bloc cible dans chaque stalle (ex: WATER_CAULDRON pour TERRESTRE, PRISMARINE pour AQUATIQUE).
Activer le wand : /ecurie wand on → clic gauche (point A) + clic droit (coin B) pour délimiter la région
Créer et scanner : /ecurie create <nom> [type] — crée l'étable ET enregistre automatiquement les boxes détectées.
Lier un NPC : placer un Citizens devant l'étable, s'en approcher à < 5 blocs : /ecurie setnpc <stable_id> (le nom et le skin par défaut sont appliqués automatiquement).

Visualiser les boxes

Après création, afficher les boxes avec particules colorées :

/ecurie show on

Particules vertes = box libre
Particules rouges = box occupée

Désactiver l'affichage :

/ecurie show off

Workflow joueur — Interagir avec une étable

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.

Une GUI s'ouvre avec les actions suivantes :

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 : prices.store en sols

Reprendre un compagnon

Cliquer Reprendre un compagnon
Choisir le compagnon dans la liste
Coût : prices.retrieve 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 : prices.rename en sols (défaut 50)

Mes compagnons

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

Placeholders (PlaceholderAPI)

Requiert PlaceholderAPI installé.

Placeholder	Valeur
`%ecurie_horses_count%`	Nombre de compagnons en pension du joueur
`%ecurie_horse_name_<n>%`	Nom du n-ième compagnon (1-indexé, trié par nom)
`%ecurie_horse_stable_<n>%`	Nom de l'étable du n-ième compagnon
`%ecurie_horse_health_<n>%`	Santé (ex : `18.0/20.0`)

Notes techniques

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.
Maître d'Écurie : NPC Citizens permanent lié à l'étable via /ecurie setnpc. Sert d'interface pour toutes les interactions joueur. Nom et skin configurables dans npc (config.yml).
Palefrenier : NPC Citizens temporaire spawné uniquement pendant l'animation de départ ou d'arrivée d'un acheminement. Nom et skin configurables dans groom (config.yml).
Mort en box : perte définitive, slot libéré
Banco : intégré par réflexion pure (aucun jar requis à la compilation)
Stockage universel : Supporte tous les familiers montables (Chevaux, Chameaux, Cochons, Striders) ainsi que tous les familiers MyPet.
Typage des écuries (RPG) : Les familiers aquatiques ne peuvent aller que dans une écurie AQUATIQUE. Les familiers volants dans une VOLIERE. Les familiers terrestres dans une TERRESTRE ou STABLE. Les restrictions sont activables via l'option restrict-stable-types.
MyPet : Le plugin révoque automatiquement le MyPet lors de la mise en pension (via /petsendaway) pour éviter les doublons dans le monde, et restaure correctement ses états.
Transferts : vérifiés toutes les 10 secondes en async

Build

./gradlew shadowJar
# Sortie : build/libs/Ecurie-<version>.jar

Requiert Java 21. La compilation locale sous Java 26+ peut échouer (incompatibilité Groovy/ASM) — utiliser la CI GitLab.

Changelog

Version	Date	Notes
1.0.0	2026-05-15	V1 : pension, récupération, transfert, GUI
1.0.1	2026-05-16	PlaceholderAPI + garde MyPet
1.0.2	2026-05-18	Détection boxes : WATER_CAULDRON remplace HAY_BLOCK+Sign, scan+création fusionnés en une commande
1.0.3	2026-05-19	Nommage : skip enclume si compagnon déjà nommé au stockage ; fix renommage (slot résultat pré-rempli)
1.0.4	2026-06-11	Fix validation renommage ; noms fantômes 2 lignes (ArmorStand passager) ; blocage monte ; correction calcul distance transferts ; rapatriement depuis l'écurie de destination ; animations de départ/arrivée via pathfinding ; attribution automatique de nom/skin pour les NPCs lors du setnpc
1.1.0	2026-06-11	Support de tous les familiers montables et des MyPet, configuration des prix depuis config.yml, ajout des types d'écuries (AQUATIQUE, VOLIERE, TERRESTRE) avec blocs de ciblage configurables et validations RPG
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 `/ecurie gui` 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.