Configuración inicial de ResurrectionChest

Primer arranque

Hasta completar la configuración, ResurrectionChest muestra un recordatorio inicial diez segundos después de cada conexión de un administrador con resurrectionchest.*. Confirma que el plugin está listo para usarse, indica el comando /resurrectionchest setup y recuerda cómo registrar un cofre: coloca un cofre y añade un cartel que diga [DeathChest], o el texto que hayas definido en Input name for death chest.

ResurrectionChest funciona desde el principio con cofres vanilla, así que no hay ningún paso obligatorio aquí. El recordatorio deja de aparecer cuando setupDone es true en config.yml. Abrir /resurrectionchest setup cambia automáticamente setupDone a true y descarta el mensaje de forma permanente.

/resurrectionchest initialize abre la configuración guiada. Las opciones Configuración recomendada, Configuración manual y Usar contenido actual marcan la configuración como terminada. Los cofres de muerte vanilla funcionan sin descargar ningún paquete.

Menú de configuración

/resurrectionchest setup

Abre el menú de configuración de Nightbreak. Desde él, los administradores pueden:

• ver todos los paquetes de contenido de ResurrectionChest, Wooden Chest y Angelic Chest
• instalar o desinstalar paquetes, moviendo sus archivos de modelo entre las carpetas models y models_disabled de FreeMinecraftModels
• filtrar los paquetes por Gratuitos o Premium
• consultar y descargar una actualización del plugin desde Actualización del plugin
• descargar o actualizar todos los paquetes a la vez con la entrada de descarga completa, que ejecuta /resurrectionchest downloadall por ti
• abrir la lista de Plugins recomendados, la misma que muestra /resurrectionchest recommendedplugins
• activar o desactivar las Actualizaciones automáticas mediante la opción nightbreak.autoDownloadPluginUpdates. Consulta Configuración y permisos
• leer instrucciones de instalación y abrir enlaces relacionados de Nightbreak mediante el botón de información

Al instalar o desinstalar un paquete, ResurrectionChest recarga FreeMinecraftModels automáticamente para actualizar los modelos de cofre.

/resurrectionchest downloadall descarga a la vez la actualización del plugin, si existe, y todos los paquetes de contenido de ResurrectionChest disponibles en Nightbreak. Requiere una cuenta de Nightbreak vinculada. /resurrectionchest downloadallcontent solo descarga los paquetes de contenido, mientras que /resurrectionchest updatecontent, con alias updateallcontent, vuelve a descargar únicamente los paquetes desactualizados.

Si los archivos de un paquete se dañaron o se borraron pero su número de versión sigue figurando como actual, /resurrectionchest forcereinstallcontent <package|all> permite descargarlo de nuevo. El argumento del paquete se autocompleta con all, wooden-chest y angelic-chest. Usa all para reinstalar todos los paquetes ya descargados o indica su identificador directamente si han desaparecido todos sus archivos.

Importaciones manuales

Las descargas se guardan en esta carpeta, donde también puedes colocar paquetes manualmente:

plugins/ResurrectionChest/imports

Deja intactos los archivos comprimidos de los paquetes. ResurrectionChest extrae el contenido de la carpeta al arrancar, envía los modelos a FreeMinecraftModels y actualiza FreeMinecraftModels automáticamente si ha instalado modelos. Consulta la guía compartida de Importaciones manuales y gestión dentro del juego.

Registrar un cofre

1. Coloca un cofre.
2. Coloca un cartel de pared pegado a ese cofre.
3. Escribe el texto de activación configurado en la primera o segunda línea del cartel. No importa si usas mayúsculas o minúsculas.

El texto de activación predeterminado es:

[DeathChest]

Cuando acepta el cartel, ResurrectionChest:

• reescribe el cartel: borra la primera línea, muestra el texto de activación en morado en la segunda y el nombre visible del jugador en la tercera, y borra la cuarta
• registra ese cofre para el jugador
• elimina el registro anterior del jugador, si tenía uno, incluido el cartel de configuración del cofre antiguo; conserva el bloque del cofre antiguo y su contenido
• añade una marca de propiedad a los bloques de cofre y cartel en el siguiente tick, para distinguir después sus propios bloques de otros iguales

Si otro plugin cancela la colocación del cartel, no se confirma el registro y el cofre anterior sigue registrado. Romper un cofre o cartel solo elimina su registro cuando la rotura se hace efectiva. Si se cancela la rotura, el registro se conserva.

No hay un procedimiento de registro de cofres mediante comandos.

Reglas de configuración

• El jugador necesita resurrectionchest.use.
• El registro está bloqueado en los mundos excluidos.
• El cartel debe ser un cartel de pared pegado a un cofre.
• Sirve cualquier material de cartel de pared, porque el código comprueba el tipo de bloque y no un material concreto.
• El bloque situado detrás del cartel debe ser un cofre normal. Se rechazan los cofres trampa, barriles y demás contenedores.
• El cofre no puede estar registrado a nombre de otro jugador. Si lo está, aunque solo sea una mitad de un cofre doble, el cartel conserva su texto normal y se informa al jugador de que el cofre pertenece a otra persona.
• El jugador debe tener permiso para construir en el bloque del cofre. ResurrectionChest usa la consulta compartida de WorldGuard y GriefPrevention de MagmaCore y los informes de protección de los proveedores de propiedad de ubicaciones. Una denegación rechaza el registro con el texto de Chest protected region message. Sin proveedores de protección o propiedad no hay restricciones adicionales. Consulta Configuración y permisos.

