✨ BossRewards ✨ A Advanced Reward System for Boss Fights using MythicMobs

What is BossRewards? BossRewards is a powerful plugin that transforms your server's boss battles into exciting competitive events! It seamlessly integrates with MythicMobs, tracking every player's contribution including projectile damage (arrows, tridents, etc.) and rewarding your most valiant warriors with customizable prizes featuring individual chance-based rewards and consolation prizes.

Features

• Comprehensive Damage Tracking: Track individual player damage to MythicMobs bosses including projectile damage
• Multi-Tier Reward System: Reward top 1-3 players with premium rewards, 4-5th place with special rewards, and 6+ with consolation prizes
• Individual Chance System: Each reward has its own configurable chance (0-100%)
• Automatic Broadcasting: Showcase top contributors with customizable defeat messages
• Offline Player Support: Queue rewards for players who are offline
• Flexible Reward Types: Items with ranges, commands, and chance-based distribution
• Multi-language Support: Full customization with HEX color formatting
• Real-time Statistics: View damage leaderboards and player rankings in-game

⚙️ Configuration
config.yml
settings:
# Minimum damage percentage required for rewards (0.0 - 1.0)
min-damage-percent: 0.05
# Broadcast boss defeat messages to whole server
broadcast-defeat: true
# Show damage notifications to players
show-damage-notifications: true
# Clear damage data after boss is defeated
clear-data-after-defeat: true
# Store offline rewards (in seconds, -1 for no expiration)
offline-data-retention: 86400

bosses:
# MythicMobs boss ID (must match exactly)
SkeletonKing:
display-name: "Skeleton King"
rewards:
# 1st place rewards (premium)
1:
- "DIAMOND 8-12" # 100% chance (no chance specified)
- "NETHERITE_INGOT 2-3 chance:80" # 80% chance
- "ELYTRA 1 chance:10" # 10% chance (very rare!)
- "cmd:broadcast &6&l %player% &6conquered &c%boss%!" # 100% chance
- "cmd:give %player% experience_bottle 25 chance:70" # 70% chance

# 2nd place rewards
2:
- "DIAMOND 5-8"
- "NETHERITE_INGOT 1-2 chance:60"
- "cmd:give %player% experience_bottle 20 chance:80"

# 3rd place rewards
3:
- "DIAMOND 3-6"
- "GOLDEN_APPLE 4-6 chance:90"
- "cmd:give %player% experience_bottle 15 chance:90"

# 4th-5th place special rewards
4-5:
- "DIAMOND 2-4 chance:80"
- "GOLDEN_APPLE 2-4 chance:70"
- "EMERALD 2-5 chance:90"
- "cmd:give %player% experience_bottle 10 chance:70"

# 6th+ place consolation rewards
consolation:
- "IRON_INGOT 8-12 chance:80"
- "GOLDEN_APPLE 1-2 chance:40"
- "EMERALD 1-3 chance:50"
- "COOKED_BEEF 10-15 chance:60"

Messages Configuration
All messages can be fully customized through messages.yml with support for both standard color codes and HEX colors.

prefix: "&6[BossRewards] &r"

general:
reload: "&aConfiguration reloaded successfully!"
no-permission: "&cYou don't have permission to use this command."
command-usage: "&eUsage: &f/bossrewards [reload|stats <bossId>|clear <bossId>]"
invalid-boss: "&cBoss &e%boss% &cnot found or has no damage data."
data-cleared: "&aDamage data for &e%boss% &ahas been cleared."

damage:
notification: "&7You dealt &e%damage% &7damage to &6%boss%&7."

boss-defeat:
header: "<#FFD700>════════════════════════════════"
title: "<#FF5555>⚔ &l%boss% &r<#FF5555>has been defeated! ⚔"
top-players: "<#55FF55> TOP DAMAGE DEALERS "
first-place: "<#FFD700> &lFirst: <#FFFFFF>%player% <#AAAAAA>(<#55FF55>%damage%<#AAAAAA> | <#55FFFF>%percentage%%<#AAAAAA>)"
second-place: "<#C0C0C0> &lSecond: <#FFFFFF>%player% <#AAAAAA>(<#55FF55>%damage%<#AAAAAA> | <#55FFFF>%percentage%%<#AAAAAA>)"
third-place: "<#CD7F32> &lThird: <#FFFFFF>%player% <#AAAAAA>(<#55FF55>%damage%<#AAAAAA> | <#55FFFF>%percentage%%<#AAAAAA>)"
your-rank: "<#FFFF55> Your Rank: <#FFFFFF>#%rank% <#AAAAAA>(<#55FF55>%damage%<#AAAAAA> | <#55FFFF>%percentage%%<#AAAAAA>)"
footer: "<#FFD700>════════════════════════════════"

rewards:
received: "<#55FF55> You received &e%reward_type% &arewards for position #%position%!"
no-reward: "<#FFAA00> You didn't receive &e%reward_type% &6rewards this time (position #%position%). Better luck next time!"
inventory-full: "<#FFFF55>⚠️ Some rewards were dropped on the ground because your inventory is full!"
offline-pending: "<#FFFF55> There are pending rewards for &e%player%&6. They will receive them upon login."

