Solución de problemas de Resource Pack Manager

Esta página solo cubre el comportamiento que está confirmado actualmente en el código de ResourcePackManager.

Los jugadores no están recibiendo el paquete de recursos

Comprueba primero estos puntos:

• autoHost debe estar activado si quieres que ResourcePackManager envíe su paquete alojado automáticamente
• el paquete fusionado debe existir y terminar de subirse correctamente
• los jugadores solo reciben el paquete al conectarse, o tras una nueva subida durante la ejecución actual

Si es necesario:

1. Ejecuta /rspm reload.
2. Observa la salida de consola en busca de errores de subida o del servidor remoto.
3. Vuelve a conectarte con un jugador de prueba después de que se complete la recarga.

Si estás autoalojando en lugar de usar el alojamiento automático, ResourcePackManager no envía tu URL personalizada por ti. En ese caso aún necesitas tu propio flujo de entrega de paquete desde el servidor.

ItemsAdder está instalado, pero su contenido falta en el paquete final

Esto suele significar que ItemsAdder sigue configurado de una forma que impide a ResourcePackManager leer o alojar su salida.

Usa:

/rspm itemsadder configure

Ese comando actualmente:

• activa resource-pack.hosting.no-host.enabled
• desactiva protection_1, protection_2 y protection_3
• ejecuta /iazip
• recarga ResourcePackManager poco después

Si el comando te indica que ItemsAdder ya está alojando su propio paquete, desactiva manualmente el alojamiento de ItemsAdder primero y vuelve a ejecutar el comando.

El paquete fusionado es inválido o no se sube

La integración de alojamiento automático de ResourcePackManager gestiona explícitamente estos tipos de errores del lado del servidor:

• archivos requeridos faltantes
• archivo demasiado grande
• formato de archivo no válido
• sesión faltante
• servidor remoto no disponible

Si te topas con uno de estos:

1. Ejecuta /rspm reload para reconstruir el paquete.
2. Comprueba si uno de los paquetes fuente está mal formado, cifrado o es ilegible por algún otro motivo.
3. Comprueba si el paquete final fusionado todavía contiene un pack.mcmeta y un pack.png válidos en la raíz.

El plugin omite los paquetes que no puede extraer correctamente y registra advertencias en consola cuando esto ocurre.

Los assets de un plugin están sobrescribiendo los de otro plugin

Esto se controla mediante priorityOrder en:

plugins/ResourcePackManager/config.yml

Las entradas superiores ganan sobre las inferiores.

Para archivos no fusionables, ResourcePackManager reemplaza el archivo de menor prioridad. Para archivos JSON fusionables, fusiona el contenido en su lugar. Las categorías JSON actualmente fusionables son:

• sounds.json
• archivos de idioma
• JSON de modelos de ítems vanilla en minecraft/models/item (con shield.json y crossbow.json explícitamente excluidos de la fusión recursiva entre paquetes — para esos dos gana la copia del paquete de mayor prioridad)
• archivos de atlas
• archivos de fuente
• definiciones de modelos de ítems 1.21.4+ en items/ (fusión consciente del formato que respeta la estructura del árbol de predicados)

pack.mcmeta también se fusiona de forma especial: gana el pack_format más alto, los rangos de supported_formats se amplían (se admiten las formas de entero, array de dos enteros y objeto {min_inclusive, max_inclusive}), las entradas de overlay se combinan y las claves de nivel superior no estándar se conservan. Las entradas de overlay se normalizan para compatibilidad con 1.21.9+ añadiendo los campos min_format/max_format cuando faltan. Las fuentes de atlas base también se fusionan en los archivos de atlas de overlay para evitar que los overlays oculten entradas base.

Si necesitas inspeccionar qué ocurrió durante la última fusión, consulta:

plugins/ResourcePackManager/collision_log.txt

El texto de GUI o elementos basados en fuentes se ven mal

Los archivos de fuente son una de las categorías JSON que ResourcePackManager fusiona, pero eso no garantiza que dos sistemas de fuentes distintos convivan bien en Minecraft.

Si un menú o HUD basado en fuentes se ve mal:

1. Cambia priorityOrder para que el paquete que deseas que gane tenga mayor prioridad.
2. Ejecuta /rspm reload.
3. Revisa collision_log.txt para confirmar que las colisiones ocurrieron donde esperabas.

