Nefald - Contributions [fr]

Éveillés de fer

2026-06-18T05:28:50Z

Hiob : gallerie

{{SHORTDESC:Créatures mécaniques utilisées pour le transport de charges lourdes ou de personnes}}
{{Infobox Transport
| nom = Éveillés de fer
| soustitre = Transport vers le continent ressource
| image = Eveillé poulpe.png
| tailleimage = 300px
| legende = Eveillé de Glemdäl
| type = Animal mécanique
| mode = Transport collectif
| utilisation = Transport de citoyen vers le continent ressource
| vitesse = NC
| disponibilite = Tous les citoyens
| statut = Fonctionnel
| localisation = Chaque Cité-État
}}
{{Lettrine|L|texte=es Éveillés de fer}} ont été conçus par le Maître Artificier Veythas, ces créatures sont des assemblages de métal et d’énergie magique, capables de se déplacer avec une grâce presque vivante. Leur fonctionnement repose sur des runes gravées dans leur structure, alimentées par une essence cristalline rare, le Souffle du Dragon.

Personne ne maîtrise pleinement leur création. Les artificiers actuels ne savent que les réparer et les alimenter, mais leur origine exacte reste un secret jalousement gardé.

Ces créatures mécaniques sont principalement utilisées pour le transport de charges lourdes ou de personnes. Elles sont aujourd'hui surtout utilisée pour assurer les liens depuis les [[Cités-États]] avec [[Kaldrah]], continent dont sont extraits une grande partie des ressources de [[Fendral]].

Ainsi chaque Cité-État est dotée d'un éveillé :

