# Golden Head Plugin<\/p>\n
Professional UHC-style golden head plugin for Minecraft Paper servers.<\/p>\n
## What is a Golden Head?<\/p>\n
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.<\/p>\n
This plugin is fully compliant with the official MCTiers.com UHC tierlist rules and is suitable for competitive UHC gameplay.<\/p>\n
## Features<\/p>\n
### Crafting Recipe<\/p>\n
– Combine 8 gold ingots and 1 player head on a crafting table
\n– Produces 1 golden head item
\n– Recipe shows in recipe book for easy access<\/p>\n
### In-Game Effects<\/p>\n
When a player consumes a golden head by right-clicking it:<\/p>\n
– Regeneration effect (customizable duration and strength)
\n– Absorption effect (customizable duration and strength)
\n– Cooldown system to prevent spam (customizable duration)
\n– Feedback messages confirming consumption<\/p>\n
## Commands<\/p>\n
### Player Commands<\/p>\n
**`\/goldenheads reload`**<\/p>\n
– Reloads the plugin configuration without restarting
\n– Shows confirmation message to the user
\n– Updates all settings instantly
\n– Requires operator permission by default<\/p>\n
## Configuration<\/p>\n
The plugin is highly customizable through the `config.yml` file. Edit this file to adjust gameplay without modifying code.<\/p>\n
### Customizable Settings<\/p>\n
**Effects Section**<\/p>\n
– Regeneration duration in seconds
\n– Regeneration effect level (strength)
\n– Absorption duration in seconds
\n– Absorption effect level (strength)<\/p>\n
Example:
\n“`yaml
\neffects:
\n regeneration:
\n duration-seconds: 5
\n level: 3
\n absorption:
\n duration-seconds: 120
\n level: 2
\n“`<\/p>\n
**Gameplay Section**<\/p>\n
– Cooldown time between uses in seconds
\n– Controls how frequently players can consume golden heads<\/p>\n
Example:
\n“`yaml
\ngameplay:
\n cooldown-seconds: 10
\n“`<\/p>\n
**Item Section**<\/p>\n
– Custom display name with color support
\n– Description text (lore) shown in item tooltip
\n– Add multiple lore lines for detailed descriptions<\/p>\n
Example:
\n“`yaml
\nitem:
\n display-name: “Golden Head”
\n lore:
\n – “Right-click to use”
\n – “10 second cooldown”
\n“`<\/p>\n
**Messages Section**<\/p>\n
All player-facing text is customizable:<\/p>\n
– Consumption confirmation message
\n– Cooldown warning message (with remaining time display)
\n– Reload notification messages
\n– Permission denied messages<\/p>\n
Example:
\n“`yaml
\nmessages:
\n consumed: “You consumed a Golden Head!”
\n cooldown: “You need to wait {REMAINING}s more!”
\n reload_success: “Golden Head plugin reloaded!”
\n“`<\/p>\n
## Compliance<\/p>\n
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.<\/p>\n
## Server Requirements<\/p>\n
– Minecraft Paper 1.21 or compatible
\n– Java 21 or higher<\/p>\n","protected":false},"excerpt":{"rendered":"
Golden Heads plugin that complies with the mctiers.com UHC testing guidelines<\/p>\n","protected":false},"featured_media":77081,"template":"","meta":{"_minecraft_slug":"golden-head","_minecraft_project_id":"mzX25ere","_minecraft_author":"starifiedmc","_minecraft_license":"MIT","_minecraft_downloads":286,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"golden-head.zip","_minecraft_size_bytes":38033,"_minecraft_version_count":3,"_minecraft_updated_at":"2026-05-16T11:53:54.146427Z","_minecraft_date_created":"2025-12-05T04:06:32.570331Z","_minecraft_date_modified":"2025-12-02T00:31:52.315354Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/golden-head","_minecraft_icon_attachment_id":77081,"_minecraft_imported_at":"2026-06-04T10:58:56+00:00","_minecraft_import_hash":"7594e50cbf67e7bba0e451da4734e5ce","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,88,89,866,127],"mod_loader":[130,132],"minecraft_version":[62,37,40,73,74,38,78,79,80,81,82],"class_list":["post-77080","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-equipment","mod_category-game-mechanics","mod_category-minigame","mod_category-paper","mod_loader-bukkit","mod_loader-paper","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n