MMDSkin-Bukkit

<p align="center"> <img src="https://github.com/opdent-cmd/MmdSkin-Bukkit/raw/main/icon.png" alt="MMDSync Icon"> </p> **MmdSkin-Bukkit** is the Bukkit/Spigot server-side implementation for the (https://modrinth.com/mod/mmdskin) mod. It handles the synchronization of MMD models, animations, physics states, and morphs between players on the server, allowing players with the mod installed to see each other's MMD avatars and movements in real-time. ## Features - **Model & Animation Sync**: Real-time synchronization of MMD model selection, animation playback, morphs, and physics states. - **Resource Sync Service**: Supports players uploading models and animation packs directly from the game. - **Cross-Version Support**: Compatible with plugins like ViaVersion, allowing players on different versions (e.g., 1.20.1 and 1.21.1) to see each other. - **Security & Encryption**: Real-time encryption ensures the security of server model resources during transmission and client-side storage. - **High Performance**: Built with the Bukkit API, supporting asynchronous chunked processing and GZIP compression with minimal impact on server performance. ## Client Requirements Depending on your needs, players may need to install the following mods: 1. **Basic Model Display (Required)**: - Requires (https://modrinth.com/mod/mmdskin). This is necessary to see other players' models. 2. **Convenient Sync Features (Optional)**: - Requires the (https://modrinth.com/mod/mmdskinsync) mod. - **Resource Upload**: Once installed, players can click the "Upload Model" button in the model selection interface to upload local models to the server via a system file dialog. - **Auto-Sync**: When joining the server, the mod automatically downloads missing models or animation files (incremental updates), removing the need for manual resource distribution. > - If (https://modrinth.com/mod/mmdskinsync) is not installed, players can still see others' models but won't be able to use in-game uploads or auto-sync (manual distribution of files would be required). > - Players without any of these mods can still join and play normally; they simply won't see the MMD models. ## Installation & Configuration 1. Download the latest version from (https://github.com/opdent-cmd/MmdSkin-Bukkit/releases). 2. Place it in your server's `plugins` folder and restart. 3. Configure the generated `config.yml`: - `sync.enabled`: Whether to enable the synchronization service. - `sync.enableGzip`: Whether to enable GZIP compression. - `security.serverSecret`: Server-side secret salt (automatically generated on first start, do not disclose). - `debug.enabled`: Debug mode switch for troubleshooting forwarding issues. ## Build ```bash ./gradlew build ``` ## License MIT License