Configuration et Permissions de ResurrectionChest

Permissions

Permission	Objectif	Par défaut
resurrectionchest.*	Donne aux administrateurs l'accès aux commandes setup, content, update, reload et clear	op
resurrectionchest.setup	Donne aux administrateurs l'accès à /resurrectionchest setup, recommendedplugins, downloadallcontent et updatecontent	op
resurrectionchest.initialize	Permet d'ouvrir la première configuration avec /resurrectionchest initialize.	op
resurrectionchest.use	Permet à un joueur d'enregistrer un coffre et d'y faire acheminer les objets de mort	true
resurrectionchest.model.free	Permet à un joueur d'utiliser les visuels gratuits de coffre FreeMinecraftModels (Wooden Chest)	true
resurrectionchest.model.premium	Permet à un joueur d'utiliser les visuels premium de coffre FreeMinecraftModels (Angelic Chest)	op

resurrectionchest.use est la permission importante pour le comportement réel du coffre. Les permissions d'administrateur et de modèle n'affectent respectivement que les commandes et les visuels optionnels.

Commandes

Commande	Permission	Objectif
/resurrectionchest	resurrectionchest.*	Affiche une courte info pointant vers le flux de configuration
/resurrectionchest setup	resurrectionchest.setup	Ouvre le menu de configuration (parcourir et activer/désactiver les packs de coffres, vérifier les mises à jour du plugin, voir les plugins recommandés, activer/désactiver les mises à jour automatiques)
/resurrectionchest recommendedplugins	resurrectionchest.setup	Ouvre (ou, pour la console, liste) les plugins compagnons recommandés pour ResurrectionChest
/resurrectionchest downloadall	resurrectionchest.*	Télécharge la mise à jour du plugin (le cas échéant) et tous les packs de contenu disponibles depuis Nightbreak
/resurrectionchest downloadallcontent	resurrectionchest.setup	Télécharge tous les packs de contenu disponibles depuis Nightbreak
/resurrectionchest updatecontent (alias updateallcontent)	resurrectionchest.setup	Re-télécharge uniquement les packs de contenu installés obsolètes
/resurrectionchest forcereinstallcontent <package|all>	resurrectionchest.*	Re-télécharge un pack de contenu (ou tous les packs téléchargés) même quand la version installée est déjà à jour. Les noms de package se complètent au tab avec les slugs Nightbreak wooden-chest et angelic-chest, plus all
/resurrectionchest downloadpluginupdate	resurrectionchest.*	Télécharge une mise à jour du plugin ResurrectionChest si elle est disponible
/resurrectionchest reload	resurrectionchest.*	Recharge ResurrectionChest
/resurrectionchest clear	resurrectionchest.*	Efface tous les blocs ResurrectionChest suivis ; lâche l'inventaire de chaque coffre suivi et supprime les blocs de coffre et de panneau

Les mises à jour de plugin téléchargées sont placées dans le dossier update du serveur et ne prennent effet qu'après le prochain redémarrage du serveur.

Fichiers du Plugin

Chemin	Objectif
plugins/ResurrectionChest/config.yml	Tous les paramètres du tableau ci-dessous
plugins/ResurrectionChest/playerData.yml	Une entrée par coffre enregistré, indexée par UUID de joueur : la location du coffre, le préfixe chestModel choisi au moment de l'enregistrement du coffre, et un trackedBlockSchemaVersion utilisé pour migrer les anciens enregistrements vers les balises de propriété de bloc actuelles
plugins/ResurrectionChest/content_packages/	Les définitions de packs de contenu wooden_chest.yml / angelic_chest.yml (nom, description, lien de téléchargement, version, isEnabled, category)
plugins/ResurrectionChest/nightbreak-changelogs.yml	État lu/ignoré de la boîte de réception partagée des changelogs derrière /resurrectionchestchangelog. Voir Notifications de changelog
plugins/ResurrectionChest/imports/	Dossier de dépôt pour les imports manuels. Tout ce qui y est laissé est décompressé au démarrage — les fichiers de modèle sont acheminés vers FreeMinecraftModels et FreeMinecraftModels est rafraîchi automatiquement. Voir Imports manuels vs gestion en jeu

