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 / 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 ni una "extensión de proxy" incluida que extraer y copiar a ningún sitio.

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.

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 reload — reconstruye y vuelve a alojar el paquete fusionado
  • /rspm status — imprime un volcado de diagnóstico completo: estado del paquete, modo de alojamiento, clave de red, integraciones
  • /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. RSPM también hereda unos pocos subcomandos compartidos de MagmaCore/Nightbreak (p. ej. /rspm recommendedplugins, /rspm downloadall) a los que enlaza el menú de configuración.

Permisos:

  • /rspm setup requiere resourcepackmanager.setup y es solo para jugadores (abre una GUI de inventario, por lo que no puede ejecutarse desde consola).
  • /rspm reload, /rspm status, /rspm itemsadder <configure|dismiss> y /rspm data_compliance_request requieren todos 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).

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)
  • 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​