Los cambios del paquete de recursos no aparecen de inmediato

ResourcePackManager tiene un watchdog para las fuentes de paquetes compatibles.

Espera hasta que un paquete modificado permanezca sin cambios durante 3 segundos, y entonces, una vez que todos los paquetes vigilados son estables, la nueva mezcla ocurre inmediatamente.

Si estás regenerando activamente el paquete de otro plugin, dale unos segundos después de que terminen las escrituras de archivos. En caso de duda, ejecuta /rspm reload después de que el plugin de origen haya terminado.

El alojamiento automático no puede contactar con el servidor remoto

El host integrado de ResourcePackManager se comunica con:

https://magmaguy.com/rsp/

Si esa conexión falla, el plugin registra advertencias de comunicación y no puede auto-alojar hasta que vuelva a conectar correctamente.

Tus opciones son:

1. arreglar la conectividad HTTPS saliente del servidor
2. esperar a que el servicio remoto vuelva a estar accesible
3. desactivar autoHost y autoalojar el zip generado

Quiero autoalojar el paquete fusionado

La configuración soportada por el código es:

1. Establecer autoHost: false.
2. Establecer resourcePackRerouting si quieres que ResourcePackManager escriba una copia adicional en una carpeta existente.
3. Alojar ResourcePackManager_RSP.zip tú mismo.

resourcePackRerouting se resuelve relativo al directorio plugins, y la carpeta de destino debe existir previamente.

Necesito inspeccionar qué datos remotos están almacenados para este servidor

Usa:

/rspm data_compliance_request

Si hay una sesión de alojamiento remoto activa, ResourcePackManager descarga la respuesta en:

plugins/ResourcePackManager/data_compliance

Si no hay sesión remota, el comando informa que no hay datos remotos que solicitar.

El paquete de Bedrock no se está generando

bedrockConversionEnabled por defecto es true, así que debería ejecutarse automáticamente. Si no aparece ningún paquete de Bedrock:

1. Comprueba que el paquete Java fusionado realmente contenga definiciones de ítems: al menos uno de assets/<namespace>/items/*.json (formato 1.21.4+), o modelos por huesos de FreeMinecraftModels. Si el paquete son solo sobrescrituras vanilla puras, el convertidor no tiene nada que emitir y lo omite silenciosamente.
2. Busca mensajes de consola que empiecen con [BedrockConverter], FMM Bedrock conversion o Generic pipeline: para detalles del error.
3. El paquete de Bedrock se sirve en vivo por sesión mediante la API de Geyser, por lo que no se requiere reinicio del servidor para ajustes de textura/modelo en ítems existentes — el siguiente jugador de Bedrock que se conecte recibe el paquete recién mezclado. Sí se requiere reinicio cuando cambia el CONJUNTO de ítems personalizados (se añaden nuevos o se eliminan los existentes), porque Geyser registra sus mappings de ítems personalizados al arrancar.

Si falla la autodetección de Geyser:

1. Establece bedrockGeyserFolder en config.yml a la ruta de tu carpeta de datos de Geyser (p. ej. Geyser-Spigot).
2. La ruta puede ser absoluta o relativa al directorio plugins.

El convertidor autodetecta Geyser en plugins/Geyser-Spigot/, cualquier variante plugins/Geyser-*/, o config/Geyser-*/ para configuraciones Fabric/NeoForge.

Los jugadores de Bedrock ven los ítems en mano en una posición incorrecta

Esto es un problema de ajuste, no un fallo de conversión. Abre plugins/ResourcePackManager/bedrock_display_offsets.yml y ajusta el eje pertinente. La primera persona y la tercera persona son independientes — ajustar una no afecta a la otra. El cliente de Bedrock recarga en vivo el JSON de attachable sin relanzar, así que iterar es rápido. Consulta la página de conversión a Bedrock para ver la lista completa de parámetros y lo que controla cada uno.

Las texturas de armadura personalizadas faltan en los jugadores de Bedrock

La armadura personalizada se renderiza en Bedrock combinando la geometría de armadura vanilla con la textura Java como capa visible. Para que esto funcione, el paquete del plugin de origen debe definir un archivo de equipamiento bajo assets/<namespace>/equipment/<material>.json junto a la definición del ítem. Si el log de conversión muestra el ítem pero no aparece textura de armadura en el juego, verifica que ese archivo existe en el paquete fusionado.