Saltar al contenido principal

Configuración de ResourcePackManager

Esta página cubre una configuración para un único servidor (independiente). Si ejecutas una red de BungeeCord / Velocity, sigue Redes proxy en su lugar — instalas el mismo ResourcePackManager.jar en el proxy, pero genera su propia configuración y desempeña un rol del lado del proxy.

ResourcePackManager 2.x se distribuye como un único jar universal. El mismo ResourcePackManager.jar se ejecuta en backends de Bukkit/Paper y en proxies de Velocity / BungeeCord; detecta la plataforma a partir del cargador que lo ejecuta. Ya no hay archivos resourcepackmanager-velocity-*.jar / resourcepackmanager-bungee-*.jar separados que extraer. Si detecta un backend detrás de un proxy sin una clave de red guardada o derivada inicialmente, prepara una copia de su jar en plugins/ResourcePackManager/proxy-extension/ResourcePackManager.jar para copiarla al proxy: el mismo archivo en una ubicación práctica.

El descriptor del plugin del backend declara la API de Bukkit 1.21.4, por lo que el servidor de Bukkit/Paper debe ser Minecraft 1.21.4 o posterior. La extensión de entidades personalizadas de Geyser incluida apunta a Geyser 2.11+.

  1. Coloca ResourcePackManager.jar en la carpeta plugins/ de tu servidor. (Es el mismo jar que usarías en un proxy de Velocity / BungeeCord — no hay jars de proxy separados.)
  2. Inicia el servidor una vez para que se generen las carpetas de configuración, mezclador, blueprint y salida.
  3. Decide si deseas:
    • autoalojamiento (por defecto, activo)
    • el fallback gratuito de auto-host de MagmaGuy (por defecto, activo)
    • aceptación forzada por parte del cliente
    • paquetes personalizados manuales en la carpeta del mezclador
  4. Ejecuta /rspm reload después de cambiar la configuración o de añadir paquetes personalizados manualmente.

Con la configuración por defecto, RSPM intenta primero el autoalojamiento verificado y recurre al alojamiento remoto mediante magmaguy.com si la verificación falla o no está disponible. Si ambas rutas automáticas fallan, no puede anunciar una URL de entrega nueva. Comprueba el estado final y la descarga del cliente antes de dar la configuración por terminada.

Una configuración de alojamiento correcta produce una línea en consola como esta:

[ResourcePackManager] Resource pack is live via self-hosting — http://play.example.com:25566/rspm.zip

RSPM mantiene la consola en silencio a propósito — informa del resultado, no de cada paso, y no avisa de condiciones de las que se recupera por sí mismo (un sondeo de autoalojamiento fallido seguido de un respaldo exitoso es un éxito, no un fallo). Si hay que diagnosticar algo, ejecuta /rspm verbose on (o pon verboseLogging: true en config.yml) y recarga. Consulta Solución de problemas.

Carpetas que genera RSPM​

Bajo plugins/ResourcePackManager/:

CarpetaPara qué sirve
mixer/Coloca aquí paquetes .zip terminados para fusionarlos. Referéncialos en priorityOrder por su nombre de archivo exacto, incluyendo .zip.
resource_pack/Coloca aquí un paquete descomprimido (un árbol de carpetas con assets/, pack.mcmeta, ...). RSPM lo comprime y lo fusiona bajo la entrada de prioridad ResourcePackManager, que está en lo más alto del priorityOrder por defecto.
blueprint/Contiene el pack.png y el pack.mcmeta por defecto que RSPM aporta a la fusión. Edítalos para cambiar el icono del paquete fusionado o la descripción de su pack.mcmeta; la carpeta se vuelve a comprimir en blueprint.zip en cada arranque.
output/Los artefactos terminados: ResourcePackManager_RSP.zip, más ResourcePackManager_Bedrock.zip y rspm_geyser_mappings.json cuando la conversión a Bedrock los haya producido.
compatible_plugins/Un YAML por cada integración de plugin soportada.
data_compliance/Donde /rspm data_compliance_request escribe su descarga.
proxy-extension/Se crea cuando un backend detrás de un proxy no tiene una clave de red guardada o derivada inicialmente. Contiene una copia del ResourcePackManager.jar en ejecución para instalar en el proxy. Que la carpeta siga existiendo no demuestra que el backend siga sin vincular.
geyser-extension/Se exporta cuando la instalación automática de la extensión está activada, Floodgate es local y Geyser-Spigot no está presente. Sigue la ruta exacta de la consola, que puede apuntar dentro de update/, al copiar el jar a extensions/ del Geyser externo. La exportación no configura la entrega externa del paquete.

