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
- Instala AssetSync en
mods/del servidor Forge y enmods/de cada cliente. - Inicia una vez el servidor. AssetSync crea
server/assetsync/upload/, la subcarpetapacks/y su carpeta de caché. - 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
- Comprime el paquete como ZIP y asegúrate de que
pack.mcmetaestá en la raíz del ZIP, no dentro de una carpeta anidada. - Copia el ZIP directamente en
server/assetsync/upload/packs/. El nombre del archivo identifica el paquete; utiliza nombres únicos y estables. - 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. - 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 applyEscanea de nuevo, genera la revisión y comienza la sincronización actual.
/assetsync syncReenvía la revisión publicada a todos los jugadores conectados.
/assetsync statusMuestra revisión, cantidad de archivos y paquetes, y bytes publicados.
/assetsync packsLista paquetes publicados con identificador, nombre de archivo, versión leída del manifiesto y tamaño.
/assetsync listLista 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: 11880Puerto reservado para el transporte HTTP, entre 1024 y 65535. El transporte HTTP no está activo en esta versión.
maxPackSizeBytes: 268435456Tamaño máximo admitido por paquete ZIP: 256 MiB. El rango de configuración llega hasta 1 GiB.
maxTotalTransferBytes: 536870912Tamañ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: 33554432Lí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: trueEn 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
- Si
statusdice que no hay manifiesto, publica la primera revisión con/assetsync apply. - Si un ZIP aparece en
packspero no se activa, comprueba quepack.mcmetaesté en su raíz, que el archivo no esté dañado y que el paquete no supere los límites. - Si los recursos no cambian después de una edición, vuelve a publicar con
apply; para un jugador ya conectado, usaresync. - El cliente guarda los paquetes bajo
resourcepacks/; la caché de trabajo del servidor está bajoserver/assetsync/cache/.
Limitaciones conocidas
- La sincronización a clientes transmite paquetes ZIP encontrados directamente en
upload/packs/. Los archivos sueltos se registran en el manifiesto y se muestran con/assetsync list, pero no forman parte del paquete que el cliente descarga en esta versión. transportModeyhttpPortaparecen en la configuración, pero no hay transporte HTTP implementado; usa el modoCHANNEL.- Si un ZIP no tiene
pack.mcmetaen la raíz, el cliente lo rechaza aunque el servidor lo liste.