Ne modifiez pas playerData.yml à la main pendant que le serveur tourne ; ResurrectionChest le réécrit chaque fois qu'un coffre est enregistré ou supprimé.

Surface de Configuration

config.yml expose actuellement ces paramètres orientés utilisateur :

Clé de Config	Type	Par défaut
setupDone	boolean	false
nightbreak.autoDownloadPluginUpdates	boolean	false
Input name for death chest	string	[DeathChest]
Enable high compatibility / low security mode for plugin conflicts	boolean	false
Lower worn armor's durability on death	boolean	true
Amount of durability to lower on death	int	100
Chest creation message	string	&8[ResurrectionChest] &aYou've created your Death Chest!
Chest destruction message	string	&8[ResurrectionChest] &cYour Death Chest has been destroyed!
Chest missing message	string	&8[ResurrectionChest] &4Your Death Chest is missing!
Chest protected region message	string	&8[ResurrectionChest] &cYou can't create a Death Chest here - this area is protected!
Death message	string	&8[ResurrectionChest] &aYour items have been moved to your Death Chest!
deathChestRemovedMessage	string	&8[ResurrectionChest] &cYour Death Chest has been removed!
Enable particle effects for death chests	boolean	true
Particle effect 1	string	ENCHANTMENT_TABLE
Particle effect 2	string	ENCHANTMENT_TABLE
Particle effect 3	string	PORTAL
blacklistedWorlds	list	[none]
storeXP	boolean	true
xpPercentageKept	double	0.75
deathChestNameTag	string	$playerName's &fResurrection Chest
freeSingleDeathChestModelName	string	resurrectionchest_free_single
freeDoubleDeathChestModelName	string	resurrectionchest_free_double
premiumSingleDeathChestModelName	string	resurrectionchest_angelic_single
premiumDoubleDeathChestModelName	string	resurrectionchest_angelic_double

Mises à Jour Automatiques du Plugin et du Contenu

nightbreak.autoDownloadPluginUpdates est un paramètre partagé Nightbreak/MagmaCore livré avec ResurrectionChest. Sa valeur par défaut est false.

• Quand il est à false (la valeur par défaut), rien n'est téléchargé automatiquement. ResurrectionChest vérifie tout de même la présence d'une mise à jour du plugin au démarrage (et environ une fois par heure) afin que le bouton de mise à jour en jeu puisse afficher le résultat, mais c'est vous qui déclenchez tout téléchargement réel.
• Quand il est à true, ResurrectionChest télécharge au démarrage une mise à jour du plugin disponible ainsi que les packs de contenu obsolètes. Les mises à jour de plugin et de contenu téléchargées ne sont utilisées qu'après le redémarrage du serveur.
• Les téléchargements automatiques de plugin nécessitent un jeton de compte Nightbreak valide et une adhésion de soutien active.

Vous pouvez modifier ce paramètre en jeu depuis le bouton Automatic Updates de la barre d'outils dans /resurrectionchest setup, ou éditer directement config.yml.

Le menu de configuration expose également une entrée Plugin Update (affiche la version installée/disponible et télécharge une mise à jour au clic) et une entrée Recommended Plugins (la même liste que /resurrectionchest recommendedplugins).

Protection des régions

Enregistrer un coffre de mort est traité comme une construction : avant que le panneau ne soit accepté, ResurrectionChest demande au LocationQueryRegistry partagé de MagmaCore si le joueur peut construire sur le bloc du coffre.