Commands
/bossrewards or /br - Show plugin help
/bossrewards reload - Reload configuration files
/bossrewards stats <id> - View damage statistics for a boss
/bossrewards clear <id> - Clear damage data for a boss

Advanced Reward System
Reward Categories:

• Position 1-3: Premium rewards for top performers
• Position 4-5: Special rewards for good performance
• Position 6+: Consolation prizes for participation

Item Rewards Format:
# Basic format (100% chance)
- "DIAMOND 5-10"

# With chance percentage
- "ELYTRA 1 chance:10" # 10% chance to receive

# Amount ranges supported
- "EMERALD 3-8 chance:75" # Random amount between 3-8, 75% chance

Command Rewards Format:
# Basic command (100% chance)
- "cmd:give %player% diamond 5"

# With chance percentage
- "cmd:broadcast &6%player% got lucky! chance:50" # 50% chance to execute

Available Placeholders:

• %player% – Player name
• %boss% – Boss display name
• %position% – Player ranking (1st, 2nd, etc.)
• %damage% – Raw damage dealt
• %percentage% – Percentage of total damage
• %reward_type% – Type of reward category (Top 1, Special, Consolation)

Adding New Bosses
bosses:
# Use exact MythicMobs boss ID
YourBossID:
display-name: "Epic Dragon"
rewards:
1:
- "NETHERITE_INGOT 3-5"
- "DRAGON_EGG 1 chance:5" # Very rare!
- "cmd:broadcast &d%player% slayed the dragon!"
2:
- "NETHERITE_INGOT 2-3 chance:90"
- "cmd:give %player% experience_bottle 30"
3:
- "DIAMOND 5-10"
- "cmd:give %player% experience_bottle 20"
4-5:
- "DIAMOND 3-6 chance:80"
- "GOLDEN_APPLE 2-4 chance:70"
consolation:
- "IRON_INGOT 5-10 chance:70"
- "COAL 10-20 chance:80"

Permissions

• bossrewards.use – Access to base commands (default: true)
• bossrewards.admin – Admin access for reload (default: op)
• bossrewards.stats – View damage statistics (default: true)
• bossrewards.clear – Clear damage data (default: op)

⚠️ Requirements & Notes

• MythicMobs Required: This plugin requires MythicMobs to function
• Boss IDs: Must match exactly with your MythicMobs configuration
• Materials: Item names must be valid Minecraft materials
• Projectile Support: Automatically tracks damage from arrows, tridents, and other projectiles
• Performance: Optimized for servers with multiple concurrent boss fights

How It Works

1. Damage Tracking: Every hit on a configured MythicMobs boss is tracked per player
2. Boss Defeat: When the boss dies, all participants are ranked by damage dealt
3. Reward Distribution: Players receive rewards based on their ranking and individual item chances
4. Offline Support: Players who are offline get their rewards queued for next login
5. Minimum Threshold: Only players who deal above the minimum damage percentage qualify

Advanced Features

• Chance-Based Rewards: Each item/command has individual success probability
• Range Amounts: Items can have random quantities (e.g., 5-10 diamonds)
• Consolation System: Even lower-ranked players get participation rewards
• HEX Color Support: Beautiful messages with modern color formatting
• Real-time Notifications: Players see damage numbers as they fight
• Statistics Tracking: View detailed leaderboards anytime

รายละเอียดภาษาไทย

BossRewards เป็นปลั๊กอินขั้นสูงที่ออกแบบมาเพื่อเพิ่มความน่าสนใจให้กับการต่อสู้บอสในเซิร์ฟเวอร์ Minecraft ของคุณ ทำงานร่วมกับ MythicMobs เพื่อติดตามความเสียหายอย่างแม่นยำ รวมถึงความเสียหายจากลูกธนูและอาวุธระยะไกล

คุณสมบัติใหม่:

• ระบบรางวัลหลายระดับ: อันดับ 1-3 ได้รางวัลพิเศษ, อันดับ 4-5 ได้รางวัลดี, อันดับ 6+ ได้รางวัลชมเชย
• โอกาสรางวัลแต่ละรายการ: ทุกไอเทมมีโอกาสได้รับแยกกัน (0-100%)
• รองรับ Projectile: นับดาเมจจากลูกธนู, ตรีศูล, และอาวุธระยะไกลอื่นๆ
• ระบบออฟไลน์: เก็บรางวัลไว้ให้ผู้เล่นที่ไม่ออนไลน์
• ข้อความสวยงาม: รองรับสี HEX และ emoji สำหรับประสบการณ์ที่ดีขึ้น

สนับสนุน & ข้อเสนอแนะ พบบัค? มีคำถาม? ต้องการคุณสมบัติเพิ่มเติม? แสดงความคิดเห็นด้านล่างและผมจะตอบกลับโดยเร็วที่สุด!