Configuración y Permisos de ResurrectionChest

Permisos

Permiso	Propósito	Predeterminado
resurrectionchest.*	Da a los administradores acceso a los comandos setup, initialize, downloadall, updatecontent y reload	op
resurrectionchest.setup	Da a los administradores acceso al comando /resurrectionchest setup	op
resurrectionchest.initialize	Da a los administradores acceso al comando /resurrectionchest initialize	op
resurrectionchest.use	Permite a un jugador registrar un cofre y que los objetos de muerte se dirijan a él	true
resurrectionchest.model.free	Permite a un jugador usar los visuales gratuitos de cofre de FreeMinecraftModels (Wooden Chest)	true
resurrectionchest.model.premium	Permite a un jugador usar los visuales premium de cofre de FreeMinecraftModels (Angelic Chest)	op

resurrectionchest.use es el importante para el comportamiento real del cofre. Los permisos de administrador y de modelo solo afectan a los comandos y a los visuales opcionales respectivamente.

Comandos

Comando	Permiso	Propósito
/resurrectionchest	resurrectionchest.*	Imprime una breve nota informativa que apunta al flujo de configuración
/resurrectionchest setup	resurrectionchest.setup	Abre el menú de configuración de contenido (explorar y alternar packs de cofres)
/resurrectionchest initialize	resurrectionchest.initialize	Abre el menú de configuración inicial
/resurrectionchest downloadall	resurrectionchest.setup	Descarga todos los packs disponibles desde Nightbreak
/resurrectionchest updatecontent (alias updateall)	resurrectionchest.setup	Vuelve a descargar solo los packs instalados desactualizados
/resurrectionchest reload	resurrectionchest.*	Recarga ResurrectionChest

Superficie de Configuración

config.yml actualmente expone estas configuraciones orientadas al usuario:

Clave de Config	Tipo	Predeterminado
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

Manejo de XP

Cuando storeXP está habilitado:

• ResurrectionChest rastrea la XP total actual del jugador durante el juego
• al morir, almacena XP total rastreada * xpPercentageKept
• establece la XP dejada caer en 0
• devuelve la XP almacenada cuando el propietario abre su cofre registrado la próxima vez

Excepciones importantes:

• Si keepInventory está activo, ResurrectionChest no hace nada.
• Si keepLevel está activo, la rama de almacenamiento de XP sale temprano y deja el manejo de nivel vanilla intacto.

Manejo de Excedentes

Si el cofre no tiene espacio libre para un objeto:

• ese objeto permanece en la lista normal de objetos de muerte
• el jugador recibe una advertencia de que el cofre estaba lleno

Integración con FreeMinecraftModels

Si FreeMinecraftModels está instalado, ResurrectionChest puede generar un prop visual de cofre encima del cofre real.

Comportamiento actual:

• los visuales premium (Angelic Chest) se prefieren cuando el jugador tiene resurrectionchest.model.premium y el modelo premium está realmente cargado
• de lo contrario, se usa el visual gratuito (Wooden Chest) cuando el jugador tiene resurrectionchest.model.free
• si ningún permiso otorga un modelo utilizable, no se genera ningún prop y se usa el cofre vanilla tal cual
• el modelo visual cambia entre variantes simple y doble según el tamaño del cofre
• el cofre real sigue siendo el almacenamiento de fondo

Cuando hay un prop de modelo personalizado activo, los jugadores pueden interactuar con él directamente:

• clic derecho sobre el prop para abrir el inventario del cofre subyacente
• agacharse + clic izquierdo sobre el prop para destruir el registro (solo el propietario puede hacerlo)
• el clic izquierdo sin agacharse muestra una advertencia amarilla en lugar de destruir el cofre

Si FreeMinecraftModels no está presente o el modelo no puede generarse, el cofre subyacente sigue funcionando normalmente.

Packs de Contenido

ResurrectionChest incluye dos packs de contenido que envuelven los modelos de cofre de FreeMinecraftModels:

• Wooden Chest (gratuito): proporciona resurrectionchest_free_single / resurrectionchest_free_double. Utilizado por resurrectionchest.model.free.
• Angelic Chest (premium): proporciona resurrectionchest_angelic_single / resurrectionchest_angelic_double. Utilizado por resurrectionchest.model.premium.

Cada pack reside en la carpeta models de FreeMinecraftModels cuando está instalado y en models_disabled cuando está desinstalado. Alternarlos mediante /resurrectionchest setup mueve los archivos entre esas carpetas y recarga FreeMinecraftModels automáticamente.

Advertencias Basadas en el Código Fuente

El código fuente actual muestra algunas entradas de configuración que están expuestas en config.yml pero no se referencian en ningún sitio fuera de DefaultConfig:

• Enable high compatibility / low security mode for plugin conflicts
• Lower worn armor's durability on death y Amount of durability to lower on death
• Particle effect 1
• Particle effect 2
• freeDoubleDeathChestModelName y premiumDoubleDeathChestModelName (el plugin codifica internamente los prefijos de nombre de modelo resurrectionchest_free y resurrectionchest_angelic, luego añade _single o _double según el tamaño del cofre, por lo que las claves de configuración "Double" no afectan actualmente a los visuales del cofre)

En contraste, Particle effect 3 es la configuración de partículas con un uso activo obvio en el código actual (generada cada tick mientras el chunk del cofre está cargado). freeSingleDeathChestModelName y premiumSingleDeathChestModelName se usan para verificar que el archivo de modelo existe antes de asignar el prefijo premium.