Configuration et Permissions de ResurrectionChest

Permissions

Permission	Objectif	Par défaut
resurrectionchest.*	Donne aux administrateurs l'accès aux commandes setup, initialize, downloadall, updatecontent et reload	op
resurrectionchest.setup	Donne aux administrateurs l'accès à la commande /resurrectionchest setup	op
resurrectionchest.initialize	Donne aux administrateurs l'accès à la commande /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 de contenu (parcourir et activer/désactiver les packs de coffres)
/resurrectionchest initialize	resurrectionchest.initialize	Ouvre le menu de configuration initiale
/resurrectionchest downloadall	resurrectionchest.setup	Télécharge tous les packs disponibles depuis Nightbreak
/resurrectionchest updatecontent (alias updateall)	resurrectionchest.setup	Re-télécharge uniquement les packs installés obsolètes
/resurrectionchest reload	resurrectionchest.*	Recharge ResurrectionChest

Surface de Configuration

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

Clé de Config	Type	Par défaut
setupDone	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

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
• 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é). freeSingleDeathChestModelName et premiumSingleDeathChestModelName sont utilisés pour vérifier que le fichier de modèle existe avant d'assigner le préfixe premium.