← Todas las guías

02 / Recursos

AssetSync

Java 1.20.1 · Forge

AssetSync publica paquetes ZIP de recursos desde el servidor y los descarga a los clientes conectados sin reiniciar el servidor ni desconectar al cliente. Requiere Minecraft Java 1.20.1, Java 17, Forge 47.x y la misma versión del mod en el servidor y en cada cliente. Sin el mod en el cliente no se puede recibir ni activar el paquete.

Instalación

  1. Instala AssetSync en mods/ del servidor Forge y en mods/ de cada cliente.
  2. Inicia una vez el servidor. AssetSync crea server/assetsync/upload/, la subcarpeta packs/ y su carpeta de caché.
  3. Conecta un cliente con AssetSync instalado para comprobar que ambos usan la misma versión del protocolo y del mod.

Preparar y publicar un paquete

  1. Comprime el paquete como ZIP y asegúrate de que pack.mcmeta está en la raíz del ZIP, no dentro de una carpeta anidada.
  2. Copia el ZIP directamente en server/assetsync/upload/packs/. El nombre del archivo identifica el paquete; utiliza nombres únicos y estables.
  3. Desde la consola o como OP nivel 4, ejecuta /assetsync apply. El comando escanea la carpeta, calcula hashes SHA-256, aumenta la revisión del manifiesto y empieza a enviar la lista a todos los jugadores conectados.
  4. Los clientes descargan solo los paquetes ausentes o modificados, verifican su hash y los guardan como resourcepacks/AssetSync-<id>.zip. Después se seleccionan y activan automáticamente.

Cuando modifiques o retires un ZIP, vuelve a ejecutar /assetsync apply. La salida informa cuántos paquetes y archivos se añadieron, cambiaron o desaparecieron y cuál es la revisión publicada. Los jugadores que se conecten más tarde reciben esa revisión al entrar.

Comandos de administración

Todos los comandos /assetsync requieren OP nivel 4. apply crea y transmite una revisión; sync vuelve a enviar a los conectados el manifiesto ya publicado, sin volver a escanear el disco.

/assetsync apply

Escanea de nuevo, genera la revisión y comienza la sincronización actual.

/assetsync sync

Reenvía la revisión publicada a todos los jugadores conectados.

/assetsync status

Muestra revisión, cantidad de archivos y paquetes, y bytes publicados.

/assetsync packs

Lista paquetes publicados con identificador, nombre de archivo, versión leída del manifiesto y tamaño.

/assetsync list

Lista los archivos sueltos que aparecen registrados en el manifiesto y su tamaño.

/assetsync resync <jugador>

Reenvía el manifiesto a un jugador conectado concreto.

Configuración

Forge crea archivos de configuración comunes y de cliente dentro de config/. Los límites son bytes; las equivalencias aproximadas se muestran entre paréntesis.

transportMode: "CHANNEL"

El transporte implementado actualmente es el canal de red de Forge. Mantén este valor; la alternativa HTTP aún no está conectada al flujo de descarga.

httpPort: 11880

Puerto reservado para el transporte HTTP, entre 1024 y 65535. El transporte HTTP no está activo en esta versión.

maxPackSizeBytes: 268435456

Tamaño máximo admitido por paquete ZIP: 256 MiB. El rango de configuración llega hasta 1 GiB.

maxTotalTransferBytes: 536870912

Tamaño total máximo de paquetes por sincronización: 512 MiB. Si el manifiesto supera el límite, el cliente no comienza esa sincronización.

maxFileSizeBytes: 33554432

Límite declarado para un archivo suelto: 32 MiB. La distribución actual de clientes procesa paquetes ZIP; este valor no convierte archivos sueltos en archivos descargables.

enableDownloadHud: true

En el cliente, muestra u oculta el HUD de progreso. Cambiarlo no cancela ni desactiva la descarga.

Qué ve el jugador

Durante la primera descarga se muestra el progreso por bytes y paquetes completados en la parte inferior izquierda. Las partes se transfieren en bloques de hasta 512 KiB. Al terminar, AssetSync valida el SHA-256 y que el ZIP tenga un pack.mcmeta en la raíz. Los paquetes ya idénticos no se vuelven a descargar ni fuerzan una recarga de recursos. La selección de paquetes ajenos a AssetSync se conserva.

Resolución de problemas

Limitaciones conocidas