HeadBound is an addon for CuriosPaper that adds a set of unique, configurable head accessories to the Curios-style head slot.
Each item grants a small, focused passive ability that fits naturally into vanilla gameplay: better mining, safer exploring, utility vision, and more.

Requires: Paper 1.21+ and CuriosPaper (hard dependency)
Link: https://www.spigotmc.org/resources/curiospaper.130346/


Features

• ⚔ 11+ custom head accessories, each with its own effect
• Passive, conditional bonuses (Y-level checks, structure loot, mob drops, etc.)
• ⚙ Fully configurable enable/disable for each item
• Multiple acquisition paths:
  • Mob drops (Endermen, Drowned, Strays)
  • Structure loot (mineshafts, temples, ruins, fortresses)
  • Villager trades (wandering traders, master librarians)
• Simple config values for:
  • Ranges, durations, multipliers, chances
  • Drop/loot/trade probabilities (0.0–1.0)
  • Global debug & cosmetic toggles (particles, sounds)
• ✅ Built cleanly on CuriosPaper’s head slot, no custom commands required

Included Head Items (Default)

Each of these is a head accessory meant for the CuriosPaper head slot:

• Scout’s Lens
  • Reveals nearby mobs with a glowing outline.
  • Configurable range, duration, interval.
  • 
• Miner’s Charmband
  • Grants Night Vision below a configurable Y-level.
  • Perfect for caving without torches.
  • 
• Third Eye Circlet
  • Enhanced vision and glow detection.
  • Separate radius/duration tuning.
  • 
• Drowned Crown Shard
  • Swim speed boost; reduced drowning damage.
  • 
• Blazing Mask
  • Reduces fire damage taken.
  • 
• Serpent Hood
  • Applies configurable poison to enemies.
  • 
• Wanderer’s Hood
  • Wandering traders stay longer.
  • 
• Stormcaller Cap
  • Increases loyalty trident return speed.
• Frostbound Circlet
  • Reduces powdered snow freeze buildup.
  • 
• Ghastbone Mask
  • Reduces explosion knockback.
• Scholar’s Laurel
  • Grants bonus XP.
  • 

How to Obtain the Items

All drop/loot/trade chances are configurable.

Mob Drops

• Third Eye Circlet – Endermen
• Drowned Crown Shard – Drowned
• Frostbound Circlet – Strays

Each controlled under ` drops:` in `config.yml`.

Structure Loot

• Miner’s Charmband – Mineshafts
• Serpent Hood – Jungle temples
• Stormcaller Cap – Ocean ruins
• Ghastbone Mask – Nether fortresses

Villager Trades

• Wanderer’s Hood
  • Sold by wandering traders
  • Emerald cost + chance configurable
• Scholar’s Laurel
  • Sold by master librarians
  • Emerald cost + chance configurable

Configuration

The plugin ships with a configurable `config.yml`.

Per-item enable/disable
items:
scouts-lens:
enabled: true
miners-charmband:
enabled: true

Mob drops & structure loot
drops:
third-eye-circlet:
mob: ENDERMAN
chance: 0.05

loot:
miners-charmband:
structure: MINESHAFT
chance: 0.15

Villager trades
trades:
wanderer-hood:
villager-type: WANDERING_TRADER
emerald-cost: 1
chance: 0.30

General settings

• debug-mode
• particle-effects
• sound-effects

Commands & Permissions

Commands:

• `/headbound` (`/hb`)
  • `/headbound reload` – reload config
  • `/headbound list` – list items

Permission:

• `headbound.admin` – access admin commands (default: OP)

Requirements

• Server: Paper 1.21+ (api-version: 1.21)
• Dependency: CuriosPaper
• Side: Server-side only (players auto-receive resource pack if used)