GoldenHead

GoldenHead is a standalone UHC and PvP consumable plugin that introduces customizable Golden Heads. Players can consume golden heads with custom eating times to gain absorption hearts, regeneration, speed, or other potion effects, with cooldown enforcement and placement cancellation.

Supported Platforms

• Minecraft Version: 1.16 through 1.21+
• Server Engines: Spigot, Paper, Purpur, Folia

Core Features

• Custom Potion Stacking: Configure duration and amplifier for any number of potion effects applied simultaneously upon consumption.
• Base64 Custom Textures: Automatically renders the golden head item with a custom player skin texture.
• Eating Delay & Cooldown Timer: Configurable consumption time (or instant eating) with real-time Adventure MiniMessage action-bar cooldown timers.
• Placement Protection: Prevents players from accidentally placing golden heads on the ground as decorative skull blocks during intense combat.

Commands and Permissions

Command	Purpose	Permission
/goldenhead give <player> [amount]	Give Golden Heads to a player	yowsefgoldenhead.admin
/goldenhead reload	Reload configuration and effect values	yowsefgoldenhead.admin

Aliases

• /ghead

Key Permissions

• yowsefgoldenhead.admin: Full access to give items and reload settings.

Configuration Reference

The configuration file is located at plugins/YowsefGoldenHead/config.yml:

# =====================================================
#             GoldenHead Configuration
# =====================================================

GOLDEN-HEAD:
  # Base64 texture for player skull
  TEXTURE: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvOGUzNGM1MGZkY2E4ZTM2YzFlMDUwYjk2M2YyZTZlMWY3MGU0NjVlNTVjNDQzZjY4OTQ3NDQzNDA5Y2M2YTMzOCJ9fX0="

  # Cooldown between uses in seconds
  COOLDOWN: 10

  # Eating duration in seconds (0 = Instant consume)
  CONSUME-TIME: 1.6

  # Action bar cooldown timer format
  ACTION-BAR-COOLDOWN-MSG: "<gold>[Cooldown] <yellow>%remaining%s"

  # Item display properties
  ITEM:
    NAME: "&e&lGolden Head"
    MATERIAL: PLAYER_HEAD
    LORE:
      - "&7Consume to receive combat"
      - "&7regeneration and absorption."

  # Applied potion effects (EFFECT::DURATION_SECONDS::AMPLIFIER)
  # Amplifier 1 = Level I, 2 = Level II
  EFFECTS:
    - "REGENERATION::5::2"
    - "ABSORPTION::120::1"
    - "SPEED::15::2"