✨ BossRewards ✨
A 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 and rewarding your most valiant warriors with customizable prizes.
Features
- Track individual player damage to MythicMobs bosses
- Automatically reward the top 1-3 players when a boss is defeated
- Broadcast defeat messages showcasing your top contributors
- Queue rewards for players who are offline
- Fully customizable loot tables and command rewards
- Multi-language support with HEX color formatting
- In-game statistics to view damage leaderboards
⚙️ Configuration
config.yml
Code (YAML):
settings
:
# Minimum damage percentage required for rewards
min-damage-percent
: 0.05
# Broadcast boss defeat messages
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)
offline-data-retention
: 86400
bosses
:
# MythicMobs boss ID
SkeletonKing
:
# Display name
display-name
:
"Skeleton King"
rewards
:
# First place rewards
1
:
# Format: ITEM_ID AMOUNT CHANCE
-
"DIAMOND 5-10 1.0"
-
"NETHERITE_INGOT 1-2 0.8"
# Command reward
-
"cmd:broadcast &6%player% defeated %boss%!"
# Second place rewards
2
:
-
"DIAMOND 3-5 1.0"
-
"GOLDEN_APPLE 2-3 1.0"
# Third place rewards
3
:
-
"IRON_INGOT 5-10 1.0"
-
"EXPERIENCE_BOTTLE 15-20 1.0"
Messages Configuration
All messages in the plugin can be fully customized through the messages.yml file. You can use both standard color codes (&6, &a, etc.) and HEX colors formats (&#RRGGBB or <#RRGGBB>).
messages.yml
Code (YAML):
prefix
:
"&6[BossRewards] &r"
# General messages
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
damage:
notification
:
"&7You dealt &e%damage% &7damage to &6%boss%&7."
# Boss defeat messages with HEX colors
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>======================="
# Stats display
stats:
header
:
"<#FFD700>======================="
title
:
"<#FFAA00>Damage Stats for &l%boss%"
total-damage
:
"<#FFFF55>Total Damage: <#55FF55>%damage%"
top-title
:
"<#FFFF55>Top Damage Dealers:"
player-format
:
"<#AAAAAA>%position%. <#FFFFFF>%player% <#AAAAAA>- <#55FF55>%damage% <#AAAAAA>(<#55FFFF>%percentage%%<#AAAAAA>)"
footer
:
"<#FFD700>======================="
# Reward messages
rewards:
received
:
"<#55FF55>You received rewards for your position #%position%!"
inventory-full
:
"<#FFFF55>Some rewards were dropped on the ground because your inventory is full."
offline-pending
:
"<#FFFF55>There are pending rewards for %player%. They will receive them upon login."
Commands
Code (Text):
/bossrewards or /br - Show plugin help
/bossrewards reload - Reload configuration
/bossrewards stats <id> - View damage stats for a boss
/bossrewards clear <id> - Clear damage data for a boss
Reward System
Item Rewards:
Format: `[MATERIAL] [AMOUNT] [CHANCE]`
Example: `DIAMOND 5-10 1.0`
Command Rewards:
Format: `cmd:[command]`
Example: `cmd:give %player% diamond 5`
Placeholders:
- %player% – Player name
- %boss% – Boss display name
- %position% – Ranking (1st–3rd)
- %damage% – Raw damage dealt
- %percentage% – Percent of total damage
Adding New Bosses
To add a new boss, simply define it in your `config.yml`:
Code (YAML):
bosses
:
# MythicMobs boss ID
NewBossID
:
# Display name shown in messages
display-name
:
"New Boss"
rewards
:
# First place rewards
1
:
-
"NETHERITE_INGOT 1 1.0"
-
"cmd:broadcast &6%player% defeated %boss%!"
# Second place rewards
2
:
-
"DIAMOND 5 1.0"
# Third place rewards
3
:
-
"GOLD_INGOT 10 1.0"
Permissions
-
bossrewards.use – Access to base commands (default: true)
-
bossrewards.admin – Admin access (default: op)
-
bossrewards.stats – View damage stats (default: true)
-
bossrewards.clear – Clear damage data (default: op)
⚠️ Important Note
This plugin requires
MythicMobs to function. Boss IDs must match the IDs used in MythicMobs. Item names must be valid Minecraft materials.
รายละเอียดภาษาไทย
BossRewards คือปลั๊กอินที่ออกแบบมาสำหรับเซิร์ฟเวอร์ Minecraft ที่ทำงานร่วมกับ
MythicMobs เพื่อติดตามความเสียหายที่ผู้เล่นทำต่อบอส และให้รางวัลแก่ผู้ที่ทำความเสียหายสูงสุด ทำให้การต่อสู้กับบอสของคุณน่าสนใจ แข่งขันกันได้ และมีรางวัลที่คุ้มค่ามากขึ้น!
คุณสมบัติเด่น:
- ติดตามความเสียหายของผู้เล่นแต่ละคนที่ทำต่อบอส MythicMobs อย่างแม่นยำ
- ให้รางวัลโดยอัตโนมัติแก่ผู้เล่น 1-3 อันดับแรกเมื่อบอสถูกเอาชนะ
- ประกาศข้อความเมื่อเอาชนะบอสและผู้ที่ทำความเสียหายสูงสุด
- เก็บรางวัลไว้ให้ผู้เล่นที่ออฟไลน์
- ปรับแต่งไอเทมและคำสั่งได้อย่างเต็มที่
- รองรับหลายภาษาพร้อมการจัดรูปแบบสี HEX สวยงาม
- แสดงสถิติและอันดับผู้เล่นในเกม
การตั้งค่าข้อความ:
สามารถปรับแต่งข้อความทั้งหมดได้ในไฟล์ messages.yml โดยใช้รหัสสีปกติ (&6, &a, ฯลฯ) และรูปแบบสี HEX (&#RRGGBB หรือ <#RRGGBB>) เพื่อทำให้ข้อความในเกมของคุณโดดเด่นและสวยงาม
สนับสนุน & ข้อเสนอแนะ
พบบัค? มีคำถาม? ต้องการคุณสมบัติเพิ่มเติม?
แสดงความคิดเห็นด้านล่างและผมจะตอบกลับโดยเร็วที่สุด!