• WorldGuard et GriefPrevention sont encapsulés automatiquement ; si aucun des deux n'est installé, il n'y a aucune restriction supplémentaire et l'enregistrement se comporte exactement comme auparavant.
• Si un plugin de protection refuse la construction, l'enregistrement est refusé et le joueur reçoit le message Chest protected region message.
• Si un adaptateur de protection lève une erreur, la requête échoue en mode fermé (l'enregistrement est refusé) plutôt que de contourner silencieusement la protection.

Les adaptateurs sont attachés pendant le démarrage, un échec d'attachement apparaît donc dans le journal de démarrage plutôt qu'au premier enregistrement de coffre.

Pénalité de durabilité de l'armure

Lower worn armor's durability on death (défaut true) et Amount of durability to lower on death (défaut 100) sont appliqués à l'armure portée par le joueur au moment où elle est acheminée vers le coffre de mort :

• chaque pièce d'armure portée qui apparaît dans les objets de mort voit Amount of durability to lower on death ajouté à sa valeur de dégâts
• si cela devait amener la pièce à sa durabilité maximale ou au-delà, la pièce est entièrement retirée des objets lâchés (elle est détruite plutôt que stockée)
• sinon, c'est la pièce endommagée qui est placée dans le coffre

La pénalité ne s'applique qu'aux morts réellement gérées par ResurrectionChest — elle est ignorée lorsque keepInventory est actif, lorsque le monde est sur liste noire, lorsque le joueur n'a pas resurrectionchest.use et lorsque le coffre enregistré est absent.

Mode haute compatibilité

Enable high compatibility / low security mode for plugin conflicts vaut false par défaut. Le panneau ou coffre enregistré doit alors conserver la marque du propriétaire attendu.

Avec true, une marque absente est acceptée à l'emplacement enregistré. Une marque indiquant un autre propriétaire reste refusée, et un coffre doit toujours être un bloc de coffre. Ce mode aide avec les plugins qui suppriment les marques ; il n'autorise pas n'importe quel bloc de remplacement.

Gestion de l'XP

Quand storeXP est activé :

• ResurrectionChest suit l'XP totale du joueur pendant le jeu, mais lit le total réel du joueur au moment de la mort, de sorte que l'XP accordée directement via l'API d'un autre plugin est également comptabilisée
• à la mort, il stocke total XP * xpPercentageKept
• il met l'XP lâchée à 0
• il rend l'XP stockée quand le propriétaire ouvre son coffre enregistré la prochaine fois (l'une ou l'autre moitié d'un double coffre compte)
• mourir de nouveau avant d'avoir récupéré l'XP s'ajoute au montant stocké au lieu de le remplacer

xpPercentageKept est ramené dans l'intervalle 0-1 à la lecture de la configuration : les valeurs supérieures à 1 se comportent donc comme 1, et les valeurs négatives ou invalides comme 0.

Exceptions importantes :

• Si keepInventory est actif, ResurrectionChest ne fait rien.
• Si keepLevel est actif, la branche de stockage d'XP est ignorée et la gestion vanilla des niveaux est laissée intacte.
• L'XP stockée n'est conservée qu'en mémoire. Elle n'est pas écrite dans playerData.yml : un redémarrage du serveur, un /resurrectionchest reload ou un rechargement de plugin fait donc perdre toute XP qui n'a pas encore été récupérée. Les objets déjà présents dans le coffre ne sont pas affectés.

Gestion des Excédents

Les objets sont insérés dans le coffre pile par pile, et l'insertion partielle est autorisée :

• tout ce qui rentre est stocké, y compris en complétant une pile existante
• seule la quantité restante demeure dans la liste normale des objets de mort, à l'endroit de la mort
• le joueur reçoit un avertissement que le coffre était plein

Intégration FreeMinecraftModels

Si FreeMinecraftModels est installé, ResurrectionChest peut faire apparaître un accessoire visuel de coffre au-dessus du vrai coffre.

Comportement actuel :