Comandos principales​

  • /rspm setup — abre un menú de configuración GUI dentro del juego (estado de actualización del plugin, plugins recomendados, un interruptor de actualizaciones automáticas y un botón de información con enlaces clicables al wiki, Discord y el token de tu cuenta de Nightbreak)
  • /rspm recommendedplugins — muestra el menú compartido de plugins recomendados de Nightbreak
  • /rspm downloadpluginupdate — descarga una actualización disponible de ResourcePackManager para el siguiente reinicio
  • /rspm downloadall — descarga todas las actualizaciones disponibles que expone este plugin (actualmente la actualización de ResourcePackManager)
  • /rspm applypluginupdate — lo registra el conjunto de comandos compartidos de Nightbreak, pero RSPM siempre lo rechaza: ResourcePackManager updates need a server restart: its Geyser extension only loads when Geyser starts. Reinicia el servidor para aplicar una actualización descargada.
  • /rspm reload — reinicia la inicialización del plugin y programa la preparación del paquete; un paquete sin cambios puede reutilizar el registro de alojamiento existente
  • /rspm status — imprime un volcado de diagnóstico completo: estado del paquete, modo de alojamiento, huella de la clave de red, integraciones
  • /rspm verbose [on|off] — activa o desactiva el registro de diagnóstico detallado sin abrir config.yml. Sin argumento, alterna el estado. La elección se escribe de vuelta en verboseLogging dentro de config.yml, así que sobrevive a los reinicios. Tiene el alias /rspm verboselogging.
  • /rspm itemsadder configure — configura automáticamente ItemsAdder para el alojamiento por RSPM (ver abajo)
  • /rspm itemsadder dismiss — descarta permanentemente la advertencia de ItemsAdder para el UUID de tu jugador
  • /rspm data_compliance_request — descarga todos los datos almacenados de forma remota para este servidor

El comando raíz es /resourcepackmanager, con /rspm como su alias. Los comandos de actualización y de plugins recomendados de arriba son comandos compartidos de MagmaCore/Nightbreak registrados por RSPM.

Permisos:

  • /rspm setup y /rspm recommendedplugins requieren resourcepackmanager.setup. /rspm setup es solo para jugadores porque abre una GUI de inventario.
  • /rspm downloadpluginupdate, /rspm downloadall, /rspm applypluginupdate, /rspm reload, /rspm status, /rspm verbose, /rspm itemsadder <configure|dismiss> y /rspm data_compliance_request requieren resourcepackmanager.*.

ItemsAdder​

La ruta preferida actual para ItemsAdder ya no es exclusivamente manual.

Usa:

/rspm itemsadder configure

Ese asistente actualiza los ajustes pertinentes de ItemsAdder, solicita la regeneración del paquete y espera a que RSPM fusione la nueva exportación. En concreto:

  • establece resource-pack.hosting.no-host.enabled: true
  • desactiva protection_1, protection_2 y protection_3 en resource-pack.zip.protect-file-from-unzip
  • establece resource-pack.zip.compress-json-files: false (RSPM necesita el JSON de modelos sin comprimir y analizable para el mezclador y el convertidor de Bedrock)
  • ejecuta /iareload tras 20 ticks del servidor y /iazip otros 100 ticks después
  • espera a que el watchdog de RSPM detecte la exportación regenerada de ItemsAdder y termine la fusión; después informa RSPM merged the regenerated ItemsAdder export. Use /rspm status to check hosting. Si esa fusión falla, informa de que no se pudo fusionar la exportación y RSPM lo vuelve a intentar.