Cofres simples y dobles

• Un cofre simple normal funciona inmediatamente.
• Si un cofre registrado pasa a formar parte de un cofre doble, ResurrectionChest detecta el cambio un tick después de colocar el bloque, marca la nueva mitad y sus carteles, y cambia el modelo visual por el de cofre doble.
• Si la nueva mitad ya pertenece al registro de otro jugador, se descarta el registro completo en vez de incorporar el cofre ajeno.
• Los objetos de la muerte pueden llenar ambas mitades del inventario de un cofre doble, las 54 ranuras.
• Un cofre doble puede cruzar el límite de un chunk. El servidor solo empareja las dos mitades mientras ambos chunks están cargados, así que cuando el propietario muere lejos, ResurrectionChest carga el chunk que contiene la otra mitad antes de comprobar la propiedad y mover los objetos. Lo carga con normalidad y no lo mantiene con carga forzada. Si aun así las mitades no se emparejan, la consola registra un aviso con el nombre del jugador y la ubicación del cofre, y solo la mitad registrada recibe objetos.
• Con los ajustes de seguridad predeterminados, al morir el jugador ambas mitades deben conservar su marca de propiedad. Si una mitad se sustituyó sin que el plugin lo supiera, el cofre se considera desaparecido.

Eliminación del registro

Romper cualquiera de estos bloques elimina el registro:

• el cofre registrado
• un cartel pegado que pertenezca a ese cofre registrado

Cuando se elimina un registro, ya sea al romper el cofre, romper su cartel o destruirlo mediante el modelo de FreeMinecraftModels, el plugin también retira los carteles de pared pegados que superen su comprobación de propiedad. Esos carteles se eliminan sin soltarse como objetos.

El registro también se descarta automáticamente cuando el plugin ya no puede confirmar la propiedad de los bloques. Si una mitad del cofre en una ubicación guardada pierde su marca de propiedad o lleva la de otra persona, el registro se descarta en el siguiente arranque, carga del chunk o actualización del modelo. Se escribe una advertencia en la consola con el UUID del propietario y las coordenadas del cofre. El bloque del cofre se conserva. Las marcas de los carteles solo se comprueban de nuevo cuando el plugin vuelve a marcar sus bloques: al unir la segunda mitad de un cofre doble o al migrar un registro antiguo a las marcas actuales. Activa Enable high compatibility / low security mode for plugin conflicts si otro plugin elimina esos datos de bloque. Consulta Configuración y permisos.

El plugin también cancela los intentos de editar directamente el cartel de configuración registrado.

Si hay un modelo personalizado de cofre activo, hacer clic izquierdo sobre él también elimina el registro. Solo puede hacerlo el propietario; consulta Configuración y permisos.

Los administradores pueden eliminar todos los cofres registrados a la vez con /resurrectionchest clear. Para cada cofre, deja caer su inventario al suelo, retira el cofre y sus carteles de configuración y borra el registro guardado.

Esta limpieza respeta las comprobaciones de propiedad configuradas. Los bloques que no las superan se conservan. Si el mundo de un cofre está descargado, solo se borra su registro; los bloques de ese mundo permanecen.

Advertencia sobre la protección

ResurrectionChest no es un plugin de protección.

• No impide que otros jugadores abran el cofre físico.
• No impide que otros jugadores rompan el cofre físico o su cartel si la protección de tu servidor lo permite.

Usa protección de regiones u otra solución de protección de cofres si necesitas controlar el acceso.

Solución de problemas

• Los objetos no van al cofre. Comprueba que el jugador tiene resurrectionchest.use, que el cartel usó el texto de activación configurado y que el cofre sigue existiendo y está registrado a nombre de ese jugador (romperlo elimina el registro). Las muertes en un mundo incluido en blacklistedWorlds, o con keepInventory activado, se dejan sin tocar.
• No se muestra el modelo personalizado del cofre. El modelo se elige cuando se registra el cofre. Si FreeMinecraftModels o el paquete de modelos se instaló después, o cambió el permiso de modelo del jugador, rompe el cofre y regístralo de nuevo. Consulta Integración con FreeMinecraftModels.
• Antes de ejecutar /resurrectionchest clear, haz una copia de seguridad de playerData.yml y de cualquier contenido de cofres que quieras conservar. El comando vuelca en el suelo el contenido de todos los cofres registrados y elimina los cofres y sus carteles.

Cuando pidas ayuda, incluye las versiones de ResurrectionChest y del servidor, tu config.yml, los pasos que reproducen el problema y el registro completo del servidor. /logify sube el registro y devuelve un enlace.