Configuración de ResourcePackManager

Esta página cubre una configuración para un único servidor (independiente). Si ejecutas una red de BungeeCord / Waterfall / 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 mismísimo ResourcePackManager.jar se ejecuta en backends de Bukkit/Paper y en proxies de Velocity / BungeeCord / Waterfall — autodetecta la plataforma a partir del cargador bajo el que se ejecuta. Ya no existen archivos resourcepackmanager-velocity-*.jar / resourcepackmanager-bungee-*.jar separados que extraer. (Si RSPM detecta que este backend está detrás de un proxy que nunca le ha dado una clave, prepara una copia de su propio jar en plugins/ResourcePackManager/proxy-extension/ResourcePackManager.jar para que la copies al proxy — el mismo archivo, solo colocado en un sitio cómodo.)

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

Configuración recomendada (independiente)

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.

Eso es todo para el camino feliz. Con la configuración por defecto, RSPM intentará autoalojar primero y recurrirá automáticamente al CDN de MagmaGuy si algo no cuadra.

Sabrás que funcionó por una sola línea en consola:

[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/:

Carpeta	Para 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/	Solo aparece en un backend que está detrás de un proxy que nunca le ha dado una clave. Contiene una copia del ResourcePackManager.jar en ejecución para ponerla en el proxy.
geyser-extension/	Solo aparece cuando Floodgate es local pero Geyser es un proceso externo. Contiene una copia del jar para ponerla en la carpeta extensions/ de ese Geyser.

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 reload — reconstruye y vuelve a alojar el paquete fusionado
• /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 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, regenera el paquete de ItemsAdder y luego recarga ResourcePackManager. 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)
• despacha /iareload y luego /iazip
• recarga ResourcePackManager unos 15 segundos después, una vez que ItemsAdder ha tenido tiempo de recargar y regenerar

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.

Soporte para Bedrock / GeyserMC

RSPM convierte automáticamente el paquete Java fusionado en un paquete de Bedrock para GeyserMC. La conversión gestiona el paquete de definición de ítems 1.21.4+ de cualquier plugin — no solo FreeMinecraftModels — incluyendo ítems en mano 3D, armaduras personalizadas y equipo modelado.

bedrockConversionEnabled por defecto es true, así que una instalación nueva en un servidor que tenga GeyserMC funcionará sin más.

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 en este servidor, RSPM también se instala a sí mismo en plugins/Geyser-Spigot/extensions/ como extensión de Geyser, que es lo que hace que las entidades personalizadas de Bedrock se rendericen en lugar de aparecer como armor stands. Es el mismo ResourcePackManager.jar — no hay nada extra que descargar — pero necesita un reinicio del servidor para surtir efecto. Pon geyserExtensionAutoInstall: false en config.yml para que RSPM deje de instalar y preparar esa extensión. 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 el ajuste de los desplazamientos de visualización.

Verificación de la configuración

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

• Metadatos del plugin — versión + modo de despliegue (independiente vs network-backend). En un backend de red también imprime una huella corta y no secreta de la clave de red y de dónde vino esa clave (provided by the proxy / saved on this server / adopted from Floodgate's key / not set yet).
• 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
• 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

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

A dónde ir después

• FAQ — preguntas frecuentes
• Conversión a Bedrock / Geyser — detalles del convertidor y ajustes
• Extensión de Geyser y entidades personalizadas — instalación de la extensión y requisitos de versión de Geyser
• Autoalojamiento — servidor HTTP integrado, resolución de puertos
• Redes proxy — si ejecutas BungeeCord / Waterfall / Velocity
• API — registrar el paquete de tu plugin desde código