Huntermark

# 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!