rGoldenHeads

Golden Heads, Light Apples, enchanted apple crafting, head drops and head poles for UHC on Paper and Folia. Compatible with MCPvP and ShieldlessUHC. Fully configurable.

The healing kit that defines UHC and tiering PvP: an edible player head that trades an inventory slot for burst regeneration and absorption, cheap Light Apples, and the classic crafting recipes, all in one plugin. Every value is a config entry, so you can match your server's ruleset instead of the numbers someone else hardcoded.

One jar for Paper 1.21.4 – 26.3, Folia included.

What you get

All three are edible on a full hunger bar and restore no hunger or saturation.

Crafting

• Optional head drops: dying players drop their own skinned head, ready to craft. Every death, or PvP kills only.
• Head poles: or set the head on a nether brick fence where the player died, classic UHC style. Break it to collect the head.
• Switch off vanilla recipes: e.g. remove the 8-ingot golden apple so the Light Apple is the only way to craft one.
• Every recipe is yours to change: shape, ingredients, result, amount, shaped or shapeless, item tags, your own plugin items as ingredients, and an optional permission.
• Recipe book support: recipes are unlocked automatically and click-to-craft. Crafters work too.
• No exploits: a Golden Head is never mistaken for a golden carrot, and a Custom Golden Apple can't be turned into a Notch apple.
• Reload live: recipes are added, changed or removed with /rgoldenheads reload.

Fully configurable items

• Two head skins built in. modern is the default, and classic brings back the original look with one line (head-skin: classic). You can also add your own.

• Add your own items. Define as many as you like; each gets its own command and permission.

• Tune everything: name, lore, material, stack size, eating speed, cooldown, hunger values, effects.

• Readable effects. No amplifier off-by-one, no tick math:

  effects:
    - type: regeneration
      level: 3        # 1 = plain, 2 = II, 3 = III
      duration: 10    # seconds
  

• MiniMessage or & codes: write whichever you already use.

• A bad value never takes the server down: it's logged with the exact config path and skipped, so one broken item or recipe can't stop the rest.

Commands

All default to op. /rgoldenheads give works from the console, so kit and UHC plugins can hand items out. Grant rgoldenheads.give to allow every item for self-use, or rgoldenheads.admin for everything.

Requirements

• Paper 1.21.4 – 26.3 (or a fork such as Purpur), or Folia
• The Java version your server already needs: 21 for 1.21.x, 25 for 26.x
• No dependencies, nothing shaded. Drop the jar in plugins/ and start.

Every supported version is booted and checked automatically before each release. An optional update check asks Modrinth once per startup for a newer build matching your server version; turn it off with update-checker.enabled: false.

Upgrading? Your existing config keeps working and nothing changes until you copy the new player-heads, recipe-book and recipes sections from the default config.

Source, docs and issues: https://github.com/ZeroArsen/rGoldenHeads · GPL-3.0-only

This project is Vibe Coded.