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	Permission d'administrateur réservée au flux de configuration initiale	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 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.

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!
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).

Gestion de l'XP

Quand storeXP est activé :

• ResurrectionChest suit l'XP totale actuelle du joueur pendant le jeu
• à la mort, il stocke XP totale suivie * 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

Exceptions importantes :

• Si keepInventory est actif, ResurrectionChest ne fait rien.
• Si keepLevel est actif, la branche de stockage d'XP sort prématurément et laisse la gestion vanilla des niveaux intacte.

Gestion des Excédents

Si le coffre n'a pas de place libre pour un objet :

• cet objet reste dans la liste normale des objets de 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

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
• sneak + clic gauche sur l'accessoire pour détruire l'enregistrement (seul le propriétaire peut faire cela)
• cliquer à gauche sans sneak affiche un avertissement jaune au lieu de détruire le coffre

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 :

• Enable high compatibility / low security mode for plugin conflicts
• Lower worn armor's durability on death et Amount of durability to lower on death
• 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 (généré à chaque tick tant que le chunk du coffre est chargé). 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.