El asistente no recarga ResourcePackManager. Se niega a empezar mientras siga pendiente una configuración anterior, y se detiene sin guardar si el config.yml de ItemsAdder cambia mientras lo está editando. Si ItemsAdder rechaza /iareload o /iazip, ejecuta ese comando a mano. El mensaje de fusión confirma la fusión, no el alojamiento: comprueba después /rspm status y una descarga con un cliente real.

Si ItemsAdder ya está configurado para alojar su propio paquete (self-host, external-host o lobfile), el asistente se detiene y te indica que desactives manualmente el alojamiento de ItemsAdder primero.

Compatibilidad con Bedrock / GeyserMC​

RSPM puede convertir los recursos compatibles del paquete Java fusionado en un paquete Bedrock para GeyserMC. Examina definiciones de objetos de 1.21.4+ de cualquier plugin, incluidos objetos 3D en mano y equipo compatibles; esto no garantiza la conversión de cada nodo de modelo, predicado o diseño de armadura. Consulta los límites en la guía de conversión indicada abajo.

bedrockConversionEnabled es true por defecto. La conversión también requiere detectar un destino Bedrock y disponer de recursos de origen compatibles; el registro al arrancar puede requerir el reinicio de Geyser descrito a continuación.

Para un servidor independiente, la conversión se activa cuando se cumple cualquiera de estas condiciones: Geyser-Spigot está instalado en este servidor, Floodgate está instalado en este servidor, o RSPM detectó el modo proxy (consulta Redes proxy).

Si Geyser-Spigot está instalado localmente y geyserExtensionAutoInstall: true, RSPM instala o prepara su jar universal en plugins/Geyser-Spigot/extensions/. Reinicia el servidor para cargar una extensión recién instalada o preparada. Las entidades Bedrock personalizadas también requieren que un productor compatible marque la entidad Java mediante el puente, definiciones registradas y el paquete correcto en el cliente. geyserExtensionAutoInstall: false impide instalaciones y preparaciones futuras; no elimina un jar instalado ni cancela una actualización ya preparada. Consulta Extensión de Geyser y entidades personalizadas.

Consulta Conversión a Bedrock / Geyser para conocer la canalización completa, las rutas de salida y las poses de los ítems en mano.

Verificación de la configuración​

Para ofrecer una dirección pública de descarga HTTPS, mantén activado el alojamiento automático y establece selfHostExternalUrl con la URL completa del paquete en tu proxy inverso. Consulta HTTPS y proxies inversos para configurar el servidor de escucha y el reenvío.

Ejecuta /rspm status en consola o como op. La salida se divide en secciones:

  • Metadatos del plugin — versión y modo de despliegue (independiente o backend de red). En un backend de red también muestra una huella corta y no secreta de la clave de red y su procedencia (proporcionada por el proxy, guardada en este servidor, adoptada de la clave de Floodgate o aún sin establecer).
  • Paquete Java — mezclado sí/no, tamaño, prefijo SHA1
  • Paquete Bedrock — convertido sí/no, mappings presentes, con pistas de diagnóstico si se omitió la conversión
  • Alojamiento — qué ruta de entrega está activa (autoalojado / remoto / aún no listo), la URL que verán los clientes, host externo resuelto, IP pública autodetectada y el resultado de la última comprobación de autoalojamiento con el motivo del fallo
  • Despliegue del proxy — un recordatorio de que el jar del proxy de red es el mismo ResourcePackManager.jar; en una red, cópialo a la carpeta plugins/ del proxy
  • Integraciones — detección de Floodgate / Geyser-Spigot, conteo de jugadores en línea

Cuando el estado muestre una URL de entrega, conéctate con un cliente real, acepta el paquete e inspecciona un objeto o modelo personalizado conocido. En Bedrock, vuelve a conectarte después de reconstruir el paquete y reinicia Geyser cuando las nuevas asignaciones o definiciones de entidades necesiten registrarse. El estado y los registros de alojamiento describen la publicación, no la representación gráfica en el cliente.

Si algo no se ve bien, consulta Solución de problemas.

Próximos pasos​