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	Permite abrir la configuración inicial con /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 (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 forcereinstallcontent <package|all>	resurrectionchest.*	Vuelve a descargar un pack de contenido (o todos los packs descargados) incluso cuando la versión instalada ya está al día. Los nombres de paquete se autocompletan con los slugs de Nightbreak wooden-chest y angelic-chest, además de all
/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.

Archivos del Plugin

Ruta	Propósito
plugins/ResurrectionChest/config.yml	Todas las opciones de la tabla de más abajo
plugins/ResurrectionChest/playerData.yml	Una entrada por cofre registrado, indexada por el UUID del jugador: la location del cofre, el prefijo chestModel elegido cuando se registró el cofre y un trackedBlockSchemaVersion que se usa para migrar registros antiguos a las etiquetas de propiedad de bloque actuales
plugins/ResurrectionChest/content_packages/	Las definiciones de pack de contenido wooden_chest.yml / angelic_chest.yml (nombre, descripción, enlace de descarga, versión, isEnabled, category)
plugins/ResurrectionChest/nightbreak-changelogs.yml	Estado de leído/descartado de la bandeja de changelogs compartida detrás de /resurrectionchestchangelog. Ver Notificaciones de Changelog
plugins/ResurrectionChest/imports/	Carpeta donde dejar las importaciones manuales. Todo lo que se deje aquí se desempaqueta al iniciar: los archivos de modelo se encaminan hacia FreeMinecraftModels y FreeMinecraftModels se actualiza automáticamente. Ver Importaciones manuales vs gestión dentro del juego

No edites playerData.yml a mano mientras el servidor está en marcha; ResurrectionChest lo reescribe cada vez que se registra o se elimina un cofre.

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

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

Protección de Regiones

Registrar un cofre de la muerte se trata como construir: antes de aceptar el cartel, ResurrectionChest pregunta al LocationQueryRegistry compartido de MagmaCore si el jugador puede construir en el bloque del cofre.

• WorldGuard y GriefPrevention se integran automáticamente; si no hay ninguno instalado no existe ninguna restricción adicional y el registro se comporta exactamente como antes.
• Si un plugin de protección deniega la construcción, el registro se rechaza y al jugador se le envía Chest protected region message.
• Si un adaptador de protección lanza un error, la consulta falla de forma segura (el registro se rechaza) en lugar de saltarse la protección en silencio.

Los adaptadores se conectan durante el arranque, así que cualquier fallo de conexión aparece en el registro de inicio en lugar de en el primer registro de un cofre.

Penalización de Durabilidad de Armadura

Lower worn armor's durability on death (por defecto true) y Amount of durability to lower on death (por defecto 100) se aplican a la armadura que lleva puesta el jugador mientras se encamina al cofre de la muerte:

• a cada pieza de armadura equipada que aparece en los objetos soltados al morir se le suma Amount of durability to lower on death a su valor de daño
• si eso llevara la pieza a su durabilidad máxima o más allá, la pieza se elimina por completo de los objetos soltados (se destruye en lugar de guardarse)
• en caso contrario, la pieza dañada es lo que acaba colocándose en el cofre

La penalización solo se ejecuta en las muertes que ResurrectionChest gestiona realmente: se omite cuando keepInventory está activo, cuando el mundo está en la lista negra, cuando el jugador carece de resurrectionchest.use y cuando falta el cofre registrado.

Modo de Alta Compatibilidad

Enable high compatibility / low security mode for plugin conflicts vale false por defecto. En ese caso, el cartel o cofre registrado debe conservar la etiqueta de propietario correspondiente.

Con true se acepta que falte la etiqueta en una ubicación registrada. Una etiqueta de otro propietario sigue rechazándose y el cofre debe seguir siendo un bloque de cofre. Este modo sirve para plugins que eliminan etiquetas; no acepta cualquier bloque de sustitución.

Manejo de XP

Cuando storeXP está habilitado:

• ResurrectionChest rastrea la XP total del jugador durante el juego, pero lee el total en vivo del jugador en el momento de la muerte, así que la XP concedida directamente a través de la API de otro plugin también se contabiliza
• al morir, almacena total XP * xpPercentageKept
• establece la XP dejada caer en 0
• devuelve la XP almacenada cuando el propietario abre su cofre registrado la próxima vez (cualquiera de las dos mitades de un cofre doble cuenta)
• morir de nuevo antes de recogerla suma a la cantidad almacenada en lugar de reemplazarla

xpPercentageKept se limita al rango 0-1 al leer la configuración, así que los valores por encima de 1 se comportan como 1 y los negativos o inválidos se comportan como 0.

Excepciones importantes:

• Si keepInventory está activo, ResurrectionChest no hace nada.
• Si keepLevel está activo, la rama de almacenamiento de XP se omite y deja el manejo de nivel vanilla intacto.
• La XP almacenada se guarda solo en memoria. No se escribe en playerData.yml, así que reiniciar el servidor, un /resurrectionchest reload o una recarga del plugin descartan cualquier XP que todavía no se haya recogido. Los objetos que ya están dentro del cofre no se ven afectados.

Manejo de Excedentes

Los objetos se insertan en el cofre pila a pila y se permite la inserción parcial:

• se guarda todo lo que quepa, incluso completando una pila ya existente
• solo la cantidad sobrante se queda en la lista normal de objetos de muerte en el lugar de la 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

La elección del modelo se hace una sola vez, cuando se registra el cofre, y se guarda en playerData.yml como el chestModel de ese cofre. Esto tiene dos consecuencias:

• si FreeMinecraftModels no estaba instalado en el momento del registro, el cofre se registra sin modelo y sigue siendo un cofre vanilla normal incluso después de instalar FreeMinecraftModels
• un cambio de permisos posterior no mejora ni degrada retroactivamente un cofre ya existente

En ambos casos el jugador tiene que volver a registrar el cofre (romperlo y colocar el cartel de nuevo) para adoptar el nuevo modelo.

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
• clic izquierdo sobre el prop para destruir el registro (solo el propietario puede hacerlo; a quien no sea el propietario y haga clic izquierdo le sale un mensaje en rojo y no se destruye nada)

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:

• 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: se resuelve una vez al cargar (recurriendo a PORTAL con una advertencia en la consola si el nombre no es una partícula válida) y después se genera cada tick mientras el chunk del cofre está cargado. Poner Enable particle effects for death chests en false cancela por completo esa tarea por tick, que es la opción más económica en servidores con muchos cofres registrados. 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.

Dos advertencias más sobre la superficie de comandos:

• /resurrectionchest initialize abre la configuración inicial y requiere resurrectionchest.initialize. /resurrectionchest setup abre las opciones de contenido, actualizaciones y plugins recomendados.
• /resurrectionchest clear no está limitado a un solo jugador. Borra todos los cofres registrados del servidor en una sola pasada.