HunterMark

A complete bounty hunting experience for Paper 1.21.11+ featuring player-driven bounties, hunter tools, streak rewards, and four legendary swords with unique abilities.

Turn PvP into a true hunt. Place bounties on players, track targets, claim rewards, and rise through the hunter rankings to earn the coveted Top Hunter Aura.

Paper 1.21.11 • Java 21 Required

---

Features

Bounty System

• Create bounties using a GUI escrow system
• Automatic expiry and refunds
• Early cancellation with configurable fee
• Hunter streak bonuses up to +50% rewards
• Anti-abuse protections including cooldowns, minimum values, and world restrictions

Hunter Tools

• Hunter's Compass tracks your claimed target
• Wanted Poster broadcasts a target's approximate location
• Hunter's Trophy drops a collectible player head on bounty claims
• Wanted players emit particles
• Top bounty hunter receives a glowing aura and gold particles

Legendary Swords

Sword	Playstyle
Hunter's Verdict	Aggressive hunter blade with Sonic Boom and target marking
Moonwake	Lunar sword with stronger abilities at night
Bloodwake	Evolved Moonwake focused on bleed and area damage
Riftpiercer	Mobility-focused void blade with dashes, swaps, and prisons

Use /bounty swords in-game for complete ability information.

Quality of Life

• Cooldown management system
• Full command tab-completion
• Player-friendly help menus
• Configurable balancing options
• SQLite data storage with persistent stats

---

Installation

1. Place HunterMark.jar into your plugins folder
2. Start the server
3. Configure config.yml if desired
4. Run /bounty reload

Requires Paper 1.21.11+ and Java 21

---

Player Commands

Command	Description
/bounty <player>	Create a bounty
/bounty claim <player>	Track a target
/bounty cancel <player>	Cancel your bounty
/bounty compass	Get a tracking compass
/bounty streak	View streak progress
/bounty swords	View sword abilities
/bounty cooldowns	View ability cooldowns
/bounties	View active bounties

---

Admin Commands

Command	Description
/bounty reload	Reload configs
/bounty stats	View plugin statistics
/bounty multiplier	Adjust reward multipliers
/bounty items	Spawn custom items
/bounty cooldown	Modify ability cooldowns
/bounty cooldowns reset	Restore default cooldowns
/bounty setkills	Modify sword progression
/bounty fx	Test sword effects

---

Permissions

Permission	Description
huntermark.use	Use bounty system
huntermark.claim	Claim bounties
huntermark.cancel	Cancel bounties
huntermark.compass	Use hunter compass
huntermark.reload	Reload plugin
huntermark.admin	Administrative access

---

Storage

• SQLite (default)
• Persistent bounty, player, and hunter data
• MySQL support planned for a future release

---

Sword Abilities

Hunter's Verdict

• Sonic Boom — Piercing ranged attack
• Marked For Judgment — Mark targets for bonus damage
• Passive: Increases escape difficulty for marked targets

Moonwake

• Moon Shard — Crescent projectile attack
• Moon Veil — Protective moonlight shield
• Passive: Stronger during nighttime

Bloodwake

• Obtained by evolving Moonwake after 3 player kills
• Crimson Orbit — Orbiting damaging moons
• Blood Moon Pulse — Defensive shockwave
• Passive: Gains bonuses during Blood Moon events

Riftpiercer

• Rift Dash — High-speed void movement
• Dimensional Swap — Swap positions with enemies
• Rift Prison — Trap targets in a void arena
• Passive: Charge system that empowers abilities

---

Recipes

Crafting recipes are available in the Gallery tab.

---

Beta Notes

• All bounty and sword systems are fully functional
• SQLite is currently recommended
• WorldGuard integration is planned
• Balance values can be adjusted through configuration

Report bugs and feedback through Modrinth comments!