🏹Bounty System – Wanted System for Hytale

A full-featured bounty system for Hytale servers with a modern UI bounty board, optional economy and ecotale + item rewards, automatic bounties from killstreaks, and HyperFactions integration to prevent abuse (same-faction/allies/recent-faction-leave rules).

Join our discord for support/suggestions or complaints:

https://discord.gg/f3WsEF6UNE

Permissions:
bounty.use (to use the bounty ui)
bounty.admin (running admin commands)

✨ Core Features

🧾 Bounty Board UI

Players can open a modern bounty board with:

         👥 Online player list

         🔎 Search bar to quickly find a player

        💰 Preset bounty buttons (like +1000 / +5000 / +10000)

        ✍️ Custom amount field for any value you allow

🎯 Place Bounties on Players

Players can put a bounty on someone to make them a target:

           ✅ The target becomes WANTED

           ✅ The bounty amount is shown in the UI next to their name

           ✅ Bounties can optionally expire after a set time

           ✅ Multiple Reward Types

💸 Economy Payout (Optional)

If enabled, when someone claims a bounty they receive:

💰 Money payout equal to the bounty total

Supports

 TheEconomy

EcoTale

🎁 Item Rewards (Optional)

If enabled, bounty claims can also grant:

🎲 Random item rewards from your configured item list

Great for adding extra excitement or rare loot rewards.

🔥 Automatic “Wanted” System (Optional)

If enabled, the plugin can automatically place bounties:

⚔️ Players who reach a configured kill requirement become “Wanted”

🎲 The bounty amount is randomly picked from your configured bounty amount list

⏳ These can also expire (if expiry is enabled)

This creates natural PvP hotspots without admins needing to do anything.

🛡️ HyperFactions Support (Optional)

If HyperFactions is installed and enabled in config, the plugin can enforce faction-safe bounty rules:

🚫 No bounty abuse inside factions

❌ Players can’t place bounties on their own faction members

❌ Players can’t claim bounties from their own faction members

🤝 Ally protection

❌ Players can’t place bounties on allied factions

❌ Players can’t claim bounties from allied factions

🕒 Cooldowns for faction exploits (Optional)

Stops common abuse like “leave faction → place bounty → rejoin”:

The plugin can block bounty actions for a configurable period after faction changes.

🎮 Player Commands

/bounty

✅ Opens the Bounty Board UI (main player menu)
🔒 Requires: bounty.use

🛠️ Admin Commands (console)

/bounty adminset <player> <amount> (in game) 

/bountyadminset <player> 1000 (console)

✅ Adds a bounty without charging money
👤 Target must be online

✅ Admin panel in /bounty UI
🔒 Requires: bounty.admin

Example: /bounty adminset Steve 10000

/bounty reload

✅ Reloads the plugin config (no reboot needed)
🔒 Requires: bounty.admin

⚙️ Config Options (What each one does)

• Enableautobounties: true/false — If true, the mod can automatically place bounties when someone hits the kill threshold.
• killsRequired: Number — How many kills a player must get (without already having a bounty) before an auto bounty is placed on them.
• defaultBountyExpiryHours: Number — How long bounties last before expiring (in hours).
  
  • 0 (or <=0) usually means no expiry (bounties stay until claimed/cleared).

Manual Bounties (Player placed)

• minManualBountyAmount: Number — Minimum amount a player is allowed to set when placing a bounty manually.
• manualBountyCooldownSeconds: Number — Cooldown (in seconds) before the same player can place another bounty on the same target again.
  
  • 0 disables the cooldown.

Economy

• economyRewardsEnabled: true/false — If true, bounty payouts use the economy system.
• economyAmounts: List of numbers — Preset bounty amounts shown in the UI buttons.
  
  • Example: [100, 250, 500, 1000]
• EconomyProvider: theeconomy, ecotale, none

Item Rewards (Optional extras on claim)

• itemRewardsEnabled: true/false — If true, the killer also gets an item reward when claiming a bounty.
• rewardItems: List of item strings — Possible items rewarded. One is picked randomly on claim.
  
  • Format depends on your server’s give command (example: diamond_sword, gold_ingot 16, etc.)

HyperFactions Rules (Anti-abuse / faction logic)

• useHyperFactionsRules: true/false — Enables faction restrictions (requires HyperFactions installed).
• factionLeaveCooldownHours: Number — Blocks bounty placement/claiming involving someone who recently left a faction for X hours (prevents leave-to-farm abuse).
  
  • 0 disables this protection.
• allyCooldownHours: Number — If two factions were recently allied, bounty actions between them can be blocked for X hours (prevents ally-toggle exploits).
  
  • 0 disables this protection.