MMDSkin-Bukkit

MmdSkin-Bukkit is the Bukkit/Spigot server-side implementation for the 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 MmdSkin. This is necessary to see other players' models.
2. Convenient Sync Features (Optional):
   • Requires the MMDSync 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 MMDSync 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 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

./gradlew build

License

MIT License