English
AssetSync automatically distributes server resource packs to players.** Add your resource pack ZIP files to the server, publish them with one command, and AssetSync downloads and enables them for players who are online and for players who join later.
Features
- Automatically checks for published packs when a player joins.
-
/assetsync apply publishes pack changes and starts syncing them to everyone currently online.-
/assetsync sync resends the published pack list to all online players.- Saves packs in the client's `resourcepacks` folder and enables them automatically.
- Shows a lower-left download HUD with completed-pack counts and byte-based progress; skips the HUD and resource reload when everything is already current.
-
/assetsync resync <player> resends the pack list to one player.Requirements
- Minecraft Java Edition 1.20.1
- Minecraft Forge 47.x
- AssetSync installed on both the server and each client.
Server setup
1. Install the AssetSync JAR in the server's `mods` folder and in each player's `mods` folder.
2. Start the server once. AssetSync creates `server/assetsync/upload/packs/` relative to the server working directory.
3. Put each resource pack in that `packs` folder as a `.zip` file. The ZIP must contain `pack.mcmeta` at its root:
text MyPack.zip ├── pack.mcmeta └── assets/ Do not put the pack inside an extra enclosing folder in the ZIP.
4. Run
/assetsync apply as an operator. This publishes the packs and starts syncing them to online players. Players who join later are synced automatically.5. To resend the published list without changing it, run `/assetsync sync` (all online players) or `/assetsync resync <player>` (one player).
### Commands
All
/assetsync` commands require operator-level permission.- /assetsync apply Scan the upload folder, publish a new revision, and sync online players.
- /assetsync sync Sync all online players with the currently published packs.
- /assetsync resync <player> Resend the published pack list to one player.
- /assetsync status Show the published revision and asset counts.
- /assetsync packs List published resource packs.
- /assetsync list List loose files found in the upload folder.
Notes
- Run
/assetsync apply after adding, replacing, or removing a pack. Changes are not published just by copying a ZIP.- Players need AssetSync installed and must connect to a server running a compatible AssetSync version.
- Only ZIP resource packs with a root-level `pack.mcmeta` are downloaded and enabled. Loose files are listed by the mod but are not currently transferred as resource packs.
- Players should only accept downloads from servers they trust.
---
Español
AssetSync distribuye automáticamente los paquetes de recursos del servidor a los jugadores.** Añade los ZIP al servidor, publícalos con un comando y AssetSync los descarga y activa tanto para quienes ya están conectados como para quienes entren después sin necesidad de subir los packs a servidores externos o reiniciar el servidor o cliente.
Características
- Comprueba automáticamente si hay packs publicados cuando entra un jugador.
-
/assetsync apply publica los cambios e inicia la sincronización para todos los jugadores conectados.-
/assetsync sync vuelve a enviar la lista de packs publicados a todos los jugadores conectados.- Descarga los packs por fragmentos, verifica sus hashes SHA-256 y evita volver a descargar un pack que ya coincide.
- Guarda los packs en la carpeta `resourcepacks` del cliente y los activa automáticamente.
- Muestra un HUD abajo a la izquierda con los packs completados y el progreso por bytes; no muestra el HUD ni recarga recursos cuando el cliente ya está al día.
-
/assetsync resync <jugador> vuelve a enviar la lista a un jugador.Requisitos
- Minecraft Java Edition 1.20.1
- Minecraft Forge 47.x
- AssetSync instalado tanto en el servidor como en el cliente de cada jugador.
Configuración del servidor
1. Instala el JAR de AssetSync en la carpeta `mods` del servidor y en la carpeta `mods` de cada jugador.
2. Inicia el servidor una vez. AssetSync crea `server/assetsync/upload/packs/` con respecto a la carpeta de trabajo del servidor.
3. Coloca cada paquete de recursos en esa carpeta como archivo `.zip`. El ZIP debe contener `pack.mcmeta` en su raíz:
text MiPack.zip ├── pack.mcmeta └── assets/ No incluyas una carpeta contenedora adicional dentro del ZIP.
4. Ejecuta
/assetsync apply como operador. El comando publica los packs e inicia la sincronización para quienes estén conectados. Los jugadores que entren más tarde también se sincronizan automáticamente.5. Para volver a enviar la lista publicada sin modificarla, ejecuta
/assetsync sync (todos los conectados) o /assetsync resync <jugador> (un jugador).Comandos
Todos los comandos
/assetsync requieren permisos de operador.- /assetsync apply Escanea la carpeta de subida, publica una revisión e inicia la sincronización para los jugadores conectados.
- /assetsync sync Sincroniza a todos los jugadores conectados con los packs publicados.
- /assetsync resync <jugador> Vuelve a enviar la lista de packs publicados a un jugador.
- /assetsync status Muestra la revisión publicada y el número de recursos.
- /assetsync packs Lista los paquetes de recursos publicados.
- /assetsync list Lista los archivos sueltos encontrados en la carpeta de subida.
Notas
- Ejecuta /assetsync apply después de añadir, reemplazar o eliminar un pack. Copiar un ZIP no lo publica automáticamente.
- Los jugadores necesitan tener AssetSync instalado y conectarse a un servidor con una versión compatible del mod.
- Solo se descargan y activan paquetes ZIP que tengan `pack.mcmeta` en la raíz. El mod puede listar archivos sueltos, pero actualmente no los transfiere como paquetes de recursos.
- Los jugadores solo deberían aceptar descargas de servidores de confianza.
AssetSync Team