* [[Mahj'Akar]] dispose d'une Abeille
* [[Ald'Vidsom|Ald'Vidsom]] bénéfice d'une Grenouille
* [[Glemdäl]] est dotée d'un Poulpe

<gallery>
Eveillé abeille.png|Eveillé de fer abeille
Eveillé grenouille.png|Eveillé de fer grenouille
Eveillé poulpe.png|Eveillé de fer poulpe
</gallery>
[[Catégorie:Transport]]

Plugin:Écurie

2026-06-12T22:39:22Z

Hiob : Mise à jour des commandes, permissions, configuration MySQL et restrictions par type (v1.4.0)

{{SHORTDESC:Gestion d'écuries RP : mise en pension, acheminements de montures et stockage physique de compagnons}}

{{Infobox Plugin
|nom=Écurie
|type=roleplay
|dev=[[Scriptomancien|Nefald]]
|status=Installé
|grade=[[Pérégrin]]
|sources=https://git.nefald.fr/minecraft/plugins/ecurie
|dépendance=[[Plugin:Vault|Vault]] (optionnel), [[Plugin:Banco|Banco]] (optionnel, recommandé), [[Plugin:Citizens|Citizens]] (optionnel), [[Plugin:PlaceholderAPI|PlaceholderAPI]] (optionnel), [[Plugin:MyPet|MyPet]] (optionnel)
}}

'''É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.

== Prérequis ==

{| class="wikitable"
! 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 <code>Ecurie-<version>.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)

== Configuration ==

=== config.yml ===

<syntaxhighlight lang="yaml">
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
</syntaxhighlight>

=== lang.yml ===

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

== Commandes ==

=== Commandes joueurs ===

{| class="wikitable"
! Commande !! Description !! Permission
|-
| <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"
! Commande !! Description !! Permission
|-
| <code>/ecurie wand [on/off]</code> || Active ou désactive le wand (bâton de sélection pour délimiter les étables) || <code>ecurie.admin</code>
|-
| <code>/ecurie create <nom> [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 delete <id></code> || Supprime l'étable spécifiée (rend ses compagnons orphelins) || <code>ecurie.admin</code>
|-
| <code>/ecurie setnpc <stable_id></code> || Lie le NPC Citizens le plus proche (≤5 blocs) à l'étable en lui attribuant son nom/skin par défaut || <code>ecurie.admin</code>
|-
| <code>/ecurie list</code> || Liste toutes les étables enregistrées || <code>ecurie.admin</code>
|-
| <code>/ecurie tp <stable_id/nom></code> || Téléporte le joueur en face du NPC de l'étable spécifiée (sécurité anticollision intégrée) || <code>ecurie.admin</code>
|-
| <code>/ecurie box scan <stable_id></code> || Relance la détection des blocs cibles (box) dans la sélection wand pour cette étable || <code>ecurie.admin</code>
|-
| <code>/ecurie box list <stable_id></code> || Liste les coordonnées de toutes les boxes de l'étable spécifiée || <code>ecurie.admin</code>
|-
| <code>/ecurie box delete <box_id></code> || Supprime définitivement la box spécifiée || <code>ecurie.admin</code>
|-
| <code>/ecurie show [on/off]</code> || Active ou désactive l'affichage de particules colorées sur les blocs de box (vert=libre, rouge=occupé) || <code>ecurie.admin</code>
|-
| <code>/ecurie horse free <horse_id></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 horse reassign <horse_id> <stable_id></code> || Réassigne un compagnon orphelin à une box libre de l'étable spécifiée || <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>
|}

Les blocs cibles de boxes détectés par défaut selon le type d'écurie sont :
* <code>STABLE</code> / <code>TERRESTRE</code> : '''WATER_CAULDRON'''
* <code>AQUATIQUE</code> : '''PRISMARINE'''
* <code>VOLIERE</code> : '''DAYLIGHT_DETECTOR'''

== Permissions ==

{| class="wikitable"
! Permission !! Description !! Défaut
|-
| <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
|}

== Workflow admin — Créer une étable ==

=== Étapes ===

# '''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 <nom> [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 à < 5 blocs : <code>/ecurie setnpc <stable_id></code> (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 :
<syntaxhighlight lang="text">
/ecurie show on
</syntaxhighlight>
* Particules '''vertes''' = box libre
* Particules '''rouges''' = box occupée

Désactiver l'affichage :
<syntaxhighlight lang="text">
/ecurie show off
</syntaxhighlight>

== 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 : <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.

== Placeholders (PlaceholderAPI) ==

Requiert PlaceholderAPI installé.

{| class="wikitable"
! 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>)
|}

== 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 <code>/ecurie setnpc</code>. Sert d'interface pour toutes les interactions joueur. Nom et skin configurables dans <code>npc</code> (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 <code>groom</code> (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 <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.
* '''Transferts''' : vérifiés toutes les 10 secondes en async

== Build ==

<syntaxhighlight lang="bash">
./gradlew shadowJar
# Sortie : build/libs/Ecurie-<version>.jar
</syntaxhighlight>

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

== Changelog ==

{| class="wikitable"
! 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 <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.
|}

[[Catégorie:Plugin développé pour Nefald]]
[[Catégorie:Plugin installé]]

Plugin:Écurie

2026-06-12T22:37:59Z

Hiob : Mise à jour des commandes, permissions, configuration MySQL et restrictions par type (v1.4.0)

{{SHORTDESC:Gestion des écuries RP}}

{{Infobox Plugin
|nom=Écurie
|type=roleplay
|dev=[[Scriptomancien|Nefald]]
|status=Installé
|grade=[[Pérégrin]]
|sources=https://git.nefald.fr/minecraft/plugins/ecurie
|dépendance=[[Plugin:Vault|Vault]] (optionnel), [[Plugin:Banco|Banco]] (optionnel, recommandé), [[Plugin:Citizens|Citizens]] (optionnel), [[Plugin:PlaceholderAPI|PlaceholderAPI]] (optionnel), [[Plugin:MyPet|MyPet]] (optionnel)
}}

'''É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.

== Prérequis ==

{| class="wikitable"
! 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 <code>Ecurie-<version>.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)

== Configuration ==

=== config.yml ===

<syntaxhighlight lang="yaml">
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
</syntaxhighlight>

=== lang.yml ===

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

== Commandes ==

=== Commandes joueurs ===

{| class="wikitable"
! Commande !! Description !! Permission
|-
| <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"
! Commande !! Description !! Permission
|-
| <code>/ecurie wand [on/off]</code> || Active ou désactive le wand (bâton de sélection pour délimiter les étables) || <code>ecurie.admin</code>
|-
| <code>/ecurie create <nom> [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 delete <id></code> || Supprime l'étable spécifiée (rend ses compagnons orphelins) || <code>ecurie.admin</code>
|-
| <code>/ecurie setnpc <stable_id></code> || Lie le NPC Citizens le plus proche (≤5 blocs) à l'étable en lui attribuant son nom/skin par défaut || <code>ecurie.admin</code>
|-
| <code>/ecurie list</code> || Liste toutes les étables enregistrées || <code>ecurie.admin</code>
|-
| <code>/ecurie tp <stable_id/nom></code> || Téléporte le joueur en face du NPC de l'étable spécifiée (sécurité anticollision intégrée) || <code>ecurie.admin</code>
|-
| <code>/ecurie box scan <stable_id></code> || Relance la détection des blocs cibles (box) dans la sélection wand pour cette étable || <code>ecurie.admin</code>
|-
| <code>/ecurie box list <stable_id></code> || Liste les coordonnées de toutes les boxes de l'étable spécifiée || <code>ecurie.admin</code>
|-
| <code>/ecurie box delete <box_id></code> || Supprime définitivement la box spécifiée || <code>ecurie.admin</code>
|-
| <code>/ecurie show [on/off]</code> || Active ou désactive l'affichage de particules colorées sur les blocs de box (vert=libre, rouge=occupé) || <code>ecurie.admin</code>
|-
| <code>/ecurie horse free <horse_id></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 horse reassign <horse_id> <stable_id></code> || Réassigne un compagnon orphelin à une box libre de l'étable spécifiée || <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>
|}

Les blocs cibles de boxes détectés par défaut selon le type d'écurie sont :
* <code>STABLE</code> / <code>TERRESTRE</code> : '''WATER_CAULDRON'''
* <code>AQUATIQUE</code> : '''PRISMARINE'''
* <code>VOLIERE</code> : '''DAYLIGHT_DETECTOR'''

== Permissions ==

{| class="wikitable"
! Permission !! Description !! Défaut
|-
| <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
|}

== Workflow admin — Créer une étable ==

=== Étapes ===

# '''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 <nom> [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 à < 5 blocs : <code>/ecurie setnpc <stable_id></code> (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 :
<syntaxhighlight lang="text">
/ecurie show on
</syntaxhighlight>
* Particules '''vertes''' = box libre
* Particules '''rouges''' = box occupée

Désactiver l'affichage :
<syntaxhighlight lang="text">
/ecurie show off
</syntaxhighlight>

== 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 : <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.

== Placeholders (PlaceholderAPI) ==

Requiert PlaceholderAPI installé.

{| class="wikitable"
! 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>)
|}

== 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 <code>/ecurie setnpc</code>. Sert d'interface pour toutes les interactions joueur. Nom et skin configurables dans <code>npc</code> (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 <code>groom</code> (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 <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.
* '''Transferts''' : vérifiés toutes les 10 secondes en async

== Build ==

<syntaxhighlight lang="bash">
./gradlew shadowJar
# Sortie : build/libs/Ecurie-<version>.jar
</syntaxhighlight>

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

== Changelog ==

{| class="wikitable"
! 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 <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.
|}

[[Catégorie:Plugin développé pour Nefald]]
[[Catégorie:Plugin installé]]

Plugin:Écurie

2026-06-12T22:36:45Z

Hiob : Mise à jour des commandes, permissions, configuration MySQL et restrictions par type (v1.4.0)

{{SHORTDESC:Gestion des écuries RP}}

{{Infobox Plugin
|nom=Écurie
|type=roleplay
|dev=[[Scriptomancien|Nefald]]
|status=Installé
|grade=[[Pérégrin]]
|sources=https://git.nefald.fr/minecraft/plugins/ecurie
|dépendance=[[Plugin:Vault|Vault]] (optionnel), [[Plugin:Banco|Banco]] (optionnel, recommandé), [[Plugin:Citizens|Citizens]] (optionnel), [[Plugin:PlaceholderAPI|PlaceholderAPI]] (optionnel), [[Plugin:MyPet|MyPet]] (optionnel)
}}

'''É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.

== Prérequis ==

{| class="wikitable"
! 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 ==

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

== Configuration ==

=== config.yml ===

<syntaxhighlight lang="yaml">
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
</syntaxhighlight>

=== lang.yml ===

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

== Commandes ==

=== Commandes joueurs ===

{| class="wikitable"
! Commande !! Description !! Permission
|-
| <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"
! Commande !! Description !! Permission
|-
| <code>/ecurie wand [on/off]</code> || Active ou désactive le wand (bâton de sélection pour délimiter les étables) || <code>ecurie.admin</code>
|-
| <code>/ecurie create <nom> [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 delete <id></code> || Supprime l'étable spécifiée (rend ses compagnons orphelins) || <code>ecurie.admin</code>
|-
| <code>/ecurie setnpc <stable_id></code> || Lie le NPC Citizens le plus proche (≤5 blocs) à l'étable en lui attribuant son nom/skin par défaut || <code>ecurie.admin</code>
|-
| <code>/ecurie list</code> || Liste toutes les étables enregistrées || <code>ecurie.admin</code>
|-
| <code>/ecurie tp <stable_id/nom></code> || Téléporte le joueur en face du NPC de l'étable spécifiée (sécurité anticollision intégrée) || <code>ecurie.admin</code>
|-
| <code>/ecurie box scan <stable_id></code> || Relance la détection des blocs cibles (box) dans la sélection wand pour cette étable || <code>ecurie.admin</code>
|-
| <code>/ecurie box list <stable_id></code> || Liste les coordonnées de toutes les boxes de l'étable spécifiée || <code>ecurie.admin</code>
|-
| <code>/ecurie box delete <box_id></code> || Supprime définitivement la box spécifiée || <code>ecurie.admin</code>
|-
| <code>/ecurie show [on/off]</code> || Active ou désactive l'affichage de particules colorées sur les blocs de box (vert=libre, rouge=occupé) || <code>ecurie.admin</code>
|-
| <code>/ecurie horse free <horse_id></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 horse reassign <horse_id> <stable_id></code> || Réassigne un compagnon orphelin à une box libre de l'étable spécifiée || <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>
|}

Les blocs cibles de boxes détectés par défaut selon le type d'écurie sont :
* <code>STABLE</code> / <code>TERRESTRE</code> : '''WATER_CAULDRON'''
* <code>AQUATIQUE</code> : '''PRISMARINE'''
* <code>VOLIERE</code> : '''DAYLIGHT_DETECTOR'''

== Permissions ==

{| class="wikitable"
! Permission !! Description !! Défaut
|-
| <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
|}

== Workflow admin — Créer une étable ==

=== Étapes ===

1. '''Construire l'étable''' — poser le bloc cible dans chaque stalle (ex: <code>WATER_CAULDRON</code> pour TERRESTRE, <code>PRISMARINE</code> pour AQUATIQUE).
2. '''Activer le wand''' : <code>/ecurie wand on</code> → clic gauche (point A) + clic droit (coin B) pour délimiter la région
3. '''Créer et scanner''' : <code>/ecurie create <nom> [type]</code> — crée l'étable ET enregistre automatiquement les boxes détectées.
4. '''Lier un NPC''' : placer un Citizens devant l'étable, s'en approcher à < 5 blocs : <code>/ecurie setnpc <stable_id></code> (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 :
<syntaxhighlight lang="text">
/ecurie show on
</syntaxhighlight>
* Particules '''vertes''' = box libre
* Particules '''rouges''' = box occupée

Désactiver l'affichage :
<syntaxhighlight lang="text">
/ecurie show off
</syntaxhighlight>

== 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 ===
1. Amener le compagnon à côté ou le monter
2. Cliquer '''Mettre en pension''' dans la GUI
3. '''Si le compagnon n'a pas de nom custom''' (nom générique ou absent) → une enclume s'ouvre pour le nommer
4. '''Si le compagnon a déjà un nom custom''' → mise en pension directe sans nommage
5. Coût : <code>prices.store</code> en sols

=== Reprendre un compagnon ===
1. Cliquer '''Reprendre un compagnon'''
2. Choisir le compagnon dans la liste
3. 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 ===
1. Cliquer '''Modifier le registre'''
2. Choisir le compagnon dans la liste
3. Une enclume s'ouvre pré-remplie avec le nom actuel — modifier ou confirmer
4. Coût : <code>prices.rename</code> en sols (défaut 50)

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

== Placeholders (PlaceholderAPI) ==

Requiert PlaceholderAPI installé.

{| class="wikitable"
! 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>)
|}

== 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 <code>/ecurie setnpc</code>. Sert d'interface pour toutes les interactions joueur. Nom et skin configurables dans <code>npc</code> (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 <code>groom</code> (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 <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.
* '''Transferts''' : vérifiés toutes les 10 secondes en async

== Build ==

<syntaxhighlight lang="bash">
./gradlew shadowJar
# Sortie : build/libs/Ecurie-<version>.jar
</syntaxhighlight>

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

== Changelog ==

{| class="wikitable"
! 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 <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.
|}

[[Catégorie:Plugin développé pour Nefald]]
[[Catégorie:Plugin installé]]

Plugin:Écurie

2026-06-12T22:34:37Z

Hiob : Mise à jour des commandes, permissions, configuration MySQL et restrictions par type (v1.4.0)

{{SHORTDESC:Gestion des écuries RP}}

{{Infobox Plugin
|nom=Écurie
|type=roleplay
|dev=[[Scriptomancien|Nefald]]
|status=Installé
|grade=[[Pérégrin]]
|sources=https://git.nefald.fr/minecraft/plugins/ecurie
|dépendance=[[Plugin:Vault|Vault]] (optionnel), [[Plugin:Banco|Banco]] (optionnel, recommandé), [[Plugin:Citizens|Citizens]] (optionnel), [[Plugin:PlaceholderAPI|PlaceholderAPI]] (optionnel), [[Plugin:MyPet|MyPet]] (optionnel)
}}

'''É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.

== Prérequis ==

{| class="wikitable"
! 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 ==

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

== Configuration ==

=== `config.yml` ===

<syntaxhighlight lang="yaml">
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
</syntaxhighlight>

=== `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 ===

{| class="wikitable"
! Commande !! Description !! Permission
|-
| <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"
! Commande !! Description !! Permission
|-
| <code>/ecurie wand [on/off]</code> || Active ou désactive le wand (bâton de sélection pour délimiter les étables) || <code>ecurie.admin</code>
|-
| <code>/ecurie create <nom> [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 delete <id></code> || Supprime l'étable spécifiée (rend ses compagnons orphelins) || <code>ecurie.admin</code>
|-
| <code>/ecurie setnpc <stable_id></code> || Lie le NPC Citizens le plus proche (≤5 blocs) à l'étable en lui attribuant son nom/skin par défaut || <code>ecurie.admin</code>
|-
| <code>/ecurie list</code> || Liste toutes les étables enregistrées || <code>ecurie.admin</code>
|-
| <code>/ecurie tp <stable_id/nom></code> || Téléporte le joueur en face du NPC de l'étable spécifiée (sécurité anticollision intégrée) || <code>ecurie.admin</code>
|-
| <code>/ecurie box scan <stable_id></code> || Relance la détection des blocs cibles (box) dans la sélection wand pour cette étable || <code>ecurie.admin</code>
|-
| <code>/ecurie box list <stable_id></code> || Liste les coordonnées de toutes les boxes de l'étable spécifiée || <code>ecurie.admin</code>
|-
| <code>/ecurie box delete <box_id></code> || Supprime définitivement la box spécifiée || <code>ecurie.admin</code>
|-
| <code>/ecurie show [on/off]</code> || Active ou désactive l'affichage de particules colorées sur les blocs de box (vert=libre, rouge=occupé) || <code>ecurie.admin</code>
|-
| <code>/ecurie horse free <horse_id></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 horse reassign <horse_id> <stable_id></code> || Réassigne un compagnon orphelin à une box libre de l'étable spécifiée || <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>
|}

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 ==

{| class="wikitable"
! Permission !! Description !! Défaut
|-
| <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
|}

== Workflow admin — Créer une étable ==

=== Étapes ===

1. '''Construire l'étable''' — poser le bloc cible dans chaque stalle (ex: `WATER_CAULDRON` pour TERRESTRE, `PRISMARINE` pour AQUATIQUE).
2. '''Activer le wand''' : `/ecurie wand on` → clic gauche (point A) + clic droit (coin B) pour délimiter la région
3. '''Créer et scanner''' : `/ecurie create <nom> [type]` — crée l'étable ET enregistre automatiquement les boxes détectées.
4. '''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 :
<syntaxhighlight lang="text">
/ecurie show on
</syntaxhighlight>
* Particules '''vertes''' = box libre
* Particules '''rouges''' = box occupée

Désactiver l'affichage :
<syntaxhighlight lang="text">
/ecurie show off
</syntaxhighlight>

== 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 ===
1. Amener le compagnon à côté ou le monter
2. Cliquer '''Mettre en pension''' dans la GUI
3. '''Si le compagnon n'a pas de nom custom''' (nom générique ou absent) → une enclume s'ouvre pour le nommer
4. '''Si le compagnon a déjà un nom custom''' → mise en pension directe sans nommage
5. Coût : `prices.store` en sols

=== Reprendre un compagnon ===
1. Cliquer '''Reprendre un compagnon'''
2. Choisir le compagnon dans la liste
3. 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 ===
1. Cliquer '''Modifier le registre'''
2. Choisir le compagnon dans la liste
3. Une enclume s'ouvre pré-remplie avec le nom actuel — modifier ou confirmer
4. 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é.

{| class="wikitable"
! 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>)
|}

== 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 ==

<syntaxhighlight lang="bash">
./gradlew shadowJar
# Sortie : build/libs/Ecurie-<version>.jar
</syntaxhighlight>

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

== Changelog ==

{| class="wikitable"
! 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.
|}

[[Catégorie:Plugin développé pour Nefald]]
[[Catégorie:Plugin installé]]

Plugin:Écurie

2026-06-12T22:32:07Z

Hiob : Mise à jour des commandes, permissions, configuration MySQL et restrictions par type (v1.4.0)

{{SHORTDESC:Gestion des écuries RP}}

{{Infobox Plugin
|nom=Écurie
|type=roleplay
|dev=[[Scriptomancien|Nefald]]
|status=Installé
|grade=[[Pérégrin]]
|sources=https://git.nefald.fr/minecraft/plugins/ecurie
|dépendance=[[Plugin:Vault|Vault]] (optionnel), [[Plugin:Banco|Banco]] (optionnel, recommandé), [[Plugin:Citizens|Citizens]] (optionnel), [[Plugin:PlaceholderAPI|PlaceholderAPI]] (optionnel), [[Plugin:MyPet|MyPet]] (optionnel)
}}

'''É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.

== Prérequis ==

{| class="wikitable"
! 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 ==

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

== Configuration ==

=== `config.yml` ===

<syntaxhighlight lang="yaml">
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
</syntaxhighlight>

=== `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 admin ==

Permission requise : `ecurie.admin` (op par défaut). Alias : `/ec`

=== Sélection de région ===

<syntaxhighlight lang="text">
/ecurie wand [on|off] — Active/désactive le wand (bâton). Clic G = pt 1, clic D = pt 2.
</syntaxhighlight>

=== Étables ===

<syntaxhighlight lang="text">
/ecurie create <nom> [type] — Crée l'étable et scanne automatiquement les boxes. Types : STABLE, TERRESTRE, AQUATIQUE, VOLIERE.
/ecurie delete <id> — Supprime une étable (met les compagnons en statut orphelin)
/ecurie setnpc <stable_id> — Lie le NPC Citizens le plus proche (≤5 blocs) à l'étable (applique nom et skin auto)
/ecurie list — Liste toutes les étables
/ecurie tp <stable_id|nom> — Téléporte le joueur en face du NPC associé à l'étable (sécurité anti-collision)
</syntaxhighlight>

=== Boxes ===

<syntaxhighlight lang="text">
/ecurie box scan <stable_id> — Rescanne les blocs cibles dans la sélection wand
/ecurie box list <stable_id> — Liste les boxes d'une étable
/ecurie box delete <box_id> — Supprime une box
/ecurie show [on|off] — Affiche les boxes en surbrillance (particules colorées : vertes=libre, rouges=occupée)
</syntaxhighlight>

Détection : chaque stalle doit contenir un bloc spécifique configuré dans `config.yml` (`box-blocks`). Par défaut :
* `STABLE` / `TERRESTRE` : '''WATER_CAULDRON'''
* `AQUATIQUE` : '''PRISMARINE'''
* `VOLIERE` : '''DAYLIGHT_DETECTOR'''
La commande `create` ou `box scan` détecte automatiquement ces blocs dans la région wand et enregistre les boxes immédiatement.

=== Compagnons ===

<syntaxhighlight lang="text">
/ecurie horse free <horse_id> — Supprime définitivement un compagnon de la DB (urgence admin)
/ecurie horse orphans — Liste les compagnons orphelins (étable d'origine supprimée)
/ecurie horse reassign <h_id> <s_id> — Réassigne un compagnon orphelin à une nouvelle étable
</syntaxhighlight>

=== Divers ===

<syntaxhighlight lang="text">
/ecurie reload — Recharge config.yml et lang.yml
</syntaxhighlight>

== Commandes joueurs ==

Permission requise : `ecurie.use` (true par défaut).

<syntaxhighlight lang="text">
/ecurie gui [dialog|inventory] — Change votre type d'interface (persistant via PDC)
</syntaxhighlight>

== Workflow admin — Créer une étable ==

=== Étapes ===

1. '''Construire l'étable''' — poser le bloc cible dans chaque stalle (ex: `WATER_CAULDRON` pour TERRESTRE, `PRISMARINE` pour AQUATIQUE).
2. '''Activer le wand''' : `/ecurie wand on` → clic gauche (point A) + clic droit (coin B) pour délimiter la région
3. '''Créer et scanner''' : `/ecurie create <nom> [type]` — crée l'étable ET enregistre automatiquement les boxes détectées.
4. '''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 :
<syntaxhighlight lang="text">
/ecurie show on
</syntaxhighlight>
* Particules '''vertes''' = box libre
* Particules '''rouges''' = box occupée

Désactiver l'affichage :
<syntaxhighlight lang="text">
/ecurie show off
</syntaxhighlight>

== 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 ===
1. Amener le compagnon à côté ou le monter
2. Cliquer '''Mettre en pension''' dans la GUI
3. '''Si le compagnon n'a pas de nom custom''' (nom générique ou absent) → une enclume s'ouvre pour le nommer
4. '''Si le compagnon a déjà un nom custom''' → mise en pension directe sans nommage
5. Coût : `prices.store` en sols

=== Reprendre un compagnon ===
1. Cliquer '''Reprendre un compagnon'''
2. Choisir le compagnon dans la liste
3. 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 ===
1. Cliquer '''Modifier le registre'''
2. Choisir le compagnon dans la liste
3. Une enclume s'ouvre pré-remplie avec le nom actuel — modifier ou confirmer
4. 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é.

{| class="wikitable"
! 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 ==

{| class="wikitable"
! 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 ==

* '''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 ==

<syntaxhighlight lang="bash">
./gradlew shadowJar
# Sortie : build/libs/Ecurie-<version>.jar
</syntaxhighlight>

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

== Changelog ==

{| class="wikitable"
! 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.
|}

[[Catégorie:Plugin développé pour Nefald]]
[[Catégorie:Plugin installé]]

MediaWiki:Citizen.css

2026-06-12T19:29:15Z

Hiob : Harmonisation avec Blog / Forum

/* ============================================================
* Mediawiki:Citizen.css — Nefald Wiki
* Palette centralisée OKLCH + support light/dark/auto
* Harmonisé avec Ghost Jaeger et Flarum Hyvan
* ============================================================ */

/* 1. Typographie & Polices Nefald (Importation Google Fonts) */
@import url('https://fonts.googleapis.com/css2?family=VT323&family=Oswald:wght@300;400;500;600;700&display=swap');

/* ============================================================
* 1. PALETTE NEFALD — Variables personnalisées
* ============================================================ */

:root {
/* -- Typographie globale Citizen -- */
--font-family-citizen-base: 'Oswald';
--font-family-citizen-monospace: 'VT323', monospace;

/* -- Angles droits rigides (Esthétique Nefald / Hyvan / Jaeger) -- */
--border-radius-base: 2px;

/* -- Couleur progressive Citizen (#5a8db8 en OKLCH pour l'accentuation) -- */
--color-progressive-oklch__l: 60.15%;
--color-progressive-oklch__c: 0.134;
--color-progressive-oklch__h: 246.33;

/* -- Palette sémantique Nefald (light par défaut) -- */

/* Success */
--nefald-success-bg: oklch(93% 0.08 145);
--nefald-success-text: oklch(35% 0.12 145);
--nefald-success-border: oklch(75% 0.14 145);

/* Danger */
--nefald-danger-bg: oklch(93% 0.07 25);
--nefald-danger-text: oklch(38% 0.14 25);
--nefald-danger-border: oklch(70% 0.16 25);

/* Warning */
--nefald-warning-bg: oklch(95% 0.09 85);
--nefald-warning-text: oklch(42% 0.13 75);
--nefald-warning-border: oklch(78% 0.15 85);

/* Info */
--nefald-info-bg: oklch(93% 0.06 230);
--nefald-info-text: oklch(38% 0.12 230);
--nefald-info-border: oklch(72% 0.14 230);

/* Neutral */
--nefald-neutral-bg: oklch(94% 0.01 230);
--nefald-neutral-text: oklch(40% 0.02 230);
--nefald-neutral-border: oklch(78% 0.02 230);

/* Tip (violet) */
--nefald-tip-bg: oklch(94% 0.06 310);
--nefald-tip-text: oklch(35% 0.14 310);
--nefald-tip-border: oklch(55% 0.18 310);

/* Question (cyan) */
--nefald-question-bg: oklch(94% 0.06 200);
--nefald-question-text: oklch(35% 0.12 200);
--nefald-question-border: oklch(55% 0.16 200);

/* Accent */
--nefald-accent: oklch(53.25% 0.1679 230);
--nefald-accent-subtle: oklch(93% 0.05 230);

/* Recherche dans la page */
--nefald-highlight-bg: oklch(90% 0.18 85);
--nefald-highlight-text: oklch(25% 0.08 75);
--nefald-highlight-active-bg: oklch(78% 0.20 60);
--nefald-highlight-active-text: oklch(20% 0.10 55);
--nefald-highlight-active-outline: oklch(65% 0.22 55);

/* -- Variables Roadmap (dérivées de la palette) -- */
--roadmap-idea-bg: var(--nefald-neutral-bg);
--roadmap-idea-text: var(--nefald-neutral-text);
--roadmap-idea-border: var(--nefald-neutral-border);

--roadmap-planned-bg: var(--nefald-warning-bg);
--roadmap-planned-text: var(--nefald-warning-text);
--roadmap-planned-border: var(--nefald-warning-border);

--roadmap-inprogress-bg: var(--nefald-info-bg);
--roadmap-inprogress-text: var(--nefald-info-text);
--roadmap-inprogress-border: var(--nefald-info-border);

--roadmap-done-bg: var(--nefald-success-bg);
--roadmap-done-text: var(--nefald-success-text);
--roadmap-done-border: var(--nefald-success-border);

--roadmap-cancelled-bg: var(--nefald-danger-bg);
--roadmap-cancelled-text: var(--nefald-danger-text);
--roadmap-cancelled-border: var(--nefald-danger-border);
}

/* -- Mode sombre (manuel) -- */
:root.skin-theme-clientpref-night {
/* Surcharges des surfaces Citizen pour le thème sombre Nefald (Jaeger/Hyvan) */
--color-surface-0: #0a0c10; /* Fond de page principal (nefald-ink) */
--color-surface-1: #11161d; /* Cartes, modales et menus déroulants (nefald-ink-2) */
--color-surface-2: #1a2230; /* Éléments surélevés (nefald-ink-3) */
--color-surface-3: #1c2532; /* Zones de survol / lignes subtiles (nefald-rule) */
--color-surface-4: #2a3a4e; /* Éléments actifs / acier (nefald-steel) */

/* Textes */
--color-base: #c8d1de; /* Texte général (nefald-cream) */
--color-emphasized: #e6ecf3; /* Titres et en-têtes (nefald-cream-bright) */
--color-subtle: #7c8694; /* Légendes et métadonnées (nefald-muted) */
--color-link: #8eb4d4; /* Liens (nefald-blue-light) */
--color-link-hover: #5a8db8; /* Liens survolés (nefald-blue-bright) */

/* Frontières */
--border-color-base: #2a3a4e;
--border-color-subtle: #1c2532;
--border-color-interactive: #5a8db8;

/* Sémantique Nefald */
--nefald-success-bg: oklch(28% 0.09 145);
--nefald-success-text: oklch(82% 0.12 145);
--nefald-success-border: oklch(45% 0.12 145);

--nefald-danger-bg: oklch(28% 0.09 25);
--nefald-danger-text: oklch(85% 0.10 25);
--nefald-danger-border: oklch(48% 0.14 25);

--nefald-warning-bg: oklch(30% 0.09 75);
--nefald-warning-text: oklch(88% 0.12 85);
--nefald-warning-border: oklch(52% 0.14 80);

--nefald-info-bg: oklch(28% 0.07 230);
--nefald-info-text: oklch(84% 0.10 230);
--nefald-info-border: oklch(48% 0.12 230);

--nefald-neutral-bg: oklch(28% 0.01 230);
--nefald-neutral-text: oklch(82% 0.02 230);
--nefald-neutral-border: oklch(45% 0.02 230);

--nefald-tip-bg: oklch(25% 0.07 310);
--nefald-tip-text: oklch(80% 0.12 310);
--nefald-tip-border: oklch(50% 0.16 310);

--nefald-question-bg: oklch(25% 0.06 200);
--nefald-question-text: oklch(80% 0.11 200);
--nefald-question-border: oklch(50% 0.14 200);

--nefald-accent: oklch(65% 0.18 230);
--nefald-accent-subtle: oklch(28% 0.07 230);

/* Recherche dans la page */
--nefald-highlight-bg: oklch(45% 0.18 85);
--nefald-highlight-text: oklch(95% 0.05 85);
--nefald-highlight-active-bg: oklch(58% 0.22 60);
--nefald-highlight-active-text: oklch(98% 0.02 60);
--nefald-highlight-active-outline: oklch(70% 0.22 55);
}

/* -- Mode automatique (suit le système) -- */
@media (prefers-color-scheme: dark) {
:root.skin-theme-clientpref-os {
/* Surcharges des surfaces Citizen pour le thème sombre Nefald (Jaeger/Hyvan) */
--color-surface-0: #0a0c10;
--color-surface-1: #11161d;
--color-surface-2: #1a2230;
--color-surface-3: #1c2532;
--color-surface-4: #2a3a4e;

--color-base: #c8d1de;
--color-emphasized: #e6ecf3;
--color-subtle: #7c8694;
--color-link: #8eb4d4;
--color-link-hover: #5a8db8;

--border-color-base: #2a3a4e;
--border-color-subtle: #1c2532;
--border-color-interactive: #5a8db8;

/* Sémantique Nefald */
--nefald-success-bg: oklch(28% 0.09 145);
--nefald-success-text: oklch(82% 0.12 145);
--nefald-success-border: oklch(45% 0.12 145);

--nefald-danger-bg: oklch(28% 0.09 25);
--nefald-danger-text: oklch(85% 0.10 25);
--nefald-danger-border: oklch(48% 0.14 25);

--nefald-warning-bg: oklch(30% 0.09 75);
--nefald-warning-text: oklch(88% 0.12 85);
--nefald-warning-border: oklch(52% 0.14 80);

--nefald-info-bg: oklch(28% 0.07 230);
--nefald-info-text: oklch(84% 0.10 230);
--nefald-info-border: oklch(48% 0.12 230);

--nefald-neutral-bg: oklch(28% 0.01 230);
--nefald-neutral-text: oklch(82% 0.02 230);
--nefald-neutral-border: oklch(45% 0.02 230);

--nefald-tip-bg: oklch(25% 0.07 310);
--nefald-tip-text: oklch(80% 0.12 310);
--nefald-tip-border: oklch(50% 0.16 310);

--nefald-question-bg: oklch(25% 0.06 200);
--nefald-question-text: oklch(80% 0.11 200);
--nefald-question-border: oklch(50% 0.14 200);

--nefald-accent: oklch(65% 0.18 230);
--nefald-accent-subtle: oklch(28% 0.07 230);

/* Recherche dans la page */
--nefald-highlight-bg: oklch(45% 0.18 85);
--nefald-highlight-text: oklch(95% 0.05 85);
--nefald-highlight-active-bg: oklch(58% 0.22 60);
--nefald-highlight-active-text: oklch(98% 0.02 60);
--nefald-highlight-active-outline: oklch(70% 0.22 55);
}
}

/* -- Mode Noir Pur (OLED) -- */
.skin-theme-clientpref-night.citizen-feature-pure-black-clientpref-1 {
--color-surface-0: #000000;
--color-surface-1: #0a0c10;
--color-surface-2: #11161d;
--color-surface-3: #1a2230;
--color-surface-4: #2a3a4e;
}

/* -- Mode Clair -- */
.skin-theme-clientpref-day {
/* Progressive color assombrie en mode clair pour l'accessibilité */
--color-progressive-oklch__l: 43.15%;
--color-progressive-oklch__c: 0.114;
--color-progressive-oklch__h: 246.33;
}

/* -- Jaeger background gradient (Effet cinématique du fond) -- */
.skin-theme-clientpref-night body {
background: radial-gradient(ellipse at top, #0e1822 0%, #0a0c10 60%, #0a0c10 100%) !important;
background-attachment: fixed !important;
}
@media screen and (prefers-color-scheme: dark) {
.skin-theme-clientpref-os body {
background: radial-gradient(ellipse at top, #0e1822 0%, #0a0c10 60%, #0a0c10 100%) !important;
background-attachment: fixed !important;
}
}

/* ============================================================
* 2. TYPOGRAPHIE
* ============================================================ */

h1, h2, h3, h4, h5, h6,
.citizen-sticky-header-page-title {
font-weight: var(--font-weight-medium);
}

h4, h5, h6 {
letter-spacing: 0.0125em;
}

/* ============================================================
* 3. TABLEAUX — Classes sémantiques
* ============================================================ */

.table-color-success {
background-color: var(--nefald-success-bg) !important;
color: var(--nefald-success-text) !important;
border-left: 3px solid var(--nefald-success-border) !important;
}

.table-color-danger {
background-color: var(--nefald-danger-bg) !important;
color: var(--nefald-danger-text) !important;
border-left: 3px solid var(--nefald-danger-border) !important;
}

.table-color-warning {
background-color: var(--nefald-warning-bg) !important;
color: var(--nefald-warning-text) !important;
border-left: 3px solid var(--nefald-warning-border) !important;
}

.table-color-info {
background-color: var(--nefald-info-bg) !important;
color: var(--nefald-info-text) !important;
border-left: 3px solid var(--nefald-info-border) !important;
}

.table-color-secondary {
background-color: var(--nefald-neutral-bg) !important;
color: var(--nefald-neutral-text) !important;
border-left: 3px solid var(--nefald-neutral-border) !important;
}

.table-color-success,
.table-color-danger,
.table-color-warning,
.table-color-info,
.table-color-secondary {
transition: filter 0.2s ease;
}

.wikitable tr:hover .table-color-success,
.wikitable tr:hover .table-color-danger,
.wikitable tr:hover .table-color-warning,
.wikitable tr:hover .table-color-info,
.wikitable tr:hover .table-color-secondary {
filter: brightness(0.95);
}

.table-color-success code,
.table-color-danger code,
.table-color-warning code,
.table-color-info code,
.table-color-secondary code {
background-color: rgba(0, 0, 0, 0.1) !important;
color: inherit !important;
border: 1px solid rgba(0, 0, 0, 0.15);
padding: 2px 6px;
border-radius: 3px;
font-size: 0.9em;
}

:root.skin-theme-clientpref-night .table-color-success code,
:root.skin-theme-clientpref-night .table-color-danger code,
:root.skin-theme-clientpref-night .table-color-warning code,
:root.skin-theme-clientpref-night .table-color-info code,
:root.skin-theme-clientpref-night .table-color-secondary code {
background-color: rgba(255, 255, 255, 0.1) !important;
border-color: rgba(255, 255, 255, 0.15);
}

.table-color-success:focus-within,
.table-color-danger:focus-within,
.table-color-warning:focus-within,
.table-color-info:focus-within,
.table-color-secondary:focus-within {
outline: 2px solid currentColor;
outline-offset: -2px;
}

/* ============================================================
* 4. COMMAND PALETTE — Repositionnement desktop
* ============================================================ */

@media (min-width: 1000px) {
.citizen-command-palette {
left: calc(56px + var(--space-xs)) !important;
top: 2rem !important;
}
}

/* ============================================================
* 5. MENU LATÉRAL (Drawer)
* ============================================================ */

.citizen-drawer__menu {
margin-bottom: 0;
padding-bottom: 0;
}

.mw-portlet-External {
position: sticky;
bottom: 0;
margin-top: var(--space-md);
margin-inline: calc(var(--space-xs) * -1);
padding: var(--space-xs);
border-top: var(--border-base);
backdrop-filter: var(--backdrop-filter-frosted-glass);
font-size: var(--font-size-x-small);
grid-column: 1 / -1;
white-space: nowrap;
}

.mw-portlet-External .citizen-menu__heading {
display: none;
}

.mw-portlet-External ul {
display: flex;
overflow: auto;
}

.mw-portlet-External .mw-list-item a {
gap: 0;
}

.citizen-drawer__menu [id^="n-sidebar-label-"] a {
pointer-events: none;
margin-left: var(--space-xs);
padding-left: var(--space-md);
padding-right: var(--space-xs);
border-left: 1px solid var(--border-color-base);
border-radius: 0;
letter-spacing: 0.05em;
font-weight: var(--font-weight-normal);
color: var(--color-subtle) !important;
}

.citizen-drawer__menu [id^="n-sidebar-icon-"] a {
font-size: 0;
content-visibility: auto;
}

.citizen-drawer__menu [id^="n-sidebar-icon-"] a:before {
display: block;
content: "";
width: var(--size-icon);
height: var(--size-icon);
background-color: currentColor;
mask-size: contain;
mask-repeat: no-repeat;
mask-position: center;
}

#n-sidebar-icon-bluesky a:before { mask-image: url(https://wiki.nefald.fr/images/2/21/IconButton-bluesky.svg); }
#n-sidebar-icon-discord a:before { mask-image: url(https://wiki.nefald.fr/images/9/9c/Discord_Icons.svg); }
#n-sidebar-icon-facebook a:before { mask-image: url(https://wiki.nefald.fr/images/9/9c/IconButton-facebook.svg); }
#n-sidebar-icon-ghost a:before { mask-image: url(https://wiki.nefald.fr/images/f/f6/IconButton-ghost.svg); }
#n-sidebar-icon-gitlab a:before { mask-image: url(https://wiki.nefald.fr/images/0/01/IconButton-gitlab.svg); }
#n-sidebar-icon-helloasso a:before { mask-image: url(https://wiki.nefald.fr/images/c/c3/IconButton-helloasso.svg); }
#n-sidebar-icon-instagram a:before { mask-image: url(https://wiki.nefald.fr/images/f/f9/ButtonLink-instagram.svg); }
#n-sidebar-icon-mastodon a:before { mask-image: url(https://wiki.nefald.fr/images/b/b0/IconButton-mastodon.svg); }
#n-sidebar-icon-patreon a:before { mask-image: url(); }
#n-sidebar-icon-tiktok a:before { mask-image: url(https://wiki.nefald.fr/images/0/07/IconButton-tiktok.svg); }
#n-sidebar-icon-twitter a:before { mask-image: url(https://wiki.nefald.fr/images/3/35/ButtonLink-twitter.svg); }
#n-sidebar-icon-youtube a:before { mask-image: url(https://wiki.nefald.fr/images/6/64/IconButton-youtube.svg); }

/* ============================================================
* 6. FOOTER
* ============================================================ */

.citizen-footer {
padding-block: 6rem;
background-color: transparent;
}

.citizen-footer__siteinfo {
justify-content: space-between;
}

#footer-icons a {
border: 0;
padding: 0;
background: transparent;
opacity: var(--opacity-icon-base);
transition: opacity 250ms ease;
}

#footer-icons a:hover { opacity: var(--opacity-icon-base--hover); }
#footer-icons a:active { opacity: var(--opacity-icon-base--active); }

#footer-icons ul,
#footer-icons li {
column-gap: var(--space-md);
}

#footer-icons img {
width: auto;
height: 32px;
}

/* ============================================================
* 7. MODÈLE:RECHERCHE — Surlignage
* ============================================================ */

.nefald-highlight {
background-color: var(--nefald-highlight-bg);
color: var(--nefald-highlight-text);
border-radius: 2px;
padding: 0 2px;
}

.nefald-highlight--active {
background-color: var(--nefald-highlight-active-bg);
color: var(--nefald-highlight-active-text);
outline: 2px solid var(--nefald-highlight-active-outline);
outline-offset: 1px;
}

Plugin:Écurie

2026-06-11T23:37:33Z

Hiob : style: aligner le formatage sur Plugin:Banco (H1, gras intro, type infobox, séparateurs, code dans tableaux) (via update-page on MediaWiki MCP Server)

{{SHORTDESC:Gestion des écuries RP}}

{{Infobox Plugin
|nom=Écurie
|type=roleplay
|dev=[[Scriptomancien|Nefald]]
|status=Installé
|grade=[[Pérégrin]]
|sources=https://git.nefald.fr/minecraft/plugins/ecurie
|dépendance=[[Plugin:Vault|Vault]] (optionnel), [[Plugin:Banco|Banco]] (optionnel, recommandé), [[Plugin:Citizens|Citizens]] (optionnel), [[Plugin:PlaceholderAPI|PlaceholderAPI]] (optionnel), [[Plugin:MyPet|MyPet]] (optionnel)
}}

'''É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.

== Prérequis ==

{| class="wikitable"
! 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 ==

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

== Configuration ==

=== `config.yml` ===

<syntaxhighlight lang="yaml">
database:
file: "ecurie.db" # Chemin relatif au dossier du plugin

# 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

routes:
on-road-speed: 0.35 # Vitesse cheval sur route (vanilla ≈ 0.225)
enabled: false # Routes RP (désactivé en V1)

# 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 stable 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

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

=== `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 admin ==

Permission requise : `ecurie.admin` (op par défaut). Alias : `/ec`

=== Wand — sélection de région ===

<syntaxhighlight lang="text">
/ecurie wand [on|off]
</syntaxhighlight>

Active/désactive le wand bâton. Clic gauche = point 1, clic droit = point 2. Utilisé pour scanner les boxes d'une étable.

=== Étables ===

<syntaxhighlight lang="text">
/ecurie stable create <nom> [type] — Crée l'étable ET scanne automatiquement les boxes. Type: STABLE, TERRESTRE, AQUATIQUE, VOLIERE.
/ecurie stable delete <id> — Supprime une étable
/ecurie stable setnpc <stable_id> — Lie le NPC Citizens le plus proche (≤5 blocs) à l'étable
/ecurie stable list — Liste toutes les étables
</syntaxhighlight>

=== Boxes ===

<syntaxhighlight lang="text">
/ecurie box list <stable_id> — Liste les boxes d'une étable
/ecurie box delete <box_id> — Supprime une box
/ecurie show [on|off] — Affiche les boxes en surbrillance (particules colorées : vertes=libre, rouges=occupée)
</syntaxhighlight>

Détection : chaque stalle doit contenir un bloc spécifique configuré dans `config.yml` (`box-blocks`). Par défaut :
* `STABLE` / `TERRESTRE` : '''WATER_CAULDRON'''
* `AQUATIQUE` : '''PRISMARINE'''
* `VOLIERE` : '''DAYLIGHT_DETECTOR'''
La commande `stable create` détecte automatiquement tous ces blocs dans la région wand et enregistre les boxes immédiatement.

=== Chevaux ===

<syntaxhighlight lang="text">
/ecurie horse free <horse_id> — Libère un compagnon de la DB (urgence admin)
</syntaxhighlight>

=== Divers ===

<syntaxhighlight lang="text">
/ecurie reload — Recharge config.yml et le cache ShowManager
</syntaxhighlight>

== Commandes joueurs ==

Permission requise : `ecurie.use` (true par défaut).

<syntaxhighlight lang="text">
/ecurie gui [dialog|inventory] — Change votre type d'interface (persistant via PDC)
</syntaxhighlight>

== Workflow admin — Créer une étable ==

=== Étapes ===

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

=== Visualiser les boxes ===

Après création, afficher les boxes avec particules colorées :
<syntaxhighlight lang="text">
/ecurie show on
</syntaxhighlight>
* Particules '''vertes''' = box libre
* Particules '''rouges''' = box occupée

Désactiver l'affichage :
<syntaxhighlight lang="text">
/ecurie show off
</syntaxhighlight>

== 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 ===
1. Amener le compagnon à côté ou le monter
2. Cliquer '''Mettre en pension''' dans la GUI
3. '''Si le compagnon n'a pas de nom custom''' (nom générique ou absent) → une enclume s'ouvre pour le nommer
4. '''Si le compagnon a déjà un nom custom''' → mise en pension directe sans nommage
5. Coût : `prices.store` en sols

=== Reprendre un compagnon ===
1. Cliquer '''Reprendre un compagnon'''
2. Choisir le compagnon dans la liste
3. 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 ===
1. Cliquer '''Modifier le registre'''
2. Choisir le compagnon dans la liste
3. Une enclume s'ouvre pré-remplie avec le nom actuel — modifier ou confirmer
4. 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é.

{| class="wikitable"
! 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 ==

{| class="wikitable"
! 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 ==

* '''Stockage''' : SQLite embarqué (shadowed, pas de dépendance runtime)
* '''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 stable 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`.
* '''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

== Build ==

<syntaxhighlight lang="bash">
./gradlew shadowJar
# Sortie : build/libs/Ecurie-<version>.jar
</syntaxhighlight>

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

== Changelog ==

{| class="wikitable"
! 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).
|}

[[Catégorie:Plugin développé pour Nefald]]
[[Catégorie:Plugin installé]]

Plugin:Écurie

2026-06-11T23:29:21Z

Hiob : 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)

{{SHORTDESC:Gestion des écuries RP}}

{{Infobox Plugin
|nom=Écurie
|type=gameplay
|dev=[[Scriptomancien|Nefald]]
|status=Installé
|grade=[[Pérégrin]]
|sources=https://git.nefald.fr/minecraft/plugins/ecurie
|dépendance=[[Plugin:Vault|Vault]] (optionnel), [[Plugin:Banco|Banco]] (optionnel, recommandé), [[Plugin:Citizens|Citizens]] (optionnel), [[Plugin:PlaceholderAPI|PlaceholderAPI]] (optionnel), [[Plugin:MyPet|MyPet]] (optionnel)
}}

= Ecurie =

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.

---

== Prérequis ==

{| class="wikitable"
! 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 ==

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

---

== Configuration ==

=== `config.yml` ===

<syntaxhighlight lang="yaml">
database:
file: "ecurie.db" # Chemin relatif au dossier du plugin

# 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

routes:
on-road-speed: 0.35 # Vitesse cheval sur route (vanilla ≈ 0.225)
enabled: false # Routes RP (désactivé en V1)

# 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 stable 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

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

=== `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 admin ==

Permission requise : `ecurie.admin` (op par défaut). Alias : `/ec`

=== Wand — sélection de région ===

<syntaxhighlight lang="text">
/ecurie wand [on|off]
</syntaxhighlight>

Active/désactive le wand bâton. Clic gauche = point 1, clic droit = point 2. Utilisé pour scanner les boxes d'une étable.

=== Étables ===

<syntaxhighlight lang="text">
/ecurie stable create <nom> [type] — Crée l'étable ET scanne automatiquement les boxes. Type: STABLE, TERRESTRE, AQUATIQUE, VOLIERE.
/ecurie stable delete <id> — Supprime une étable
/ecurie stable setnpc <stable_id> — Lie le NPC Citizens le plus proche (≤5 blocs) à l'étable
/ecurie stable list — Liste toutes les étables
</syntaxhighlight>

=== Boxes ===

<syntaxhighlight lang="text">
/ecurie box list <stable_id> — Liste les boxes d'une étable
/ecurie box delete <box_id> — Supprime une box
/ecurie show [on|off] — Affiche les boxes en surbrillance (particules colorées : vertes=libre, rouges=occupée)
</syntaxhighlight>

Détection : chaque stalle doit contenir un bloc spécifique configuré dans `config.yml` (`box-blocks`). Par défaut :
* `STABLE` / `TERRESTRE` : '''WATER_CAULDRON'''
* `AQUATIQUE` : '''PRISMARINE'''
* `VOLIERE` : '''DAYLIGHT_DETECTOR'''
La commande `stable create` détecte automatiquement tous ces blocs dans la région wand et enregistre les boxes immédiatement.

=== Chevaux ===

<syntaxhighlight lang="text">
/ecurie horse free <horse_id> — Libère un compagnon de la DB (urgence admin)
</syntaxhighlight>

=== Divers ===

<syntaxhighlight lang="text">
/ecurie reload — Recharge config.yml et le cache ShowManager
</syntaxhighlight>

---

== Commandes joueurs ==

Permission requise : `ecurie.use` (true par défaut).

<syntaxhighlight lang="text">
/ecurie gui [dialog|inventory] — Change votre type d'interface (persistant via PDC)
</syntaxhighlight>

---

== Workflow admin — Créer une étable ==

=== Étapes ===

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

=== Visualiser les boxes ===

Après création, afficher les boxes avec particules colorées :
<syntaxhighlight lang="text">
/ecurie show on
</syntaxhighlight>
* Particules '''vertes''' = box libre
* Particules '''rouges''' = box occupée

Désactiver l'affichage :
<syntaxhighlight lang="text">
/ecurie show off
</syntaxhighlight>

---

== 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 ===
1. Amener le compagnon à côté ou le monter
2. Cliquer '''Mettre en pension''' dans la GUI
3. '''Si le compagnon n'a pas de nom custom''' (nom générique ou absent) → une enclume s'ouvre pour le nommer
4. '''Si le compagnon a déjà un nom custom''' → mise en pension directe sans nommage
5. Coût : `prices.store` en sols

=== Reprendre un compagnon ===
1. Cliquer '''Reprendre un compagnon'''
2. Choisir le compagnon dans la liste
3. 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 ===
1. Cliquer '''Modifier le registre'''
2. Choisir le compagnon dans la liste
3. Une enclume s'ouvre pré-remplie avec le nom actuel — modifier ou confirmer
4. 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é.

{| class="wikitable"
! 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`)
|}

---

== Permissions ==

{| class="wikitable"
! Permission !! Description !! Défaut
|-
| `ecurie.admin` || Accès aux commandes d'administration `/ecurie` || op
|-
| `ecurie.use` || Interaction avec les PNJ et `/ecurie gui` || true
|}

---

== Notes techniques ==

* '''Stockage''' : SQLite embarqué (shadowed, pas de dépendance runtime)
* '''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 stable 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`.
* '''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

---

== Build ==

<syntaxhighlight lang="bash">
./gradlew shadowJar
# Sortie : build/libs/Ecurie-<version>.jar
</syntaxhighlight>

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

---

== Changelog ==

{| class="wikitable"
! 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).
|}

[[Catégorie:Plugin développé pour Nefald]]
[[Catégorie:Plugin installé]]

Plugin:Écurie

2026-06-11T23:20:04Z

Hiob :

= Ecurie =

Plugin PaperMC de gestion des chevaux RP pour le serveur Nefald.

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

---

== Prérequis ==

{| class="wikitable"
! 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 ==

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

---

== Configuration ==

=== `config.yml` ===

<syntaxhighlight lang="yaml">
database:
file: "ecurie.db" # Chemin relatif au dossier du plugin

transfer:
base-delay-seconds: 600 # Délai de base pour un transfert (10 min)
delay-per-100-blocks: 30 # Délai additionnel par 100 blocs de distance

routes:
on-road-speed: 0.35 # Vitesse cheval sur route (vanilla ≈ 0.225)
enabled: false # Routes RP (désactivé en V1)

phantom-horse:
health: 20.0 # PV du cheval fantôme en box
</syntaxhighlight>

=== `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 admin ==

Permission requise : `ecurie.admin` (op par défaut). Alias : `/ec`

=== Wand — sélection de région ===

<syntaxhighlight lang="text">
/ecurie wand [on|off]
</syntaxhighlight>

Active/désactive le wand bâton. Clic gauche = point 1, clic droit = point 2. Utilisé pour scanner les boxes d'une étable.

=== Étables ===

<syntaxhighlight lang="text">
/ecurie stable create <nom> [type] — Crée l'étable ET scanne automatiquement les boxes. Type: STABLE, TERRESTRE, AQUATIQUE, VOLIERE.
/ecurie stable delete <id> — Supprime une étable
/ecurie stable setnpc <stable_id> — Lie le NPC Citizens le plus proche (≤5 blocs) à l'étable
/ecurie stable list — Liste toutes les étables
</syntaxhighlight>

=== Boxes ===

<syntaxhighlight lang="text">
/ecurie box list <stable_id> — Liste les boxes d'une étable
/ecurie box delete <box_id> — Supprime une box
/ecurie show [on|off] — Affiche les boxes en surbrillance (particules colorées : vertes=libre, rouges=occupée)
</syntaxhighlight>

Détection : chaque stalle doit contenir un bloc spécifique configuré dans `config.yml` (`box-blocks`). Par défaut :
* `STABLE` / `TERRESTRE` : '''WATER_CAULDRON'''
* `AQUATIQUE` : '''PRISMARINE'''
* `VOLIERE` : '''DAYLIGHT_DETECTOR'''
La commande `stable create` détecte automatiquement tous ces blocs dans la région wand et enregistre les boxes immédiatement.
=== Chevaux ===

<syntaxhighlight lang="text">
/ecurie horse free <horse_id> — Libère un cheval de la DB (urgence admin)
</syntaxhighlight>

=== Divers ===

<syntaxhighlight lang="text">
/ecurie reload — Recharge config.yml et le cache ShowManager
</syntaxhighlight>

---

== Commandes joueurs ==

Permission requise : `ecurie.use` (true par défaut).

<syntaxhighlight lang="text">
/ecurie gui [dialog|inventory] — Change votre type d'interface (persistant via PDC)
</syntaxhighlight>

---

== Workflow admin — Créer une étable ==

=== Étapes ===

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

=== Visualiser les boxes ===

Après création, afficher les boxes avec particules colorées :
<syntaxhighlight lang="text">
/ecurie show on
</syntaxhighlight>
* Particules '''vertes''' = box libre
* Particules '''rouges''' = box occupée

Désactiver l'affichage :
<syntaxhighlight lang="text">
/ecurie show off
</syntaxhighlight>

---

== Workflow joueur — Interagir avec une étable ==

Le joueur interagit via clic droit sur le NPC Citizens de l'étable. Le plugin propose deux types d'interfaces, configurables librement par chaque joueur (la préférence est persistante) :
* '''Dialog (par défaut)''' : Une fenêtre de dialogue textuelle native (Paper 1.21.6+). Immersif et orienté RPG.
* '''Inventory''' : Un inventaire classique sous forme de coffre pour les habitués.

Une GUI s'ouvre avec les actions suivantes :

=== Stocker un cheval ===
1. Amener le cheval à côté ou le monter
2. Cliquer '''Stocker mon cheval''' dans la GUI
3. '''Si le cheval n'a pas de nom custom''' (nom "Horse" ou absent) → une enclume s'ouvre pour nommer le cheval
4. '''Si le cheval a déjà un nom custom''' → stockage direct sans nommage
5. Coût : `price-in` de l'étable en sols

=== Récupérer un cheval ===
1. Cliquer '''Récupérer un cheval'''
2. Choisir le cheval dans la liste
3. Coût : `price-out` de l'étable

=== Transférer ou Rapatrier un cheval ===
Le transfert peut être initié depuis l'écurie de départ ou de destination :
* '''Depuis l'écurie d'origine (Transfert sortant) :''' Cliquer '''Transférer vers...''', sélectionner le cheval, puis choisir l'écurie de destination.
* '''Depuis l'écurie d'arrivée (Rapatriement entrant) :''' Cliquer '''Transférer vers...''', le plugin liste vos chevaux situés dans d'autres étables. Cliquer sur l'un d'eux lance directement le rapatriement vers l'écurie actuelle.
* '''Calcul de distance :''' Le délai de transfert et le coût en écus s'ajustent dynamiquement selon la distance réelle (calculée en blocs 3D) entre les deux étables (délai/coût de base + ajustement par tranche de 100 blocs).

=== Renommer un cheval ===
1. Cliquer '''Renommer un cheval'''
2. Choisir le cheval dans la liste
3. Une enclume s'ouvre pré-remplie avec le nom actuel — modifier ou confirmer
4. Coût : `rename-price` en sols (défaut 50)

=== Mes chevaux ===
Vue globale de tous les chevaux du joueur, toutes étables confondues.

---

== Placeholders (PlaceholderAPI) ==

Requiert PlaceholderAPI installé.

{| class="wikitable"
! Placeholder !! Valeur
|-
| `%ecurie_horses_count%` || Nombre de chevaux en pension du joueur
|-
| `%ecurie_horse_name_<n>%` || Nom du n-ième cheval (1-indexé, trié par nom)
|-
| `%ecurie_horse_stable_<n>%` || Nom de l'étable du n-ième cheval
|-
| `%ecurie_horse_health_<n>%` || Santé (ex : `18.0/20.0`)
|}

---

== Permissions ==

{| class="wikitable"
! Permission !! Description !! Défaut
|-
| `ecurie.admin` || Accès aux commandes d'administration `/ecurie` || op
|-
| `ecurie.use` || Interaction avec les PNJ et `/ecurie gui` || true
|}

---

== Notes techniques ==

* '''Stockage''' : SQLite embarqué (shadowed, pas de dépendance runtime)
* '''Chevaux fantômes''' : entités invulnérables, sans gravité ni IA, représentant le cheval en box. Toute monte ou interaction (inventaire du cheval, etc.) est strictement bloquée pour des raisons de sécurité.
* '''Double étiquette de nom''' : Le nom du cheval (ligne 1, blanc) et le pseudo du propriétaire (ligne 2, gris italique) s'affichent au-dessus du cheval en box grâce à un Armor Stand passager invisible (`Marker`), nettoyé automatiquement lors du despawn.
* '''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 (Dauphin, Calamar MyPet, etc.) ne peuvent aller que dans une écurie de type `AQUATIQUE`. Les familiers volants (Perroquet, Phantom, etc.) dans une `VOLIERE`. Les familiers terrestres dans une `TERRESTRE`.
* '''MyPet''' : Ecurie stocke correctement le `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

---

== Build ==

<syntaxhighlight lang="bash">
./gradlew shadowJar
# Sortie : build/libs/Ecurie-<version>.jar
</syntaxhighlight>

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

---

== Changelog ==

{| class="wikitable"
! 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 cheval 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 ; possibilité d'initier un transfert (rapatriement) depuis l'écurie de destination ; animations de départ et d'arrivée des chevaux avec PNJ montés via pathfinding local ; attribution automatique de nom/skin configurables par défaut pour les NPCs d'écurie lors du setnpc
|-
| 1.1.0 || 2026-06-11 || Support de tous les familiers montables et des MyPet, configuration des prix en jeu depuis config.yml, ajout des types d'écuries (AQUATIQUE, VOLIERE, TERRESTRE) avec blocs de ciblage wand configurables et validations RPG pour le stockage.
|-
| 1.2.0 || 2026-06-11 || Architecture GUI hybride : intégration de l'API native Paper Dialog (1.21.6+) en interface par défaut, et maintien d'InventoryFramework en fallback. Choix laissé aux joueurs via `/ecurie gui [dialog|inventory]` sauvegardé par PDC. Affichage ostensible des tarifs et gestion asynchrone sécurisée.
|}

Plugin:Écurie

2026-06-11T23:17:36Z

Hiob : Page créée avec « # Ecurie <img src="nanobanana-output/Ecurie_logo.png" alt="Ecurie Logo" width="300" /> Plugin PaperMC de gestion des chevaux RP pour le serveur Nefald. Permet aux joueurs de mettre leurs chevaux en pension dans des étables gérées par des NPCs Citizens. Supporte les transferts inter-étables, la tarification en écus (Banco/Vault), et expose des placeholders PlaceholderAPI. --- ## Prérequis | Dépendance | Rôle | Type | |---|--... »

# Ecurie


<img src="nanobanana-output/Ecurie_logo.png" alt="Ecurie Logo" width="300" />


Plugin PaperMC de gestion des chevaux RP pour le serveur Nefald.

Permet aux joueurs de mettre leurs chevaux en pension dans des étables gérées par des NPCs Citizens. Supporte les transferts inter-étables, 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

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

---

## Configuration

### `config.yml`

```yaml
database:
file: "ecurie.db" # Chemin relatif au dossier du plugin

transfer:
base-delay-seconds: 600 # Délai de base pour un transfert (10 min)
delay-per-100-blocks: 30 # Délai additionnel par 100 blocs de distance

routes:
on-road-speed: 0.35 # Vitesse cheval sur route (vanilla ≈ 0.225)
enabled: false # Routes RP (désactivé en V1)

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

### `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 admin

Permission requise : `ecurie.admin` (op par défaut). Alias : `/ec`

### Wand — sélection de région

```
/ecurie wand [on|off]
```

Active/désactive le wand bâton. Clic gauche = point 1, clic droit = point 2. Utilisé pour scanner les boxes d'une étable.

### Étables

```
/ecurie stable create <nom> [type] — Crée l'étable ET scanne automatiquement les boxes. Type: STABLE, TERRESTRE, AQUATIQUE, VOLIERE.
/ecurie stable delete <id> — Supprime une étable
/ecurie stable setnpc <stable_id> — Lie le NPC Citizens le plus proche (≤5 blocs) à l'étable
/ecurie stable list — Liste toutes les étables
```

### Boxes

```
/ecurie box list <stable_id> — Liste les boxes d'une étable
/ecurie box delete <box_id> — Supprime une box
/ecurie show [on|off] — Affiche les boxes en surbrillance (particules colorées : vertes=libre, rouges=occupée)
```

Détection : chaque stalle doit contenir un bloc spécifique configuré dans `config.yml` (`box-blocks`). Par défaut :
- `STABLE` / `TERRESTRE` : **WATER_CAULDRON**
- `AQUATIQUE` : **PRISMARINE**
- `VOLIERE` : **DAYLIGHT_DETECTOR**
La commande `stable create` détecte automatiquement tous ces blocs dans la région wand et enregistre les boxes immédiatement.
### Chevaux

```
/ecurie horse free <horse_id> — Libère un cheval de la DB (urgence admin)
```

### Divers

```
/ecurie reload — Recharge config.yml et le cache ShowManager
```

---

## Commandes joueurs

Permission requise : `ecurie.use` (true par défaut).

```
/ecurie gui [dialog|inventory] — Change votre type d'interface (persistant via PDC)
```

---

## Workflow admin — Créer une étable

### Étapes

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

### 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 NPC Citizens de l'étable. Le plugin propose deux types d'interfaces, configurables librement par chaque joueur (la préférence est persistante) :
- **Dialog (par défaut)** : Une fenêtre de dialogue textuelle native (Paper 1.21.6+). Immersif et orienté RPG.
- **Inventory** : Un inventaire classique sous forme de coffre pour les habitués.

Une GUI s'ouvre avec les actions suivantes :

### Stocker un cheval
1. Amener le cheval à côté ou le monter
2. Cliquer **Stocker mon cheval** dans la GUI
3. **Si le cheval n'a pas de nom custom** (nom "Horse" ou absent) → une enclume s'ouvre pour nommer le cheval
4. **Si le cheval a déjà un nom custom** → stockage direct sans nommage
5. Coût : `price-in` de l'étable en sols

### Récupérer un cheval
1. Cliquer **Récupérer un cheval**
2. Choisir le cheval dans la liste
3. Coût : `price-out` de l'étable

### Transférer ou Rapatrier un cheval
Le transfert peut être initié depuis l'écurie de départ ou de destination :
- **Depuis l'écurie d'origine (Transfert sortant) :** Cliquer **Transférer vers...**, sélectionner le cheval, puis choisir l'écurie de destination.
- **Depuis l'écurie d'arrivée (Rapatriement entrant) :** Cliquer **Transférer vers...**, le plugin liste vos chevaux situés dans d'autres étables. Cliquer sur l'un d'eux lance directement le rapatriement vers l'écurie actuelle.
- **Calcul de distance :** Le délai de transfert et le coût en écus s'ajustent dynamiquement selon la distance réelle (calculée en blocs 3D) entre les deux étables (délai/coût de base + ajustement par tranche de 100 blocs).

### Renommer un cheval
1. Cliquer **Renommer un cheval**
2. Choisir le cheval dans la liste
3. Une enclume s'ouvre pré-remplie avec le nom actuel — modifier ou confirmer
4. Coût : `rename-price` en sols (défaut 50)

### Mes chevaux
Vue globale de tous les chevaux du joueur, toutes étables confondues.

---

## Placeholders (PlaceholderAPI)

Requiert PlaceholderAPI installé.

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

---

## Permissions

| Permission | Description | Défaut |
|---|---|---|
| `ecurie.admin` | Accès aux commandes d'administration `/ecurie` | op |
| `ecurie.use` | Interaction avec les PNJ et `/ecurie gui` | true |

---

## Notes techniques

- **Stockage** : SQLite embarqué (shadowed, pas de dépendance runtime)
- **Chevaux fantômes** : entités invulnérables, sans gravité ni IA, représentant le cheval en box. Toute monte ou interaction (inventaire du cheval, etc.) est strictement bloquée pour des raisons de sécurité.
- **Double étiquette de nom** : Le nom du cheval (ligne 1, blanc) et le pseudo du propriétaire (ligne 2, gris italique) s'affichent au-dessus du cheval en box grâce à un Armor Stand passager invisible (`Marker`), nettoyé automatiquement lors du despawn.
- **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 (Dauphin, Calamar MyPet, etc.) ne peuvent aller que dans une écurie de type `AQUATIQUE`. Les familiers volants (Perroquet, Phantom, etc.) dans une `VOLIERE`. Les familiers terrestres dans une `TERRESTRE`.
- **MyPet** : Ecurie stocke correctement le `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

---

## Build

```bash
./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 cheval 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 ; possibilité d'initier un transfert (rapatriement) depuis l'écurie de destination ; animations de départ et d'arrivée des chevaux avec PNJ montés via pathfinding local ; attribution automatique de nom/skin configurables par défaut pour les NPCs d'écurie lors du setnpc |
| 1.1.0 | 2026-06-11 | Support de tous les familiers montables et des MyPet, configuration des prix en jeu depuis config.yml, ajout des types d'écuries (AQUATIQUE, VOLIERE, TERRESTRE) avec blocs de ciblage wand configurables et validations RPG pour le stockage. |
| 1.2.0 | 2026-06-11 | Architecture GUI hybride : intégration de l'API native Paper Dialog (1.21.6+) en interface par défaut, et maintien d'InventoryFramework en fallback. Choix laissé aux joueurs via `/ecurie gui [dialog|inventory]` sauvegardé par PDC. Affichage ostensible des tarifs et gestion asynchrone sécurisée. |

Grades

2026-06-06T05:49:49Z

Hiob : lien

{{SHORTDESC:Les différents grades jouables dans notre communauté.}}

== Général ==
=== Maraud ===
[[Fichier:Maraud grade.png|right|200px]]
Le grade maraud est le grade par défaut, octroyé à tout visiteur. Ils ne peuvent faire que peu de chose sur notre serveur, mis à part parler et visiter.
{{Article détaillé|Maraud}}

=== Pérégrin ===
[[Fichier:Peregrin grade.png|right|200px]]Les pérégrins sont à la base de la communauté de Nefald, notre serveur ne pourrait pas exister sans eux. Les pérégrins méritants peuvent obtenir la distinction de Contremaître, signalée par un préfixe spécial.

{{Article détaillé|Pérégrin}}

== Construction ==
=== Bâtisseur ===
[[Fichier:Batisseur grade.png|right|200px]]
Plus proches des architectes, chargés de diriger les contremaîtres sur le chantier, les bâtisseurs ont exactement les mêmes accès que leurs ouvriers, à l'exception du gamemode qui leur permet de se donner du matériel de construction. Ils ont accès au GM1 et donc à des ressources illimitées et peuvent voler. 
Ce grade est réservé aux pérégrins ayant fait leurs preuves en construction et gestion de projet. Les bâtisseurs restent sous la direction de l'Architecte.

{{Article détaillé|Bâtisseur}}

=== Architecte ===
[[Fichier:Architecte grade.png|right|200px]]
Les '''Architectes''' sont les grands bâtisseurs du Nefald. Ils ont pour mission de bâtir les grandes villes sur le serveur et d'entretenir les infrastructures existantes. 
Ils dirigent la branche Construction et sont nommés parmi les Bâtisseurs par le Conseil.
Ils ont accès à [[WorldGuard]] et [[WorldEdit]] en leurs entiers, ainsi qu'à nombre d'autres plugins.

{{Article détaillé|Architecte}}

== Animation ==
=== Ménestrel ===
[[Fichier:Menestrel grade.png|right|200px]]
Les ménestrels sont les animateurs de Nefald. Ils peuvent s'orienter en trois activités : 
- L'événementiel : ils créent des évènements pour divertir les joueurs. 
- Le RolePlay : ils créent du contenu RP et des quêtes. 
- Le développement : ils créent du contenu via les scripts et codes. 

Les ménestrels disposent du /broadcast leur permettant de passer des annonces sur le chat. Ils sont la base de l'animation et sont accessibles par candidature.

{{Article détaillé|Ménestrel}}

=== Scribe ===
[[Fichier:Scribe grade.png|right|200px]]
Les Scribes sont les dépositaires de notre histoire au travers de ses légendes. Ils rédigent le RolePlay et organisent des événements en conséquence, coordonnent les ménestrels. 
Ils sont choisis pour leurs connaissances du RP, leurs talents événementiels et leurs capacités à diriger l'équipe.
Ils sont nommés par le Conseil.
{{Article détaillé|Scribe}}

== Modération ==
=== Aspirant ===
[[Fichier:Aspirant grade.png|right|200px]]
Le grade Aspirant est un passage obligatoire dans l'accès au grade Officier. Quiconque souhaite devenir Officier doit d'abord postuler au grade Aspirant et y faire ses preuves.
Les Aspirants guident les marauds et pérégrins, leur permettent de résoudre les problèmes auxquels ils sont confrontés, et modèrent tout comportement indésirable. Ils ont pour cela accès à toutes les commandes nécessaires.

{{Article détaillé|Aspirant}}

=== Officier ===
[[Fichier:Officier grade.png|right|200px]]
Les Officiers sont là pour protéger les joueurs et font figure d'autorité en cas de conflit ou de manquement aux règles.

Ils ont quasiment les mêmes fonctions que les Intendants : venir en aide aux joueurs et protéger le serveur. C'est principalement du maintien de l'ordre. Ils sont les bras droits des Intendants et font respecter les règles de manière impartiale.
Ils peuvent bannir, kicker ou mettre en prison les joueurs.
Ils sont nommés parmi les Aspirants par les Intendants.

{{Article détaillé|Officier}}

== Administration ==
=== Scriptomancien ===
[[Fichier:Scriptomancien grade.png|right|200px]]
Les Scriptomanciens sont les développeurs de Nefald.
Ils ont pour mission l'entretien et la création de plugins pour la communauté. Ils sont aussi aptes à développer des scripts Denizen/Campaign/etc.
Selon leurs connaissances, ils pourront être amenés à participer au bon fonctionnement des sites web et du serveur.
Ils travaillent main dans la main avec les Scribes dans le cercle de l'Animation. Ils sont nommés par le Conseil.
{{Article détaillé|Scriptomancien}}

=== Intendant ===
[[Fichier:Intendant grade.png|right|200px]]
Un dernier grade, et non des moindres, est celui d''''Intendant'''. Les Intendants sont les administrateurs du serveur, ont toutes les capacités en jeu, mais assument surtout la lourde responsabilité de présider le '''Conseil''', réunissant l'ensemble de l'équipe, afin de prendre des décisions concernant l'avenir de la communauté. On ne postule pas pour devenir Intendant : on est nommé par les Intendants eux-mêmes.

{{Article détaillé|Intendant}}

=== Prérequis ===
Tous les grades non membres du Conseil ne peuvent être convoités qu'à la condition d'avoir trois semaines d'ancienneté en tant que pérégrin.

Pour les grades du Conseil, trois mois d'ancienneté minimum sont demandés.

;Cumul des grades
* Il est possible, sur demande particulière d'un membre déjà gradé, d'envisager un cumul de grades dans des branches différentes. (Par exemple, un Aspirant peut demander à rejoindre les rangs des Bâtisseurs.)

== À propos du Conseil ==
;Sont uniquement considérés comme faisant partie du Conseil :
Les [[Scribe]]s, les [[Scriptomancien]]s, les [[Officier]]s, les [[Architecte]]s et les [[Intendant]]s. Ces grades ne sont accessibles que sur nomination des Intendants.
C'est en priorité à eux que vous devrez vous adresser en cas de besoin, faisant autorité.

Devenir membre du Conseil sur Nefald, c'est (presque) comme rentrer en religion ; on devient membre dans le seul et unique but de servir la communauté sur quatre points distincts : '''l'animation''', '''la construction''', '''la modération''' et '''l'administration'''.
 À chacun son rôle et ses spécificités. Nous attendrons d'un Officier calme et impartialité, d'un Scribe et d'un Scriptomancien une créativité à toute épreuve, d'un Architecte un talent certain pour la construction et d'un Intendant une réflexion claire et une certaine objectivité.

=== L'Agora ===
D'autres grades, sans faire partie du Conseil, font figure de relais entre celui-ci et les autres joueurs. Ils sont régulièrement consultés lors des prises de décision.

Les grades ayant ces qualités sont ceux de [[Bâtisseur]], de [[Ménestrel]] et d'[[Aspirant]].

{{#mermaid:flowchart TD
%% --- Base ---
subgraph Base
Maraud["Maraud"]
Pelerin["Pérégrin"]
Maraud --> Pelerin
Pelerin -. distinction .-> Contremaitre["Contremaître ✦"]
end

%% --- Branches ---
subgraph Construction
Batisseur["Bâtisseur"] --> Architecte["Architecte"]
end

subgraph Animation
Menestrel["Ménestrel"] --> Scribe["Scribe"]
Menestrel -. nomination .-> Scriptomancien["Scriptomancien"]
end

subgraph Moderation["Modération"]
Aspirant["Aspirant"] --> Officier["Officier"]
end

subgraph Administration
Intendant["Intendant"]
end

%% --- Entrées en branches depuis Pérégrin ---
Pelerin --> Batisseur
Pelerin --> Menestrel
Pelerin --> Aspirant

%% --- Nominations vers l'Administration ---
Scribe -. nomination .-> Intendant
Scriptomancien -. nomination .-> Intendant
Architecte -. nomination .-> Intendant
Officier -. nomination .-> Intendant

%% --- Styles ---
classDef council fill:#d1f7c4,stroke:#2b8a3e,stroke-width:1px,color:#0b3d1b;
classDef agora fill:#fff3bf,stroke:#f59f00,stroke-width:1px,color:#7a4b00;
classDef base fill:#e7f5ff,stroke:#1c7ed6,stroke-width:1px,color:#0b2e59;

class Scribe,Scriptomancien,Architecte,Officier,Intendant council;
class Menestrel,Batisseur,Aspirant agora;
class Maraud,Pelerin,Contremaitre base;

subgraph Legende[ ]
leg1[Conseil]:::council
leg2[Agora — relais]:::agora
leg3[Grades de base]:::base
end
}}
<noinclude>
[[Catégorie:Édit de l'Intendance]]
[[Catégorie:Guide]]
[[Catégorie:Grade]]</noinclude>

Grades

2026-06-05T21:22:35Z

Hiob : Réorganisation grades : Contremaître en distinction, Scriptomancien → Administration (via update-page on MediaWiki MCP Server)

{{SHORTDESC:Les différents grades jouables dans notre communauté.}}

== Général ==
=== Maraud ===
[[Fichier:Maraud grade.png|right|200px]]
Le grade maraud est le grade par défaut, octroyé à tout visiteur. Ils ne peuvent faire que peu de chose sur notre serveur, mis à part parler et visiter.
{{Article détaillé|[[Maraud]]}}

=== Pérégrin ===
[[Fichier:Peregrin grade.png|right|200px]]Les pérégrins sont à la base de la communauté de Nefald, notre serveur ne pourrait pas exister sans eux. Les pérégrins méritants peuvent obtenir la distinction de Contremaître, signalée par un préfixe spécial.

{{Article détaillé|[[Pérégrin]]}}

== Construction ==
=== Bâtisseur ===
[[Fichier:Batisseur grade.png|right|200px]]
Plus proches des architectes, chargés de diriger les contremaîtres sur le chantier, les bâtisseurs ont exactement les mêmes accès que leurs ouvriers, à l'exception du gamemode qui leur permet de se donner du matériel de construction. Ils ont accès au GM1 et donc à des ressources illimitées et peuvent voler. 
Ce grade est réservé aux pérégrins ayant fait leurs preuves en construction et gestion de projet. Les bâtisseurs restent sous la direction de l'Architecte.

{{Article détaillé|[[Bâtisseur]]}}

=== Architecte ===
[[Fichier:Architecte grade.png|right|200px]]
Les '''Architectes''' sont les grands bâtisseurs du Nefald. Ils ont pour mission de bâtir les grandes villes sur le serveur et d'entretenir les infrastructures existantes. 
Ils dirigent la branche Construction et sont nommés parmi les Bâtisseurs par le Conseil.
Ils ont accès à [[WorldGuard]] et [[WorldEdit]] en leurs entiers, ainsi qu'à nombre d'autres plugins.

{{Article détaillé|[[Architecte]]}}

== Animation ==
=== Ménestrel ===
[[Fichier:Menestrel grade.png|right|200px]]
Les ménestrels sont les animateurs de Nefald. Ils peuvent s'orienter en trois activités : 
- L'événementiel : ils créent des évènements pour divertir les joueurs. 
- Le RolePlay : ils créent du contenu RP et des quêtes. 
- Le développement : ils créent du contenu via les scripts et codes. 

Les ménestrels disposent du /broadcast leur permettant de passer des annonces sur le chat. Ils sont la base de l'animation et sont accessibles par candidature.

{{Article détaillé|[[Ménestrel]]}}

=== Scribe ===
[[Fichier:Scribe grade.png|right|200px]]
Les Scribes sont les dépositaires de notre histoire au travers de ses légendes. Ils rédigent le RolePlay et organisent des événements en conséquence, coordonnent les ménestrels. 
Ils sont choisis pour leurs connaissances du RP, leurs talents événementiels et leurs capacités à diriger l'équipe.
Ils sont nommés par le Conseil.
{{Article détaillé|[[Scribe]]}}

== Modération ==
=== Aspirant ===
[[Fichier:Aspirant grade.png|right|200px]]
Le grade Aspirant est un passage obligatoire dans l'accès au grade Officier. Quiconque souhaite devenir Officier doit d'abord postuler au grade Aspirant et y faire ses preuves.
Les Aspirants guident les marauds et pérégrins, leur permettent de résoudre les problèmes auxquels ils sont confrontés, et modèrent tout comportement indésirable. Ils ont pour cela accès à toutes les commandes nécessaires.

{{Article détaillé|[[Aspirant]]}}

=== Officier ===
[[Fichier:Officier grade.png|right|200px]]
Les Officiers sont là pour protéger les joueurs et font figure d'autorité en cas de conflit ou de manquement aux règles.

Ils ont quasiment les mêmes fonctions que les Intendants : venir en aide aux joueurs et protéger le serveur. C'est principalement du maintien de l'ordre. Ils sont les bras droits des Intendants et font respecter les règles de manière impartiale.
Ils peuvent bannir, kicker ou mettre en prison les joueurs.
Ils sont nommés parmi les Aspirants par les Intendants.

{{Article détaillé|[[Officier]]}}

== Administration ==
=== Scriptomancien ===
[[Fichier:Scriptomancien grade.png|right|200px]]
Les Scriptomanciens sont les développeurs de Nefald.
Ils ont pour mission l'entretien et la création de plugins pour la communauté. Ils sont aussi aptes à développer des scripts Denizen/Campaign/etc.
Selon leurs connaissances, ils pourront être amenés à participer au bon fonctionnement des sites web et du serveur.
Ils travaillent main dans la main avec les Scribes dans le cercle de l'Animation. Ils sont nommés par le Conseil.
{{Article détaillé|[[Scriptomancien]]}}

=== Intendant ===
[[Fichier:Intendant grade.png|right|200px]]
Un dernier grade, et non des moindres, est celui d''''Intendant'''. Les Intendants sont les administrateurs du serveur, ont toutes les capacités en jeu, mais assument surtout la lourde responsabilité de présider le '''Conseil''', réunissant l'ensemble de l'équipe, afin de prendre des décisions concernant l'avenir de la communauté. On ne postule pas pour devenir Intendant : on est nommé par les Intendants eux-mêmes.

{{Article détaillé|[[Intendant]]}}

=== Prérequis ===
Tous les grades non membres du Conseil ne peuvent être convoités qu'à la condition d'avoir trois semaines d'ancienneté en tant que pérégrin.

Pour les grades du Conseil, trois mois d'ancienneté minimum sont demandés.

;Cumul des grades
* Il est possible, sur demande particulière d'un membre déjà gradé, d'envisager un cumul de grades dans des branches différentes. (Par exemple, un Aspirant peut demander à rejoindre les rangs des Bâtisseurs.)

== À propos du Conseil ==
;Sont uniquement considérés comme faisant partie du Conseil :
Les [[Scribe]]s, les [[Scriptomancien]]s, les [[Officier]]s, les [[Architecte]]s et les [[Intendant]]s. Ces grades ne sont accessibles que sur nomination des Intendants.
C'est en priorité à eux que vous devrez vous adresser en cas de besoin, faisant autorité.

Devenir membre du Conseil sur Nefald, c'est (presque) comme rentrer en religion ; on devient membre dans le seul et unique but de servir la communauté sur quatre points distincts : '''l'animation''', '''la construction''', '''la modération''' et '''l'administration'''.
 À chacun son rôle et ses spécificités. Nous attendrons d'un Officier calme et impartialité, d'un Scribe et d'un Scriptomancien une créativité à toute épreuve, d'un Architecte un talent certain pour la construction et d'un Intendant une réflexion claire et une certaine objectivité.

=== L'Agora ===
D'autres grades, sans faire partie du Conseil, font figure de relais entre celui-ci et les autres joueurs. Ils sont régulièrement consultés lors des prises de décision.

Les grades ayant ces qualités sont ceux de [[Bâtisseur]], de [[Ménestrel]] et d'[[Aspirant]].

{{#mermaid:flowchart TD
%% --- Base ---
subgraph Base
Maraud["Maraud"]
Pelerin["Pérégrin"]
Maraud --> Pelerin
Pelerin -. distinction .-> Contremaitre["Contremaître ✦"]
end

%% --- Branches ---
subgraph Construction
Batisseur["Bâtisseur"] --> Architecte["Architecte"]
end

subgraph Animation
Menestrel["Ménestrel"] --> Scribe["Scribe"]
Menestrel -. nomination .-> Scriptomancien["Scriptomancien"]
end

subgraph Moderation["Modération"]
Aspirant["Aspirant"] --> Officier["Officier"]
end

subgraph Administration
Intendant["Intendant"]
end

%% --- Entrées en branches depuis Pérégrin ---
Pelerin --> Batisseur
Pelerin --> Menestrel
Pelerin --> Aspirant

%% --- Nominations vers l'Administration ---
Scribe -. nomination .-> Intendant
Scriptomancien -. nomination .-> Intendant
Architecte -. nomination .-> Intendant
Officier -. nomination .-> Intendant

%% --- Styles ---
classDef council fill:#d1f7c4,stroke:#2b8a3e,stroke-width:1px,color:#0b3d1b;
classDef agora fill:#fff3bf,stroke:#f59f00,stroke-width:1px,color:#7a4b00;
classDef base fill:#e7f5ff,stroke:#1c7ed6,stroke-width:1px,color:#0b2e59;

class Scribe,Scriptomancien,Architecte,Officier,Intendant council;
class Menestrel,Batisseur,Aspirant agora;
class Maraud,Pelerin,Contremaitre base;

subgraph Legende[ ]
leg1[Conseil]:::council
leg2[Agora — relais]:::agora
leg3[Grades de base]:::base
end
}}
<noinclude>
[[Catégorie:Édit de l'Intendance]]
[[Catégorie:Guide]]
[[Catégorie:Grade]]</noinclude>

Grades

2026-06-02T21:12:34Z

Hiob : Simplification : suppression Machiniste (incomplet), Contremaître reclassé en distinction optionnelle, candidatures archivées (via update-page on MediaWiki MCP Server)

{{SHORTDESC:Les différents grades jouables dans notre communauté.}}

== Général ==
=== Maraud ===
[[Fichier:Maraud grade.png|right|200px]]
Le grade maraud est le grade par défaut, octroyé à tout visiteur. Ils ne peuvent faire que peu de chose sur notre serveur, mis à part parler et visiter.
{{Article détaillé|[[Maraud]]}}

=== Pérégrin ===
[[Fichier:Peregrin grade.png|right|200px]]Les pérégrins sont à la base de la communauté de Nefald, notre serveur ne pourrait pas exister sans eux.

{{Article détaillé|[[Pérégrin]]}}

=== Contremaître ===
[[Fichier:Contremaitre grade.png|right|200px]]
Le Contremaître n'est pas un grade de branche à proprement parler, mais une distinction accordée à des pérégrins prometteurs. Elle donne accès à la boussole magique (téléportation) et signale un engagement sérieux dans la Construction ou l'Animation. L'entrée dans une branche reste ouverte à tout pérégrin ; le titre de Contremaître est un signe de confiance supplémentaire, pas un prérequis.
{{Article détaillé|[[Contremaître]]}}

== Construction ==
=== Bâtisseur ===
[[Fichier:Batisseur grade.png|right|200px]]
Plus proches des architectes, chargés de diriger les contremaîtres sur le chantier, les bâtisseurs ont exactement les mêmes accès que leurs ouvriers, à l'exception du gamemode qui leur permet de se donner du matériel de construction. Ils ont accès au GM1 et donc à des ressources illimitées et peuvent voler. 
Ce grade est réservé aux pérégrins ayant fait leurs preuves en construction et gestion de projet. Les bâtisseurs restent sous la direction de l'Architecte.

{{Article détaillé|[[Bâtisseur]]}}

=== Architecte ===
[[Fichier:Architecte grade.png|right|200px]]
Les '''Architectes''' sont les grands bâtisseurs du Nefald. Ils ont pour mission de bâtir les grandes villes sur le serveur et d'entretenir les infrastructures existantes. 
Ils dirigent la branche Construction et sont nommés parmi les Bâtisseurs par le Conseil.
Ils ont accès à [[WorldGuard]] et [[WorldEdit]] en leurs entiers, ainsi qu'à nombre d'autres plugins.

{{Article détaillé|[[Architecte]]}}

== Animation ==
=== Ménestrel ===
[[Fichier:Menestrel grade.png|right|200px]]
Les ménestrels sont les animateurs de Nefald. Ils peuvent s'orienter en trois activités : 
- L'événementiel : ils créent des évènements pour divertir les joueurs. 
- Le RolePlay : ils créent du contenu RP et des quêtes. 
- Le développement : ils créent du contenu via les scripts et codes. 

Les ménestrels disposent du /broadcast leur permettant de passer des annonces sur le chat. Ils sont la base de l'animation et sont accessibles par candidature.

{{Article détaillé|[[Ménestrel]]}}

=== Scribe ===
[[Fichier:Scribe grade.png|right|200px]]
Les Scribes sont les dépositaires de notre histoire au travers de ses légendes. Ils rédigent le RolePlay et organisent des événements en conséquence, coordonnent les ménestrels. 
Ils sont choisis pour leurs connaissances du RP, leurs talents événementiels et leurs capacités à diriger l'équipe.
Ils sont nommés par le Conseil.
{{Article détaillé|[[Scribe]]}}

=== Scriptomancien ===
[[Fichier:Scriptomancien grade.png|right|200px]]
Les Scriptomanciens sont les développeurs de Nefald.
Ils ont pour mission l'entretien et la création de plugins pour la communauté. Ils sont aussi aptes à développer des scripts Denizen/Campaign/etc.
Selon leurs connaissances, ils pourront être amenés à participer au bon fonctionnement des sites web et du serveur.
Ils travaillent main dans la main avec les Scribes dans le cercle de l'Animation. Ils sont nommés par le Conseil.
{{Article détaillé|[[Scriptomancien]]}}

== Modération ==
=== Aspirant ===
[[Fichier:Aspirant grade.png|right|200px]]
Le grade Aspirant est un passage obligatoire dans l'accès au grade Officier. Quiconque souhaite devenir Officier doit d'abord postuler au grade Aspirant et y faire ses preuves.
Les Aspirants guident les marauds et pérégrins, leur permettent de résoudre les problèmes auxquels ils sont confrontés, et modèrent tout comportement indésirable. Ils ont pour cela accès à toutes les commandes nécessaires.

{{Article détaillé|[[Aspirant]]}}

=== Officier ===
[[Fichier:Officier grade.png|right|200px]]
Les Officiers sont là pour protéger les joueurs et font figure d'autorité en cas de conflit ou de manquement aux règles.

Ils ont quasiment les mêmes fonctions que les Intendants : venir en aide aux joueurs et protéger le serveur. C'est principalement du maintien de l'ordre. Ils sont les bras droits des Intendants et font respecter les règles de manière impartiale.
Ils peuvent bannir, kicker ou mettre en prison les joueurs.
Ils sont nommés parmi les Aspirants par les Intendants.

{{Article détaillé|[[Officier]]}}

== Administration ==
=== Intendant ===
[[Fichier:Intendant grade.png|right|200px]]
Un dernier grade, et non des moindres, est celui d''''Intendant'''. Les Intendants sont les administrateurs du serveur, ont toutes les capacités en jeu, mais assument surtout la lourde responsabilité de présider le '''Conseil''', réunissant l'ensemble de l'équipe, afin de prendre des décisions concernant l'avenir de la communauté. On ne postule pas pour devenir Intendant : on est nommé par les Intendants eux-mêmes.

{{Article détaillé|[[Intendant]]}}

=== Prérequis ===
Tous les grades non membres du Conseil ne peuvent être convoités qu'à la condition d'avoir trois semaines d'ancienneté en tant que pérégrin.

Pour les grades du Conseil, trois mois d'ancienneté minimum sont demandés.

;Cumul des grades
* Il est possible, sur demande particulière d'un membre déjà gradé, d'envisager un cumul de grades dans des branches différentes. (Par exemple, un Aspirant peut demander à rejoindre les rangs des Bâtisseurs.)

== À propos du Conseil ==
;Sont uniquement considérés comme faisant partie du Conseil :
Les [[Scribe]]s, les [[Scriptomancien]]s, les [[Officier]]s, les [[Architecte]]s et les [[Intendant]]s. Ces grades ne sont accessibles que sur nomination des Intendants.
C'est en priorité à eux que vous devrez vous adresser en cas de besoin, faisant autorité.

Devenir membre du Conseil sur Nefald, c'est (presque) comme rentrer en religion ; on devient membre dans le seul et unique but de servir la communauté sur quatre points distincts : '''l'animation''', '''la construction''', '''la modération''' et '''l'administration'''.
 À chacun son rôle et ses spécificités. Nous attendrons d'un Officier calme et impartialité, d'un Scribe et d'un Scriptomancien une créativité à toute épreuve, d'un Architecte un talent certain pour la construction et d'un Intendant une réflexion claire et une certaine objectivité.

=== L'Agora ===
D'autres grades, sans faire partie du Conseil, font figure de relais entre celui-ci et les autres joueurs. Ils sont régulièrement consultés lors des prises de décision.

Les grades ayant ces qualités sont ceux de [[Bâtisseur]], de [[Ménestrel]] et d'[[Aspirant]].

{{#mermaid:flowchart TD
%% --- Base ---
subgraph Base
Maraud["Maraud"]
Pelerin["Pérégrin"]
Maraud --> Pelerin
Pelerin -. distinction .-> Contremaitre["Contremaître ✦"]
end

%% --- Branches ---
subgraph Construction
Batisseur["Bâtisseur"] --> Architecte["Architecte"]
end

subgraph Animation
Menestrel["Ménestrel"] --> Scribe["Scribe"]
Menestrel -. nomination .-> Scriptomancien["Scriptomancien"]
end

subgraph Moderation["Modération"]
Aspirant["Aspirant"] --> Officier["Officier"]
end

subgraph Administration
Intendant["Intendant"]
end

%% --- Entrées en branches depuis Pérégrin ---
Pelerin --> Batisseur
Pelerin --> Menestrel
Pelerin --> Aspirant

%% --- Nominations vers l'Administration ---
Scribe -. nomination .-> Intendant
Scriptomancien -. nomination .-> Intendant
Architecte -. nomination .-> Intendant
Officier -. nomination .-> Intendant

%% --- Styles ---
classDef council fill:#d1f7c4,stroke:#2b8a3e,stroke-width:1px,color:#0b3d1b;
classDef agora fill:#fff3bf,stroke:#f59f00,stroke-width:1px,color:#7a4b00;
classDef base fill:#e7f5ff,stroke:#1c7ed6,stroke-width:1px,color:#0b2e59;

class Scribe,Scriptomancien,Architecte,Officier,Intendant council;
class Menestrel,Batisseur,Aspirant agora;
class Maraud,Pelerin,Contremaitre base;

subgraph Legende[ ]
leg1[Conseil]:::council
leg2[Agora — relais]:::agora
leg3[Grades de base]:::base
end
}}
<noinclude>
[[Catégorie:Édit de l'Intendance]]
[[Catégorie:Guide]]
[[Catégorie:Grade]]</noinclude>

Plugin:DiscordBridge/Lands

2026-04-04T08:55:44Z

Hiob : channel discord

== Lands ==

=== Créer un salon Discord pour sa Land ===

Les '''propriétaires d'une Land ou d'une Nation''' peuvent créer un salon textuel et vocal dédié directement dans le serveur Discord.

==== Conditions requises ====

* Être propriétaire ou disposer des droits sur une Land / Nation.
* Avoir son compte Minecraft lié à son compte Discord — voir [[#Lier son compte Discord|Lier son compte Discord]].
* Se rendre dans {{Discord|id=1489710188666814564|nom=lands}} et exécutez les commandes ci-dessous.

==== Commandes Discord ====

{| class="wikitable"
! Commande Discord !! Description
|-
| <code>/lands channel create</code> || Crée un salon Discord pour la Land
|-
| <code>/nations channel create</code> || Crée un salon Discord pour la Nation
|}

{{Bandeau|type=info|Les salons sont créés dans la catégorie définie par les administrateurs, Lands. Seuls les membres du Land qui ont liés leur compte Minecraft > Discord, peuvent y accéder.
Les Ops du serveur Discord ont accès à tous les salons. }}

Plugin:DiscordBridge

2026-04-04T08:50:47Z

Hiob : compatibilité

{{SHORTDESC:Plugin d'intégration entre Minecraft et Discord}}

{{Infobox Plugin
| nom = DiscordBridge
| image = Plugin_without_Logo.png
| type = Utilitaire
| dev = incredibleplugins
| docs = https://wiki.incredibleplugins.com/discordbridge
| sources =
| grade =
| status = installé
| compatibilité = [[Lands]], [[LuckPerms]]
}}

'''DiscordBridge''' est un plugin d'intégration entre le serveur Minecraft et le serveur Discord.
Il relie les deux plateformes en offrant la synchronisation du chat, la liaison de comptes,
la gestion de tickets, les notifications d'événements et l'intégration avec le plugin [[Lands]].

== Pour tous les joueurs ==
==== Commandes en jeu ====
{{Plugin:DiscordBridge/Commandes}}
{{Plugin:DiscordBridge/Lier_son_compte}}
{{Plugin:DiscordBridge/Lands}}

== Pour les administrateurs ==

=== Installation et configuration du bot ===

==== Prérequis ====

# Créer une application Discord sur le [https://discord.com/developers/applications Portail Développeur Discord].
# Activer les '''Intents''' suivants dans l'onglet ''Bot'' :
#* '''Server Members Intent'''
#* '''Message Content Intent'''
# Lors de l'invitation du bot, les '''scopes requis''' sont :
#* <code>applications.commands</code>
#* <code>bot</code>
# Le bot doit disposer des permissions Discord suivantes :
#* Gérer les salons
#* Gérer les webhooks
#* Lire les messages / Voir les salons
#* Envoyer des messages
#* Gérer les messages
#* Intégrer des liens
#* Joindre des fichiers
#* Voir l'historique des messages
#* Ajouter des réactions
# Copier le '''token du bot''' et le coller dans <code>DiscordBridge/Modules/bot.yml</code> à l'option <code>token</code>.

=== Configuration des modules ===

==== Module Chat ====

Synchronise le chat in-game vers Discord et inversement.

{| class="wikitable"
! Commande Discord !! Description
|-
| <code>/config set CHAT_CHANNEL</code> || Définit le salon Discord recevant les messages du chat in-game
|}

{{Bandeau|type=warning|Le compte Minecraft doit être lié à Discord pour que les messages se synchronisent.}}

==== Module Events ====

Envoie des messages dans Discord lors d'événements sur le serveur (connexion, déconnexion, mort, etc.).

* La configuration se fait dans : <code>DiscordBridge/Modules/events.yml</code>
* Chaque événement peut être désactivé individuellement dans ce fichier.

==== Module Lands ====

Intègre DiscordBridge avec le plugin [[Lands]] pour les annonces et les salons de Land/Nation.

{| class="wikitable"
! Commande Discord !! Description
|-
| <code>/config set LANDS_CHAT_CATEGORY</code> || (Optionnel) Catégorie Discord où seront créés les salons de Land/Nation
|-
| <code>/config set LANDS_BROADCAST_CHANNEL</code> || (Optionnel) Salon Discord pour les annonces Lands (guerres, suppressions, etc.)
|-
| <code>/config set LANDS_NOTIFY_<broadcast_category></code> || Configure les rôles notifiés pour chaque catégorie d'annonce
|}

{{Bandeau|type=warning|Le compte Minecraft doit être lié à Discord pour pouvoir créer un salon Lands.}}
{{Bandeau|type=info|Remplacer <code><broadcast_category></code> par la catégorie souhaitée (ex : <code>WAR</code>, <code>DELETE</code>…).}}

==== Module Linking ====

Gère la liaison entre comptes Minecraft et Discord.

{{Bandeau|type=warning|Les synchronisations ne fonctionnent que dans un seul sens selon le paramètre configuré.}}

===== Sens de synchronisation =====

{| class="wikitable"
! Paramètre !! Sens !! Effet
|-
| <code>linking_roles add</code> || Minecraft → Discord || Le joueur reçoit un '''rôle Discord''' automatiquement lorsqu'il lie son compte
|-
| <code>linking_groups add</code> || Discord → Minecraft || Le joueur reçoit un '''groupe LuckPerms''' in-game selon son rôle Discord au moment de la liaison
|}

{{Bandeau|type=warning|Ces deux paramètres sont indépendants. Les configurer simultanément peut créer des '''boucles logiques involontaires''' ou des attributions redondantes. Il est recommandé de n'en utiliser qu'un seul selon l'architecture choisie.}}

=== Architecture recommandée ===

{| class="wikitable"
! Cas d'usage !! Paramètre à utiliser !! Paramètre à éviter
|-
| Gérer les grades depuis Discord || <code>linking_groups add</code> || <code>linking_roles add</code>
|-
| Donner un badge Discord aux joueurs liés || <code>linking_roles add</code> || <code>linking_groups add</code>
|-
| Synchronisation complète bidirectionnelle || Non supporté nativement || —
|}

{{Bandeau|type=warning|DiscordBridge ne supporte pas la synchronisation bidirectionnelle native. Utiliser les deux paramètres simultanément est possible mais doit être fait consciemment pour éviter les conflits de permissions.}}

===== Commande in-game (administration) =====

{| class="wikitable"
! Commande !! Description !! Permission
|-
| <code>/discordbridge account admin migrate</code> || Migre les liaisons existantes depuis un autre plugin || <code>discordbridge.admin.command.account.admin.migrate</code>
|}

{{bandeau|type=info|Lors de l'ajout d'un rôle ou d'un groupe, les joueurs déjà liés le reçoivent automatiquement. La mise à jour est planifiée pour éviter toute surcharge sur les grands serveurs.}}

==== Module Tickets ====

Permet aux membres Discord de créer des tickets de support directement depuis le serveur Discord.

===== Configuration requise =====

{| class="wikitable"
! Commande Discord !! Description
|-
| <code>/config set tickets_category_closed</code> || Catégorie où sont déplacés les tickets fermés avant suppression
|-
| <code>/config set tickets_member_max_tickets</code> || Nombre maximum de tickets simultanés par utilisateur
|-
| <code>/config set tickets_role_support</code> || Rôle Discord pouvant voir et gérer tous les tickets
|-
| <code>/config set tickets_deletion_time</code> || Délai avant suppression d'un ticket fermé (ex : <code>1d</code>, <code>12h</code>)
|-
| <code>/config set tickets_remind_submitter</code> || Active ou désactive le rappel automatique au créateur (<code>true</code> / <code>false</code>)
|-
| <code>/config set tickets_staff_unavailable</code> || Message affiché si aucun staff n'est disponible (nécessite <code>tickets_role_support</code>)
|-
| <code>/config set tickets_creation_channel</code> || Salon Discord où le message de création de ticket sera posté
|-
| <code>/config type upsert</code> || Créer ou mettre à jour un type de ticket
|-
| <code>/config field upsert</code> || Créer ou mettre à jour les champs d'un type de ticket
|-
| <code>/config info create</code> || (Optionnel) Prédéfinir des informations demandées après création du ticket
|-
| <code>/config reason create</code> || (Optionnel) Prédéfinir des raisons de fermeture de ticket
|}

{{Bandeau|type=info|Pour effacer une valeur de configuration, exécuter <code>/config set <option></code> sans préciser de valeur.}}

=== Commandes d'administration générales ===

{| class="wikitable"
! Commande !! Description !! Permission
|-
| <code>/discordbridge admin</code> || Accès aux commandes d'administration || <code>discordbridge.admin.command</code>
|-
| <code>/discordbridge admin reload</code> || Recharge la configuration du plugin || <code>discordbridge.admin.command.reload</code>
|}

{{Bandeau|type=info|Toutes les sous-commandes de <code>/discordbridge admin</code> suivent le format de permission : <code>discordbridge.admin.command.<souscommande></code>}}

=== Placeholders PlaceholderAPI ===

Ces placeholders nécessitent l'installation de [[PlaceholderAPI]].

{| class="wikitable"
! Placeholder !! Description
|-
| <code>%discordbridge_module_linking_amount%</code> || Nombre de joueurs ayant lié leur compte
|-
| <code>%discordbridge_module_linking_user_state_bool%</code> || <code>true</code> si le joueur a lié son compte, sinon <code>false</code>
|-
| <code>%discordbridge_module_linking_user_state%</code> || État de liaison (texte traduit depuis le fichier de locale)
|-
| <code>%discordbridge_module_linking_user_id%</code> || ID Discord de l'utilisateur lié
|-
| <code>%discordbridge_module_linking_user_name%</code> || Pseudo Discord de l'utilisateur lié
|-
| <code>%discordbridge_module_linking_user_booster%</code> || Indique si le joueur booste un serveur Discord du bot (texte)
|-
| <code>%discordbridge_module_linking_user_booster_bool%</code> || <code>true</code> si le joueur booste un serveur Discord du bot
|}

== Fichiers de configuration ==

{| class="wikitable"
! Fichier !! Rôle
|-
| <code>DiscordBridge/Modules/bot.yml</code> || Configuration principale du bot (token, URL d'invitation, etc.)
|-
| <code>DiscordBridge/Modules/events.yml</code> || Activation et désactivation des événements envoyés sur Discord
|-
| <code>DiscordBridge/Modules/chat.yml</code> || Configuration du module chat
|-
| <code>DiscordBridge/Modules/linking.yml</code> || Configuration du module de liaison de comptes
|-
| <code>DiscordBridge/Modules/lands.yml</code> || Configuration du module Lands
|-
| <code>DiscordBridge/Modules/tickets.yml</code> || Configuration du module Tickets
|}

== Voir aussi ==

* [[Lands]] — Plugin de gestion de territoires
* [[LuckPerms]] — Gestion des permissions et groupes
* [[PlaceholderAPI]] — Placeholders dynamiques
* [https://wiki.incredibleplugins.com/discordbridge Documentation officielle DiscordBridge]

Plugin:DiscordBridge/Lands

2026-04-04T08:49:19Z

Hiob :

== Lands ==

=== Créer un salon Discord pour sa Land ===

Les '''propriétaires d'une Land ou d'une Nation''' peuvent créer un salon textuel et vocal dédié directement dans le serveur Discord.

==== Conditions requises ====

* Être propriétaire ou disposer des droits sur une Land / Nation.
* Avoir son compte Minecraft lié à son compte Discord — voir [[#Lier son compte Discord|Lier son compte Discord]].

==== Commandes Discord ====

{| class="wikitable"
! Commande Discord !! Description
|-
| <code>/lands channel create</code> || Crée un salon Discord pour la Land
|-
| <code>/nations channel create</code> || Crée un salon Discord pour la Nation
|}

{{Bandeau|type=info|Les salons sont créés dans la catégorie définie par les administrateurs, Lands. Seuls les membres du Land qui ont liés leur compte Minecraft > Discord, peuvent y accéder.
Les Ops du serveur Discord ont accès à tous les salons. }}

Plugin:DiscordBridge/Lier son compte

2026-04-04T08:37:59Z

Hiob : lien discord

=== Lier son compte Discord ===

La liaison entre votre compte Minecraft et Discord permet une synchronisation automatique des rôles.
Sur Nefald, la synchronisation se fait dans le sens '''Discord → Minecraft''' : les rôles Discord déterminent les groupes attribués en jeu.

{{Bandeau|type=info|En cas de changement de pseudo ou de rôle sur Discord, la synchronisation n'est pas immédiate — elle s'effectue automatiquement de façon planifiée.}}

==== Étapes ====

# Connectez-vous au serveur Minecraft.
# Exécutez la commande <code>/discordbridge account link</code> en jeu.
# Suivez les instructions affichées dans le chat : un code et une commande Discord vous seront fournis.
# Sur {{Discord|id=1398359022951858196|nom=account-linking}}, envoyez la commande indiquée au bot pour finaliser la liaison.
# Vos rôles Discord et groupes en jeu sont alors attribués automatiquement.

DiscordBridge

2026-04-04T08:03:08Z

Hiob : Page redirigée vers Plugin:DiscordBridge

#REDIRECTION [[Plugin:DiscordBridge]]

__AUCUNSOMMAIRE__

Plugin:DiscordBridge

2026-04-04T08:01:49Z

Hiob : transclusion

{{SHORTDESC:Plugin d'intégration entre Minecraft et Discord}}

{{Infobox Plugin
| nom = DiscordBridge
| image = Plugin_without_Logo.png
| type = Utilitaire
| dev = incredibleplugins
| docs = https://wiki.incredibleplugins.com/discordbridge
| sources =
| grade =
| status = installé
}}

'''DiscordBridge''' est un plugin d'intégration entre le serveur Minecraft et le serveur Discord.
Il relie les deux plateformes en offrant la synchronisation du chat, la liaison de comptes,
la gestion de tickets, les notifications d'événements et l'intégration avec le plugin [[Lands]].

== Pour tous les joueurs ==
==== Commandes en jeu ====
{{Plugin:DiscordBridge/Commandes}}
{{Plugin:DiscordBridge/Lier_son_compte}}
{{Plugin:DiscordBridge/Lands}}

== Pour les administrateurs ==

=== Installation et configuration du bot ===

==== Prérequis ====

# Créer une application Discord sur le [https://discord.com/developers/applications Portail Développeur Discord].
# Activer les '''Intents''' suivants dans l'onglet ''Bot'' :
#* '''Server Members Intent'''
#* '''Message Content Intent'''
# Lors de l'invitation du bot, les '''scopes requis''' sont :
#* <code>applications.commands</code>
#* <code>bot</code>
# Le bot doit disposer des permissions Discord suivantes :
#* Gérer les salons
#* Gérer les webhooks
#* Lire les messages / Voir les salons
#* Envoyer des messages
#* Gérer les messages
#* Intégrer des liens
#* Joindre des fichiers
#* Voir l'historique des messages
#* Ajouter des réactions
# Copier le '''token du bot''' et le coller dans <code>DiscordBridge/Modules/bot.yml</code> à l'option <code>token</code>.

=== Configuration des modules ===

==== Module Chat ====

Synchronise le chat in-game vers Discord et inversement.

{| class="wikitable"
! Commande Discord !! Description
|-
| <code>/config set CHAT_CHANNEL</code> || Définit le salon Discord recevant les messages du chat in-game
|}

{{Bandeau|type=warning|Le compte Minecraft doit être lié à Discord pour que les messages se synchronisent.}}

==== Module Events ====

Envoie des messages dans Discord lors d'événements sur le serveur (connexion, déconnexion, mort, etc.).

* La configuration se fait dans : <code>DiscordBridge/Modules/events.yml</code>
* Chaque événement peut être désactivé individuellement dans ce fichier.

==== Module Lands ====

Intègre DiscordBridge avec le plugin [[Lands]] pour les annonces et les salons de Land/Nation.

{| class="wikitable"
! Commande Discord !! Description
|-
| <code>/config set LANDS_CHAT_CATEGORY</code> || (Optionnel) Catégorie Discord où seront créés les salons de Land/Nation
|-
| <code>/config set LANDS_BROADCAST_CHANNEL</code> || (Optionnel) Salon Discord pour les annonces Lands (guerres, suppressions, etc.)
|-
| <code>/config set LANDS_NOTIFY_<broadcast_category></code> || Configure les rôles notifiés pour chaque catégorie d'annonce
|}

{{Bandeau|type=warning|Le compte Minecraft doit être lié à Discord pour pouvoir créer un salon Lands.}}
{{Bandeau|type=info|Remplacer <code><broadcast_category></code> par la catégorie souhaitée (ex : <code>WAR</code>, <code>DELETE</code>…).}}

==== Module Linking ====

Gère la liaison entre comptes Minecraft et Discord.

{{Bandeau|type=warning|Les synchronisations ne fonctionnent que dans un seul sens selon le paramètre configuré.}}

===== Sens de synchronisation =====

{| class="wikitable"
! Paramètre !! Sens !! Effet
|-
| <code>linking_roles add</code> || Minecraft → Discord || Le joueur reçoit un '''rôle Discord''' automatiquement lorsqu'il lie son compte
|-
| <code>linking_groups add</code> || Discord → Minecraft || Le joueur reçoit un '''groupe LuckPerms''' in-game selon son rôle Discord au moment de la liaison
|}

{{Bandeau|type=warning|Ces deux paramètres sont indépendants. Les configurer simultanément peut créer des '''boucles logiques involontaires''' ou des attributions redondantes. Il est recommandé de n'en utiliser qu'un seul selon l'architecture choisie.}}

=== Architecture recommandée ===

{| class="wikitable"
! Cas d'usage !! Paramètre à utiliser !! Paramètre à éviter
|-
| Gérer les grades depuis Discord || <code>linking_groups add</code> || <code>linking_roles add</code>
|-
| Donner un badge Discord aux joueurs liés || <code>linking_roles add</code> || <code>linking_groups add</code>
|-
| Synchronisation complète bidirectionnelle || Non supporté nativement || —
|}

{{Bandeau|type=warning|DiscordBridge ne supporte pas la synchronisation bidirectionnelle native. Utiliser les deux paramètres simultanément est possible mais doit être fait consciemment pour éviter les conflits de permissions.}}

===== Commande in-game (administration) =====

{| class="wikitable"
! Commande !! Description !! Permission
|-
| <code>/discordbridge account admin migrate</code> || Migre les liaisons existantes depuis un autre plugin || <code>discordbridge.admin.command.account.admin.migrate</code>
|}

{{bandeau|type=info|Lors de l'ajout d'un rôle ou d'un groupe, les joueurs déjà liés le reçoivent automatiquement. La mise à jour est planifiée pour éviter toute surcharge sur les grands serveurs.}}

==== Module Tickets ====

Permet aux membres Discord de créer des tickets de support directement depuis le serveur Discord.

===== Configuration requise =====

{| class="wikitable"
! Commande Discord !! Description
|-
| <code>/config set tickets_category_closed</code> || Catégorie où sont déplacés les tickets fermés avant suppression
|-
| <code>/config set tickets_member_max_tickets</code> || Nombre maximum de tickets simultanés par utilisateur
|-
| <code>/config set tickets_role_support</code> || Rôle Discord pouvant voir et gérer tous les tickets
|-
| <code>/config set tickets_deletion_time</code> || Délai avant suppression d'un ticket fermé (ex : <code>1d</code>, <code>12h</code>)
|-
| <code>/config set tickets_remind_submitter</code> || Active ou désactive le rappel automatique au créateur (<code>true</code> / <code>false</code>)
|-
| <code>/config set tickets_staff_unavailable</code> || Message affiché si aucun staff n'est disponible (nécessite <code>tickets_role_support</code>)
|-
| <code>/config set tickets_creation_channel</code> || Salon Discord où le message de création de ticket sera posté
|-
| <code>/config type upsert</code> || Créer ou mettre à jour un type de ticket
|-
| <code>/config field upsert</code> || Créer ou mettre à jour les champs d'un type de ticket
|-
| <code>/config info create</code> || (Optionnel) Prédéfinir des informations demandées après création du ticket
|-
| <code>/config reason create</code> || (Optionnel) Prédéfinir des raisons de fermeture de ticket
|}

{{Bandeau|type=info|Pour effacer une valeur de configuration, exécuter <code>/config set <option></code> sans préciser de valeur.}}

=== Commandes d'administration générales ===

{| class="wikitable"
! Commande !! Description !! Permission
|-
| <code>/discordbridge admin</code> || Accès aux commandes d'administration || <code>discordbridge.admin.command</code>
|-
| <code>/discordbridge admin reload</code> || Recharge la configuration du plugin || <code>discordbridge.admin.command.reload</code>
|}

{{Bandeau|type=info|Toutes les sous-commandes de <code>/discordbridge admin</code> suivent le format de permission : <code>discordbridge.admin.command.<souscommande></code>}}

=== Placeholders PlaceholderAPI ===

Ces placeholders nécessitent l'installation de [[PlaceholderAPI]].

{| class="wikitable"
! Placeholder !! Description
|-
| <code>%discordbridge_module_linking_amount%</code> || Nombre de joueurs ayant lié leur compte
|-
| <code>%discordbridge_module_linking_user_state_bool%</code> || <code>true</code> si le joueur a lié son compte, sinon <code>false</code>
|-
| <code>%discordbridge_module_linking_user_state%</code> || État de liaison (texte traduit depuis le fichier de locale)
|-
| <code>%discordbridge_module_linking_user_id%</code> || ID Discord de l'utilisateur lié
|-
| <code>%discordbridge_module_linking_user_name%</code> || Pseudo Discord de l'utilisateur lié
|-
| <code>%discordbridge_module_linking_user_booster%</code> || Indique si le joueur booste un serveur Discord du bot (texte)
|-
| <code>%discordbridge_module_linking_user_booster_bool%</code> || <code>true</code> si le joueur booste un serveur Discord du bot
|}

== Fichiers de configuration ==

{| class="wikitable"
! Fichier !! Rôle
|-
| <code>DiscordBridge/Modules/bot.yml</code> || Configuration principale du bot (token, URL d'invitation, etc.)
|-
| <code>DiscordBridge/Modules/events.yml</code> || Activation et désactivation des événements envoyés sur Discord
|-
| <code>DiscordBridge/Modules/chat.yml</code> || Configuration du module chat
|-
| <code>DiscordBridge/Modules/linking.yml</code> || Configuration du module de liaison de comptes
|-
| <code>DiscordBridge/Modules/lands.yml</code> || Configuration du module Lands
|-
| <code>DiscordBridge/Modules/tickets.yml</code> || Configuration du module Tickets
|}

== Voir aussi ==

* [[Lands]] — Plugin de gestion de territoires
* [[LuckPerms]] — Gestion des permissions et groupes
* [[PlaceholderAPI]] — Placeholders dynamiques
* [https://wiki.incredibleplugins.com/discordbridge Documentation officielle DiscordBridge]

Plugin:DiscordBridge/Lands

2026-04-04T08:01:23Z

Hiob : Page créée avec « === Créer un salon Discord pour sa Land === Les '''propriétaires d'une Land ou d'une Nation''' peuvent créer un salon textuel et vocal dédié directement dans le serveur Discord. ==== Conditions requises ==== * Être propriétaire ou disposer des droits sur une Land / Nation. * Avoir son compte Minecraft lié à son compte Discord — voir Lier son compte Discord. * Le plugin Lands doit être installé sur le serveur. ====... »

=== Créer un salon Discord pour sa Land ===

Les '''propriétaires d'une Land ou d'une Nation''' peuvent créer un salon textuel et vocal dédié directement dans le serveur Discord.

==== Conditions requises ====

* Être propriétaire ou disposer des droits sur une Land / Nation.
* Avoir son compte Minecraft lié à son compte Discord — voir [[#Lier son compte Discord|Lier son compte Discord]].
* Le plugin [[Lands]] doit être installé sur le serveur.

==== Commandes Discord ====

{| class="wikitable"
! Commande Discord !! Description
|-
| <code>/lands channel create</code> || Crée un salon Discord pour la Land
|-
| <code>/nations channel create</code> || Crée un salon Discord pour la Nation
|}

{{Bandeau|type=info|Les salons sont créés dans la catégorie définie par les administrateurs. Si aucune catégorie n'est configurée, ils apparaissent à la racine du serveur Discord.}}

Plugin:DiscordBridge/Lier son compte

2026-04-04T07:58:32Z

Hiob : Page créée avec « === Lier son compte Discord === La liaison entre votre compte Minecraft et Discord permet une synchronisation automatique des rôles. Sur Nefald, la synchronisation se fait dans le sens '''Discord → Minecraft''' : les rôles Discord déterminent les groupes attribués en jeu. {{Bandeau|type=info|En cas de changement de pseudo ou de rôle sur Discord, la synchronisation n'est pas immédiate — elle s'effectue automatiquement de façon planifiée.}} ==== Éta... »

=== Lier son compte Discord ===

La liaison entre votre compte Minecraft et Discord permet une synchronisation automatique des rôles.
Sur Nefald, la synchronisation se fait dans le sens '''Discord → Minecraft''' : les rôles Discord déterminent les groupes attribués en jeu.

{{Bandeau|type=info|En cas de changement de pseudo ou de rôle sur Discord, la synchronisation n'est pas immédiate — elle s'effectue automatiquement de façon planifiée.}}

==== Étapes ====

# Connectez-vous au serveur Minecraft.
# Exécutez la commande <code>/discordbridge account link</code> en jeu.
# Suivez les instructions affichées dans le chat : un code et une commande Discord vous seront fournis.
# Sur Discord, envoyez la commande indiquée au bot pour finaliser la liaison.
# Vos rôles Discord et groupes in-game sont alors attribués automatiquement.

Plugin:DiscordBridge/Commandes

2026-04-04T07:48:40Z

Hiob : Page créée avec « {| class="wikitable" ! Commande !! Description !! Permission |- | <code>/discordbridge account link</code> || Lier son compte Discord à son compte Minecraft || <code>discordbridge.command.account.link</code> |- | <code>/discordbridge account unlink</code> || Délier son compte Discord || <code>discordbridge.command.account.unlink</code> |- | <code>/discordbridge invite</code> || Obtenir le lien d'invitation du serveur Discord || <code>discordbridge.command.invit... »

{| class="wikitable"
! Commande !! Description !! Permission
|-
| <code>/discordbridge account link</code> || Lier son compte Discord à son compte Minecraft || <code>discordbridge.command.account.link</code>
|-
| <code>/discordbridge account unlink</code> || Délier son compte Discord || <code>discordbridge.command.account.unlink</code>
|-
| <code>/discordbridge invite</code> || Obtenir le lien d'invitation du serveur Discord || <code>discordbridge.command.invite</code>
|-
| <code>/discordbridge help [page]</code> || Afficher l'aide des commandes disponibles || <code>discordbridge.command.help</code>
|}

Plugin:DiscordBridge

2026-04-04T06:05:49Z

Hiob : +

{{SHORTDESC:Plugin d'intégration entre Minecraft et Discord}}

{{Infobox Plugin
| nom = DiscordBridge
| image = Plugin_without_Logo.png
| type = Utilitaire
| dev = incredibleplugins
| docs = https://wiki.incredibleplugins.com/discordbridge
| sources =
| grade =
| status = installé
}}

'''DiscordBridge''' est un plugin d'intégration entre le serveur Minecraft et le serveur Discord.
Il relie les deux plateformes en offrant la synchronisation du chat, la liaison de comptes,
la gestion de tickets, les notifications d'événements et l'intégration avec le plugin [[Lands]].

== Pour tous les joueurs ==

=== Lier son compte Discord ===

Selon la configuration du serveur, la liaison peut :
* Attribuer un '''rôle Discord''' automatiquement (sync Minecraft → Discord)
* Attribuer un '''groupe LuckPerms''' in-game selon ton rôle Discord (sync Discord → Minecraft)

{{Bandeau|type=info|Sur Nefald la synchronisation se fait de Discord → Minecraft.}}

==== Commandes in-game ====

{| class="wikitable"
! Commande !! Description !! Permission
|-
| <code>/discordbridge account link</code> || Lier son compte Discord à son compte Minecraft || <code>discordbridge.command.account.link</code>
|-
| <code>/discordbridge account unlink</code> || Délier son compte Discord || <code>discordbridge.command.account.unlink</code>
|-
| <code>/discordbridge invite</code> || Obtenir le lien d'invitation du serveur Discord || <code>discordbridge.command.invite</code>
|-
| <code>/discordbridge help [page]</code> || Afficher l'aide des commandes disponibles || <code>discordbridge.command.help</code>
|}

==== Étapes pour lier son compte ====

# Se connecter au serveur Minecraft.
# Exécuter <code>/discordbridge account link</code> en jeu.
# Suivre les instructions affichées dans le chat (un code ou un lien sera fourni).
# Sur Discord, compléter la liaison en suivant les instructions du bot.
# Une fois le compte lié, les rôles Discord et groupes in-game configurés par les administrateurs sont attribués automatiquement.

{{Bandeau |type=info|En cas de changement de pseudo Discord, la synchronisation du nom peut être automatique selon la configuration du serveur.}}

=== Créer un salon Discord pour sa Land ===

Les '''propriétaires d'une Land ou d'une Nation''' peuvent créer un salon textuel et vocal dédié directement dans le serveur Discord.

==== Conditions requises ====

* Être propriétaire ou disposer des droits sur une Land / Nation.
* Avoir son compte Minecraft lié à son compte Discord — voir [[#Lier son compte Discord|Lier son compte Discord]].
* Le plugin [[Lands]] doit être installé sur le serveur.

==== Commandes Discord ====

{| class="wikitable"
! Commande Discord !! Description
|-
| <code>/lands channel create</code> || Crée un salon Discord pour la Land
|-
| <code>/nations channel create</code> || Crée un salon Discord pour la Nation
|}

{{Bandeau|type=info|Les salons sont créés dans la catégorie définie par les administrateurs. Si aucune catégorie n'est configurée, ils apparaissent à la racine du serveur Discord.}}

== Pour les administrateurs ==

=== Installation et configuration du bot ===

==== Prérequis ====

# Créer une application Discord sur le [https://discord.com/developers/applications Portail Développeur Discord].
# Activer les '''Intents''' suivants dans l'onglet ''Bot'' :
#* '''Server Members Intent'''
#* '''Message Content Intent'''
# Lors de l'invitation du bot, les '''scopes requis''' sont :
#* <code>applications.commands</code>
#* <code>bot</code>
# Le bot doit disposer des permissions Discord suivantes :
#* Gérer les salons
#* Gérer les webhooks
#* Lire les messages / Voir les salons
#* Envoyer des messages
#* Gérer les messages
#* Intégrer des liens
#* Joindre des fichiers
#* Voir l'historique des messages
#* Ajouter des réactions
# Copier le '''token du bot''' et le coller dans <code>DiscordBridge/Modules/bot.yml</code> à l'option <code>token</code>.

=== Configuration des modules ===

==== Module Chat ====

Synchronise le chat in-game vers Discord et inversement.

{| class="wikitable"
! Commande Discord !! Description
|-
| <code>/config set CHAT_CHANNEL</code> || Définit le salon Discord recevant les messages du chat in-game
|}

{{Bandeau|type=warning|Le compte Minecraft doit être lié à Discord pour que les messages se synchronisent.}}

==== Module Events ====

Envoie des messages dans Discord lors d'événements sur le serveur (connexion, déconnexion, mort, etc.).

* La configuration se fait dans : <code>DiscordBridge/Modules/events.yml</code>
* Chaque événement peut être désactivé individuellement dans ce fichier.

==== Module Lands ====

Intègre DiscordBridge avec le plugin [[Lands]] pour les annonces et les salons de Land/Nation.

{| class="wikitable"
! Commande Discord !! Description
|-
| <code>/config set LANDS_CHAT_CATEGORY</code> || (Optionnel) Catégorie Discord où seront créés les salons de Land/Nation
|-
| <code>/config set LANDS_BROADCAST_CHANNEL</code> || (Optionnel) Salon Discord pour les annonces Lands (guerres, suppressions, etc.)
|-
| <code>/config set LANDS_NOTIFY_<broadcast_category></code> || Configure les rôles notifiés pour chaque catégorie d'annonce
|}

{{Bandeau|type=warning|Le compte Minecraft doit être lié à Discord pour pouvoir créer un salon Lands.}}
{{Bandeau|type=info|Remplacer <code><broadcast_category></code> par la catégorie souhaitée (ex : <code>WAR</code>, <code>DELETE</code>…).}}

==== Module Linking ====

Gère la liaison entre comptes Minecraft et Discord.

{{Bandeau|type=warning|Les synchronisations ne fonctionnent que dans un seul sens selon le paramètre configuré.}}

===== Sens de synchronisation =====

{| class="wikitable"
! Paramètre !! Sens !! Effet
|-
| <code>linking_roles add</code> || Minecraft → Discord || Le joueur reçoit un '''rôle Discord''' automatiquement lorsqu'il lie son compte
|-
| <code>linking_groups add</code> || Discord → Minecraft || Le joueur reçoit un '''groupe LuckPerms''' in-game selon son rôle Discord au moment de la liaison
|}

{{Bandeau|type=warning|Ces deux paramètres sont indépendants. Les configurer simultanément peut créer des '''boucles logiques involontaires''' ou des attributions redondantes. Il est recommandé de n'en utiliser qu'un seul selon l'architecture choisie.}}

=== Architecture recommandée ===

{| class="wikitable"
! Cas d'usage !! Paramètre à utiliser !! Paramètre à éviter
|-
| Gérer les grades depuis Discord || <code>linking_groups add</code> || <code>linking_roles add</code>
|-
| Donner un badge Discord aux joueurs liés || <code>linking_roles add</code> || <code>linking_groups add</code>
|-
| Synchronisation complète bidirectionnelle || Non supporté nativement || —
|}

{{Bandeau|type=warning|DiscordBridge ne supporte pas la synchronisation bidirectionnelle native. Utiliser les deux paramètres simultanément est possible mais doit être fait consciemment pour éviter les conflits de permissions.}}

===== Commande in-game (administration) =====

{| class="wikitable"
! Commande !! Description !! Permission
|-
| <code>/discordbridge account admin migrate</code> || Migre les liaisons existantes depuis un autre plugin || <code>discordbridge.admin.command.account.admin.migrate</code>
|}

{{bandeau|type=info|Lors de l'ajout d'un rôle ou d'un groupe, les joueurs déjà liés le reçoivent automatiquement. La mise à jour est planifiée pour éviter toute surcharge sur les grands serveurs.}}

==== Module Tickets ====

Permet aux membres Discord de créer des tickets de support directement depuis le serveur Discord.

===== Configuration requise =====

{| class="wikitable"
! Commande Discord !! Description
|-
| <code>/config set tickets_category_closed</code> || Catégorie où sont déplacés les tickets fermés avant suppression
|-
| <code>/config set tickets_member_max_tickets</code> || Nombre maximum de tickets simultanés par utilisateur
|-
| <code>/config set tickets_role_support</code> || Rôle Discord pouvant voir et gérer tous les tickets
|-
| <code>/config set tickets_deletion_time</code> || Délai avant suppression d'un ticket fermé (ex : <code>1d</code>, <code>12h</code>)
|-
| <code>/config set tickets_remind_submitter</code> || Active ou désactive le rappel automatique au créateur (<code>true</code> / <code>false</code>)
|-
| <code>/config set tickets_staff_unavailable</code> || Message affiché si aucun staff n'est disponible (nécessite <code>tickets_role_support</code>)
|-
| <code>/config set tickets_creation_channel</code> || Salon Discord où le message de création de ticket sera posté
|-
| <code>/config type upsert</code> || Créer ou mettre à jour un type de ticket
|-
| <code>/config field upsert</code> || Créer ou mettre à jour les champs d'un type de ticket
|-
| <code>/config info create</code> || (Optionnel) Prédéfinir des informations demandées après création du ticket
|-
| <code>/config reason create</code> || (Optionnel) Prédéfinir des raisons de fermeture de ticket
|}

{{Bandeau|type=info|Pour effacer une valeur de configuration, exécuter <code>/config set <option></code> sans préciser de valeur.}}

=== Commandes d'administration générales ===

{| class="wikitable"
! Commande !! Description !! Permission
|-
| <code>/discordbridge admin</code> || Accès aux commandes d'administration || <code>discordbridge.admin.command</code>
|-
| <code>/discordbridge admin reload</code> || Recharge la configuration du plugin || <code>discordbridge.admin.command.reload</code>
|}

{{Bandeau|type=info|Toutes les sous-commandes de <code>/discordbridge admin</code> suivent le format de permission : <code>discordbridge.admin.command.<souscommande></code>}}

=== Placeholders PlaceholderAPI ===

Ces placeholders nécessitent l'installation de [[PlaceholderAPI]].

{| class="wikitable"
! Placeholder !! Description
|-
| <code>%discordbridge_module_linking_amount%</code> || Nombre de joueurs ayant lié leur compte
|-
| <code>%discordbridge_module_linking_user_state_bool%</code> || <code>true</code> si le joueur a lié son compte, sinon <code>false</code>
|-
| <code>%discordbridge_module_linking_user_state%</code> || État de liaison (texte traduit depuis le fichier de locale)
|-
| <code>%discordbridge_module_linking_user_id%</code> || ID Discord de l'utilisateur lié
|-
| <code>%discordbridge_module_linking_user_name%</code> || Pseudo Discord de l'utilisateur lié
|-
| <code>%discordbridge_module_linking_user_booster%</code> || Indique si le joueur booste un serveur Discord du bot (texte)
|-
| <code>%discordbridge_module_linking_user_booster_bool%</code> || <code>true</code> si le joueur booste un serveur Discord du bot
|}

== Fichiers de configuration ==

{| class="wikitable"
! Fichier !! Rôle
|-
| <code>DiscordBridge/Modules/bot.yml</code> || Configuration principale du bot (token, URL d'invitation, etc.)
|-
| <code>DiscordBridge/Modules/events.yml</code> || Activation et désactivation des événements envoyés sur Discord
|-
| <code>DiscordBridge/Modules/chat.yml</code> || Configuration du module chat
|-
| <code>DiscordBridge/Modules/linking.yml</code> || Configuration du module de liaison de comptes
|-
| <code>DiscordBridge/Modules/lands.yml</code> || Configuration du module Lands
|-
| <code>DiscordBridge/Modules/tickets.yml</code> || Configuration du module Tickets
|}

== Voir aussi ==

* [[Lands]] — Plugin de gestion de territoires
* [[LuckPerms]] — Gestion des permissions et groupes
* [[PlaceholderAPI]] — Placeholders dynamiques
* [https://wiki.incredibleplugins.com/discordbridge Documentation officielle DiscordBridge]

Plugin:DiscordBridge

2026-04-04T06:02:21Z

Hiob :

{{SHORTDESC:Plugin d'intégration entre Minecraft et Discord}}

{{Infobox Plugin
| nom = DiscordBridge
| image = Plugin_without_Logo.png
| type = Utilitaire
| dev = incredibleplugins
| docs = https://wiki.incredibleplugins.com/discordbridge
| sources =
| grade =
| status = installé
}}

'''DiscordBridge''' est un plugin d'intégration entre le serveur Minecraft et le serveur Discord.
Il relie les deux plateformes en offrant la synchronisation du chat, la liaison de comptes,
la gestion de tickets, les notifications d'événements et l'intégration avec le plugin [[Lands]].

== Pour les joueurs ==

=== Lier son compte Discord ===

Selon la configuration du serveur, la liaison peut :
* Attribuer un '''rôle Discord''' automatiquement (sync Minecraft → Discord)
* Attribuer un '''groupe LuckPerms''' in-game selon ton rôle Discord (sync Discord → Minecraft)

{{Bandeau|type=info|Sur Nefald la synchronisation se fait de Discord → Minecraft.}}

==== Commandes in-game ====

{| class="wikitable"
! Commande !! Description !! Permission
|-
| <code>/discordbridge account link</code> || Lier son compte Discord à son compte Minecraft || <code>discordbridge.command.account.link</code>
|-
| <code>/discordbridge account unlink</code> || Délier son compte Discord || <code>discordbridge.command.account.unlink</code>
|-
| <code>/discordbridge invite</code> || Obtenir le lien d'invitation du serveur Discord || <code>discordbridge.command.invite</code>
|-
| <code>/discordbridge help [page]</code> || Afficher l'aide des commandes disponibles || <code>discordbridge.command.help</code>
|}

==== Étapes pour lier son compte ====

# Se connecter au serveur Minecraft.
# Exécuter <code>/discordbridge account link</code> en jeu.
# Suivre les instructions affichées dans le chat (un code ou un lien sera fourni).
# Sur Discord, compléter la liaison en suivant les instructions du bot.
# Une fois le compte lié, les rôles Discord et groupes in-game configurés par les administrateurs sont attribués automatiquement.

{{Bandeau |type=info|En cas de changement de pseudo Discord, la synchronisation du nom peut être automatique selon la configuration du serveur.}}

=== Créer un salon Discord pour sa Land ===

Les '''propriétaires d'une Land ou d'une Nation''' peuvent créer un salon textuel et vocal dédié directement dans le serveur Discord.

==== Conditions requises ====

* Être propriétaire ou disposer des droits sur une Land / Nation.
* Avoir son compte Minecraft lié à son compte Discord — voir [[#Lier son compte Discord|Lier son compte Discord]].
* Le plugin [[Lands]] doit être installé sur le serveur.

==== Commandes Discord ====

{| class="wikitable"
! Commande Discord !! Description
|-
| <code>/lands channel create</code> || Crée un salon Discord pour la Land
|-
| <code>/nations channel create</code> || Crée un salon Discord pour la Nation
|}

{{Bandeau|type=info|Les salons sont créés dans la catégorie définie par les administrateurs. Si aucune catégorie n'est configurée, ils apparaissent à la racine du serveur Discord.}}

== Pour les administrateurs ==

=== Installation et configuration du bot ===

==== Prérequis ====

# Créer une application Discord sur le [https://discord.com/developers/applications Portail Développeur Discord].
# Activer les '''Intents''' suivants dans l'onglet ''Bot'' :
#* '''Server Members Intent'''
#* '''Message Content Intent'''
# Lors de l'invitation du bot, les '''scopes requis''' sont :
#* <code>applications.commands</code>
#* <code>bot</code>
# Le bot doit disposer des permissions Discord suivantes :
#* Gérer les salons
#* Gérer les webhooks
#* Lire les messages / Voir les salons
#* Envoyer des messages
#* Gérer les messages
#* Intégrer des liens
#* Joindre des fichiers
#* Voir l'historique des messages
#* Ajouter des réactions
# Copier le '''token du bot''' et le coller dans <code>DiscordBridge/Modules/bot.yml</code> à l'option <code>token</code>.

=== Configuration des modules ===

==== Module Chat ====

Synchronise le chat in-game vers Discord et inversement.

{| class="wikitable"
! Commande Discord !! Description
|-
| <code>/config set CHAT_CHANNEL</code> || Définit le salon Discord recevant les messages du chat in-game
|}

{{Bandeau|type=warning|Le compte Minecraft doit être lié à Discord pour que les messages se synchronisent.}}

==== Module Events ====

Envoie des messages dans Discord lors d'événements sur le serveur (connexion, déconnexion, mort, etc.).

* La configuration se fait dans : <code>DiscordBridge/Modules/events.yml</code>
* Chaque événement peut être désactivé individuellement dans ce fichier.

==== Module Lands ====

Intègre DiscordBridge avec le plugin [[Lands]] pour les annonces et les salons de Land/Nation.

{| class="wikitable"
! Commande Discord !! Description
|-
| <code>/config set LANDS_CHAT_CATEGORY</code> || (Optionnel) Catégorie Discord où seront créés les salons de Land/Nation
|-
| <code>/config set LANDS_BROADCAST_CHANNEL</code> || (Optionnel) Salon Discord pour les annonces Lands (guerres, suppressions, etc.)
|-
| <code>/config set LANDS_NOTIFY_<broadcast_category></code> || Configure les rôles notifiés pour chaque catégorie d'annonce
|}

{{Bandeau|type=warning|Le compte Minecraft doit être lié à Discord pour pouvoir créer un salon Lands.}}
{{Bandeau|type=info|Remplacer <code><broadcast_category></code> par la catégorie souhaitée (ex : <code>WAR</code>, <code>DELETE</code>…).}}

==== Module Linking ====

Gère la liaison entre comptes Minecraft et Discord.

{{Bandeau|type=warning|Les synchronisations ne fonctionnent que dans un seul sens selon le paramètre configuré.}}

===== Sens de synchronisation =====

{| class="wikitable"
! Paramètre !! Sens !! Effet
|-
| <code>linking_roles add</code> || Minecraft → Discord || Le joueur reçoit un '''rôle Discord''' automatiquement lorsqu'il lie son compte
|-
| <code>linking_groups add</code> || Discord → Minecraft || Le joueur reçoit un '''groupe LuckPerms''' in-game selon son rôle Discord au moment de la liaison
|}

{{Bandeau|type=warning|Ces deux paramètres sont indépendants. Les configurer simultanément peut créer des '''boucles logiques involontaires''' ou des attributions redondantes. Il est recommandé de n'en utiliser qu'un seul selon l'architecture choisie.}}

===== Commande in-game (administration) =====

{| class="wikitable"
! Commande !! Description !! Permission
|-
| <code>/discordbridge account admin migrate</code> || Migre les liaisons existantes depuis un autre plugin || <code>discordbridge.admin.command.account.admin.migrate</code>
|}

{{bandeau|type=info|Lors de l'ajout d'un rôle ou d'un groupe, les joueurs déjà liés le reçoivent automatiquement. La mise à jour est planifiée pour éviter toute surcharge sur les grands serveurs.}}

==== Module Tickets ====

Permet aux membres Discord de créer des tickets de support directement depuis le serveur Discord.

===== Configuration requise =====

{| class="wikitable"
! Commande Discord !! Description
|-
| <code>/config set tickets_category_closed</code> || Catégorie où sont déplacés les tickets fermés avant suppression
|-
| <code>/config set tickets_member_max_tickets</code> || Nombre maximum de tickets simultanés par utilisateur
|-
| <code>/config set tickets_role_support</code> || Rôle Discord pouvant voir et gérer tous les tickets
|-
| <code>/config set tickets_deletion_time</code> || Délai avant suppression d'un ticket fermé (ex : <code>1d</code>, <code>12h</code>)
|-
| <code>/config set tickets_remind_submitter</code> || Active ou désactive le rappel automatique au créateur (<code>true</code> / <code>false</code>)
|-
| <code>/config set tickets_staff_unavailable</code> || Message affiché si aucun staff n'est disponible (nécessite <code>tickets_role_support</code>)
|-
| <code>/config set tickets_creation_channel</code> || Salon Discord où le message de création de ticket sera posté
|-
| <code>/config type upsert</code> || Créer ou mettre à jour un type de ticket
|-
| <code>/config field upsert</code> || Créer ou mettre à jour les champs d'un type de ticket
|-
| <code>/config info create</code> || (Optionnel) Prédéfinir des informations demandées après création du ticket
|-
| <code>/config reason create</code> || (Optionnel) Prédéfinir des raisons de fermeture de ticket
|}

{{Bandeau|type=info|Pour effacer une valeur de configuration, exécuter <code>/config set <option></code> sans préciser de valeur.}}

=== Commandes d'administration générales ===

{| class="wikitable"
! Commande !! Description !! Permission
|-
| <code>/discordbridge admin</code> || Accès aux commandes d'administration || <code>discordbridge.admin.command</code>
|-
| <code>/discordbridge admin reload</code> || Recharge la configuration du plugin || <code>discordbridge.admin.command.reload</code>
|}

{{Bandeau|type=info|Toutes les sous-commandes de <code>/discordbridge admin</code> suivent le format de permission : <code>discordbridge.admin.command.<souscommande></code>}}

=== Placeholders PlaceholderAPI ===

Ces placeholders nécessitent l'installation de [[PlaceholderAPI]].

{| class="wikitable"
! Placeholder !! Description
|-
| <code>%discordbridge_module_linking_amount%</code> || Nombre de joueurs ayant lié leur compte
|-
| <code>%discordbridge_module_linking_user_state_bool%</code> || <code>true</code> si le joueur a lié son compte, sinon <code>false</code>
|-
| <code>%discordbridge_module_linking_user_state%</code> || État de liaison (texte traduit depuis le fichier de locale)
|-
| <code>%discordbridge_module_linking_user_id%</code> || ID Discord de l'utilisateur lié
|-
| <code>%discordbridge_module_linking_user_name%</code> || Pseudo Discord de l'utilisateur lié
|-
| <code>%discordbridge_module_linking_user_booster%</code> || Indique si le joueur booste un serveur Discord du bot (texte)
|-
| <code>%discordbridge_module_linking_user_booster_bool%</code> || <code>true</code> si le joueur booste un serveur Discord du bot
|}

== Fichiers de configuration ==

{| class="wikitable"
! Fichier !! Rôle
|-
| <code>DiscordBridge/Modules/bot.yml</code> || Configuration principale du bot (token, URL d'invitation, etc.)
|-
| <code>DiscordBridge/Modules/events.yml</code> || Activation et désactivation des événements envoyés sur Discord
|-
| <code>DiscordBridge/Modules/chat.yml</code> || Configuration du module chat
|-
| <code>DiscordBridge/Modules/linking.yml</code> || Configuration du module de liaison de comptes
|}

== Voir aussi ==

* [[Lands]] — Plugin de gestion de territoires
* [[LuckPerms]] — Gestion des permissions et groupes
* [[PlaceholderAPI]] — Placeholders dynamiques
* [https://wiki.incredibleplugins.com/discordbridge Documentation officielle DiscordBridge]

Plugin:DiscordBridge

2026-04-04T05:53:29Z

Hiob : ton neutre

{{SHORTDESC:Plugin d'intégration entre Minecraft et Discord}}

{{Infobox Plugin
| nom = DiscordBridge
| image = Plugin_without_Logo.png
| type = Utilitaire
| dev = incredibleplugins
| docs = https://wiki.incredibleplugins.com/discordbridge
| sources =
| grade =
| status = installé
}}

'''DiscordBridge''' est un plugin d'intégration entre le serveur Minecraft et le serveur Discord.
Il relie les deux plateformes en offrant la synchronisation du chat, la liaison de comptes,
la gestion de tickets, les notifications d'événements et l'intégration avec le plugin [[Lands]].

== Pour les joueurs ==

=== Lier son compte Discord ===

La liaison de compte associe un compte Minecraft à un compte Discord.
Elle peut débloquer des rôles Discord automatiques, des groupes in-game et d'autres avantages selon la configuration du serveur.

==== Commandes in-game ====

{| class="wikitable"
! Commande !! Description !! Permission
|-
| <code>/discordbridge account link</code> || Lier son compte Discord à son compte Minecraft || <code>discordbridge.command.account.link</code>
|-
| <code>/discordbridge account unlink</code> || Délier son compte Discord || <code>discordbridge.command.account.unlink</code>
|-
| <code>/discordbridge invite</code> || Obtenir le lien d'invitation du serveur Discord || <code>discordbridge.command.invite</code>
|-
| <code>/discordbridge help [page]</code> || Afficher l'aide des commandes disponibles || <code>discordbridge.command.help</code>
|}

==== Étapes pour lier son compte ====

# Se connecter au serveur Minecraft.
# Exécuter <code>/discordbridge account link</code> en jeu.
# Suivre les instructions affichées dans le chat (un code ou un lien sera fourni).
# Sur Discord, compléter la liaison en suivant les instructions du bot.
# Une fois le compte lié, les rôles Discord et groupes in-game configurés par les administrateurs sont attribués automatiquement.

{{Bandeau |type=info|En cas de changement de pseudo Discord, la synchronisation du nom peut être automatique selon la configuration du serveur.}}

=== Créer un salon Discord pour sa Land ===

Les '''propriétaires d'une Land ou d'une Nation''' peuvent créer un salon textuel et vocal dédié directement dans le serveur Discord.

==== Conditions requises ====

* Être propriétaire ou disposer des droits sur une Land / Nation.
* Avoir son compte Minecraft lié à son compte Discord — voir [[#Lier son compte Discord|Lier son compte Discord]].
* Le plugin [[Lands]] doit être installé sur le serveur.

==== Commandes Discord ====

{| class="wikitable"
! Commande Discord !! Description
|-
| <code>/lands channel create</code> || Crée un salon Discord pour la Land
|-
| <code>/nations channel create</code> || Crée un salon Discord pour la Nation
|}

{{Bandeau|type=info|Les salons sont créés dans la catégorie définie par les administrateurs. Si aucune catégorie n'est configurée, ils apparaissent à la racine du serveur Discord.}}

== Pour les administrateurs ==

=== Installation et configuration du bot ===

==== Prérequis ====

# Créer une application Discord sur le [https://discord.com/developers/applications Portail Développeur Discord].
# Activer les '''Intents''' suivants dans l'onglet ''Bot'' :
#* '''Server Members Intent'''
#* '''Message Content Intent'''
# Lors de l'invitation du bot, les '''scopes requis''' sont :
#* <code>applications.commands</code>
#* <code>bot</code>
# Le bot doit disposer des permissions Discord suivantes :
#* Gérer les salons
#* Gérer les webhooks
#* Lire les messages / Voir les salons
#* Envoyer des messages
#* Gérer les messages
#* Intégrer des liens
#* Joindre des fichiers
#* Voir l'historique des messages
#* Ajouter des réactions
# Copier le '''token du bot''' et le coller dans <code>DiscordBridge/Modules/bot.yml</code> à l'option <code>token</code>.

=== Configuration des modules ===

==== Module Chat ====

Synchronise le chat in-game vers Discord et inversement.

{| class="wikitable"
! Commande Discord !! Description
|-
| <code>/config set CHAT_CHANNEL</code> || Définit le salon Discord recevant les messages du chat in-game
|}

{{Bandeau|type=warning|Le compte Minecraft doit être lié à Discord pour que les messages se synchronisent.}}

==== Module Events ====

Envoie des messages dans Discord lors d'événements sur le serveur (connexion, déconnexion, mort, etc.).

* La configuration se fait dans : <code>DiscordBridge/Modules/events.yml</code>
* Chaque événement peut être désactivé individuellement dans ce fichier.

==== Module Lands ====

Intègre DiscordBridge avec le plugin [[Lands]] pour les annonces et les salons de Land/Nation.

{| class="wikitable"
! Commande Discord !! Description
|-
| <code>/config set LANDS_CHAT_CATEGORY</code> || (Optionnel) Catégorie Discord où seront créés les salons de Land/Nation
|-
| <code>/config set LANDS_BROADCAST_CHANNEL</code> || (Optionnel) Salon Discord pour les annonces Lands (guerres, suppressions, etc.)
|-
| <code>/config set LANDS_NOTIFY_<broadcast_category></code> || Configure les rôles notifiés pour chaque catégorie d'annonce
|}

{{Bandeau|type=warning|Le compte Minecraft doit être lié à Discord pour pouvoir créer un salon Lands.}}
{{Bandeau|type=info|Remplacer <code><broadcast_category></code> par la catégorie souhaitée (ex : <code>WAR</code>, <code>DELETE</code>…).}}

==== Module Linking ====

Gère la liaison entre comptes Minecraft et Discord.

{| class="wikitable"
! Commande Discord !! Description
|-
| <code>/config linking_allowed_roles add <role></code> || Restreint la liaison aux joueurs ayant ce rôle Discord
|-
| <code>/config linking_roles add</code> || Ajoute un rôle Discord attribué automatiquement aux joueurs liés
|-
| <code>/config linking_groups add</code> || Ajoute un groupe LuckPerms attribué automatiquement aux joueurs liés
|-
| <code>/config linking_name_sync_ignore_roles add <role></code> || Exclut les utilisateurs ayant ce rôle de la synchronisation de nom
|}

===== Commande in-game (administration) =====

{| class="wikitable"
! Commande !! Description !! Permission
|-
| <code>/discordbridge account admin migrate</code> || Migre les liaisons existantes depuis un autre plugin || <code>discordbridge.admin.command.account.admin.migrate</code>
|}

{{bandeau|type=info|Lors de l'ajout d'un rôle ou d'un groupe, les joueurs déjà liés le reçoivent automatiquement. La mise à jour est planifiée pour éviter toute surcharge sur les grands serveurs.}}

==== Module Tickets ====

Permet aux membres Discord de créer des tickets de support directement depuis le serveur Discord.

===== Configuration requise =====

{| class="wikitable"
! Commande Discord !! Description
|-
| <code>/config set tickets_category_closed</code> || Catégorie où sont déplacés les tickets fermés avant suppression
|-
| <code>/config set tickets_member_max_tickets</code> || Nombre maximum de tickets simultanés par utilisateur
|-
| <code>/config set tickets_role_support</code> || Rôle Discord pouvant voir et gérer tous les tickets
|-
| <code>/config set tickets_deletion_time</code> || Délai avant suppression d'un ticket fermé (ex : <code>1d</code>, <code>12h</code>)
|-
| <code>/config set tickets_remind_submitter</code> || Active ou désactive le rappel automatique au créateur (<code>true</code> / <code>false</code>)
|-
| <code>/config set tickets_staff_unavailable</code> || Message affiché si aucun staff n'est disponible (nécessite <code>tickets_role_support</code>)
|-
| <code>/config set tickets_creation_channel</code> || Salon Discord où le message de création de ticket sera posté
|-
| <code>/config type upsert</code> || Créer ou mettre à jour un type de ticket
|-
| <code>/config field upsert</code> || Créer ou mettre à jour les champs d'un type de ticket
|-
| <code>/config info create</code> || (Optionnel) Prédéfinir des informations demandées après création du ticket
|-
| <code>/config reason create</code> || (Optionnel) Prédéfinir des raisons de fermeture de ticket
|}

{{Bandeau|type=info|Pour effacer une valeur de configuration, exécuter <code>/config set <option></code> sans préciser de valeur.}}

=== Commandes d'administration générales ===

{| class="wikitable"
! Commande !! Description !! Permission
|-
| <code>/discordbridge admin</code> || Accès aux commandes d'administration || <code>discordbridge.admin.command</code>
|-
| <code>/discordbridge admin reload</code> || Recharge la configuration du plugin || <code>discordbridge.admin.command.reload</code>
|}

{{Bandeau|type=info|Toutes les sous-commandes de <code>/discordbridge admin</code> suivent le format de permission : <code>discordbridge.admin.command.<souscommande></code>}}

=== Placeholders PlaceholderAPI ===

Ces placeholders nécessitent l'installation de [[PlaceholderAPI]].

{| class="wikitable"
! Placeholder !! Description
|-
| <code>%discordbridge_module_linking_amount%</code> || Nombre de joueurs ayant lié leur compte
|-
| <code>%discordbridge_module_linking_user_state_bool%</code> || <code>true</code> si le joueur a lié son compte, sinon <code>false</code>
|-
| <code>%discordbridge_module_linking_user_state%</code> || État de liaison (texte traduit depuis le fichier de locale)
|-
| <code>%discordbridge_module_linking_user_id%</code> || ID Discord de l'utilisateur lié
|-
| <code>%discordbridge_module_linking_user_name%</code> || Pseudo Discord de l'utilisateur lié
|-
| <code>%discordbridge_module_linking_user_booster%</code> || Indique si le joueur booste un serveur Discord du bot (texte)
|-
| <code>%discordbridge_module_linking_user_booster_bool%</code> || <code>true</code> si le joueur booste un serveur Discord du bot
|}

== Fichiers de configuration ==

{| class="wikitable"
! Fichier !! Rôle
|-
| <code>DiscordBridge/Modules/bot.yml</code> || Configuration principale du bot (token, URL d'invitation, etc.)
|-
| <code>DiscordBridge/Modules/events.yml</code> || Activation et désactivation des événements envoyés sur Discord
|-
| <code>DiscordBridge/Modules/chat.yml</code> || Configuration du module chat
|-
| <code>DiscordBridge/Modules/linking.yml</code> || Configuration du module de liaison de comptes
|}

== Voir aussi ==

* [[Lands]] — Plugin de gestion de territoires
* [[LuckPerms]] — Gestion des permissions et groupes
* [[PlaceholderAPI]] — Placeholders dynamiques
* [https://wiki.incredibleplugins.com/discordbridge Documentation officielle DiscordBridge]

Plugin:DiscordBridge

2026-04-04T05:37:29Z

Hiob : /* Commandes Discord */

{{SHORTDESC:Plugin d'intégration entre Minecraft et Discord}}

{{Infobox Plugin
| nom = DiscordBridge
| image = Plugin_without_Logo.png
| type = Utilitaire
| dev = incredibleplugins
| docs = https://wiki.incredibleplugins.com/discordbridge
| sources =
| grade =
| status = installé
}}

'''DiscordBridge''' est un plugin d'intégration entre le serveur Minecraft et le serveur Discord.
Il relie les deux plateformes en offrant la synchronisation du chat, la liaison de comptes,
la gestion de tickets, les notifications d'événements et l'intégration avec le plugin [[Lands]].

== Pour les joueurs ==

=== Lier son compte Discord ===

La liaison de compte associe ton compte Minecraft à ton compte Discord.
Elle peut débloquer des rôles Discord automatiques, des groupes in-game et d'autres avantages selon la configuration du serveur.

==== Commandes in-game ====

{| class="wikitable"
! Commande !! Description !! Permission
|-
| <code>/discordbridge account link</code> || Lier son compte Discord à son compte Minecraft || <code>discordbridge.command.account.link</code>
|-
| <code>/discordbridge account unlink</code> || Délier son compte Discord || <code>discordbridge.command.account.unlink</code>
|-
| <code>/discordbridge invite</code> || Obtenir le lien d'invitation du serveur Discord || <code>discordbridge.command.invite</code>
|-
| <code>/discordbridge help [page]</code> || Afficher l'aide des commandes disponibles || <code>discordbridge.command.help</code>
|}

==== Étapes pour lier son compte ====

# Connecte-toi au serveur Minecraft.
# Exécute <code>/discordbridge account link</code> en jeu.
# Suis les instructions affichées dans le chat (un code ou un lien te sera fourni).
# Sur Discord, complète la liaison en suivant les instructions du bot.
# Une fois lié, tu reçois automatiquement les rôles Discord et groupes in-game configurés par les administrateurs.

{{Bandeau |type=info|Si vous changez de pseudo Discord, la synchronisation du nom peut être automatique selon la configuration du serveur.}}

=== Créer un salon Discord pour sa Land ===

Si tu es '''propriétaire d'une Land ou d'une Nation''', tu peux créer un salon textuel et vocal dédié directement dans le serveur Discord.

==== Conditions requises ====

* Être propriétaire ou avoir les droits sur une Land / Nation.
* Avoir son compte Minecraft lié à son compte Discord — voir [[#Lier son compte Discord|Lier son compte Discord]].
* Le plugin [[Lands]] doit être installé sur le serveur.

==== Commandes Discord ====

{| class="wikitable"
! Commande Discord !! Description
|-
| <code>/lands channel create</code> || Crée un salon Discord pour ta Land
|-
| <code>/nations channel create</code> || Crée un salon Discord pour ta Nation
|}

{{Bandeau|type=info|Les salons sont créés dans la catégorie définie par les administrateurs. Si aucune catégorie n'est configurée, ils apparaissent à la racine du serveur Discord.}}

== Pour les administrateurs ==

=== Installation et configuration du bot ===

==== Prérequis ====

# Crée une application Discord sur le [https://discord.com/developers/applications Portail Développeur Discord].
# Active les '''Intents''' suivants dans l'onglet ''Bot'' :
#* '''Server Members Intent'''
#* '''Message Content Intent'''
# Lors de l'invitation du bot, les '''scopes requis''' sont :
#* <code>applications.commands</code>
#* <code>bot</code>
# Le bot doit disposer des permissions Discord suivantes :
#* Gérer les salons
#* Gérer les webhooks
#* Lire les messages / Voir les salons
#* Envoyer des messages
#* Gérer les messages
#* Intégrer des liens
#* Joindre des fichiers
#* Voir l'historique des messages
#* Ajouter des réactions
# Copie le '''token du bot''' et colle-le dans <code>DiscordBridge/Modules/bot.yml</code> à l'option <code>token</code>.

=== Configuration des modules ===

==== Module Chat ====

Synchronise le chat in-game vers Discord et inversement.

{| class="wikitable"
! Commande Discord !! Description
|-
| <code>/config set CHAT_CHANNEL</code> || Définit le salon Discord recevant les messages du chat in-game
|}

{{Bandeau|type=warning|Votre compte Minecraft doit être lié à Discord pour que vos messages se synchronisent.}}

==== Module Events ====

Envoie des messages dans Discord lors d'événements sur le serveur (connexion, déconnexion, mort, etc.).

* La configuration se fait dans : <code>DiscordBridge/Modules/events.yml</code>
* Chaque événement peut être désactivé individuellement dans ce fichier.

==== Module Lands ====

Intègre DiscordBridge avec le plugin [[Lands]] pour les annonces et les salons de Land/Nation.

{| class="wikitable"
! Commande Discord !! Description
|-
| <code>/config set LANDS_CHAT_CATEGORY</code> || (Optionnel) Catégorie Discord où seront créés les salons de Land/Nation
|-
| <code>/config set LANDS_BROADCAST_CHANNEL</code> || (Optionnel) Salon Discord pour les annonces Lands (guerres, suppressions, etc.)
|-
| <code>/config set LANDS_NOTIFY_<broadcast_category></code> || Configure les rôles notifiés pour chaque catégorie d'annonce
|}

{{Bandeau|type=warning|Votre compte Minecraft doit être lié à Discord pour que vous puissiez créer votre channel Lands.}}
{{Bandeau|type=info|Remplace <code><broadcast_category></code> par la catégorie souhaitée (ex : <code>WAR</code>, <code>DELETE</code>…).}}

==== Module Linking ====

Gère la liaison entre comptes Minecraft et Discord.

{| class="wikitable"
! Commande Discord !! Description
|-
| <code>/config linking_allowed_roles add <role></code> || Restreint la liaison aux joueurs ayant ce rôle Discord
|-
| <code>/config linking_roles add</code> || Ajoute un rôle Discord attribué automatiquement aux joueurs liés
|-
| <code>/config linking_groups add</code> || Ajoute un groupe LuckPerms attribué automatiquement aux joueurs liés
|-
| <code>/config linking_name_sync_ignore_roles add <role></code> || Exclut les utilisateurs ayant ce rôle de la synchronisation de nom
|}

===== Commande in-game (administration) =====

{| class="wikitable"
! Commande !! Description !! Permission
|-
| <code>/discordbridge account admin migrate</code> || Migre les liaisons existantes depuis un autre plugin || <code>discordbridge.admin.command.account.admin.migrate</code>
|}

{{bandeau|type=info|Lors de l'ajout d'un rôle ou d'un groupe, les joueurs déjà liés le reçoivent automatiquement. La mise à jour est planifiée pour éviter toute surcharge sur les grands serveurs.}}

==== Module Tickets ====

Permet aux membres Discord de créer des tickets de support directement depuis le serveur Discord.

===== Configuration requise =====

{| class="wikitable"
! Commande Discord !! Description
|-
| <code>/config set tickets_category_closed</code> || Catégorie où sont déplacés les tickets fermés avant suppression
|-
| <code>/config set tickets_member_max_tickets</code> || Nombre maximum de tickets simultanés par utilisateur
|-
| <code>/config set tickets_role_support</code> || Rôle Discord pouvant voir et gérer tous les tickets
|-
| <code>/config set tickets_deletion_time</code> || Délai avant suppression d'un ticket fermé (ex : <code>1d</code>, <code>12h</code>)
|-
| <code>/config set tickets_remind_submitter</code> || Active ou désactive le rappel automatique au créateur (<code>true</code> / <code>false</code>)
|-
| <code>/config set tickets_staff_unavailable</code> || Message affiché si aucun staff n'est disponible (nécessite <code>tickets_role_support</code>)
|-
| <code>/config set tickets_creation_channel</code> || Salon Discord où le message de création de ticket sera posté
|-
| <code>/config type upsert</code> || Créer ou mettre à jour un type de ticket
|-
| <code>/config field upsert</code> || Créer ou mettre à jour les champs d'un type de ticket
|-
| <code>/config info create</code> || (Optionnel) Prédéfinir des informations demandées après création du ticket
|-
| <code>/config reason create</code> || (Optionnel) Prédéfinir des raisons de fermeture de ticket
|}

{{Bandeau|type=info|Pour effacer une valeur de configuration, exécute <code>/config set <option></code> sans préciser de valeur.}}

=== Commandes d'administration générales ===

{| class="wikitable"
! Commande !! Description !! Permission
|-
| <code>/discordbridge admin</code> || Accès aux commandes d'administration || <code>discordbridge.admin.command</code>
|-
| <code>/discordbridge admin reload</code> || Recharge la configuration du plugin || <code>discordbridge.admin.command.reload</code>
|}

{{Bandeau|type=info|Toutes les sous-commandes de <code>/discordbridge admin</code> suivent le format de permission : <code>discordbridge.admin.command.<souscommande></code>}}

=== Placeholders PlaceholderAPI ===

Ces placeholders nécessitent l'installation de [[PlaceholderAPI]].

{| class="wikitable"
! Placeholder !! Description
|-
| <code>%discordbridge_module_linking_amount%</code> || Nombre de joueurs ayant lié leur compte
|-
| <code>%discordbridge_module_linking_user_state_bool%</code> || <code>true</code> si le joueur a lié son compte, sinon <code>false</code>
|-
| <code>%discordbridge_module_linking_user_state%</code> || État de liaison (texte traduit depuis le fichier de locale)
|-
| <code>%discordbridge_module_linking_user_id%</code> || ID Discord de l'utilisateur lié
|-
| <code>%discordbridge_module_linking_user_name%</code> || Pseudo Discord de l'utilisateur lié
|-
| <code>%discordbridge_module_linking_user_booster%</code> || Indique si le joueur booste un serveur Discord du bot (texte)
|-
| <code>%discordbridge_module_linking_user_booster_bool%</code> || <code>true</code> si le joueur booste un serveur Discord du bot
|}

== Fichiers de configuration ==

{| class="wikitable"
! Fichier !! Rôle
|-
| <code>DiscordBridge/Modules/bot.yml</code> || Configuration principale du bot (token, URL d'invitation, etc.)
|-
| <code>DiscordBridge/Modules/events.yml</code> || Activation et désactivation des événements envoyés sur Discord
|-
| <code>DiscordBridge/Modules/chat.yml</code> || Configuration du module chat
|-
| <code>DiscordBridge/Modules/linking.yml</code> || Configuration du module de liaison de comptes
|}

== Voir aussi ==

* [[Lands]] — Plugin de gestion de territoires
* [[LuckPerms]] — Gestion des permissions et groupes
* [[PlaceholderAPI]] — Placeholders dynamiques
* [https://wiki.incredibleplugins.com/discordbridge Documentation officielle DiscordBridge]

Plugin:DiscordBridge

2026-04-04T05:37:03Z

Hiob : bandeaux

{{SHORTDESC:Plugin d'intégration entre Minecraft et Discord}}

{{Infobox Plugin
| nom = DiscordBridge
| image = Plugin_without_Logo.png
| type = Utilitaire
| dev = incredibleplugins
| docs = https://wiki.incredibleplugins.com/discordbridge
| sources =
| grade =
| status = installé
}}

'''DiscordBridge''' est un plugin d'intégration entre le serveur Minecraft et le serveur Discord.
Il relie les deux plateformes en offrant la synchronisation du chat, la liaison de comptes,
la gestion de tickets, les notifications d'événements et l'intégration avec le plugin [[Lands]].

== Pour les joueurs ==

=== Lier son compte Discord ===

La liaison de compte associe ton compte Minecraft à ton compte Discord.
Elle peut débloquer des rôles Discord automatiques, des groupes in-game et d'autres avantages selon la configuration du serveur.

==== Commandes in-game ====

{| class="wikitable"
! Commande !! Description !! Permission
|-
| <code>/discordbridge account link</code> || Lier son compte Discord à son compte Minecraft || <code>discordbridge.command.account.link</code>
|-
| <code>/discordbridge account unlink</code> || Délier son compte Discord || <code>discordbridge.command.account.unlink</code>
|-
| <code>/discordbridge invite</code> || Obtenir le lien d'invitation du serveur Discord || <code>discordbridge.command.invite</code>
|-
| <code>/discordbridge help [page]</code> || Afficher l'aide des commandes disponibles || <code>discordbridge.command.help</code>
|}

==== Étapes pour lier son compte ====

# Connecte-toi au serveur Minecraft.
# Exécute <code>/discordbridge account link</code> en jeu.
# Suis les instructions affichées dans le chat (un code ou un lien te sera fourni).
# Sur Discord, complète la liaison en suivant les instructions du bot.
# Une fois lié, tu reçois automatiquement les rôles Discord et groupes in-game configurés par les administrateurs.

{{Bandeau |type=info|Si vous changez de pseudo Discord, la synchronisation du nom peut être automatique selon la configuration du serveur.}}

=== Créer un salon Discord pour sa Land ===

Si tu es '''propriétaire d'une Land ou d'une Nation''', tu peux créer un salon textuel et vocal dédié directement dans le serveur Discord.

==== Conditions requises ====

* Être propriétaire ou avoir les droits sur une Land / Nation.
* Avoir son compte Minecraft lié à son compte Discord — voir [[#Lier son compte Discord|Lier son compte Discord]].
* Le plugin [[Lands]] doit être installé sur le serveur.

==== Commandes Discord ====

{| class="wikitable"
! Commande Discord !! Description
|-
| <code>/lands channel create</code> || Crée un salon Discord pour ta Land
|-
| <code>/nations channel create</code> || Crée un salon Discord pour ta Nation
|}

{{Note|Les salons sont créés dans la catégorie définie par les administrateurs. Si aucune catégorie n'est configurée, ils apparaissent à la racine du serveur Discord.}}

== Pour les administrateurs ==

=== Installation et configuration du bot ===

==== Prérequis ====

# Crée une application Discord sur le [https://discord.com/developers/applications Portail Développeur Discord].
# Active les '''Intents''' suivants dans l'onglet ''Bot'' :
#* '''Server Members Intent'''
#* '''Message Content Intent'''
# Lors de l'invitation du bot, les '''scopes requis''' sont :
#* <code>applications.commands</code>
#* <code>bot</code>
# Le bot doit disposer des permissions Discord suivantes :
#* Gérer les salons
#* Gérer les webhooks
#* Lire les messages / Voir les salons
#* Envoyer des messages
#* Gérer les messages
#* Intégrer des liens
#* Joindre des fichiers
#* Voir l'historique des messages
#* Ajouter des réactions
# Copie le '''token du bot''' et colle-le dans <code>DiscordBridge/Modules/bot.yml</code> à l'option <code>token</code>.

=== Configuration des modules ===

==== Module Chat ====

Synchronise le chat in-game vers Discord et inversement.

{| class="wikitable"
! Commande Discord !! Description
|-
| <code>/config set CHAT_CHANNEL</code> || Définit le salon Discord recevant les messages du chat in-game
|}

{{Bandeau|type=warning|Votre compte Minecraft doit être lié à Discord pour que vos messages se synchronisent.}}

==== Module Events ====

Envoie des messages dans Discord lors d'événements sur le serveur (connexion, déconnexion, mort, etc.).

* La configuration se fait dans : <code>DiscordBridge/Modules/events.yml</code>
* Chaque événement peut être désactivé individuellement dans ce fichier.

==== Module Lands ====

Intègre DiscordBridge avec le plugin [[Lands]] pour les annonces et les salons de Land/Nation.

{| class="wikitable"
! Commande Discord !! Description
|-
| <code>/config set LANDS_CHAT_CATEGORY</code> || (Optionnel) Catégorie Discord où seront créés les salons de Land/Nation
|-
| <code>/config set LANDS_BROADCAST_CHANNEL</code> || (Optionnel) Salon Discord pour les annonces Lands (guerres, suppressions, etc.)
|-
| <code>/config set LANDS_NOTIFY_<broadcast_category></code> || Configure les rôles notifiés pour chaque catégorie d'annonce
|}

{{Bandeau|type=warning|Votre compte Minecraft doit être lié à Discord pour que vous puissiez créer votre channel Lands.}}
{{Bandeau|type=info|Remplace <code><broadcast_category></code> par la catégorie souhaitée (ex : <code>WAR</code>, <code>DELETE</code>…).}}

==== Module Linking ====

Gère la liaison entre comptes Minecraft et Discord.

{| class="wikitable"
! Commande Discord !! Description
|-
| <code>/config linking_allowed_roles add <role></code> || Restreint la liaison aux joueurs ayant ce rôle Discord
|-
| <code>/config linking_roles add</code> || Ajoute un rôle Discord attribué automatiquement aux joueurs liés
|-
| <code>/config linking_groups add</code> || Ajoute un groupe LuckPerms attribué automatiquement aux joueurs liés
|-
| <code>/config linking_name_sync_ignore_roles add <role></code> || Exclut les utilisateurs ayant ce rôle de la synchronisation de nom
|}

===== Commande in-game (administration) =====

{| class="wikitable"
! Commande !! Description !! Permission
|-
| <code>/discordbridge account admin migrate</code> || Migre les liaisons existantes depuis un autre plugin || <code>discordbridge.admin.command.account.admin.migrate</code>
|}

{{bandeau|type=info|Lors de l'ajout d'un rôle ou d'un groupe, les joueurs déjà liés le reçoivent automatiquement. La mise à jour est planifiée pour éviter toute surcharge sur les grands serveurs.}}

==== Module Tickets ====

Permet aux membres Discord de créer des tickets de support directement depuis le serveur Discord.

===== Configuration requise =====

{| class="wikitable"
! Commande Discord !! Description
|-
| <code>/config set tickets_category_closed</code> || Catégorie où sont déplacés les tickets fermés avant suppression
|-
| <code>/config set tickets_member_max_tickets</code> || Nombre maximum de tickets simultanés par utilisateur
|-
| <code>/config set tickets_role_support</code> || Rôle Discord pouvant voir et gérer tous les tickets
|-
| <code>/config set tickets_deletion_time</code> || Délai avant suppression d'un ticket fermé (ex : <code>1d</code>, <code>12h</code>)
|-
| <code>/config set tickets_remind_submitter</code> || Active ou désactive le rappel automatique au créateur (<code>true</code> / <code>false</code>)
|-
| <code>/config set tickets_staff_unavailable</code> || Message affiché si aucun staff n'est disponible (nécessite <code>tickets_role_support</code>)
|-
| <code>/config set tickets_creation_channel</code> || Salon Discord où le message de création de ticket sera posté
|-
| <code>/config type upsert</code> || Créer ou mettre à jour un type de ticket
|-
| <code>/config field upsert</code> || Créer ou mettre à jour les champs d'un type de ticket
|-
| <code>/config info create</code> || (Optionnel) Prédéfinir des informations demandées après création du ticket
|-
| <code>/config reason create</code> || (Optionnel) Prédéfinir des raisons de fermeture de ticket
|}

{{Bandeau|type=info|Pour effacer une valeur de configuration, exécute <code>/config set <option></code> sans préciser de valeur.}}

=== Commandes d'administration générales ===

{| class="wikitable"
! Commande !! Description !! Permission
|-
| <code>/discordbridge admin</code> || Accès aux commandes d'administration || <code>discordbridge.admin.command</code>
|-
| <code>/discordbridge admin reload</code> || Recharge la configuration du plugin || <code>discordbridge.admin.command.reload</code>
|}

{{Bandeau|type=info|Toutes les sous-commandes de <code>/discordbridge admin</code> suivent le format de permission : <code>discordbridge.admin.command.<souscommande></code>}}

=== Placeholders PlaceholderAPI ===

Ces placeholders nécessitent l'installation de [[PlaceholderAPI]].

{| class="wikitable"
! Placeholder !! Description
|-
| <code>%discordbridge_module_linking_amount%</code> || Nombre de joueurs ayant lié leur compte
|-
| <code>%discordbridge_module_linking_user_state_bool%</code> || <code>true</code> si le joueur a lié son compte, sinon <code>false</code>
|-
| <code>%discordbridge_module_linking_user_state%</code> || État de liaison (texte traduit depuis le fichier de locale)
|-
| <code>%discordbridge_module_linking_user_id%</code> || ID Discord de l'utilisateur lié
|-
| <code>%discordbridge_module_linking_user_name%</code> || Pseudo Discord de l'utilisateur lié
|-
| <code>%discordbridge_module_linking_user_booster%</code> || Indique si le joueur booste un serveur Discord du bot (texte)
|-
| <code>%discordbridge_module_linking_user_booster_bool%</code> || <code>true</code> si le joueur booste un serveur Discord du bot
|}

== Fichiers de configuration ==

{| class="wikitable"
! Fichier !! Rôle
|-
| <code>DiscordBridge/Modules/bot.yml</code> || Configuration principale du bot (token, URL d'invitation, etc.)
|-
| <code>DiscordBridge/Modules/events.yml</code> || Activation et désactivation des événements envoyés sur Discord
|-
| <code>DiscordBridge/Modules/chat.yml</code> || Configuration du module chat
|-
| <code>DiscordBridge/Modules/linking.yml</code> || Configuration du module de liaison de comptes
|}

== Voir aussi ==

* [[Lands]] — Plugin de gestion de territoires
* [[LuckPerms]] — Gestion des permissions et groupes
* [[PlaceholderAPI]] — Placeholders dynamiques
* [https://wiki.incredibleplugins.com/discordbridge Documentation officielle DiscordBridge]

Plugin:DiscordBridge

2026-04-03T13:39:25Z

Hiob :

{{SHORTDESC:Plugin d'intégration entre Minecraft et Discord}}

{{Infobox Plugin
| nom = DiscordBridge
| image = Plugin_without_Logo.png
| type = Utilitaire
| dev = incredibleplugins
| docs = https://wiki.incredibleplugins.com/discordbridge
| sources =
| grade =
| status = installé
}}

'''DiscordBridge''' est un plugin d'intégration entre le serveur Minecraft et le serveur Discord.
Il relie les deux plateformes en offrant la synchronisation du chat, la liaison de comptes,
la gestion de tickets, les notifications d'événements et l'intégration avec le plugin [[Lands]].

== Pour les joueurs ==

=== Lier son compte Discord ===

La liaison de compte associe ton compte Minecraft à ton compte Discord.
Elle peut débloquer des rôles Discord automatiques, des groupes in-game et d'autres avantages selon la configuration du serveur.

==== Commandes in-game ====

{| class="wikitable"
! Commande !! Description !! Permission
|-
| <code>/discordbridge account link</code> || Lier son compte Discord à son compte Minecraft || <code>discordbridge.command.account.link</code>
|-
| <code>/discordbridge account unlink</code> || Délier son compte Discord || <code>discordbridge.command.account.unlink</code>
|-
| <code>/discordbridge invite</code> || Obtenir le lien d'invitation du serveur Discord || <code>discordbridge.command.invite</code>
|-
| <code>/discordbridge help [page]</code> || Afficher l'aide des commandes disponibles || <code>discordbridge.command.help</code>
|}

==== Étapes pour lier son compte ====

# Connecte-toi au serveur Minecraft.
# Exécute <code>/discordbridge account link</code> en jeu.
# Suis les instructions affichées dans le chat (un code ou un lien te sera fourni).
# Sur Discord, complète la liaison en suivant les instructions du bot.
# Une fois lié, tu reçois automatiquement les rôles Discord et groupes in-game configurés par les administrateurs.

{{Note|Si tu changes de pseudo Discord, la synchronisation du nom peut être automatique selon la configuration du serveur.}}

=== Créer un salon Discord pour sa Land ===

Si tu es '''propriétaire d'une Land ou d'une Nation''', tu peux créer un salon textuel et vocal dédié directement dans le serveur Discord.

==== Conditions requises ====

* Être propriétaire ou avoir les droits sur une Land / Nation.
* Avoir son compte Minecraft lié à son compte Discord — voir [[#Lier son compte Discord|Lier son compte Discord]].
* Le plugin [[Lands]] doit être installé sur le serveur.

==== Commandes Discord ====

{| class="wikitable"
! Commande Discord !! Description
|-
| <code>/lands channel create</code> || Crée un salon Discord pour ta Land
|-
| <code>/nations channel create</code> || Crée un salon Discord pour ta Nation
|}

{{Note|Les salons sont créés dans la catégorie définie par les administrateurs. Si aucune catégorie n'est configurée, ils apparaissent à la racine du serveur Discord.}}

== Pour les administrateurs ==

=== Installation et configuration du bot ===

==== Prérequis ====

# Crée une application Discord sur le [https://discord.com/developers/applications Portail Développeur Discord].
# Active les '''Intents''' suivants dans l'onglet ''Bot'' :
#* '''Server Members Intent'''
#* '''Message Content Intent'''
# Lors de l'invitation du bot, les '''scopes requis''' sont :
#* <code>applications.commands</code>
#* <code>bot</code>
# Le bot doit disposer des permissions Discord suivantes :
#* Gérer les salons
#* Gérer les webhooks
#* Lire les messages / Voir les salons
#* Envoyer des messages
#* Gérer les messages
#* Intégrer des liens
#* Joindre des fichiers
#* Voir l'historique des messages
#* Ajouter des réactions
# Copie le '''token du bot''' et colle-le dans <code>DiscordBridge/Modules/bot.yml</code> à l'option <code>token</code>.

{{Bandeau|type=warning|Ne partage jamais le token de ton bot. En cas de fuite, régénère-le immédiatement depuis le portail développeur Discord.}}

=== Configuration des modules ===

==== Module Chat ====

Synchronise le chat in-game vers Discord et inversement.

{| class="wikitable"
! Commande Discord !! Description
|-
| <code>/config set CHAT_CHANNEL</code> || Définit le salon Discord recevant les messages du chat in-game
|}

==== Module Events ====

Envoie des messages dans Discord lors d'événements sur le serveur (connexion, déconnexion, mort, etc.).

* La configuration se fait dans : <code>DiscordBridge/Modules/events.yml</code>
* Chaque événement peut être désactivé individuellement dans ce fichier.

==== Module Lands ====

Intègre DiscordBridge avec le plugin [[Lands]] pour les annonces et les salons de Land/Nation.

{| class="wikitable"
! Commande Discord !! Description
|-
| <code>/config set LANDS_CHAT_CATEGORY</code> || (Optionnel) Catégorie Discord où seront créés les salons de Land/Nation
|-
| <code>/config set LANDS_BROADCAST_CHANNEL</code> || (Optionnel) Salon Discord pour les annonces Lands (guerres, suppressions, etc.)
|-
| <code>/config set LANDS_NOTIFY_<broadcast_category></code> || Configure les rôles notifiés pour chaque catégorie d'annonce
|}

{{Bandeau|type=info|Remplace <code><broadcast_category></code> par la catégorie souhaitée (ex : <code>WAR</code>, <code>DELETE</code>…).}}

==== Module Linking ====

Gère la liaison entre comptes Minecraft et Discord.

{| class="wikitable"
! Commande Discord !! Description
|-
| <code>/config linking_allowed_roles add <role></code> || Restreint la liaison aux joueurs ayant ce rôle Discord
|-
| <code>/config linking_roles add</code> || Ajoute un rôle Discord attribué automatiquement aux joueurs liés
|-
| <code>/config linking_groups add</code> || Ajoute un groupe LuckPerms attribué automatiquement aux joueurs liés
|-
| <code>/config linking_name_sync_ignore_roles add <role></code> || Exclut les utilisateurs ayant ce rôle de la synchronisation de nom
|}

===== Commande in-game (administration) =====

{| class="wikitable"
! Commande !! Description !! Permission
|-
| <code>/discordbridge account admin migrate</code> || Migre les liaisons existantes depuis un autre plugin || <code>discordbridge.admin.command.account.admin.migrate</code>
|}

{{bandeau|type=info|Lors de l'ajout d'un rôle ou d'un groupe, les joueurs déjà liés le reçoivent automatiquement. La mise à jour est planifiée pour éviter toute surcharge sur les grands serveurs.}}

==== Module Tickets ====

Permet aux membres Discord de créer des tickets de support directement depuis le serveur Discord.

===== Configuration requise =====

{| class="wikitable"
! Commande Discord !! Description
|-
| <code>/config set tickets_category_closed</code> || Catégorie où sont déplacés les tickets fermés avant suppression
|-
| <code>/config set tickets_member_max_tickets</code> || Nombre maximum de tickets simultanés par utilisateur
|-
| <code>/config set tickets_role_support</code> || Rôle Discord pouvant voir et gérer tous les tickets
|-
| <code>/config set tickets_deletion_time</code> || Délai avant suppression d'un ticket fermé (ex : <code>1d</code>, <code>12h</code>)
|-
| <code>/config set tickets_remind_submitter</code> || Active ou désactive le rappel automatique au créateur (<code>true</code> / <code>false</code>)
|-
| <code>/config set tickets_staff_unavailable</code> || Message affiché si aucun staff n'est disponible (nécessite <code>tickets_role_support</code>)
|-
| <code>/config set tickets_creation_channel</code> || Salon Discord où le message de création de ticket sera posté
|-
| <code>/config type upsert</code> || Créer ou mettre à jour un type de ticket
|-
| <code>/config field upsert</code> || Créer ou mettre à jour les champs d'un type de ticket
|-
| <code>/config info create</code> || (Optionnel) Prédéfinir des informations demandées après création du ticket
|-
| <code>/config reason create</code> || (Optionnel) Prédéfinir des raisons de fermeture de ticket
|}

{{Bandeau|type=info|Pour effacer une valeur de configuration, exécute <code>/config set <option></code> sans préciser de valeur.}}

=== Commandes d'administration générales ===

{| class="wikitable"
! Commande !! Description !! Permission
|-
| <code>/discordbridge admin</code> || Accès aux commandes d'administration || <code>discordbridge.admin.command</code>
|-
| <code>/discordbridge admin reload</code> || Recharge la configuration du plugin || <code>discordbridge.admin.command.reload</code>
|}

{{Note|Toutes les sous-commandes de <code>/discordbridge admin</code> suivent le format de permission : <code>discordbridge.admin.command.<souscommande></code>}}

=== Placeholders PlaceholderAPI ===

Ces placeholders nécessitent l'installation de [[PlaceholderAPI]].

{| class="wikitable"
! Placeholder !! Description
|-
| <code>%discordbridge_module_linking_amount%</code> || Nombre de joueurs ayant lié leur compte
|-
| <code>%discordbridge_module_linking_user_state_bool%</code> || <code>true</code> si le joueur a lié son compte, sinon <code>false</code>
|-
| <code>%discordbridge_module_linking_user_state%</code> || État de liaison (texte traduit depuis le fichier de locale)
|-
| <code>%discordbridge_module_linking_user_id%</code> || ID Discord de l'utilisateur lié
|-
| <code>%discordbridge_module_linking_user_name%</code> || Pseudo Discord de l'utilisateur lié
|-
| <code>%discordbridge_module_linking_user_booster%</code> || Indique si le joueur booste un serveur Discord du bot (texte)
|-
| <code>%discordbridge_module_linking_user_booster_bool%</code> || <code>true</code> si le joueur booste un serveur Discord du bot
|}

== Fichiers de configuration ==

{| class="wikitable"
! Fichier !! Rôle
|-
| <code>DiscordBridge/Modules/bot.yml</code> || Configuration principale du bot (token, URL d'invitation, etc.)
|-
| <code>DiscordBridge/Modules/events.yml</code> || Activation et désactivation des événements envoyés sur Discord
|-
| <code>DiscordBridge/Modules/chat.yml</code> || Configuration du module chat
|-
| <code>DiscordBridge/Modules/linking.yml</code> || Configuration du module de liaison de comptes
|}

== Voir aussi ==

* [[Lands]] — Plugin de gestion de territoires
* [[LuckPerms]] — Gestion des permissions et groupes
* [[PlaceholderAPI]] — Placeholders dynamiques
* [https://wiki.incredibleplugins.com/discordbridge Documentation officielle DiscordBridge]

Plugin:DiscordBridge

2026-04-03T09:50:49Z

Hiob : Page créée avec « {{Infobox Plugin | nom = DiscordBridge | image = Plugin_without_Logo.png | type = Utilitaire | dev = incredibleplugins | docs = https://wiki.incredibleplugins.com/discordbridge | sources = | grade = | status = installé }} '''DiscordBridge''' est un plugin d'intégration entre le serveur Minecraft et le serveur Discord. Il relie les deux plateformes en offrant la synchronisation du chat, la liaison de comptes, la gestion de tickets, les not... »

{{Infobox Plugin
| nom = DiscordBridge
| image = Plugin_without_Logo.png
| type = Utilitaire
| dev = incredibleplugins
| docs = https://wiki.incredibleplugins.com/discordbridge
| sources =
| grade =
| status = installé
}}

'''DiscordBridge''' est un plugin d'intégration entre le serveur Minecraft et le serveur Discord.
Il relie les deux plateformes en offrant la synchronisation du chat, la liaison de comptes,
la gestion de tickets, les notifications d'événements et l'intégration avec le plugin [[Lands]].

== Pour les joueurs ==

=== Lier son compte Discord ===

La liaison de compte associe ton compte Minecraft à ton compte Discord.
Elle peut débloquer des rôles Discord automatiques, des groupes in-game et d'autres avantages selon la configuration du serveur.

==== Commandes in-game ====

{| class="wikitable"
! Commande !! Description !! Permission
|-
| <code>/discordbridge account link</code> || Lier son compte Discord à son compte Minecraft || <code>discordbridge.command.account.link</code>
|-
| <code>/discordbridge account unlink</code> || Délier son compte Discord || <code>discordbridge.command.account.unlink</code>
|-
| <code>/discordbridge invite</code> || Obtenir le lien d'invitation du serveur Discord || <code>discordbridge.command.invite</code>
|-
| <code>/discordbridge help [page]</code> || Afficher l'aide des commandes disponibles || <code>discordbridge.command.help</code>
|}

==== Étapes pour lier son compte ====

# Connecte-toi au serveur Minecraft.
# Exécute <code>/discordbridge account link</code> en jeu.
# Suis les instructions affichées dans le chat (un code ou un lien te sera fourni).
# Sur Discord, complète la liaison en suivant les instructions du bot.
# Une fois lié, tu reçois automatiquement les rôles Discord et groupes in-game configurés par les administrateurs.

{{Note|Si tu changes de pseudo Discord, la synchronisation du nom peut être automatique selon la configuration du serveur.}}

=== Créer un salon Discord pour sa Land ===

Si tu es '''propriétaire d'une Land ou d'une Nation''', tu peux créer un salon textuel et vocal dédié directement dans le serveur Discord.

==== Conditions requises ====

* Être propriétaire ou avoir les droits sur une Land / Nation.
* Avoir son compte Minecraft lié à son compte Discord — voir [[#Lier son compte Discord|Lier son compte Discord]].
* Le plugin [[Lands]] doit être installé sur le serveur.

==== Commandes Discord ====

{| class="wikitable"
! Commande Discord !! Description
|-
| <code>/lands channel create</code> || Crée un salon Discord pour ta Land
|-
| <code>/nations channel create</code> || Crée un salon Discord pour ta Nation
|}

{{Note|Les salons sont créés dans la catégorie définie par les administrateurs. Si aucune catégorie n'est configurée, ils apparaissent à la racine du serveur Discord.}}

== Pour les administrateurs ==

=== Installation et configuration du bot ===

==== Prérequis ====

# Crée une application Discord sur le [https://discord.com/developers/applications Portail Développeur Discord].
# Active les '''Intents''' suivants dans l'onglet ''Bot'' :
#* '''Server Members Intent'''
#* '''Message Content Intent'''
# Lors de l'invitation du bot, les '''scopes requis''' sont :
#* <code>applications.commands</code>
#* <code>bot</code>
# Le bot doit disposer des permissions Discord suivantes :
#* Gérer les salons
#* Gérer les webhooks
#* Lire les messages / Voir les salons
#* Envoyer des messages
#* Gérer les messages
#* Intégrer des liens
#* Joindre des fichiers
#* Voir l'historique des messages
#* Ajouter des réactions
# Copie le '''token du bot''' et colle-le dans <code>DiscordBridge/Modules/bot.yml</code> à l'option <code>token</code>.

{{Bandeau|type=warning|Ne partage jamais le token de ton bot. En cas de fuite, régénère-le immédiatement depuis le portail développeur Discord.}}

=== Configuration des modules ===

==== Module Chat ====

Synchronise le chat in-game vers Discord et inversement.

{| class="wikitable"
! Commande Discord !! Description
|-
| <code>/config set CHAT_CHANNEL</code> || Définit le salon Discord recevant les messages du chat in-game
|}

==== Module Events ====

Envoie des messages dans Discord lors d'événements sur le serveur (connexion, déconnexion, mort, etc.).

* La configuration se fait dans : <code>DiscordBridge/Modules/events.yml</code>
* Chaque événement peut être désactivé individuellement dans ce fichier.

==== Module Lands ====

Intègre DiscordBridge avec le plugin [[Lands]] pour les annonces et les salons de Land/Nation.

{| class="wikitable"
! Commande Discord !! Description
|-
| <code>/config set LANDS_CHAT_CATEGORY</code> || (Optionnel) Catégorie Discord où seront créés les salons de Land/Nation
|-
| <code>/config set LANDS_BROADCAST_CHANNEL</code> || (Optionnel) Salon Discord pour les annonces Lands (guerres, suppressions, etc.)
|-
| <code>/config set LANDS_NOTIFY_<broadcast_category></code> || Configure les rôles notifiés pour chaque catégorie d'annonce
|}

{{Bandeau|type=info|Remplace <code><broadcast_category></code> par la catégorie souhaitée (ex : <code>WAR</code>, <code>DELETE</code>…).}}

==== Module Linking ====

Gère la liaison entre comptes Minecraft et Discord.

{| class="wikitable"
! Commande Discord !! Description
|-
| <code>/config linking_allowed_roles add <role></code> || Restreint la liaison aux joueurs ayant ce rôle Discord
|-
| <code>/config linking_roles add</code> || Ajoute un rôle Discord attribué automatiquement aux joueurs liés
|-
| <code>/config linking_groups add</code> || Ajoute un groupe LuckPerms attribué automatiquement aux joueurs liés
|-
| <code>/config linking_name_sync_ignore_roles add <role></code> || Exclut les utilisateurs ayant ce rôle de la synchronisation de nom
|}

===== Commande in-game (administration) =====

{| class="wikitable"
! Commande !! Description !! Permission
|-
| <code>/discordbridge account admin migrate</code> || Migre les liaisons existantes depuis un autre plugin || <code>discordbridge.admin.command.account.admin.migrate</code>
|}

{{bandeau|type=info|Lors de l'ajout d'un rôle ou d'un groupe, les joueurs déjà liés le reçoivent automatiquement. La mise à jour est planifiée pour éviter toute surcharge sur les grands serveurs.}}

==== Module Tickets ====

Permet aux membres Discord de créer des tickets de support directement depuis le serveur Discord.

===== Configuration requise =====

{| class="wikitable"
! Commande Discord !! Description
|-
| <code>/config set tickets_category_closed</code> || Catégorie où sont déplacés les tickets fermés avant suppression
|-
| <code>/config set tickets_member_max_tickets</code> || Nombre maximum de tickets simultanés par utilisateur
|-
| <code>/config set tickets_role_support</code> || Rôle Discord pouvant voir et gérer tous les tickets
|-
| <code>/config set tickets_deletion_time</code> || Délai avant suppression d'un ticket fermé (ex : <code>1d</code>, <code>12h</code>)
|-
| <code>/config set tickets_remind_submitter</code> || Active ou désactive le rappel automatique au créateur (<code>true</code> / <code>false</code>)
|-
| <code>/config set tickets_staff_unavailable</code> || Message affiché si aucun staff n'est disponible (nécessite <code>tickets_role_support</code>)
|-
| <code>/config set tickets_creation_channel</code> || Salon Discord où le message de création de ticket sera posté
|-
| <code>/config type upsert</code> || Créer ou mettre à jour un type de ticket
|-
| <code>/config field upsert</code> || Créer ou mettre à jour les champs d'un type de ticket
|-
| <code>/config info create</code> || (Optionnel) Prédéfinir des informations demandées après création du ticket
|-
| <code>/config reason create</code> || (Optionnel) Prédéfinir des raisons de fermeture de ticket
|}

{{Bandeau|type=info|Pour effacer une valeur de configuration, exécute <code>/config set <option></code> sans préciser de valeur.}}

=== Commandes d'administration générales ===

{| class="wikitable"
! Commande !! Description !! Permission
|-
| <code>/discordbridge admin</code> || Accès aux commandes d'administration || <code>discordbridge.admin.command</code>
|-
| <code>/discordbridge admin reload</code> || Recharge la configuration du plugin || <code>discordbridge.admin.command.reload</code>
|}

{{Note|Toutes les sous-commandes de <code>/discordbridge admin</code> suivent le format de permission : <code>discordbridge.admin.command.<souscommande></code>}}

=== Placeholders PlaceholderAPI ===

Ces placeholders nécessitent l'installation de [[PlaceholderAPI]].

{| class="wikitable"
! Placeholder !! Description
|-
| <code>%discordbridge_module_linking_amount%</code> || Nombre de joueurs ayant lié leur compte
|-
| <code>%discordbridge_module_linking_user_state_bool%</code> || <code>true</code> si le joueur a lié son compte, sinon <code>false</code>
|-
| <code>%discordbridge_module_linking_user_state%</code> || État de liaison (texte traduit depuis le fichier de locale)
|-
| <code>%discordbridge_module_linking_user_id%</code> || ID Discord de l'utilisateur lié
|-
| <code>%discordbridge_module_linking_user_name%</code> || Pseudo Discord de l'utilisateur lié
|-
| <code>%discordbridge_module_linking_user_booster%</code> || Indique si le joueur booste un serveur Discord du bot (texte)
|-
| <code>%discordbridge_module_linking_user_booster_bool%</code> || <code>true</code> si le joueur booste un serveur Discord du bot
|}

== Fichiers de configuration ==

{| class="wikitable"
! Fichier !! Rôle
|-
| <code>DiscordBridge/Modules/bot.yml</code> || Configuration principale du bot (token, URL d'invitation, etc.)
|-
| <code>DiscordBridge/Modules/events.yml</code> || Activation et désactivation des événements envoyés sur Discord
|-
| <code>DiscordBridge/Modules/chat.yml</code> || Configuration du module chat
|-
| <code>DiscordBridge/Modules/linking.yml</code> || Configuration du module de liaison de comptes
|}

== Voir aussi ==

* [[Lands]] — Plugin de gestion de territoires
* [[LuckPerms]] — Gestion des permissions et groupes
* [[PlaceholderAPI]] — Placeholders dynamiques
* [https://wiki.incredibleplugins.com/discordbridge Documentation officielle DiscordBridge]

Plugin:Lands

2026-04-03T08:35:24Z

Hiob : ajout discordbridge

{{SHORTDESC:Système de gestion territoriale et politique utilisé sur Nefald pour les villes, les territoires et les relations entre joueurs.}}

{{Révision|§ coûts définitifs à ajuster selon la configuration finale}}

{{Infobox Plugin
|nom=Lands
|image=Plugin_without_Logo.png
|type=Utilitaire
|dev=incredibleplugins
|docs=https://wiki.incredibleplugins.com/lands
|sources=https://github.com/IncrediblePlugins/Lands
|grade=[[Pérégrin]]
|status=installé
}}

'''Lands''' est le système utilisé sur Nefald pour gérer les territoires, les villes, les camps et les nations.
Il constitue le socle technique de l'organisation géographique, politique et économique du monde.

Cette page présente le fonctionnement général de Lands tel qu'il s'applique sur Nefald.
Elle complète la documentation officielle du plugin par une présentation adaptée aux règles et usages du serveur.

== Notions essentielles ==

=== Territoire (Land) ===
Un '''land''' est une entité territoriale gérée par un joueur ou un groupe de joueurs.
Sur Nefald, il correspond à une ville, un camp ou un avant-poste structuré (voir les [[:Catégorie:Localité|localités]]).

=== Claim ===
Un '''claim''' correspond à un chunk revendiqué par un land.
Il délimite une zone protégée et soumise aux permissions du territoire.

=== Villes, camps et nations ===
* Un '''camp''' est une entité de taille réduite, destinée à des installations limitées ou temporaires.
* Une '''ville''' est l'entité territoriale principale, disposant d'une organisation, d'une économie et d'un rôle politique.
* Une '''nation''' regroupe plusieurs villes sous une même structure politique.

Ces entités sont définies techniquement par Lands, mais leur organisation interne relève du roleplay.

=== Résidents, rôles et permissions ===
Les joueurs rattachés à un land sont appelés '''résidents'''.
Leurs droits sont définis par des '''rôles''', qui contrôlent notamment :
* la construction ;
* l'accès aux coffres et infrastructures ;
* l'invitation ou l'exclusion de joueurs ;
* certaines actions administratives.

=== Coûts des territoires ===
Créer et maintenir un territoire, engendre un coût qui vous sera prélevé. Voir [[monnaie]].

{| class="wikitable"
! Action !! Commande !! Coût
|-
| Création d'un campement
| <code>/land createcamp</code>
| {{Monnaie|2 oboles}}
|-
| Création d'un territoire
| <code>/land create</code>
| {{Monnaie|2 écus}}
|-
| Création d'un claim
| <code>/land claim</code>
| {{Monnaie|1 obole}}
|-
| Création d'une nation
| <code>/nation create</code>
| {{Monnaie|6 écus}}
|-
| Maintien journalier d'un claim
(territoire + nation)
|
|{{Monnaie|3 sols}}
|}
{{Monnaie/Légende}}

== Niveaux et capacités des territoires ==

Les niveaux définis par Lands sont des '''niveaux techniques'''.
Ils déterminent des capacités (nombre de claims, options disponibles, limites internes).

Ils '''n'imposent aucune organisation roleplay'''.

Une ville ou une nation peut atteindre un palier élevé sans adopter le statut correspondant du point de vue roleplay.
Par exemple, une nation au palier « Royaume » peut être organisée en république ou toute autre forme politique en jeu.

=== Coûts et prérequis ===

{| class="wikitable"
! Niveau !! Prérequis !! Nombre de chunks
|-
| '''Lieu-dit'''
|
| 16 chunks
|-
| '''Hameau'''
|
* 3 habitants ''+ maire''
* 16 chunks revendiqués
* {{Monnaie|4 écus}} en banque
| 64 chunks
|-
| '''Village'''
|
* 7 habitants ''+ maire''
* 64 chunks revendiqués
* {{Monnaie|6 écus}} en banque
| 128 chunks
|-
| '''Ville'''
|
* 15 habitants ''+ maire''
* 128 chunks revendiqués
* {{Monnaie|8 écus}} en banque
| 256 chunks
|}

== Niveaux des nations ==

{| class="wikitable"
! Niveau !! Prérequis !! Chunks produits
|-
| '''Comté'''
|
| 8 chunks
|-
| '''Duché'''
|
* 3 territoires
* {{Monnaie|12 écus}} en banque
| 16 chunks
|-
| '''Royaume'''
|
* 6 territoires
* {{Monnaie|18 écus}} en banque
| 24 chunks
|-
| '''Empire'''
|
* 12 territoires
* {{Monnaie|24 écus}} en banque
| 32 chunks
|}

== Coffres-forts et économie physique ==
Sur Nefald, l'économie est intégralement '''physique'''.
Les banques des lands prennent la forme de '''coffres-forts'''.

=== Création d'un coffre-fort ===
Pour créer un coffre-fort :
* utiliser un coffre, coffre piégé, coffre en cuivre (toutes oxydations et versions cirées incluses) ou un tonneau ;
* placer un panneau sur le conteneur ;
* inscrire sur la première ligne :
<code>[land vault]</code>

Il est possible :
* d'indiquer le nom du land sur la troisième ligne ;
* à défaut, le coffre-fort est automatiquement lié au land dans lequel il se trouve.

== Diplomatie et conflits ==
Lands propose des mécaniques avancées :
* relations diplomatiques ;
* alliances ;
* conflits et guerres ;
* occupation ou perte de territoires.

{{Badge|Bêta|type=beta}} '''Les conflits armés et guerres sont désactivés durant la phase de bêta.'''
Ils seront activés ultérieurement, une fois le socle territorial stabilisé.

== Intégration Discord ==

Le plugin [[Plugin:DiscordBridge|DiscordBridge]] s'intègre nativement à Lands et permet aux chefs de Land et de Nation de disposer de salons Discord privés, gérés automatiquement par le bot sans intervention de l'administration du serveur.

=== Prérequis ===
Cette fonctionnalité nécessite que les deux plugins '''Lands''' et '''[[Plugin:DiscordBridge|DiscordBridge]]''' soient installés et actifs sur le serveur. La configuration initiale est réalisée par un administrateur directement depuis Discord.

=== Configuration des catégories (administration) ===
Avant que les chefs de Land puissent créer leurs salons, un administrateur doit définir la '''catégorie Discord''' qui les accueillera, en exécutant la commande suivante dans un salon Discord où le bot est présent :

/config set LANDS_CHAT_CATEGORY

Il est également recommandé de configurer un '''salon d'annonces''' dédié aux événements liés aux Lands (suppressions, déclarations de guerre, etc.) :

/config set LANDS_BROADCAST_CHANNEL

Les notifications peuvent être affinées par catégorie d'événement via :

/config set LANDS_NOTIFY_<broadcast_category>

où <code><broadcast_category></code> est à remplacer par la catégorie d'événement concernée.

=== Création d'un salon par un chef de Land ===
Une fois la catégorie définie par l'administration, chaque chef de Land peut créer son propre salon textuel et vocal privé depuis Discord :

{| class="wikitable"
! Commande Discord !! Description
|-
| <code>/lands channel create</code>
| Crée un salon textuel et vocal pour le Land dans la catégorie configurée.
|-
| <code>/nations channel create</code>
| Crée un salon textuel et vocal pour la Nation dans la catégorie configurée.
|}

{{Bandeau|type=info|La création de salons Discord par les joueurs est entièrement optionnelle. Si la <code>LANDS_CHAT_CATEGORY</code> n'est pas définie par l'administration, cette fonctionnalité reste simplement inactive. Les annonces via <code>LANDS_BROADCAST_CHANNEL</code> fonctionnent indépendamment.}}

== Commandes & permissions ==

=== Alias ===

{| class="wikitable"
!'''Commande'''
!'''Alias 1'''
!'''Alias 2'''
|-
|/lands
|/land
|/wars
|-
|/nations
|''N/A''
|''N/A''
|}

=== Commandes principales ===

{| class="wikitable"
!'''Commande'''
!'''Description'''
!'''Permission'''
|-
|/lands create
|Créer un land
|lands.create
|-
|/lands claim
|Revendiquer un chunk
|lands.claim
|-
|/lands unclaim
|Libérer un chunk
|lands.unclaim
|-
|/lands trust
|Inviter un joueur
|lands.trust
|-
|/lands untrust
|Retirer un joueur
|lands.untrust
|-
|/lands menu
|Ouvrir le menu du land
|lands.menu
|-
|/lands setspawn
|Définir le spawn du land
|lands.setspawn
|-
|/lands delete
|Supprimer un land
|lands.delete
|}

=== Nations ===

{| class="wikitable"
!'''Commande'''
!'''Description'''
!'''Permission'''
|-
|/nations create
|Créer une nation
|lands.nation.create
|-
|/nations trust
|Ajouter un land à une nation
|lands.nation.trust
|-
|/nations untrust
|Retirer un land d'une nation
|lands.nation.untrust
|-
|/nations relations
|Gérer les relations diplomatiques
|lands.nation.relations
|}

=== Commandes administratives ===

{| class="wikitable"
!'''Commande'''
!'''Description'''
!'''Permission'''
|-
|/lands admin
|Accéder aux outils administratifs
|lands.admin
|-
|/lands edit
|Modifier un land
|lands.admin.edit
|-
|/lands admin trust
|Forcer une invitation
|lands.admin.trust
|-
|/lands admin untrust
|Forcer une exclusion
|lands.admin.untrust
|-
|/lands reload
|Recharger la configuration
|lands.admin.reload
|}

[[Catégorie:Plugin installé]]

Modèle:Touche/Symbole

2026-04-02T19:34:31Z

Hiob : Page créée avec « <includeonly>{{#switch:{{lc:{{{1|}}}}} | verr maj = ⇪ Verr Maj | shift = ⇧ Shift | entrée = ↵ Entrée | cmd = ⌘ Cmd | opt = ⌥ Opt | tab = Tab ⇆ | retour = ← Retour | méta = ⊞ Méta | menu = ≣ Menu | ctrl = Ctrl | alt = Alt | espace = Espace | suppr = Suppr |... »

<includeonly>{{#switch:{{lc:{{{1|}}}}}
| verr maj = ⇪ Verr Maj
| shift = ⇧ Shift
| entrée = ↵ Entrée
| cmd = ⌘ Cmd
| opt = ⌥ Opt
| tab = Tab ⇆
| retour = ← Retour
| méta = ⊞ Méta
| menu = ≣ Menu
| ctrl = Ctrl
| alt = Alt
| espace = Espace
| suppr = Suppr
| échap | echap = Échap
| haut = ↑
| bas = ↓
| gauche = ←
| droite = →
| * = <nowiki/>*
| # = <nowiki/>#
| : = <nowiki/>:
| l-haut | l haut = L↑
| l-bas | l bas = L↓
| l-gauche | l gauche = L←
| l-droit | l droit = L→
| l-ne | l ne = L↗
| l-se | l se = L↘
| l-nw | l nw = L↖
| l-sw | l sw = L↙
| r-up | r up = R↑
| r-bas | r bas = R↓
| r-gauche | r gauche = R←
| r-droit | r droit = R→
| r-ne | r ne = R↗
| r-se | r se = R↘
| r-nw | r nw = R↖
| r-sw | r sw = R↙
| ps x | ex = ×
| ps c | cercle = ○
| ps s | carré = □
| ps t | triangle = △
| c-haut | c haut = C↑
| c-bas | c bas = C↓
| c-gauche | c gauche = C←
| c-droite | c droite = C→
| c-ne | c ne = C↗
| c-se | c se = C↘
| c-nw | c nw = C↖
| c-sw | c sw = C↙
| xb-a = Ⓐ
| xb-b = Ⓑ
| xb-x = Ⓧ
| xb-y = Ⓨ
| xb-lb = ╼
| xb-rb = ╾
| xb-lt = ⟅
| xb-rt = ⟆
| xb-retour = ◀
| xb-commencer = ▶
| #default = {{{1}}}
}}</includeonly>

Modèle:Touche/styles.css

2026-04-02T19:33:58Z

Hiob : Page créée avec « /* ============================================================ * MODÈLE TOUCHE — Rendu clavier * ============================================================ */ .nefald-kbd-combo { display: inline-flex; align-items: center; gap: var(--space-xxs, 0.25rem); vertical-align: middle; line-height: 1; } .nefald-kbd { display: inline-flex; align-items: center; justify-content: center; min-width: 1.75em; padding: 0.15em 0.5em 0.25em; font-family: var(--font-family... »

/* ============================================================
* MODÈLE TOUCHE — Rendu clavier
* ============================================================ */

.nefald-kbd-combo {
display: inline-flex;
align-items: center;
gap: var(--space-xxs, 0.25rem);
vertical-align: middle;
line-height: 1;
}

.nefald-kbd {
display: inline-flex;
align-items: center;
justify-content: center;
min-width: 1.75em;
padding: 0.15em 0.5em 0.25em;
font-family: var(--font-family-citizen-monospace);
font-size: 0.8em;
font-weight: var(--font-weight-semibold);
line-height: 1.4;
white-space: nowrap;
color: var(--color-emphasized);
background-color: var(--color-surface-2);
border: 1px solid var(--color-surface-4);
border-bottom-width: 3px;
border-radius: 5px;
box-shadow: 0 1px 0 1px var(--color-surface-3), inset 0 -1px 0 var(--color-surface-4);
user-select: none;
}

.nefald-kbd-sep {
font-size: 0.75em;
font-weight: var(--font-weight-semibold, 600);
color: var(--color-subtle);
user-select: none;
}

Modèle:Touche/doc

2026-04-02T19:33:36Z

Hiob : Page créée avec « == Description == Affiche une combinaison de touches de clavier de façon visuelle. == Syntaxe == <pre>{{Touche|touche1|touche2|touche3|...}}</pre> Jusqu'à 5 touches peuvent être combinées. == Exemples == {| class="wikitable" ! Wikicode !! Rendu |- | <code><nowiki>{{Touche|Ctrl|S}}</nowiki></code> || {{Touche|Ctrl|S}} |- | <code><nowiki>{{Touche|Ctrl|Shift|L}}</nowiki></code> || {{Touche|Ctrl|Shift|L}} |- | <code><nowiki>{{Touche|Cmd|Shift|L}}</nowiki></cod... »

== Description ==
Affiche une combinaison de touches de clavier de façon visuelle.

== Syntaxe ==
<pre>{{Touche|touche1|touche2|touche3|...}}</pre>

Jusqu'à 5 touches peuvent être combinées.

== Exemples ==
{| class="wikitable"
! Wikicode !! Rendu
|-
| <code><nowiki>{{Touche|Ctrl|S}}</nowiki></code> || {{Touche|Ctrl|S}}
|-
| <code><nowiki>{{Touche|Ctrl|Shift|L}}</nowiki></code> || {{Touche|Ctrl|Shift|L}}
|-
| <code><nowiki>{{Touche|Cmd|Shift|L}}</nowiki></code> || {{Touche|Cmd|Shift|L}}
|-
| <code><nowiki>{{Touche|Alt|F4}}</nowiki></code> || {{Touche|Alt|F4}}
|-
| <code><nowiki>{{Touche|Échap}}</nowiki></code> || {{Touche|Échap}}
|-
| <code><nowiki>{{Touche|↑}}</nowiki></code> || {{Touche|↑}}
|}

== Notes ==
* Fonctionne avec n'importe quel texte : <code>Ctrl</code>, <code>Cmd</code>, <code>⌘</code>, <code>⇧</code>, <code>↵</code>…
* Peut être utilisé en ligne dans une phrase : appuyez sur {{Touche|Ctrl|Z}} pour annuler.
<noinclude>[[Catégorie:Documentation de modèle]]</noinclude>

Modèle:Touche

2026-04-02T19:33:20Z

Hiob : Page créée avec « <noinclude>{{Documentation}}Catégorie:Modèle de mise en forme</noinclude><includeonly><templatestyles src="Touche/styles.css" />{{#if:{{{1|}}}|<kbd class="nefald-kbd">{{Touche/Symbole|{{{1}}}}}</kbd>}}{{#if:{{{2|}}}|+<kbd class="nefald-kbd">{{Touche/Symbole|{{{2}}}}}</kbd>}}{{#if:{{{3|}}}|+<kbd class="nefald-kbd">{{Touche/Sy... »

<noinclude>{{Documentation}}[[Catégorie:Modèle de mise en forme]]</noinclude><includeonly><templatestyles src="Touche/styles.css" />{{#if:{{{1|}}}|<kbd class="nefald-kbd">{{Touche/Symbole|{{{1}}}}}</kbd>}}{{#if:{{{2|}}}|+<kbd class="nefald-kbd">{{Touche/Symbole|{{{2}}}}}</kbd>}}{{#if:{{{3|}}}|+<kbd class="nefald-kbd">{{Touche/Symbole|{{{3}}}}}</kbd>}}{{#if:{{{4|}}}|+<kbd class="nefald-kbd">{{Touche/Symbole|{{{4}}}}}</kbd>}}{{#if:{{{5|}}}|+<kbd class="nefald-kbd">{{Touche/Symbole|{{{5}}}}}</kbd>}}</includeonly>

Monnaie

2026-03-30T19:20:18Z

Hiob : réécriture

{{SHORTDESC:Système monétaire officiel utilisé sur Fendral pour les échanges, propriétés et mécanismes économiques.}}

= Système monétaire =

Le système monétaire de [[Fendral]] repose sur des pièces physiques utilisées comme outil de gameplay.
Il constitue l'unique monnaie reconnue sur l'ensemble du serveur.

== Unités monétaires ==

Le système est en base mixte 64/64 et repose sur trois unités :

{| class="wikitable"
! Monnaie !! Item !! Matière !! Valeur en sols
|-
| '''Écu''' || [[Fichier:écu_pièce_or.png|24px|left]] || Or || 64 oboles 4096 sols
|-
| '''Obole''' || [[Fichier:obole_pièce_argent.png|24px|left]] || Argent || 64 sols
|-
| '''Sol''' || [[Fichier:sol_pièce_cuivre.png|24px|left]] || Cuivre || 1 sol
|}

== Fonctionnement ==

Les pièces :

* sont des éléments physiques non craftables
* peuvent être perdues (mort, vol, destruction)
* doivent être protégées par les joueurs
* ne sont soumises à aucune limite de possession
* ne sont pas générées automatiquement

Il n'existe pas de banque centrale à ce stade ([[Nefald:Roadmap|Roadmap]]).

== Obtention ==

=== Commercer avec les cités-états ===

Les grandes cités disposent de commerçants et d'un système d''''[[Hôtel des Ventes]]'''.
Les joueurs peuvent uniquement y vendre des ressources. Les prix pratiqués dépendent :

* du '''niveau du joueur''' dans le [[:Catégorie:Métier|métier]] associé aux objets vendus ;
* d'une logique d''''offre et de demande''' à l'échelle de chaque cité-état.

Ce système constitue une source de revenus stable et accessible.

=== Réaliser des quêtes ===

{{Badge|Bêta|type=beta}} Des '''[[Quête]]s''' permettent d'obtenir des récompenses financières.
Elles peuvent être :

* journalières ;
* liées à des villes ou factions ;
* événementielles.

Les [[Quête]]s offrent un revenu encadré, indépendant des fluctuations du marché.

=== Commerce entre joueurs ===

Les joueurs peuvent commercer librement entre eux :

* ventes directes ;
* contrats et commandes spécifiques ;
* négociations privées.

Le troc reste également possible. Ces échanges reposent sur la dynamique économique et roleplay du serveur.

== Usages ==

La monnaie est nécessaire pour :

* acheter ou louer des propriétés dans les villes existantes ;
* fonder et gérer des territoires via [[Plugin:Lands|Lands]] ;
* payer les loyers et coûts d'entretien liés aux claims ;
* servir de tribut dans le cadre d'accords de paix.

Les nations et cités peuvent définir librement des taxes, des loyers et des prélèvements.
Les propriétaires de territoires peuvent également louer des parcelles et organiser une activité économique locale, dont les revenus dépendent de la gestion et de l'attractivité du territoire.

=== Change de monnaie ===

Les bureaux de trésorerie, présents dans chaque cité-état, permettent de convertir les pièces entre elles :

* 64 sols ↔ 1 obole
* 64 oboles ↔ 1 écu

== Stockage ==

La monnaie peut être stockée :

* individuellement ;
* dans un [[territoire]] ;
* au niveau d'une [[Territoire#nation|nation]].

<noinclude>
[[Catégorie:Economie & Technologies]]
</noinclude>

Modèle:Conseil/doc

2026-03-13T20:03:59Z

Hiob : + Officier parce que FaFa il est tout chafouin

== Description ==
Le modèle {{m|Modèle:Conseil}} affiche l'ensemble des membres de l'équipe d'administration du serveur Nefald sous forme de cartes visuelles.

Il regroupe automatiquement les sous-modèles suivants :
* {{m|Modèle:Intendant}} — Les [[Intendant]]s
* {{m|Modèle:Officier}} - Les [[Officier]]s
* {{m|Modèle:Architecte}} — Les [[Architecte]]s
* {{m|Modèle:Scribe}} — Les [[Scribe]]s
* {{m|Modèle:Scriptomancien}} — Les [[Scriptomancien]]s

== Utilisation ==
<pre>{{Conseil}}</pre>

Ce modèle n'accepte '''aucun paramètre'''.
Pour modifier les membres affichés, éditez directement le sous-modèle correspondant au rôle concerné.

{{Bandeau|type=warning|N'éditez en aucun cas {{m|Modèle:Conseil}} pour ajouter des membres du '''Conseil''', éditez uniquement les sous-modèles listés ci-dessous.}}

== Modification ==
{| class="wikitable"
! Rôle !! Modèle à éditer
|-
| [[Intendant]] || {{m|Modèle:Intendant}}
|-
| [[Officier]] || {{m|Modèle:Officier}}
|-
| [[Architecte]] || {{m|Modèle:Architecte}}
|-
| [[Scribe]] || {{m|Modèle:Scribe}}
|-
| [[Scriptomancien]] || {{m|Modèle:Scriptomancien}}
|}

Utilisez {{m|Modèle:Joueur}} pour ajouter ou modifier un membre au sous-modèle adéquat.

== Rendu du modèle ==
{{Conseil}}

== Rendu par rôle ==

=== Intendants ===
{{Intendant}}

=== Officiers ===
{{Officier}}

=== Architectes ===
{{Architecte}}

=== Scribes ===
{{Scribe}}

=== Scriptomanciens ===
{{Scriptomancien}}

== Voir aussi ==
* {{m|Modèle:Intendant}}
* {{m|Modèle:Officier}}
* {{m|Modèle:Architecte}}
* {{m|Modèle:Scribe}}
* {{m|Modèle:Scriptomancien}}

<noinclude>
[[Catégorie:Documentation de modèle]]
</noinclude>

Modèle:Agora/doc

2026-03-13T15:57:57Z

Hiob : Doc

== Description ==
Le modèle {{m|Modèle:Agora}} affiche l'ensemble des membres de l'équipe joueurs du serveur Nefald sous forme de cartes visuelles.

Il regroupe automatiquement les sous-modèles suivants :
* {{m|Modèle:Aspirant}} — Les [[Aspirant]]s
* {{m|Modèle:Bâtisseur}} — Les [[Bâtisseur]]s
* {{m|Modèle:Ménestrel}} — Les [[Ménestrel]]s
* {{m|Modèle:Machiniste}} — Les [[Machiniste]]s

== Utilisation ==
<pre>{{Agora}}</pre>

Ce modèle n'accepte '''aucun paramètre'''. Pour modifier les membres affichés, éditez directement le sous-modèle correspondant au rôle concerné.

== Modification ==
{| class="wikitable"
! Rôle !! Modèle à éditer
|-
| [[Aspirant]] || {{m|Modèle:Aspirant}}
|-
| [[Bâtisseur]] || {{m|Modèle:Bâtisseur}}
|-
| [[Ménestrel]] || {{m|Modèle:Ménestrel}}
|-
| [[Machiniste]] || {{m|Modèle:Machiniste}}
|}

== Rendu du modèle ==
{{Agora}}

== Rendu par rôle ==

=== Aspirants ===
{{Aspirant}}

=== Bâtisseur ===
{{Bâtisseur}}

=== Ménestrels ===
{{Ménestrel}}

=== Machinistes===
{{Machiniste}}

== Voir aussi ==
* {{m|Modèle:Aspirant}}
* {{m|Modèle:Bâtisseur}}
* {{m|Modèle:Ménestrel}}
* {{m|Modèle:Machiniste}}

<noinclude>
[[Catégorie:Documentation de modèle]]
</noinclude>

Modèle:Agora

2026-03-13T15:50:59Z

Hiob : Doc

<includeonly>
{{Grille|
‎{{Aspirant}}
{{Machiniste}}
{{Ménestrel}}
{{Bâtisseur}}
}}</includeonly>
<noinclude>{{Documentation}}[[Catégorie:Agora]]</noinclude>

Modèle:Aspirant

2026-03-13T15:48:23Z

Hiob : Page vide créée

Modèle:Agora

2026-03-13T15:48:08Z

Hiob :

{{Grille|
‎{{Aspirant}}
{{Machiniste}}
{{Ménestrel}}
{{Bâtisseur}}
}}

<noinclude>[[Catégorie:Agora]]</noinclude>

Modèle:Conseil/doc

2026-03-12T21:25:30Z

Hiob :

== Description ==
Le modèle {{m|Modèle:Conseil}} affiche l'ensemble des membres de l'équipe d'administration du serveur Nefald sous forme de cartes visuelles.

Il regroupe automatiquement les sous-modèles suivants :
* {{m|Modèle:Intendant}} — Les [[Intendant]]s
* {{m|Modèle:Architecte}} — Les [[Architecte]]s
* {{m|Modèle:Scribe}} — Les [[Scribe]]s
* {{m|Modèle:Scriptomancien}} — Les [[Scriptomancien]]s

== Utilisation ==
<pre>{{Conseil}}</pre>

Ce modèle n'accepte '''aucun paramètre'''.
Pour modifier les membres affichés, éditez directement le sous-modèle correspondant au rôle concerné.

{{Bandeau|type=warning|N'éditez en aucun cas {{m|Modèle:Conseil}} pour ajouter des membres du '''Conseil''', éditez uniquement les sous-modèles listés ci-dessous.}}

== Modification ==
{| class="wikitable"
! Rôle !! Modèle à éditer
|-
| [[Intendant]] || {{m|Modèle:Intendant}}
|-
| [[Architecte]] || {{m|Modèle:Architecte}}
|-
| [[Scribe]] || {{m|Modèle:Scribe}}
|-
| [[Scriptomancien]] || {{m|Modèle:Scriptomancien}}
|}

Utilisez {{m|Modèle:Joueur}} pour ajouter ou modifier un membre au sous-modèle adéquat.

== Rendu du modèle ==
{{Conseil}}

== Rendu par rôle ==

=== Intendants ===
{{Intendant}}

=== Architectes ===
{{Architecte}}

=== Scribes ===
{{Scribe}}

=== Scriptomanciens ===
{{Scriptomancien}}

== Voir aussi ==
* {{m|Modèle:Intendant}}
* {{m|Modèle:Architecte}}
* {{m|Modèle:Scribe}}
* {{m|Modèle:Scriptomancien}}

<noinclude>
[[Catégorie:Documentation de modèle]]
</noinclude>

Modèle:Scriptomancien

2026-03-12T21:20:14Z

Hiob : doc

<includeonly>{{Joueur|Kaeternn|grade=Scriptomancien|texte=Développement des scripts et des plugins, maintenance du serveur Minecraft. Membre du [[Nefald:Collège|Collège]].}}{{Joueur|Monnierant|grade=Scriptomancien|texte=Développement des scripts et des plugins, maintenance du serveur Minecraft.}}</includeonly>
<noinclude>{{Modèle:Conseil/doc}}[[Catégorie:Conseil]]</noinclude>

Modèle:Scribe

2026-03-12T21:19:36Z

Hiob : doc

<includeonly>{{Joueur|Ayd|grade=Scribe|texte=Développement du roleplay. Membre du [[Nefald:Collège|Collège]].}}
{{Joueur|BestLeekEver|alias=Kelloggs|grade=Scribe|texte=Développement des quêtes, responsable de l'équipe animation.}}</includeonly>
<noinclude>{{Modèle:Conseil/doc}}[[Catégorie:Conseil]]</noinclude>

Modèle:Intendant

2026-03-12T21:19:01Z

Hiob : doc

<includeonly>{{Joueur|Hiob_|grade=Grand Intendant|lien=Utilisateur:Hiob|texte=Fondateur & owner Maintenance des infrastructures et de l'ensemble des services.}}
{{Joueur|Rocmop|grade=Intendant|texte=Administrateur en charge de l'Architecture, des créations visuelles. Membre du [[Nefald:Collège|Collège]].}}
{{Joueur|Survetman|grade=Intendant|texte=Administration des Scriptomanciens, développement des quêtes, maintenance du serveur Minecraft.}}</includeonly>
<noinclude>{{Modèle:Conseil/doc}}[[Catégorie:Conseil]]</noinclude>

Modèle:Architecte

2026-03-12T21:18:25Z

Hiob : doc

<includeonly>{{Joueur|Quicky59|grade=Architecte|texte=Achitecture, construction des principaux monuments}}
</includeonly>
<noinclude>{{Modèle:Conseil/doc}}[[Catégorie:Conseil]]</noinclude>

Modèle:Conseil

2026-03-12T21:16:02Z

Hiob :

<includeonly>{{Grille|{{Intendant}}{{Officier}}{{Architecte}}{{Scribe}}{{Scriptomancien}}}}</includeonly>
<noinclude>{{Documentation}}[[Catégorie:Conseil]]</noinclude>

Modèle:Conseil/doc

2026-03-12T21:15:19Z

Hiob : Page créée avec « == Description == Le modèle {{m|Modèle:Conseil}} affiche l'ensemble des membres de l'équipe d'administration du serveur Nefald sous forme de cartes visuelles. Il regroupe automatiquement les sous-modèles suivants : * {{m|Modèle:Intendant}} — Les Intendants * {{m|Modèle:Architecte}} — Les Architectes * {{m|Modèle:Scribe}} — Les Scribes * {{m|Modèle:Scriptomancien}} — Les Scriptomanciens == Utilisation == <pre>{{Conseil}}</pre> Ce... »

== Description ==
Le modèle {{m|Modèle:Conseil}} affiche l'ensemble des membres de l'équipe d'administration du serveur Nefald sous forme de cartes visuelles.

Il regroupe automatiquement les sous-modèles suivants :
* {{m|Modèle:Intendant}} — Les [[Intendant]]s
* {{m|Modèle:Architecte}} — Les [[Architecte]]s
* {{m|Modèle:Scribe}} — Les [[Scribe]]s
* {{m|Modèle:Scriptomancien}} — Les [[Scriptomancien]]s

== Utilisation ==
<pre>{{Conseil}}</pre>

Ce modèle n'accepte '''aucun paramètre'''. Pour modifier les membres affichés, éditez directement le sous-modèle correspondant au rôle concerné.

== Modification ==
{| class="wikitable"
! Rôle !! Modèle à éditer
|-
| Intendant || {{m|Modèle:Intendant}}
|-
| Architecte || {{m|Modèle:Architecte}}
|-
| Scribe || {{m|Modèle:Scribe}}
|-
| Scriptomancien || {{m|Modèle:Scriptomancien}}
|}

== Rendu du modèle ==
{{Conseil}}

== Rendu par rôle ==

=== Intendants ===
{{Intendant}}

=== Architectes ===
{{Architecte}}

=== Scribes ===
{{Scribe}}

=== Scriptomanciens ===
{{Scriptomancien}}

== Voir aussi ==
* {{m|Modèle:Intendant}}
* {{m|Modèle:Architecte}}
* {{m|Modèle:Scribe}}
* {{m|Modèle:Scriptomancien}}

<noinclude>
[[Catégorie:Documentation de modèle]]
</noinclude>

Modèle:Agora/doc

2026-03-12T21:14:33Z

== Description ==
Le modèle {{m|Modèle:Conseil}} affiche l'ensemble des membres de l'équipe d'administration du serveur Nefald sous forme de cartes visuelles.

Il regroupe automatiquement les sous-modèles suivants :
* {{m|Modèle:Intendant}} — Les [[Intendant]]s
* {{m|Modèle:Architecte}} — Les [[Architecte]]s
* {{m|Modèle:Scribe}} — Les [[Scribe]]s
* {{m|Modèle:Scriptomancien}} — Les [[Scriptomancien]]s

== Utilisation ==
<pre>{{Conseil}}</pre>

Ce modèle n'accepte '''aucun paramètre'''. Pour modifier les membres affichés, éditez directement le sous-modèle correspondant au rôle concerné.

== Modification ==
{| class="wikitable"
! Rôle !! Modèle à éditer
|-
| Intendant || {{m|Modèle:Intendant}}
|-
| Architecte || {{m|Modèle:Architecte}}
|-
| Scribe || {{m|Modèle:Scribe}}
|-
| Scriptomancien || {{m|Modèle:Scriptomancien}}
|}

== Rendu du modèle ==
{{Conseil}}

== Rendu par rôle ==

=== Intendants ===
{{Intendant}}

=== Architectes ===
{{Architecte}}

=== Scribes ===
{{Scribe}}

=== Scriptomanciens ===
{{Scriptomancien}}

== Voir aussi ==
* {{m|Modèle:Intendant}}
* {{m|Modèle:Architecte}}
* {{m|Modèle:Scribe}}
* {{m|Modèle:Scriptomancien}}

<noinclude>
[[Catégorie:Documentation de modèle]]
</noinclude>

Modèle:Machiniste

2026-03-12T21:06:51Z

Hiob : Page créée avec « <includeonly> </includeonly> <noinclude>{{Modèle:Agora/doc}}Catégorie:Agora</noinclude> »

<includeonly>
</includeonly>
<noinclude>{{Modèle:Agora/doc}}[[Catégorie:Agora]]</noinclude>