Перейти к содержимому
Mineforgian

Decapitator

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

Загрузки
5
Подписчики
0
Обновлён
7 июня 2026 г.
Лицензия
MIT

Опубликован 7 июня 2026 г.

Исходный кодСообщить об ошибке

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

Ченджлог

1.1Релиз26.1.2 · 7 июня 2026 г.

[1.1.0] - 2026-06-07

Added

  • Per-player persistent usage limits for /head (stored in plugins/Decapitator/playercounts.yml).
  • Config support:
    • enabled to toggle plugin behaviour.
    • max-heads-per-player to set per-player limit (use -1 for unlimited).
  • /head count [player] to view how many heads a player has ordered.
  • /head reload to reload the plugin config and player data at runtime.
  • Automatic creation and management of playercounts.yml in the plugin data folder.
  • Integration with SkinsRestorer:
    • If SkinsRestorer is installed and enabled, Decapitator will request skin data from SkinsRestorer and apply textures so heads show proper skins on offline-mode servers.
    • Reflection-based integration so SkinsRestorer is optional at runtime (no compile-time dependency).
  • README and documented permissions.

Changed

  • Command behaviour extended to include subcommands (count, reload, help) while preserving the original /head [player] functionality.
  • Messages enhanced to show current count and max (shows "∞" when unlimited).

Fixed

  • Ensure head-giving never crashes if SkinsRestorer integration fails — falls back to server-side PlayerProfile behaviour.

Notes

  • New permissions added: decapitator.count.others, decapitator.reload. See README for full list.
  • Data file format: YAML mapping of UUID -> integer (e.g., "uuid-string": 3).

Комментарии

Загружаем…