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