« Plugin:Écurie » : différence entre les versions
De Nefald
Autres actions
docs: mise à jour terminologie RP, NPC Maître/Palefrenier, TextDisplay, config npc/groom, changelog 1.3.0, infobox (via update-page on MediaWiki MCP Server) |
style: aligner le formatage sur Plugin:Banco (H1, gras intro, type infobox, séparateurs, code dans tableaux) (via update-page on MediaWiki MCP Server) |
||
| Ligne 3 : | Ligne 3 : | ||
{{Infobox Plugin | {{Infobox Plugin | ||
|nom=Écurie | |nom=Écurie | ||
|type= | |type=roleplay | ||
|dev=[[Scriptomancien|Nefald]] | |dev=[[Scriptomancien|Nefald]] | ||
|status=Installé | |status=Installé | ||
| Ligne 11 : | Ligne 11 : | ||
}} | }} | ||
'''Écurie''' est un plugin PaperMC de gestion des compagnons RP pour le serveur Nefald. | |||
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. | 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 == | == Prérequis == | ||
| Ligne 38 : | Ligne 34 : | ||
Le plugin charge sans aucune de ces dépendances optionnelles. | Le plugin charge sans aucune de ces dépendances optionnelles. | ||
== Installation == | == Installation == | ||
| Ligne 47 : | Ligne 41 : | ||
3. Éditer `plugins/Ecurie/config.yml` et `lang.yml` | 3. Éditer `plugins/Ecurie/config.yml` et `lang.yml` | ||
4. Créer les étables via les commandes admin (voir ci-dessous) | 4. Créer les étables via les commandes admin (voir ci-dessous) | ||
== Configuration == | == Configuration == | ||
| Ligne 111 : | Ligne 103 : | ||
Tous les messages joueurs. Supporte les balises MiniMessage (`<red>`, `<gold>`, etc.). | 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}`. | Variables disponibles selon le message : `{name}`, `{amount}`, `{dest}`, `{time}`, `{count}`, `{stable_id}`, `{n}`, `{x}`, `{y}`, `{z}`. | ||
== Commandes admin == | == Commandes admin == | ||
| Ligne 160 : | Ligne 150 : | ||
/ecurie reload — Recharge config.yml et le cache ShowManager | /ecurie reload — Recharge config.yml et le cache ShowManager | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== Commandes joueurs == | == Commandes joueurs == | ||
| Ligne 170 : | Ligne 158 : | ||
/ecurie gui [dialog|inventory] — Change votre type d'interface (persistant via PDC) | /ecurie gui [dialog|inventory] — Change votre type d'interface (persistant via PDC) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== Workflow admin — Créer une étable == | == Workflow admin — Créer une étable == | ||
| Ligne 195 : | Ligne 181 : | ||
/ecurie show off | /ecurie show off | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== Workflow joueur — Interagir avec une étable == | == Workflow joueur — Interagir avec une étable == | ||
| Ligne 232 : | Ligne 216 : | ||
=== Mes compagnons === | === Mes compagnons === | ||
Vue globale de tous les compagnons du joueur, toutes étables confondues. | Vue globale de tous les compagnons du joueur, toutes étables confondues. | ||
== Placeholders (PlaceholderAPI) == | == Placeholders (PlaceholderAPI) == | ||
| Ligne 242 : | Ligne 224 : | ||
! Placeholder !! Valeur | ! Placeholder !! Valeur | ||
|- | |- | ||
| | | <code>%ecurie_horses_count%</code> || Nombre de compagnons en pension du joueur | ||
|- | |- | ||
| | | <code>%ecurie_horse_name_<n>%</code> || Nom du n-ième compagnon (1-indexé, trié par nom) | ||
|- | |- | ||
| | | <code>%ecurie_horse_stable_<n>%</code> || Nom de l'étable du n-ième compagnon | ||
|- | |- | ||
| | | <code>%ecurie_horse_health_<n>%</code> || Santé (ex : <code>18.0/20.0</code>) | ||
|} | |} | ||
== Permissions == | == Permissions == | ||
| Ligne 258 : | Ligne 238 : | ||
! Permission !! Description !! Défaut | ! Permission !! Description !! Défaut | ||
|- | |- | ||
| | | <code>ecurie.admin</code> || Accès aux commandes d'administration <code>/ecurie</code> || op | ||
|- | |- | ||
| | | <code>ecurie.use</code> || Interaction avec les PNJ et <code>/ecurie gui</code> || true | ||
|} | |} | ||
== Notes techniques == | == Notes techniques == | ||
| Ligne 278 : | Ligne 256 : | ||
* '''MyPet''' : Le plugin stocke correctement l'UUID du MyPet et s'assure qu'il est révoqué automatiquement pour éviter les doublons lors du stockage. | * '''MyPet''' : Le plugin stocke correctement l'UUID du MyPet et s'assure qu'il est révoqué automatiquement pour éviter les doublons lors du stockage. | ||
* '''Transferts''' : vérifiés toutes les 10 secondes en async | * '''Transferts''' : vérifiés toutes les 10 secondes en async | ||
== Build == | == Build == | ||
| Ligne 289 : | Ligne 265 : | ||
Requiert Java 21. La compilation locale sous Java 26+ peut échouer (incompatibilité Groovy/ASM) — utiliser la CI GitLab. | Requiert Java 21. La compilation locale sous Java 26+ peut échouer (incompatibilité Groovy/ASM) — utiliser la CI GitLab. | ||
== Changelog == | == Changelog == | ||