Nefald - Contributions [fr]

Plugin:NefaldCore

2026-08-05T16:03:14Z

Hiob : Restaure le contenu écrasé par le job CI "Doc publique" (rev 5805 était un stub générique) + ajoute une section sur les marqueurs de carte (via update-page on MediaWiki MCP Server)

{{SHORTDESC:Bibliothèque technique commune du serveur, à l'origine de plusieurs effets visibles en jeu (balises de quête, restrictions)}}

{{Infobox Plugin
| nom = NefaldCore
| type = utilitaire
| dev = [[Scriptomancien|Nefald]]
| status = Installé
| sources = https://git.nefald.fr/minecraft/plugins/nefaldcore
| dépendance = [[Plugin:WorldGuard|WorldGuard]] (optionnel), [[Plugin:MythicMobs|MythicMobs]] (optionnel), [[Plugin:Vault|Vault]] (optionnel), [[Plugin:Banco|Banco]] (optionnel), [[Plugin:Citizens|Citizens]] (optionnel), [[Plugin:Dynmap|Dynmap]] (optionnel)
}}

'''NefaldCore''' est la bibliothèque technique commune aux plugins développés par Nefald. Il n'a pas de vocation RP en soi, mais plusieurs de ses fonctionnalités sont directement visibles en jeu.

== Fonctionnalités ==

=== Balises de quête ===

Certaines quêtes ou membres du staff peuvent poser une balise de localisation, visible dans la barre de repérage (locator bar). Vos balises actives sont consultables avec :

{| class="wikitable"
! Commande !! Description
|-
| <code>/questtrack list</code> || Affiche vos balises de quête actives
|}

=== Marqueurs sur la carte ===

NefaldCore fournit aux autres plugins le nécessaire pour afficher des marqueurs sur la [https://map.nefald.fr carte interactive] — c'est ce mécanisme qui affiche par exemple les étables sur la [[Plugin:Écurie|carte du plugin Écurie]].

== Voir aussi ==

* [[Plugin:Écurie]]
* [[Plugins]]

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

Plugin:Écurie

2026-08-05T16:01:38Z

Hiob : Ajoute une section sur les marqueurs de la carte interactive (via update-page on MediaWiki MCP Server)

{{SHORTDESC:Mets tes montures et compagnons en pension auprès des Maîtres d'Écurie et fais-les voyager entre les étables de Nefald}}

{{Infobox Plugin
| nom = Écurie
| image = Logo_Ecurie.png
| type = roleplay
| dev = Nefald
| status = installé
| grade = Architecte
| sources = [https://git.nefald.fr/minecraft/plugins/ecurie Gitlab]
| dépendance = [[Plugin:NefaldCore]] (obligatoire), [[Plugin:Citizens]] (softdep, requis en pratique — seul point d'entrée joueur), [[Plugin:PlaceholderAPI]] (softdep), [[Plugin:MyPet]] (softdep)
}}

'''Écurie''' te permet de mettre tes montures et familiers en pension auprès d'un '''Maître d'Écurie''', un PNJ posté devant chaque étable du monde. Ton compagnon est gardé en sécurité, à l'abri des mobs et des voleurs, et tu peux le faire voyager d'une étable à l'autre sans avoir à parcourir toi-même la distance.

== Où trouver une écurie ==

Les étables sont construites par l'Intendance dans les principales cités et zones de Fendral. Chacune est tenue par un '''Maître d'Écurie''' : clique-droit sur lui pour ouvrir le registre de l'étable.

À ton tout premier clic sur un Maître d'Écurie donné, il t'explique son service en détail. Les fois suivantes, il t'accueille d'une phrase différente à chaque passage — et te remercie après chaque service rendu.

== Mettre un compagnon en pension ==

# Amène ton compagnon à côté de toi (ou monte-le).
# Clique-droit sur le Maître d'Écurie, puis choisis '''Mettre en pension'''.
# S'il n'a pas encore de nom, une enclume s'ouvre pour le baptiser avant de le confier.
# Le coût affiché couvre la mise en pension '''et''' le bail prépayé (voir ci-dessous) — tout est réglé en une fois.

Ton compagnon est alors gardé dans une box de l'étable, en parfaite sécurité, jusqu'à ce que tu viennes le récupérer.

== Le bail de la box ==

Chaque pension inclut un '''bail prépayé''' : la box est louée pour une durée fixe dès la mise en pension. Tant que le bail court, ton compagnon reste sur place sans rien à payer de plus.

* Le bail est '''prolongeable''' à tout moment depuis le menu de récupération.
* Si le bail expire — ou si tu désertes le serveur trop longtemps — le Maître d'Écurie ne peut plus garantir la box : ton compagnon est mis '''En Réserve''' pour libérer la place.
* Un compagnon '''En Réserve''' n'est pas perdu : il reste récupérable auprès du PNJ, moyennant une pénalité de stockage longue durée (tarif de récupération majoré par rapport à une récupération normale).
* Tu peux activer le '''renouvellement automatique''' depuis le menu de récupération : le loyer est alors prélevé directement sur ton compte, même hors ligne, pour éviter que ton compagnon ne finisse En Réserve.

== Récupérer un compagnon ==

# Clique-droit sur le Maître d'Écurie, choisis '''Pension & récupération'''.
# Sélectionne ton compagnon dans la liste.
# Le tarif dépend de son état : récupération normale, ou tarif majoré s'il est En Réserve.

== Demander un acheminement ==

Besoin de retrouver ta monture ailleurs sur Fendral ? Le Maître d'Écurie peut organiser un '''acheminement''' vers une autre étable :

* '''Depuis l'étable de départ''' : choisis '''Demander un acheminement''', sélectionne ton compagnon, puis l'étable de destination.
* '''Depuis l'étable d'arrivée''' : le Maître d'Écurie te propose directement de faire venir un compagnon stationné ailleurs.

Le délai et le coût du voyage dépendent de la distance réelle entre les deux étables — plus c'est loin, plus c'est long et cher. Un '''Palefrenier''' (PNJ temporaire) anime le départ et l'arrivée de ton compagnon.

== Modifier le registre ==

Envie de rebaptiser ton compagnon ? Choisis '''Modifier le registre''' dans le menu du Maître d'Écurie : une enclume s'ouvre, pré-remplie avec le nom actuel — modifie-le ou confirme tel quel.

== Mes compagnons ==

Cette entrée du menu te donne une vue d'ensemble de '''tous''' tes compagnons en pension, toutes étables confondues — pratique pour savoir où se trouve chacun avant de demander un acheminement.

== Compagnons acceptés ==

Écurie accepte toutes les montures classiques (chevaux, chameaux, cochons sellés, striders) ainsi que tous les familiers [[MyPet]]. Selon le type d'étable, seuls certains compagnons sont acceptés :

{| class="wikitable"
! Type d'étable !! Compagnons acceptés
|-
| Terrestre || Chevaux, chameaux, cochons, familiers terrestres
|-
| Aquatique || Familiers/montures aquatiques
|-
| Volière || Familiers volants
|}

{{Info|Un familier [[MyPet]] mis en pension est automatiquement rappelé pour éviter qu'il ne traîne en double dans le monde. Il te sera rendu dans son état actuel à la récupération.}}

== Tarifs ==

Tous les tarifs sont réglés en sols, prélevés directement sur ton compte au moment du service. Les montants exacts (mise en pension + bail, récupération, récupération En Réserve, renommage, acheminement) sont fixés par l'Intendance et peuvent varier d'une étable à l'autre — le Maître d'Écurie t'affiche toujours le prix avant confirmation.

{{Bandeau|type=important|Un compagnon mort en box est perdu définitivement. Prends soin de venir le récupérer ou de renouveler son bail à temps.}}

== Voir aussi ==

* [[MyPet]] — familiers combattants
* [[Grades]] — accès et permissions selon ton rang

== Sur la carte ==

Chaque étable apparaît comme marqueur sur la [https://map.nefald.fr carte interactive], calque « Écuries » — pratique pour repérer d'un coup d'œil où déposer ou récupérer un compagnon. L'icône du marqueur change selon le type d'étable :

{| class="wikitable"
! Type d'étable !! Icône
|-
| Terrestre || Cheval
|-
| Aquatique || Dauphin
|-
| Volière || Poule
|}

Le popup du marqueur affiche le nombre de boxes libres avant de t'y rendre.

Plugin:NefaldCore

2026-08-05T15:52:40Z

Hiob : Doc publique: ajout de la page de base pour NefaldCore (28b890b4)

{{SHORTDESC:NefaldCore est un plugin système pour les fonctionnalités avancées du serveur Nefald.}}

{{Infobox Plugin
|nom=NefaldCore
|type=Système
|dev=Hiob
|status=Actif
|version=
|sources=[[https://git.nefald.fr/Nefald/NefaldCore|Dépôt Git]]
|dependance=Dynmap
|softdepend=
|description=NefaldCore fournit des outils internes pour l'intégration et l'extension des fonctionnalités du serveur.
}}

== Description ==
NefaldCore est un plugin système conçu pour faciliter l'intégration de fonctionnalités avancées sur le serveur Nefald. Il agit comme une base pour d'autres plugins et outils, notamment en gérant des interactions avec des services comme Dynmap.

== Commandes ==
Ce plugin ne fournit pas de commandes directement accessibles aux joueurs.

== Permissions ==
Ce plugin ne définit pas de permissions pour les joueurs.

== Installation ==
NefaldCore est installé et configuré par l'équipe d'administration. Aucune action n'est requise de la part des joueurs.

== Notes ==
* Ce plugin est essentiel au bon fonctionnement de certaines fonctionnalités du serveur.
* Pour toute question, contactez un membre de l'équipe d'administration.

[[Catégorie:Plugin]]

Plugin:Ecurie

2026-08-05T15:52:33Z

Hiob : Doc publique: ajout icônes Dynmap personnalisées (6bda9dfc)

{{SHORTDESC:Gérez vos écuries et visualisez-les sur la carte Dynmap.}}

{{Infobox Plugin
|nom=Ecurie
|description=Plugin permettant la gestion des écuries et leur affichage sur Dynmap.
|type=Gestion, Utilitaire
|dev=Hiob
|status=Actif
|version=
|sources=
|dependance=Dynmap
|commandes=
|permissions=
}}

== Description ==
Le plugin Ecurie permet aux joueurs de gérer leurs écuries et d'afficher leur emplacement sur la carte Dynmap du serveur. Les icônes personnalisées rendent les écuries facilement identifiables.

== Commandes ==
Aucune commande utilisateur n'est actuellement documentée pour ce plugin.

== Permissions ==
Aucune permission utilisateur n'est actuellement documentée pour ce plugin.

== Installation (joueur) ==
Aucune installation spécifique n'est requise pour les joueurs. Le plugin fonctionne automatiquement une fois installé par les administrateurs.

== Notes ==
* Les écuries sont visibles sur la carte Dynmap avec des icônes personnalisées (cheval, poulet, table de cartographie).

[[Catégorie:Plugin]]

Plugin:Ecurie

2026-08-05T15:52:26Z

Hiob : Doc publique: b95bd12d - Ajout description utilisateur et infobox

{{SHORTDESC:Gérez et visualisez vos montures sur la carte Dynmap du serveur.}}

{{Infobox Plugin
|nom=Ecurie
|type=Utilitaire
|dev=Hiob
|status=Actif
|version=Non spécifiée
|sources=[[Projet:Ecurie|Dépôt interne]]
|dependance=[[Dynmap]]
|plateforme=Bukkit/Spigot
|commandes_principales=/ecurie
|permissions=ecurie.utiliser
}}

== Description ==
Le plugin ''Ecurie'' permet aux joueurs de visualiser leurs montures (chevaux, etc.) sur la carte interactive du serveur via [[Dynmap]]. Les icônes des montures sont affichées en temps réel, offrant une meilleure immersion et un suivi pratique de vos animaux.

== Commandes ==
Aucune commande publique n'est actuellement documentée pour les joueurs. Les fonctionnalités sont accessibles automatiquement via l'intégration avec Dynmap.

== Permissions ==
* '''ecurie.utiliser''' : Permet de voir ses montures sur la carte Dynmap.

== Installation (joueur) ==
Aucune installation spécifique n'est requise pour les joueurs. Le plugin fonctionne automatiquement si vous possédez des montures enregistrées sur le serveur.

== Notes ==
* Les icônes des montures sont conçues en pixel-art pour une meilleure intégration visuelle.
* Les données sont synchronisées automatiquement au démarrage du serveur.

[[Catégorie:Plugin]]

Plugin:NefaldCore

2026-08-05T15:52:16Z

Hiob : Doc publique: b8853222 - Ajout de la documentation utilisateur pour NefaldCore

{{SHORTDESC:NefaldCore est un plugin central pour les fonctionnalités personnalisées du serveur Nefald.}}

{{Infobox Plugin
|nom=NefaldCore
|type=Utilitaire
|dev=Hiob
|status=Actif
|version=
|sources=Interne
|dependance=
|softdependance=Dynmap
|description=NefaldCore fournit les bases techniques pour les fonctionnalités avancées du serveur, incluant l'intégration avec Dynmap pour les marqueurs personnalisés.
}}

== Description ==
NefaldCore est un plugin interne qui permet d'étendre les fonctionnalités du serveur Nefald. Il sert de fondation pour d'autres modules et assure une intégration fluide avec des plugins comme Dynmap pour afficher des icônes et marqueurs personnalisés sur la carte du serveur.

== Commandes ==
Aucune commande n'est directement accessible aux joueurs pour ce plugin.

== Permissions ==
Aucune permission n'est requise pour les joueurs.

== Installation ==
Ce plugin est préinstallé sur le serveur Nefald. Aucune action n'est requise de la part des joueurs.

== Notes ==
* Ce plugin est principalement technique et n'a pas d'impact visible pour les joueurs.
* Il est maintenu par l'équipe d'administration du serveur.

[[Catégorie:Plugin]]

Plugin:NefaldCore

2026-08-05T15:52:09Z

Hiob : Doc publique: b094721e - Ajout description utilisateur

{{SHORTDESC:NefaldCore est une bibliothèque partagée entre les plugins développés par Nefald, fournissant des outils et fonctionnalités communes pour améliorer l'expérience de jeu.}}

{{Infobox Plugin
|nom=NefaldCore
|type=Bibliothèque
|dev=Nefald
|status=Actif
|sources=[https://git.nefald.fr/minecraft/plugins/nefaldcore Gitlab Nefald]
|dependance=
|version=
|api-version=
|site=
|discord=
}}

== Description ==
NefaldCore est un plugin central qui sert de fondation aux autres plugins développés par l'équipe Nefald. Il fournit des outils et des services communs pour faciliter le développement et l'intégration des fonctionnalités sur le serveur.

Ce plugin ne propose pas directement de commandes ou de fonctionnalités visibles pour les joueurs, mais il est essentiel au bon fonctionnement des autres plugins Nefald.

== Commandes ==
Ce plugin ne dispose pas de commandes accessibles aux joueurs.

== Permissions ==
Ce plugin ne définit pas de permissions spécifiques pour les joueurs.

== Installation ==
NefaldCore est installé automatiquement en tant que dépendance des autres plugins Nefald. Aucune action n'est requise de la part des joueurs.

== Notes ==
* Ce plugin est indispensable pour le fonctionnement des autres plugins Nefald.
* Aucune configuration manuelle n'est nécessaire pour les joueurs.

[[Catégorie:Plugin]]

Plugin:Ecurie

2026-08-05T15:52:02Z

Hiob : Doc publique: 93c4fa35 - Ajout des fonctionnalités utilisateur et intégration Dynmap

{{SHORTDESC:Gérez vos écuries, louez des boxes et interagissez avec les PNJ dédiés.}}

{{Infobox Plugin
|nom=Ecurie
|type=Gestion, Roleplay
|dev=Hiob
|status=Actif
|version=1.6.1
|dependance=[[Plugin:Dynmap|Dynmap]] (optionnel), [[Plugin:NefaldCore]]
|sources=Interne (Nefald)
|commandes_principales=/ecurie
|permissions=ecurie.use
}}

== Description ==
Le plugin '''Ecurie''' permet aux joueurs de gérer des écuries sur le serveur. Vous pouvez :
* Louer des boxes pour y loger vos chevaux.
* Interagir avec des PNJ dédiés pour créer ou gérer vos écuries.
* Visualiser les écuries disponibles via la carte [[Plugin:Dynmap|Dynmap]] (si activée).

Les écuries sont représentées par des marqueurs sur la carte Dynmap, affichant leur type, le nombre de boxes disponibles et le nom du PNJ associé.

== Commandes ==
{| class="wikitable"
! Commande !! Description !! Permission
|-
| '''/ecurie''' || Affiche l'aide du plugin. || ecurie.use
|-
| '''/ecurie info''' || Affiche les informations sur une écurie proche. || ecurie.use
|-
| '''/ecurie list''' || Liste les écuries disponibles. || ecurie.use
|}

== Permissions ==
* '''ecurie.use''' : Permet d'utiliser les commandes de base du plugin.

== Installation (pour les joueurs) ==
Aucune installation n'est requise. Le plugin est activé par défaut sur le serveur. Utilisez simplement les commandes ou interagissez avec les PNJ pour gérer vos écuries.

== Notes ==
* Les écuries sont visibles sur la carte Dynmap si le plugin est activé.
* Les boxes inoccupés peuvent être loués via les PNJ ou les commandes.
* Un système de bail et d'inactivité gère automatiquement la libération des boxes.

[[Catégorie:Plugin]]

Plugin:Ecurie

2026-08-05T15:51:51Z

Hiob : Doc publique: amélioration des icônes pixel-art (poule et table de cartographie)

{{SHORTDESC:Gérez votre écurie et vos animaux avec des fonctionnalités optimisées pour Minecraft.}}

{{Infobox Plugin
|nom=Ecurie
|type=Gestion des entités
|dev=Hiob
|status=Actif
|version=1.0
|sources=[[https://git.nefald.fr/nefald/ecurie|Dépôt Git Nefald]]
|dependance=
|api=
|mc_version=1.20+
}}

== Description ==
Le plugin '''Ecurie''' permet aux joueurs de gérer leurs animaux et leurs équipements liés à l'élevage de manière intuitive. Il inclut des icônes personnalisées pour une meilleure expérience utilisateur, notamment pour les poules et les tables de cartographie.

== Fonctionnalités ==
* Gestion simplifiée des animaux (poules, chevaux, etc.).
* Icônes pixel-art optimisées pour une meilleure visibilité.
* Intégration avec les mécaniques de jeu existantes.

== Commandes ==
Aucune commande utilisateur n'est actuellement documentée pour ce plugin.

== Permissions ==
Aucune permission utilisateur n'est requise pour les fonctionnalités de base.

== Installation (joueur) ==
Le plugin est activé par défaut sur le serveur. Aucune installation supplémentaire n'est nécessaire.

== Notes ==
* Les icônes des poules et des tables de cartographie ont été améliorées pour un rendu plus net.
* Pour toute suggestion ou problème, contactez l'équipe via le canal dédié sur Discord.

[[Catégorie:Plugin]]

Module:Infobox/Configs/Plugin

2026-08-03T09:33:29Z

Hiob : Port depuis codex.nefald.fr : ajout section Sous-pages (détection automatique via Module:Infobox/SousPages) (via update-page on MediaWiki MCP Server)

local sousPages = require('Module:Infobox/SousPages')

local config = {
titre = function(args)
return args.nom or '{{PAGENAME}}'
end,

icone = {
type = 'fas',
nom = 'puzzle-piece'
},

image = function(args)
if args.image then
return {
nom = args.image,
taille = args.tailleimage or "280x200px",
legende = args.legende or args.nom or '{{PAGENAME}}'
}
end
return nil
end,

sections = {
{
champs = {
{
cle = 'type',
label = 'Type',
process = function(value, args)
if not value or value == '' then
return nil
end

-- Configuration locale des types
local typeValues = {
['api'] = 'API',
['économie'] = 'Économie',
['pvp'] = 'PvP',
['roleplay'] = 'Roleplay',
['administration'] = 'Administration',
['protection'] = 'Protection',
['premium'] = 'Premium',
['cosmétique'] = 'Cosmétique',
['communication'] = 'Communication',
['construction'] = 'Construction',
['utilitaire'] = 'Utilitaire',
['mini-jeu'] = 'Mini-jeu',
['modération'] = 'Modération',
['monde'] = 'Monde',
['inventaire'] = 'Inventaire',
['terraforming'] = 'Terraforming',
['transport'] = 'Transport',
['magie'] = 'Magie',
['mob'] = 'Mob'
}

-- Séparer par virgule et traiter chaque type
local types = mw.text.split(value, ',')
local displayTypes = {}
local hasError = false
local errorMsg = ''

for _, typeItem in ipairs(types) do
local cleanValue = mw.text.trim(mw.ustring.lower(typeItem))

if typeValues[cleanValue] then
table.insert(displayTypes, typeValues[cleanValue])
else
hasError = true
errorMsg = errorMsg .. '<span style="color: red; font-weight: bold;">Type invalide: "' .. typeItem .. '"</span> '
end
end

if hasError then
return errorMsg .. '[[Catégorie:Pages avec erreurs]]'
end

-- Joindre les types avec ", " pour l'affichage
return table.concat(displayTypes, ', ')
end
},
{ cle = 'dev', label = 'Développeur' },
{
cle = 'status',
label = 'Statut',
process = function(value, args)
if not value or value == '' then
return nil
end

-- Configuration locale des statuts
local statusValues = {
['installé'] = '[[:Catégorie:Plugin installé|Installé]]',
['non-installé'] = '[[:Catégorie:Plugin non-installé|Non-installé]]'
}

local cleanValue = mw.text.trim(mw.ustring.lower(value))

if statusValues[cleanValue] then
return statusValues[cleanValue]
else
return '<span style="color: red; font-weight: bold;">Statut invalide: "' .. value .. '"</span>[[Catégorie:Pages avec erreurs]]'
end
end
},
{ cle = 'grade', label = 'Grade requis' }
}
},
{
titre = 'Ressources',
champs = {
{ cle = 'docs', label = 'Documentation',
process = function(value, args, frame)
if value and value ~= '' then
if value:match('^%[.+%]$') then
return frame:preprocess(value)
elseif value:match('^https?://') then
return frame:preprocess('[' .. value .. ' Documentation]')
else
return '[[' .. value .. ']]'
end
end
return nil
end
},
{ cle = 'website', label = 'Site web',
process = function(value, args, frame)
if value and value ~= '' then
if value:match('^%[.+%]$') then
return frame:preprocess(value)
elseif value:match('^https?://') then
return frame:preprocess('[' .. value .. ' Site web]')
else
return '[[' .. value .. ']]'
end
end
return nil
end
},
{ cle = 'bukkit', label = 'Bukkit',
process = function(value, args, frame)
if value and value ~= '' then
return frame:preprocess('[https://dev.bukkit.org/projects/' .. value .. ' Bukkit]')
end
return nil
end
},
{ cle = 'hangar', label = 'Hangar',
process = function(value, args, frame)
if value and value ~= '' then
return frame:preprocess('[https://hangar.papermc.io/' .. value .. ' Hangar]')
end
return nil
end
},
{ cle = 'modrinth', label = 'Modrinth',
process = function(value, args, frame)
if value and value ~= '' then
return frame:preprocess('[https://modrinth.com/plugin/' .. value .. ' Modrinth]')
end
return nil
end
},
{ cle = 'builtbybit', label = 'BuiltByBit',
process = function(value, args, frame)
if value and value ~= '' then
return frame:preprocess('[https://builtbybit.com/resources/' .. value .. ' BuiltByBit]')
end
return nil
end
},
{ cle = 'polymart', label = 'Polymart',
process = function(value, args, frame)
if value and value ~= '' then
return frame:preprocess('[https://polymart.org/product/' .. value .. ' Polymart]')
end
return nil
end
},
{ cle = 'spigot', label = 'Spigot',
process = function(value, args, frame)
if value and value ~= '' then
return frame:preprocess('[https://www.spigotmc.org/resources/' .. value .. ' Spigot]')
end
return nil
end
},
{ cle = 'sources', label = 'Code source',
process = function(value, args, frame)
if value and value ~= '' then
if value:match('^%[.+%]$') then
return frame:preprocess(value)
elseif value:match('^https?://') then
local domain = value:match('://([^/]+)')
local siteName = 'Source'
if domain:match('github%.com') then
siteName = 'GitHub'
elseif domain:match('gitlab%.com') then
siteName = 'GitLab'
elseif domain:match('bitbucket%.org') then
siteName = 'Bitbucket'
end
return frame:preprocess('[' .. value .. ' ' .. siteName .. ']')
else
return value
end
end
return nil
end
}
}
},
{
titre = 'Compatibilité',
champs = {
{ cle = 'dépendance', label = 'Dépendance(s)' },
{ cle = 'compatibilité', label = 'Compatible avec' }
}
},
{
titre = 'Sous-pages',
champs = {
{
cle = 'sous_pages',
process = function(value, args, frame)
return sousPages.build(args, { sousPagesNamespace = 'Plugin' }, frame)
end
}
}
}
},

categories = function(args, config, frame)
local cats = {}

-- Configuration des catégories par type
local typeCategories = {
['api'] = 'Plugin d\'API',
['économie'] = 'Plugin d\'économie',
['pvp'] = 'Plugin de PvP',
['roleplay'] = 'Plugin de roleplay',
['administration'] = 'Plugin d\'administration',
['protection'] = 'Plugin de protection',
['cosmétique'] = 'Plugin cosmétique',
['communication'] = 'Plugin de communication',
['construction'] = 'Plugin de construction',
['utilitaire'] = 'Plugin utilitaire',
['mini-jeu'] = 'Plugin de mini-jeux',
['modération'] = 'Plugin de modération',
['premium'] = 'Plugin premium',
['monde'] = 'Plugin de monde',
['inventaire'] = 'Plugin d\'inventaire',
['terraforming'] = 'Plugin de terraforming',
['transport'] = 'Plugin de transport',
['magie'] = 'Plugin de magie',
['mob'] = 'Plugin de mobs'
}

-- Configuration des catégories par statut
local statusCategories = {
['installé'] = 'Plugin installé',
['non-installé'] = 'Plugin non-installé'
}

-- Catégories basées sur le(s) type(s)
if args.type then
-- Séparer par virgule et traiter chaque type
local types = mw.text.split(args.type, ',')

for _, typeItem in ipairs(types) do
local cleanType = mw.text.trim(mw.ustring.lower(typeItem))
if typeCategories[cleanType] then
table.insert(cats, typeCategories[cleanType])
end
end
end

-- Catégorie basée sur le statut
if args.status then
local cleanStatus = mw.text.trim(mw.ustring.lower(args.status))
if statusCategories[cleanStatus] then
table.insert(cats, statusCategories[cleanStatus])
end
end

return cats
end
}

return config

Modèle:Infobox/styles.css

2026-08-03T09:32:42Z

Hiob : Port depuis codex.nefald.fr : classe .infobox-souspage-active pour la page courante en gras dans la liste des sous-pages (via update-page on MediaWiki MCP Server)

.infobox-table {
z-index: 3 !important;
overflow: hidden;
width: 400px;
max-width: 100%;
margin-bottom: var(--space-md);
padding-bottom: 20px !important;
background: var(--color-surface-1);
border: 1px solid var(--border-color-base);
border-radius: var(--border-radius-medium);
font-size: 0.875rem;
text-align: left;
display: block;
/* Propriétés de flottement */
float: right;
margin-left: 20px;
margin-right: 0;
/* Position relative pour l'icône absolue */
position: relative;
}

.infobox-header {
padding: 15px;
}

.infobox-image {
text-align: center;
background: var(--background-color-button-quiet--hover);
margin-bottom: 10px;
}

.infobox-image img {
max-width: 100%;
height: auto !important;
}

.infobox-title {
color: var(--color-emphasized);
font-size: 1.4rem !important;
font-weight: 600;
line-height: 1.4;
margin-bottom: 5px;
}

.infobox-subtitle {
color: var(--color-subtle);
font-size: 0.9rem;
}

.infobox-body {
padding: 0 15px;
}

.infobox-section-title {
padding-top: 15px;
border-top: 1px solid var(--border-color-base);
font-weight: 600;
font-size: 1rem;
color: var(--color-emphasized);
margin-top: 10px;
}

.infobox-row {
display: flex;
margin-top: 10px;
}

.infobox-label {
color: var(--color-subtle);
font-size: 0.8125rem;
font-weight: normal;
letter-spacing: 0.75px;
flex: 0 0 40%;
padding-right: 10px;
}

.infobox-value {
flex: 1;
}

/* Page courante dans la liste "Sous-pages" : mise en évidence, non cliquable */
.infobox-souspage-active {
color: var(--color-emphasized);
font-weight: 600;
}

/* Style pour l'icône en bas à droite */
.infobox-icon-bottom {
position: absolute;
bottom: 10px;
right: 15px;
font-size: 1.2em;
color: var(--color-subtle);
opacity: 0.7;
z-index: 1;
}

@media only screen and (max-width: 720px) {
.infobox-table {
float: none;
margin-right: auto;
margin-left: auto;
margin-top: 0;
}

.infobox-icon-bottom {
bottom: 8px;
right: 12px;
font-size: 1.1em;
}
}

Module:Infobox/Core

2026-08-03T09:32:16Z

Hiob : Port depuis codex.nefald.fr : masquage des sections vides, champs sans label pleine largeur, icône configurable par fonction (via update-page on MediaWiki MCP Server)

local p = {}
local getArgs = require('Module:Arguments').getArgs

-- Fonction pour générer le lien de carte dynamique
local function buildMapLink(args)
-- Vérifier les champs obligatoires
if not args.x or args.x == '' then return nil end
if not args.y or args.y == '' then return nil end
if not args.z or args.z == '' then return nil end
if not args.worldname or args.worldname == '' then return nil end

-- Valeurs par défaut pour les champs optionnels
local mapname = args.mapname or 'flat'
local zoom = args.zoom or '4'

-- Construction de l'URL
local url = string.format(
'https://map.nefald.fr/?worldname=%s&mapname=%s&zoom=%s&x=%s&y=%s&z=%s',
mw.uri.encode(args.worldname, 'PATH'),
mw.uri.encode(mapname, 'PATH'),
zoom,
args.x,
args.y,
args.z
)

-- Retourner le lien formaté
return string.format('[%s %s, %s, %s]', url, args.x, args.y, args.z)
end

-- Fonction de validation du champ "type"
local function validateTypeField(args, config)
local typeValue = args.type or args['type']

-- Si pas de configuration pour le type, pas de validation
if not config.typeField then
return { valid = true }
end

-- Si le champ est requis et vide
if config.typeField.required and (not typeValue or typeValue == '') then
return {
error = 'Le champ "type" est obligatoire.',
valid = false
}
end

-- Si pas de valeur, mais pas requis, c'est valide
if not typeValue or typeValue == '' then
return { valid = true }
end

-- Nettoyer la valeur
local cleanType = mw.text.trim(mw.ustring.lower(typeValue))

-- Vérifier si la valeur est dans la liste autorisée
if config.typeField.allowedValues and not config.typeField.allowedValues[cleanType] then
local errorMsg = config.typeField.errorMessage or 'Valeur de type non autorisée : ' .. typeValue
return {
error = errorMsg,
valid = false
}
end

return {
valid = true,
cleanValue = cleanType,
displayValue = config.typeField.allowedValues and config.typeField.allowedValues[cleanType] and config.typeField.allowedValues[cleanType].display or typeValue
}
end

-- Fonction pour gérer la catégorisation automatique
local function addCategories(args, config, frame)
-- Vérifier qu'on est dans le namespace principal (0) ou namespace plugin (3000)
local title = mw.title.getCurrentTitle()
if title.namespace ~= 0 and title.namespace ~= 3000 then
return ''
end

local categoryString = ''

-- Nouvelles catégories configurables (fonction categories)
if type(config.categories) == 'function' then
local cats = config.categories(args, config, frame)
if cats then
for _, cat in ipairs(cats) do
categoryString = categoryString .. '[[Catégorie:' .. cat .. ']]'
end
end
end

return categoryString
end

function p.build(args, config, frame)
if not args.nom or args.nom == '' then
return '<div class="error">Nom requis pour l\'infobox</div>'
end

-- Validation du champ type
local typeValidation = validateTypeField(args, config)
if not typeValidation.valid then
return '<div class="error">' .. typeValidation.error .. '</div>'
end

local root = mw.html.create('div')
:addClass('infobox-table')
:attr('role', 'table')

-- En-tête avec nom
local header = mw.html.create('div')
:addClass('infobox-header')

if args.image and args.image ~= '' then
local imageDiv = mw.html.create('div')
:addClass('infobox-image')

local imageSize = args.tailleimage or '280px'
local imageCode = string.format('[[Fichier:%s|%s|center', args.image, imageSize)
if args.legende and args.legende ~= '' then
imageCode = imageCode .. '|' .. args.legende
end
imageCode = imageCode .. ']]'

imageDiv:wikitext(imageCode)
header:node(imageDiv)
end

-- Titre sans icône (icône déplacée en bas à droite)
local titleDiv = mw.html.create('div')
:addClass('infobox-title')
:wikitext(args.nom)

header:node(titleDiv)

if args.soustitre and args.soustitre ~= '' then
local subtitleDiv = mw.html.create('div')
:addClass('infobox-subtitle')
:wikitext(args.soustitre)
header:node(subtitleDiv)
end

root:node(header)

-- Corps avec les champs
local body = mw.html.create('div')
:addClass('infobox-body')

-- Vérifier si on a des coordonnées complètes
local mapLink = buildMapLink(args)
local coordinatesDisplayed = false

for _, section in ipairs(config.sections or {}) do
-- Les lignes de la section sont accumulées ici et intégrées au body seulement
-- si au moins une a du contenu — sinon le section-title reste orphelin (ex. une
-- section "Sous-pages" ou "Compatibilité" entièrement vide sur cette page).
local sectionRows = {}

for _, champ in ipairs(section.champs or {}) do
-- Gestion spéciale pour les coordonnées
if mapLink and not coordinatesDisplayed and (champ.cle == 'x' or champ.cle == 'y' or champ.cle == 'z' or champ.cle == 'worldname' or champ.cle == 'coordonnees') then
local rowDiv = mw.html.create('div')
:addClass('infobox-row')

local labelDiv = mw.html.create('div')
:addClass('infobox-label')
:wikitext('Coordonnées')

local valueDiv = mw.html.create('div')
:addClass('infobox-value')
:wikitext(mapLink)

rowDiv:node(labelDiv):node(valueDiv)
table.insert(sectionRows, rowDiv)
coordinatesDisplayed = true

-- Traitement normal des autres champs (ignorer x, y, z, worldname s'ils sont déjà affichés comme coordonnées)
elseif not (mapLink and (champ.cle == 'x' or champ.cle == 'y' or champ.cle == 'z' or champ.cle == 'worldname' or champ.cle == 'mapname' or champ.cle == 'zoom')) then
local rawValue = args[champ.cle]

-- Si le champ a une valeur OU une fonction process qui peut générer une valeur
if (rawValue and rawValue ~= '') or champ.process then
local finalValue = rawValue

-- Appliquer la fonction process si elle existe
if champ.process and type(champ.process) == 'function' then
finalValue = champ.process(rawValue, args, frame)
end

-- N'afficher que si on a une valeur finale
if finalValue and finalValue ~= '' then
local rowDiv = mw.html.create('div')
:addClass('infobox-row')

local valueDiv = mw.html.create('div')
:addClass('infobox-value')

-- Champ sans label (ex. liste pleine largeur type Sous-pages) :
-- pas de colonne label, la valeur devient seule enfant flex du
-- row et occupe donc naturellement 100% de la largeur.
if champ.label and champ.label ~= '' then
local labelDiv = mw.html.create('div')
:addClass('infobox-label')
:wikitext(champ.label)
rowDiv:node(labelDiv)
end

-- Formatage spécial pour le champ "type"
if champ.cle == 'type' and typeValidation.displayValue then
valueDiv:wikitext(typeValidation.displayValue)
else
valueDiv:wikitext(finalValue)
end

rowDiv:node(valueDiv)
table.insert(sectionRows, rowDiv)
end
end
end
end

if #sectionRows > 0 then
if section.titre then
local sectionDiv = mw.html.create('div')
:addClass('infobox-section-title')
:wikitext(section.titre)
body:node(sectionDiv)
end
for _, rowDiv in ipairs(sectionRows) do
body:node(rowDiv)
end
end
end

root:node(body)

-- Traiter l'icône APRÈS avoir construit tout le HTML
local finalResult = tostring(root)

if config.icone then
local iconeConfig = config.icone
if type(iconeConfig) == 'function' then
iconeConfig = iconeConfig(args) or {}
end
local iconeType = iconeConfig.type or 'fas'
local iconeNom = iconeConfig.nom

-- Utiliser mw.getCurrentFrame() si frame n'est pas disponible
local currentFrame = frame or mw.getCurrentFrame()
local iconeContent = '{{#' .. iconeType .. ':' .. iconeNom .. '}}'

if currentFrame then
iconeContent = currentFrame:preprocess(iconeContent)
end

-- Créer la div d'icône séparément et l'ajouter au résultat
local iconeHtml = string.format(
'<div class="infobox-icon-bottom">%s</div>',
iconeContent
)

-- Injecter l'icône juste avant la fermeture de la div principale
finalResult = finalResult:gsub('</div>$', iconeHtml .. '</div>')
end

-- Ajouter les catégories automatiques
local categories = addCategories(args, config, frame)

return finalResult .. categories
end

return p

Module:Infobox/SousPages

2026-08-03T09:31:30Z

Hiob : Port depuis codex.nefald.fr : détection automatique des sous-pages dans l'infobox (via create-page on MediaWiki MCP Server)

local p = {}

-- Construit la liste des sous-pages en wikiliens, séparateur • sur une ligne.
-- config.sousPagesNamespace : namespace DPL à interroger ('' = espace principal, 'Plugin' = ns Plugin, etc.)
-- Retourne nil si aucune sous-page, ou si args.sous_pages == 'non' (opt-out manuel).
--
-- Si la page courante est elle-même une sous-page (ex. Plugin:NefaldCore/API), on liste les
-- pages sœurs (enfants de la racine, ex. NefaldCore) et la page courante apparaît en gras,
-- non cliquable (.infobox-souspage-active), comme sur Modèle:Navigation_sous-pages.
-- Sinon (page principale), on liste ses propres sous-pages, aucune n'est la page courante.
function p.build(args, config, frame)
if args.sous_pages == 'non' then
return nil
end

local title = mw.title.getCurrentTitle()
local namespace = (config and config.sousPagesNamespace) or ''
local base = (title.text ~= title.rootText) and title.rootText or title.text

-- Séparateur '@@' improbable dans un titre : évite tout souci de trim d'espaces/retours
-- à la ligne par MediaWiki sur les arguments de #dpl.
-- skipthispage=no : DPL exclut par défaut la page appelante de ses propres résultats ;
-- sur une sous-page on veut au contraire qu'elle apparaisse (pour le bold .infobox-souspage-active).
local dpl = '{{#dpl:namespace=' .. namespace
.. '|titlematch=' .. base .. '/%'
.. '|format=,%PAGE%,@@,'
.. '|skipthispage=no'
.. '|ignorecase=true|order=ascending|ordermethod=title}}'

local raw = frame:preprocess(dpl)
if not raw then
return nil
end
raw = mw.text.trim(raw)
if raw == '' then
return nil
end

local parts = {}
for fullTitle in (raw .. '@@'):gmatch('(.-)@@') do
local trimmed = mw.text.trim(fullTitle)
if trimmed ~= '' then
local display = trimmed:match('([^/]+)$') or trimmed
if trimmed == title.prefixedText then
table.insert(parts, '<span class="infobox-souspage-active">' .. display .. '</span>')
else
table.insert(parts, '[[' .. trimmed .. '|' .. display .. ']]')
end
end
end

if #parts == 0 then
return nil
end

return frame:preprocess(table.concat(parts, ' • '))
end

return p

Plugin:Écurie

2026-08-03T08:57:47Z

Hiob : Ajoute logo à l'infobox, reproduit infobox codex.nefald.fr (image, grade, dépendance détaillée) (via update-page on MediaWiki MCP Server)

Fichier:Logo Ecurie.png

2026-08-03T08:57:30Z

Hiob : Import depuis codex.nefald.fr (redimensionné pour cap 2 Mo) pour infobox Plugin:Écurie (via upload-file on MediaWiki MCP Server)

Logo du plugin [[Plugin:Écurie]]. Importé depuis codex.nefald.fr (redimensionné 2048→1024px, cap upload serveur 2 Mo).

Plugin:Ecurie

2026-08-03T08:05:51Z

Hiob : Doc publique: précise les interactions PNJ et la gestion des box (6bbac8a1)

{{SHORTDESC:Gérez la pension et la location de box pour vos chevaux dans les écuries Nefald.}}

{{Infobox Plugin
|nom=Ecurie
|type=Gestion
|dev=Hiob
|status=Stable
|version=1.0.0+
|sources=[[https://git.nefald.fr/nefald/ecurie|Dépôt Git Nefald]]
|dependance=[[Plugin:NefaldCore|NefaldCore]] ≥ 0.1.0
|api=Spigot
|bukkit=1.16+
}}

== Description ==
Le plugin '''Ecurie''' permet aux joueurs de mettre en pension leurs chevaux dans des box physiques, de les récupérer ou de les transférer vers d'autres écuries. Les box peuvent être loués temporairement (prépayés par défaut pour 7 jours) et sont gérés via un système de bail.

Lors de la mise en pension, de la récupération ou du transfert d'un cheval, un message de remerciement aléatoire est affiché par le PNJ de l'écurie.

== Fonctionnalités ==
* Mise en pension de chevaux dans des box physiques.
* Récupération ou transfert de chevaux entre écuries.
* Location temporaire de box (prépayée par défaut pour 7 jours).
* Prolongation manuelle ou automatique (via '''Auto-Renew''') du bail.
* Gestion des chevaux en réserve (si bail expiré ou inactivité >14 jours).
* Messages aléatoires affichés par les PNJ lors des interactions.

== Commandes ==
Aucune commande directe n'est disponible pour les joueurs. Toutes les interactions se font via les PNJ des écuries.

== Permissions ==
Aucune permission spécifique n'est requise pour les joueurs. Les fonctionnalités sont accessibles à tous.

== Installation (joueur) ==
Aucune installation n'est requise pour les joueurs. Le plugin est activé automatiquement sur les serveurs Nefald équipés d'écuries.

== Notes ==
* Les chevaux non récupérés après expiration du bail ou après 14 jours d'inactivité sont automatiquement placés en '''Réserve'''. Ils peuvent être récupérés auprès du PNJ moyennant une pénalité de stockage.
* L'option '''Auto-Renew''' permet de prolonger automatiquement le bail sans intervention du joueur (via prélèvement sur le compte Banco/Vault).

[[Catégorie:Plugin]]

Plugin:Écurie

2026-08-03T06:50:36Z

Hiob : Réécriture — recentre l'article sur le joueur (doc admin déplacée vers codex.nefald.fr), corrige gui-type/SQLite/blocs box obsolètes, ajoute bail prépayé/réserve (via update-page on MediaWiki MCP Server)

{{SHORTDESC:Mets tes montures et compagnons en pension auprès des Maîtres d'Écurie et fais-les voyager entre les étables de Nefald}}

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

'''Écurie''' te permet de mettre tes montures et familiers en pension auprès d'un '''Maître d'Écurie''', un PNJ posté devant chaque étable du monde. Ton compagnon est gardé en sécurité, à l'abri des mobs et des voleurs, et tu peux le faire voyager d'une étable à l'autre sans avoir à parcourir toi-même la distance.

== Où trouver une écurie ==

Les étables sont construites par l'Intendance dans les principales cités et zones de Fendral. Chacune est tenue par un '''Maître d'Écurie''' : clique-droit sur lui pour ouvrir le registre de l'étable.

À ton tout premier clic sur un Maître d'Écurie donné, il t'explique son service en détail. Les fois suivantes, il t'accueille d'une phrase différente à chaque passage — et te remercie après chaque service rendu.

== Mettre un compagnon en pension ==

# Amène ton compagnon à côté de toi (ou monte-le).
# Clique-droit sur le Maître d'Écurie, puis choisis '''Mettre en pension'''.
# S'il n'a pas encore de nom, une enclume s'ouvre pour le baptiser avant de le confier.
# Le coût affiché couvre la mise en pension '''et''' le bail prépayé (voir ci-dessous) — tout est réglé en une fois.

Ton compagnon est alors gardé dans une box de l'étable, en parfaite sécurité, jusqu'à ce que tu viennes le récupérer.

== Le bail de la box ==

Chaque pension inclut un '''bail prépayé''' : la box est louée pour une durée fixe dès la mise en pension. Tant que le bail court, ton compagnon reste sur place sans rien à payer de plus.

* Le bail est '''prolongeable''' à tout moment depuis le menu de récupération.
* Si le bail expire — ou si tu désertes le serveur trop longtemps — le Maître d'Écurie ne peut plus garantir la box : ton compagnon est mis '''En Réserve''' pour libérer la place.
* Un compagnon '''En Réserve''' n'est pas perdu : il reste récupérable auprès du PNJ, moyennant une pénalité de stockage longue durée (tarif de récupération majoré par rapport à une récupération normale).
* Tu peux activer le '''renouvellement automatique''' depuis le menu de récupération : le loyer est alors prélevé directement sur ton compte, même hors ligne, pour éviter que ton compagnon ne finisse En Réserve.

== Récupérer un compagnon ==

# Clique-droit sur le Maître d'Écurie, choisis '''Pension & récupération'''.
# Sélectionne ton compagnon dans la liste.
# Le tarif dépend de son état : récupération normale, ou tarif majoré s'il est En Réserve.

== Demander un acheminement ==

Besoin de retrouver ta monture ailleurs sur Fendral ? Le Maître d'Écurie peut organiser un '''acheminement''' vers une autre étable :

* '''Depuis l'étable de départ''' : choisis '''Demander un acheminement''', sélectionne ton compagnon, puis l'étable de destination.
* '''Depuis l'étable d'arrivée''' : le Maître d'Écurie te propose directement de faire venir un compagnon stationné ailleurs.

Le délai et le coût du voyage dépendent de la distance réelle entre les deux étables — plus c'est loin, plus c'est long et cher. Un '''Palefrenier''' (PNJ temporaire) anime le départ et l'arrivée de ton compagnon.

== Modifier le registre ==

Envie de rebaptiser ton compagnon ? Choisis '''Modifier le registre''' dans le menu du Maître d'Écurie : une enclume s'ouvre, pré-remplie avec le nom actuel — modifie-le ou confirme tel quel.

== Mes compagnons ==

Cette entrée du menu te donne une vue d'ensemble de '''tous''' tes compagnons en pension, toutes étables confondues — pratique pour savoir où se trouve chacun avant de demander un acheminement.

== Compagnons acceptés ==

Écurie accepte toutes les montures classiques (chevaux, chameaux, cochons sellés, striders) ainsi que tous les familiers [[MyPet]]. Selon le type d'étable, seuls certains compagnons sont acceptés :

{| class="wikitable"
! Type d'étable !! Compagnons acceptés
|-
| Terrestre || Chevaux, chameaux, cochons, familiers terrestres
|-
| Aquatique || Familiers/montures aquatiques
|-
| Volière || Familiers volants
|}

{{Info|Un familier [[MyPet]] mis en pension est automatiquement rappelé pour éviter qu'il ne traîne en double dans le monde. Il te sera rendu dans son état actuel à la récupération.}}

== Tarifs ==

Tous les tarifs sont réglés en sols, prélevés directement sur ton compte au moment du service. Les montants exacts (mise en pension + bail, récupération, récupération En Réserve, renommage, acheminement) sont fixés par l'Intendance et peuvent varier d'une étable à l'autre — le Maître d'Écurie t'affiche toujours le prix avant confirmation.

{{Bandeau|type=important|Un compagnon mort en box est perdu définitivement. Prends soin de venir le récupérer ou de renouveler son bail à temps.}}

== Voir aussi ==

* [[MyPet]] — familiers combattants
* [[Grades]] — accès et permissions selon ton rang

Plugin:NefaldCore

2026-08-01T14:37:46Z

Hiob : /* Effets passifs */

{{SHORTDESC:Bibliothèque technique commune du serveur, à l'origine de plusieurs effets visibles en jeu (balises de quête, restrictions)}}

{{Infobox Plugin
| nom = NefaldCore
| type = utilitaire
| dev = [[Scriptomancien|Nefald]]
| status = Installé
| sources = https://git.nefald.fr/minecraft/plugins/nefaldcore
| dépendance = [[Plugin:WorldGuard|WorldGuard]] (optionnel), [[Plugin:MythicMobs|MythicMobs]] (optionnel), [[Plugin:Vault|Vault]] (optionnel), [[Plugin:Banco|Banco]] (optionnel), [[Plugin:Citizens|Citizens]] (optionnel)
}}

'''NefaldCore''' est la bibliothèque technique commune aux plugins développés par Nefald. Il n'a pas de vocation RP en soi, mais plusieurs de ses fonctionnalités sont directement visibles en jeu.

== Fonctionnalités ==

=== Balises de quête ===

Certaines quêtes ou membres du staff peuvent poser une balise de localisation, visible dans la barre de repérage (locator bar). Vos balises actives sont consultables avec :

{| class="wikitable"
! Commande !! Description
|-
| <code>/questtrack list</code> || Affiche vos balises de quête actives
|}

== Voir aussi ==

* [[Plugin:Écurie]]
* [[Plugins]]

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

Plugin:NefaldCore

2026-08-01T14:35:08Z

Hiob : Suppression de la feature de boost de vitesse (roadboost) — retirée du plugin (via update-page on MediaWiki MCP Server)

{{SHORTDESC:Bibliothèque technique commune du serveur, à l'origine de plusieurs effets visibles en jeu (balises de quête, restrictions)}}

{{Infobox Plugin
| nom = NefaldCore
| type = utilitaire
| dev = [[Scriptomancien|Nefald]]
| status = Installé
| sources = https://git.nefald.fr/minecraft/plugins/nefaldcore
| dépendance = [[Plugin:WorldGuard|WorldGuard]] (optionnel), [[Plugin:MythicMobs|MythicMobs]] (optionnel), [[Plugin:Vault|Vault]] (optionnel), [[Plugin:Banco|Banco]] (optionnel), [[Plugin:Citizens|Citizens]] (optionnel)
}}

'''NefaldCore''' est la bibliothèque technique commune aux plugins développés par Nefald. Il n'a pas de vocation RP en soi, mais plusieurs de ses fonctionnalités sont directement visibles en jeu.

== Fonctionnalités ==

=== Balises de quête ===

Certaines quêtes ou membres du staff peuvent poser une balise de localisation, visible dans la barre de repérage (locator bar). Vos balises actives sont consultables avec :

{| class="wikitable"
! Commande !! Description
|-
| <code>/questtrack list</code> || Affiche vos balises de quête actives
|}

=== Effets passifs ===

* '''Coffres de l'End''' — l'ouverture d'un coffre de l'End (ender chest) est bloquée sur le serveur.
* '''Happy Ghast''' — les Happy Ghasts rencontrés en jeu sont en réalité une créature custom Nefald, pas l'entité vanilla.

== Voir aussi ==

* [[Plugin:Écurie]]
* [[Plugins]]

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

Plugin:NefaldCore

2026-08-01T14:31:52Z

Hiob : Création — doc joueur NefaldCore : boost de vitesse, balises de quête, effets passifs (coffres End, Happy Ghast) (via create-page on MediaWiki MCP Server)

{{SHORTDESC:Bibliothèque technique commune du serveur, à l'origine de plusieurs effets visibles en jeu (vitesse sur route, balises de quête)}}

{{Infobox Plugin
| nom = NefaldCore
| type = utilitaire
| dev = [[Scriptomancien|Nefald]]
| status = Installé
| sources = https://git.nefald.fr/minecraft/plugins/nefaldcore
| dépendance = [[Plugin:WorldGuard|WorldGuard]] (optionnel), [[Plugin:MythicMobs|MythicMobs]] (optionnel), [[Plugin:Vault|Vault]] (optionnel), [[Plugin:Banco|Banco]] (optionnel), [[Plugin:Citizens|Citizens]] (optionnel)
}}

'''NefaldCore''' est la bibliothèque technique commune aux plugins développés par Nefald. Il n'a pas de vocation RP en soi, mais plusieurs de ses fonctionnalités sont directement visibles en jeu.

== Fonctionnalités ==

=== Boost de vitesse sur route ===

Marcher (ou chevaucher une monture) sur un bloc d''''âme-sol (soul soil)''' donne un bonus de vitesse de déplacement, à pied comme monté. L'effet est actif sur Fendral, Kaldrah, Väsk et le Nether de Fendral.

Chaque joueur peut désactiver l'effet pour lui-même :

{| class="wikitable"
! Commande !! Description
|-
| <code>/roadboost</code> || Bascule le boost de vitesse sur route (actif/inactif)
|-
| <code>/roadboost on</code> || Réactive le boost
|-
| <code>/roadboost off</code> || Désactive le boost pour vous-même
|}

=== Balises de quête ===

Certaines quêtes ou membres du staff peuvent poser une balise de localisation, visible dans la barre de repérage (locator bar). Vos balises actives sont consultables avec :

{| class="wikitable"
! Commande !! Description
|-
| <code>/questtrack list</code> || Affiche vos balises de quête actives
|}

=== Effets passifs ===

* '''Coffres de l'End''' — l'ouverture d'un coffre de l'End (ender chest) est bloquée sur le serveur.
* '''Happy Ghast''' — les Happy Ghasts rencontrés en jeu sont en réalité une créature custom Nefald, pas l'entité vanilla.

== Voir aussi ==

* [[Plugin:Écurie]]
* [[Plugins]]

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

É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 <p align="center"> <img src="nanobanana-output/Ecurie_logo.png" alt="Ecurie Logo" width="300" /> </p> 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

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

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.<br />
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.<br />
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 :<br />
- L'événementiel : ils créent des évènements pour divertir les joueurs.<br />
- Le RolePlay : ils créent du contenu RP et des quêtes.<br />
- Le développement : ils créent du contenu via les scripts et codes.<br />

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.<br />
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.<br/>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'''.
<br />À 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.<br />
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.<br />
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 :<br />
- L'événementiel : ils créent des évènements pour divertir les joueurs.<br />
- Le RolePlay : ils créent du contenu RP et des quêtes.<br />
- Le développement : ils créent du contenu via les scripts et codes.<br />

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.<br />
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.<br/>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'''.
<br />À 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.<br />
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.<br />
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 :<br />
- L'événementiel : ils créent des évènements pour divertir les joueurs.<br />
- Le RolePlay : ils créent du contenu RP et des quêtes.<br />
- Le développement : ils créent du contenu via les scripts et codes.<br />

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.<br />
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.<br/>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'''.
<br />À 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]