Golden Head Plugin

Professional UHC-style golden head plugin for Minecraft Paper servers.

What is a Golden Head?

The Golden Head plugin adds craftable healing items to your Minecraft server. Players can combine gold ingots with a player head to create a golden head item. When consumed, it provides instant healing and protection effects during combat.

This plugin is fully compliant with the official MCTiers.com UHC tierlist rules and is suitable for competitive UHC gameplay.

Features

Crafting Recipe

• Combine 8 gold ingots and 1 player head on a crafting table
• Produces 1 golden head item
• Recipe shows in recipe book for easy access

In-Game Effects

When a player consumes a golden head by right-clicking it:

• Regeneration effect (customizable duration and strength)
• Absorption effect (customizable duration and strength)
• Cooldown system to prevent spam (customizable duration)
• Feedback messages confirming consumption

Commands

Player Commands

/goldenheads reload

• Reloads the plugin configuration without restarting
• Shows confirmation message to the user
• Updates all settings instantly
• Requires operator permission by default

Configuration

The plugin is highly customizable through the config.yml file. Edit this file to adjust gameplay without modifying code.

Customizable Settings

Effects Section

• Regeneration duration in seconds
• Regeneration effect level (strength)
• Absorption duration in seconds
• Absorption effect level (strength)

Example:

effects:
  regeneration:
    duration-seconds: 5
    level: 3
  absorption:
    duration-seconds: 120
    level: 2

Gameplay Section

• Cooldown time between uses in seconds
• Controls how frequently players can consume golden heads

Example:

gameplay:
  cooldown-seconds: 10

Item Section

• Custom display name with color support
• Description text (lore) shown in item tooltip
• Add multiple lore lines for detailed descriptions

Example:

item:
  display-name: "Golden Head"
  lore:
    - "Right-click to use"
    - "10 second cooldown"

Messages Section

All player-facing text is customizable:

• Consumption confirmation message
• Cooldown warning message (with remaining time display)
• Reload notification messages
• Permission denied messages

Example:

messages:
  consumed: "You consumed a Golden Head!"
  cooldown: "You need to wait {REMAINING}s more!"
  reload_success: "Golden Head plugin reloaded!"

Compliance

This plugin meets the official MCTiers.com UHC tierlist requirements for golden head mechanics. It implements industry-standard UHC gameplay rules and is suitable for competitive tournaments and survival events.

Server Requirements

• Minecraft Paper 1.21 or compatible
• Java 21 or higher