?
Host a server
Modrinth App
Sign in
ModsPluginsData PacksShadersResource PacksModpacksServers
Settings
Decapitator

Decapitator

A PaperMC plugin that allows players to get their player head a certain number of times by running /head

4
0
4
0

Compatibility

Minecraft: Java Edition

26.1.2

Platforms

Links

Report issues View source

Tags

Creators

Details

Licensed MIT
Published 2 days ago

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 <player> — 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