rGoldenHeads

Golden Heads, Light Apples and UHC-style crafting for modern Paper, compatible with MCPvP and ShieldlessUHC. Every item and recipe is 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

Command	Item	Effects	Eats in	Cooldown
/goldenhead	Golden Head	Regeneration III (5s), Absorption I (2min)	1.0s	10s
/instantgoldenhead	Instant Golden Head	Regeneration III (10s), Absorption II (2min), Speed I (5s)	instantly	12s
/goldenapple	Custom Golden Apple	Regeneration II (10s), Absorption I (2min)	1.6s	none

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

Crafting

Recipe	Makes
Player head surrounded by 8 gold ingots	Golden Head (or the Instant one, your choice)
Apple with 4 gold ingots in a plus	Light Apple: a normal golden apple for half the gold
Golden apple surrounded by 8 gold blocks	the vanilla Enchanted Golden Apple

• Optional head drops: dying players drop their own skinned head, ready to craft. Every death, or PvP kills only.
• 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, 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

Command	Permission
/goldenhead	rgoldenheads.give.goldenhead
/instantgoldenhead, /instanthead	rgoldenheads.give.instantgoldenhead
/goldenapple, /customgapple	rgoldenheads.give.goldenapple
/rgoldenheads give <player|*> <item> [amount]	rgoldenheads.admin.give
/rgoldenheads reload, /rgh	rgoldenheads.admin.reload

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.