BBS Server Sync: BBS Asset Synchronization Mod 🚀

Synchronizing custom BBS content between server and players has become extremely simple!

BBS Extended Server Sync is a lightweight and powerful mod compatible with Fabric and Forge that allows server administrators to automatically distribute custom content (skins, models, sounds) to all connected players.

When a player joins your server, all required BBS assets are automatically downloaded to their client — no commands needed. All synchronization happens smoothly, ensuring that every participant sees the same content instantly.

Key Features ✨

Automatic Integration: After installation, the mod independently downloads and updates all server resources for joining players.

Custom Content Support: Fully synchronizes skins, models, and sound files with complete BBS compatibility.

Skin Management:

• /getskin name <playerName> — instantly synchronizes the selected player's Mojang skin with all participants
• /getskin url "https://www.example.com/skin.png" filename — downloads a skin from a URL and applies it across the entire server

Model Synchronization:

• All server models are automatically distributed upon connection
• If new models are added after players have already joined, they can reload them with the command /bbs model reload
• Players can upload new models using /bbs model upload, but requires server owner approval via /bbs model accept <playerName>
• Use /bbs model upload --force to overwrite or resend all models from scratch

Asynchronous Transfers: Skins and models are now processed through a fully asynchronous pipeline — this improves performance, reliability, and stability. Uploads are tracked and properly restored, even with large files.

How to Use 🛠️

1. Installation: Install the mod on both the server and all clients
2. Adding Files: Place your custom resources (skins, models, sounds) in the server's config/bbs/assets folder
3. Automatic Synchronization: When players connect, files are automatically synchronized with their config/bbs/assets directory
4. Commands:

• /bbs server_sync reload — re-synchronization of resources after changes
• /getskin <playerName> — fetching and synchronization of Mojang skin
• /getskinurl <skin_URL> filename — synchronization of skin from custom URL

Compatibility

Fully tested and stable on Minecraft 1.20.1

Minecraft 1.20.4 support is unverified — stability not guaranteed

For Forge the mod requires Sinytra Connector installation

Important Notes

This mod is an addon for Blockbuster Studio (BBS) and requires BBS to function

Developed and maintained by byd3n1z and bay4lly

If you encounter issues, don't hesitate to contact via Discord (byd3n1z). Feedback is always welcome — the asynchronous architecture was carefully developed to ensure smooth synchronization, but user reports help further improve it.