Decapitator
Decapitator is a lightweight PaperMC/Bukkit plugin that lets players obtain player heads with a single command. It supports persistent per-player limits, runtime config reloads, and automatic SkinsRestorer integration for offline-mode servers. If SkinsRestorer is not present, Decapitator falls back to server-side PlayerProfile handling.
One-liner
Give yourself your player head with /head (or someone else's head with /head <player> — persistent limits, SkinsRestorer support, and simple admin tools.
Features
- /head — get your own player head
- /head — get another player's head (permission-controlled)
- /head count [player] — view how many heads a player has requested
- /head reload — reload config and stored player data at runtime
- Per-player usage tracking persisted to
plugins/Decapitator/playercounts.yml - Unlimited mode via config (
max-heads-per-player: -1) [NOTE: This is the Default Option in config.yml] - Automatic runtime integration with SkinsRestorer if installed (optional)
- Safe fallback to server-side profile behavior when SkinsRestorer is absent
Commands
/head— Get your own head./head <player>— Get another player's head (permission:decapitator.head.others)./head count— Show how many heads you've requested./head count <player>— Show another player's count (permission:decapitator.count.others)./head reload— Reload config and playercounts from disk (permission:decapitator.reload)./head help— Show usage help.
Permissions (defaults)
decapitator.head— Use/head(default: true)decapitator.head.others— Get other players' heads (default: op)decapitator.count.others— View other players' counts (default: op)decapitator.reload— Reload config/data (default: op)
Adjust these via your permissions plugin (such as LuckPerms) as needed.
Configuration
Default config is bundled at src/main/resources/config.yml and copied to plugins/Decapitator/config.yml on first run.
Example config.yml:
# Decapitator configuration
enabled: true
# Maximum number of heads a player can order (per-player limit).
# Set to -1 for unlimited heads.
max-heads-per-player: -1
