Configuración y Permisos de ResurrectionChest

Permisos

Permiso	Propósito	Predeterminado
resurrectionchest.*	Da a los administradores acceso a los comandos setup, content, update, reload y clear	op
resurrectionchest.setup	Da a los administradores acceso a /resurrectionchest setup, recommendedplugins, downloadallcontent y updatecontent	op
resurrectionchest.initialize	Permiso de administrador reservado para el flujo de configuración inicial	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 (explorar y alternar packs de cofres, comprobar actualizaciones del plugin, ver plugins recomendados, alternar actualizaciones automáticas)
/resurrectionchest recommendedplugins	resurrectionchest.setup	Abre (o, para la consola, lista) los plugins complementarios recomendados para ResurrectionChest
/resurrectionchest downloadall	resurrectionchest.*	Descarga la actualización del plugin (si la hay) y todos los packs de contenido disponibles desde Nightbreak
/resurrectionchest downloadallcontent	resurrectionchest.setup	Descarga todos los packs de contenido disponibles desde Nightbreak
/resurrectionchest updatecontent (alias updateallcontent)	resurrectionchest.setup	Vuelve a descargar solo los packs de contenido instalados que estén desactualizados
/resurrectionchest downloadpluginupdate	resurrectionchest.*	Descarga una actualización del plugin ResurrectionChest si hay una disponible
/resurrectionchest reload	resurrectionchest.*	Recarga ResurrectionChest
/resurrectionchest clear	resurrectionchest.*	Elimina todos los bloques de ResurrectionChest rastreados; deja caer el inventario de cada cofre rastreado y retira los bloques de cofre y de cartel

Las actualizaciones del plugin descargadas se colocan en la carpeta update del servidor y solo surten efecto tras el siguiente reinicio del servidor.

Superficie de Configuración

config.yml actualmente expone estas configuraciones orientadas al usuario:

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

Actualizaciones Automáticas de Plugin y Contenido

nightbreak.autoDownloadPluginUpdates es una configuración compartida de Nightbreak/MagmaCore que viene incluida en ResurrectionChest. Su valor predeterminado es false.

• Cuando es false (el predeterminado), no se descarga nada automáticamente. ResurrectionChest sigue comprobando si hay una actualización del plugin al arrancar (y aproximadamente una vez por hora) para que el botón de actualización en el juego pueda mostrar el resultado, pero tú mismo activas cualquier descarga real.
• Cuando es true, ResurrectionChest descarga una actualización del plugin disponible y los packs de contenido desactualizados al iniciar. Las actualizaciones de plugin y contenido descargadas solo se usan después de reiniciar el servidor.
• Las descargas automáticas de plugin requieren un token de cuenta de Nightbreak válido y una membresía de supporter activa.

Puedes cambiar esta configuración en el juego desde el botón de la barra de herramientas Automatic Updates dentro de /resurrectionchest setup, o editar config.yml directamente.

El menú de configuración también expone una entrada Plugin Update (muestra la versión instalada/disponible y descarga una actualización al hacer clic) y una entrada Recommended Plugins (la misma lista que /resurrectionchest recommendedplugins).

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
• freeSingleDeathChestModelName
• 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). premiumSingleDeathChestModelName se usa para verificar que el archivo del modelo premium existe antes de asignar el prefijo premium; la existencia del archivo del modelo gratuito no se comprueba por separado.