SnDevelopmentInstallation
- Download the latest
snrotatinheads-v*release from Sn-Releases. - Place the
.jarfile into your server'splugins/folder. - Start the server once. SnRotatinHeads creates a shared license file at
plugins/.Sn-License/license.yml. - Paste your Sn license key into that file, replacing the placeholder line.
- Restart the server. SnRotatinHeads validates the key at startup and then enables.
Requires SnLib installed (depend: [SnLib]), version 1.28.0 or later. SnRotatinHeads refuses to enable against an older engine, so update SnLib.jar at the same time.
SnRotatinHeads is licensed. The key in plugins/.Sn-License/license.yml is shared by every bundled Sn plugin on the server, so you paste it once. Without a valid key the plugin refuses to enable.
Dependencies
| Plugin | Required |
|---|---|
| SnLib | Yes |
| DecentHolograms | No (optional, enables the text labels above heads) |
| PlaceholderAPI | No (optional, enables placeholders in messages, labels and click actions) |
| ModelEngine | No (optional, enables meg:<model> animated heads; R4 or newer) |
| BetterModel | No (optional, enables bm:<model> animated heads; 2.2.0 or newer, and 3.x requires Java 25 on the server) |
When an optional plugin is absent, the matching feature degrades gracefully. Without DecentHolograms heads spin, bounce and click normally and simply show no label; without PlaceholderAPI placeholders stay as typed; without its engine an engine-model head stands hitbox-only and appears within a second of the engine having the model.
Requirements: Java 21+, Paper 1.20.x or 1.21.x
First boot
SnRotatinHeads generates config.yml and lang/messages_en.yml on first boot. New keys are auto-merged on later boots, and your values and comments are preserved. heads.yml appears after your first /rh create: it is data, written by the plugin after every change and never seeded, merged or regenerated, so you can edit it by hand and run /rh reload.
Updating SnLib.jar always needs a full restart, never a /reload.