BBS Server Sync Addon

# **BBS Server Sync: BBS Asset Synchronization Mod 🚀** Distributing custom BBS content to players has never been easier! **BBS Extended Server Sync** is a lightweight and powerful Fabric/Forge-compatible mod that allows server administrators to automatically synchronize their custom content (**skins, models, sounds**) with all players. When a player joins your server, **all the required BBS assets are automatically downloaded to their client — no commands needed.** Everything is synced seamlessly, ensuring that everyone sees the same content instantly. --- ## **Key Features ✨** * **Automatic Integration**: Once installed, the mod automatically downloads and updates all server assets for joining players. * **Custom Content Support**: Synchronizes **skins, models, and sound files** with full BBS compatibility. * **Skin Management**: * `/getskin name <playerName>` – Instantly syncs the selected player’s Mojang skin with everyone. * `/getskin url "https://www.example.com/skin.png" filename` – Downloads a skin from a URL and applies it server-wide. * **Model Synchronization**: * **All server models are distributed automatically upon join.** * If new models are added after players have joined, they can reload them with `/bbs model reload`. * Players can upload new models with `/bbs model upload`, requiring 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 handled through a fully **asynchronous pipeline** — improving performance, reliability, and stability. Uploads are tracked and recover gracefully, 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 assets (skins, models, sounds) in the `config/bbs/assets` folder of the server. 3. **Automatic Sync**: When players join, the files are automatically synced to their `config/bbs/assets` directory. 4. **Commands**: * `/bbs model reload` – Re-sync assets after changes. * `/getskin <playerName>` – Fetch and sync a Mojang skin. * `/getskin url <skin_url> filename` – Sync a skin from a custom URL. --- ## **Compatibility** * **Fully tested and stable on Minecraft 1.20.1.** * *Minecraft 1.20.4 support is unverified* — stability cannot be guaranteed. * For **Forge**, the mod requires (https://modrinth.com/mod/sinytra-connector). --- ## **Notes** * This mod is an **addon for Blockbuster Studio (BBS)** and requires BBS to work. * Developed and maintained by **byd3n1z** and **bay4lly**. * If you encounter issues, please don’t hesitate to reach out via **Discord (byd3n1z)**. Feedback is always welcome — the asynchronous architecture was carefully developed to ensure smooth syncing, but user reports help polish it further.