• les visuels premium (Angelic Chest) sont préférés quand le joueur a resurrectionchest.model.premium et que le modèle premium est effectivement chargé
• sinon le visuel gratuit (Wooden Chest) est utilisé quand le joueur a resurrectionchest.model.free
• si aucune permission n'accorde un modèle utilisable, aucun accessoire n'est généré et le coffre vanilla est utilisé tel quel
• le modèle visuel bascule entre les variantes simple et double selon la taille du coffre
• le vrai coffre reste le backend de stockage

Le choix du modèle est fait une seule fois, au moment de l'enregistrement du coffre, et il est stocké dans playerData.yml comme le chestModel de ce coffre. Deux conséquences :

• si FreeMinecraftModels n'était pas installé au moment de l'enregistrement, le coffre est enregistré sans modèle et reste un simple coffre vanilla même après l'installation de FreeMinecraftModels
• un changement de permission ultérieur ne met pas rétroactivement à niveau ni ne rétrograde un coffre existant

Dans les deux cas, le joueur doit ré-enregistrer le coffre (le casser et reposer le panneau) pour récupérer le nouveau modèle.

Quand un accessoire de modèle personnalisé est actif, les joueurs peuvent interagir directement avec lui :

• clic droit sur l'accessoire pour ouvrir l'inventaire du coffre sous-jacent
• clic gauche sur l'accessoire pour détruire l'enregistrement (seul le propriétaire du coffre peut faire cela ; un non-propriétaire qui clique à gauche reçoit un message rouge et rien n'est détruit)

Si FreeMinecraftModels est absent ou que le modèle ne peut pas être généré, le coffre sous-jacent fonctionne toujours normalement.

Packs de Contenu

ResurrectionChest est livré avec deux packs de contenu qui enveloppent les modèles de coffre FreeMinecraftModels :

• Wooden Chest (gratuit) : fournit resurrectionchest_free_single / resurrectionchest_free_double. Utilisé par resurrectionchest.model.free.
• Angelic Chest (premium) : fournit resurrectionchest_angelic_single / resurrectionchest_angelic_double. Utilisé par resurrectionchest.model.premium.

Chaque pack se trouve sous le dossier models de FreeMinecraftModels lorsqu'il est installé et models_disabled lorsqu'il est désinstallé. Les activer/désactiver via /resurrectionchest setup déplace les fichiers entre ces dossiers et recharge automatiquement FreeMinecraftModels.

Réserves Basées sur le Code Source

Le code source actuel montre quelques entrées de configuration qui sont exposées dans config.yml mais ne sont référencées nulle part en dehors de DefaultConfig :

• Particle effect 1
• Particle effect 2
• freeSingleDeathChestModelName
• freeDoubleDeathChestModelName et premiumDoubleDeathChestModelName (le plugin code en dur en interne les préfixes de nom de modèle resurrectionchest_free et resurrectionchest_angelic, puis ajoute _single ou _double selon la taille du coffre, donc les clés de configuration « Double » n'affectent actuellement pas les visuels du coffre)

En revanche, Particle effect 3 est le paramètre de particules avec une utilisation active évidente dans le code actuel : il est résolu une seule fois au chargement (avec repli sur PORTAL et un avertissement en console si le nom n'est pas une particule valide), puis généré à chaque tick tant que le chunk du coffre est chargé. Mettre Enable particle effects for death chests à false annule entièrement cette tâche par tick, ce qui est l'option la moins coûteuse sur les serveurs comptant beaucoup de coffres enregistrés. premiumSingleDeathChestModelName est utilisé pour vérifier que le fichier de modèle premium existe avant d'assigner le préfixe premium ; l'existence du fichier de modèle gratuit n'est pas vérifiée séparément.

Deux autres réserves concernant la surface de commandes :

• /resurrectionchest initialize ouvre la première configuration et nécessite resurrectionchest.initialize. /resurrectionchest setup ouvre les fonctions de contenu, de mise à jour et de plugins recommandés.
• /resurrectionchest clear n'est pas limitée à un seul joueur. Elle efface tous les coffres enregistrés du serveur en une seule passe.