SnDevelopmentCommands
The root command is /rotatinheads, with the aliases /rheads and /rh (edit command.aliases
in config.yml to change them, then /rh reload). Every command is an admin command; there are no
player commands. help, reload and debug are provided by SnLib.
Head ids are letters, digits, _ and -, up to 32 characters, and are stored in lower case. Ids
are case-insensitive when you type them.
Admin commands
| Command | Permission | Description |
|---|---|---|
/rh help [page] | snrotatinheads.admin | Generated help, filtered by your permissions |
/rh reload | snrotatinheads.admin.reload | Reload config.yml, the language file and heads.yml, then rebuild every head |
/rh debug | snrotatinheads.admin.debug | Toggle debug output in the console |
/rh create <id> [texture] | snrotatinheads.admin.create | Create a head at your position, facing the way you face |
/rh remove <id> | snrotatinheads.admin.remove | Remove a head (delete also works) |
/rh list | snrotatinheads.admin.list | List every head with its world and coordinates |
/rh info <id> | snrotatinheads.admin.info | Show the settings of a head and its line and action counts |
/rh movehere <id> | snrotatinheads.admin.movehere | Move a head to your position |
/rh tp <id> | snrotatinheads.admin.tp | Teleport yourself to a head (teleport also works) |
/rh texture <id> <texture> | snrotatinheads.admin.texture | Set the skin: a base64 textures value or a skin URL (visible while the head shows a skull) |
/rh model <id> <material[:model]/meg:<model>/bm:<model>/hand> | snrotatinheads.admin.model | Set what the head shows: an item, a ModelEngine or BetterModel model, or hand for the item in your main hand; player_head goes back to the skull |
/rh transform <id> <mode> | snrotatinheads.admin.transform | Item display context of an item model: ground (default), fixed, head, gui, none, thirdperson_righthand, ... |
/rh animation set <id> <name/none> | snrotatinheads.admin.animation | Looping animation an engine model (meg:/bm:) plays on the head; none stops it |
/rh animation add <id> <seconds> <name> | snrotatinheads.admin.animation | Play an animation once every so many seconds, on top of the looping one (minimum 1s) |
/rh animation remove <id> <index> | snrotatinheads.admin.animation | Remove the timed animation at that index (starting at 0) |
/rh animation list <id> | snrotatinheads.admin.animation | Show the looping animation and the timed ones with their index |
/rh animation clear <id> | snrotatinheads.admin.animation | Remove every timed animation; the looping one stays |
/rh size <id> <value> | snrotatinheads.admin.size | Scale of the head, minimum 0.05 |
/rh rotationspeed <id> <value> | snrotatinheads.admin.rotationspeed | Radians per animation frame; negative reverses, 0 stops |
/rh bouncespeed <id> <value> | snrotatinheads.admin.bouncespeed | Bounce speed multiplier; 0 stops the bounce |
/rh bounceheight <id> <value> | snrotatinheads.admin.bounceheight | Peak height of the bounce, in blocks |
/rh viewrange <id> <blocks> | snrotatinheads.admin.viewrange | How far the head renders, in blocks (approximate) |
/rh hologram list <id> | snrotatinheads.admin.hologram | Show the label lines with their index (starting at 0) |
/rh hologram add <id> <text> | snrotatinheads.admin.hologram | Append a label line (DecentHolograms text syntax) |
/rh hologram set <id> <line> <text> | snrotatinheads.admin.hologram | Replace the line at that index |
/rh hologram clear <id> | snrotatinheads.admin.hologram | Remove every label line and the label itself |
/rh hologram followbounce <id> <true/false> | snrotatinheads.admin.hologram | Make the label bob with the head |
/rh hologram offset <id> <blocks> | snrotatinheads.admin.hologram | How high above the head the label sits (negative sits it lower) |
/rh hologram spacing <id> <blocks> | snrotatinheads.admin.hologram | Distance between the label lines |
/rh action add <id> <left/right/any> <[tag]> [argument] | snrotatinheads.admin.action | Add a click action to one side or both |
/rh action remove <id> <left/right/any> <index> | snrotatinheads.admin.action | Remove the action at that index (starting at 0) |
/rh action clear <id> <left/right/any> | snrotatinheads.admin.action | Remove every action of that side |
/rh action list <id> <left/right/any> | snrotatinheads.admin.action | Show the actions of that side with their index |
Custom models
A head shows the textured player head unless you give it a model. A model is one token:
| Token | What the head shows |
|---|---|
paper:1001 | The item paper with custom-model-data 1001 (every server version) |
paper:mypack:crown | The item paper with the item_model component mypack:crown (1.21.2 or newer; older servers show the plain item) |
diamond_sword | The plain item |
player_head:7 | A player head with a model selector; the texture still applies |
player_head | Back to the textured player head |
hand | Whatever you hold in your main hand: its material and its item_model (1.21.2+) or custom-model-data |
hand is the easy way in: hold the ItemsAdder, Nexo or resource-pack item, run /rh model <id> hand,
done. The head keeps its texture, size, rotation, bounce, label and actions; only the item changes.
The texture is only visible while the head shows a player head, and /rh texture tells you so.
Most custom models are designed for one display context. ground is the default and is what a
skull reads best in; if a model looks small, offset or tilted, try /rh transform <id> fixed or
/rh transform <id> head. Every value of the vanilla item display context is accepted.
Engine models (ModelEngine, BetterModel)
An item model is a static shape. A Blockbench model with bones and animations (an NPC that breathes, waves, walks in place) needs a model engine, and the head can be one of its models:
| Token | What the head shows |
|---|---|
meg:wumpus_npc | The ModelEngine model wumpus_npc |
bm:wumpus_npc | The BetterModel model wumpus_npc |
The head keeps everything else: it spins and bounces (the engine model is moved and turned every
frame), it carries the label, and its own hitbox still answers clicks. size scales the model
(1 is its natural size), viewrange is its render distance, and the click hitbox grows with the
model's height. transform and texture do nothing for an engine model.
/rh animation set <id> <name> picks the animation the model plays on loop (idle by default,
from defaults.animation); /rh animation set <id> none stops it. The loop is forced by the
plugin, whatever loop mode the animation was authored with, because this is the animation that
plays all the time. Tab completion lists the models the installed engines have and the animations
of the models in use. A name the model does not have is ignored.
Animation sequences
A model with several animations does not have to pick one: /rh animation add <id> <seconds> <name> plays <name> ONCE every <seconds> on top of the looping animation, and the engine
falls back to the loop on its own when it ends. So "idle all the time, wave every 80 seconds" is:
/rh animation set npc idle
/rh animation add npc 80 waveAny number of timed animations per head, each with its own period (/rh animation list, remove <index>, clear manage them). The first play happens one full period after the head spawns, and
the countdown pauses while the head's chunk is unloaded. Whether the one-shot replaces or blends
with the loop on the bones they share follows the animation's own override flag in Blockbench.
The engine has to be installed and enabled, and the model loaded, when you run /rh model; the
command refuses otherwise and names the engine. Later, if the engine is still loading its models at
boot, reloads them, or restarts, the head waits hitbox-only and appears again within a second.
Click actions
An action is one line in the SnLib [tag] argument syntax. The most useful tags:
| Line | What happens on click |
|---|---|
[player] spawn | Runs /spawn as the clicking player |
[player-as-op] warp hub | Runs the command with a temporary op grant, restored afterwards |
[console] give {player} diamond | Runs the command from the console |
[message] &aWelcome, {player}! | Sends a message to the clicker |
[broadcastmessage] {player} found the secret head | Sends a message to everyone |
[sound] entity.experience_orb.pickup 1 1.2 | Plays a sound to the clicker (volume and pitch optional) |
[actionbar] &eClick! and [title] Hi;there;10;40;10 | Action bar and title |
[right-click] [message] Only on right click | Guards: [left-click], [right-click], [chance=50] and the rest of the SnLib catalogue |
{player} and %player% are the clicking player. PlaceholderAPI placeholders resolve against them.
Actions run one tick after the click, so a command that opens a menu opens it. Every line must start
with a [tag]; a plain command without a tag is rejected.
any adds the same line to both sides, removes the index from each side, or lists the left block
then the right block.