Minecraft Plugin Documentation
MythicMobs RequiredAPI 1.21+

Top Damage Reward System

Reward players based on how much damage they dealt to a boss. Perfect for multiplayer boss fights where the best damage dealers should get the best rewards.

Overview

top3damage.yml
Top 3 System
Rank top 3 players + everyone else
top5damage.yml
Top 5 System
Rank top 5 players + everyone else
topNdamage.yml
Custom System
Create any number (top7, top10, etc.)

How It Works

1
Players attack a boss
DamageTracker records every hit from every player
2
Boss dies
All players are ranked by total damage dealt
3
Top N players rewarded
Each rank gets its own specific rewards
4
Everyone else rewarded
Players outside top N who dealt enough damage get a participation reward

File Structure (top3damage.yml)

top3damage.yml
1rewardtop3:
2  - SkeletonKing          # Mobs that use the top-3 system
3
4rewardtop3-settings:
5  use-flexible-rewards: false   # true = all rewards roll; false = stop at guaranteed count
6
7SkeletonKing:
8  use-standard-rewards: false   # Don't also run config.yml drops
9  guaranteedperrank: true
10  per-rank-group: true
11  guaranteed-rewards:
12    default: 1
13    vip: 2
14
15  first-place:
16    guaranteed-rewards: 1
17    default:
18      drop1:
19        command: "give %player% diamond 10"
20        chance: 1.0
21        message: "&b&l[#1] Champion reward!"
22    vip:
23      drop1:
24        command: "give %player% diamond 20"
25        chance: 1.0
26        message: "&b&l[VIP #1] Champion reward!"
27
28  second-place:
29    guaranteed-rewards: 1
30    default:
31      drop1:
32        command: "give %player% diamond 5"
33        chance: 1.0
34        message: "&e[#2] Silver reward!"
35
36  third-place:
37    guaranteed-rewards: 1
38    default:
39      drop1:
40        command: "give %player% diamond 2"
41        chance: 1.0
42        message: "&c[#3] Bronze reward!"
43
44  everyone-else-who-contributed:
45    min-damage: 50.0          # Minimum damage needed to qualify
46    default:
47      drop1:
48        command: "give %player% emerald 1"
49        chance: 0.8
50        message: "&aThanks for helping!"

Key Settings Explained

rewardtopN list

List the exact MythicMobs names of bosses that should use this ranking system.

yaml
rewardtop3:
  - SkeletonKing
  - AncientDragon

use-flexible-rewards

ValueMeaning
falseOnly give guaranteed rewards, stop there
trueAll rewards roll their individual chances

everyone-else-who-contributed

Players not in the top N can still earn rewards if they hit the min-damage threshold.

yaml
everyone-else-who-contributed:
  min-damage: 50.0      # Player must deal at least 50 damage to qualify
  default:
    drop1:
      command: "give %player% emerald 1"
      chance: 0.8

Custom TopX Files

Create a file named topNdamage.yml (replace N with any number). For custom files, use position-1, position-2, etc. instead of first-place, second-place.

top7damage.yml
1rewardtop7:
2  - WorldBoss
3
4rewardtop7-settings:
5  use-flexible-rewards: true
6
7WorldBoss:
8  use-standard-rewards: false
9  guaranteedperrank: true
10  per-rank-group: false
11  guaranteed-rewards: 1
12
13  position-1:
14    guaranteed-rewards: 1
15    default:
16      drop1:
17        command: "give %player% netherite_ingot 3"
18        chance: 1.0
19        message: "&4&l[#1] Netherite Champion!"
20
21  position-2:
22    guaranteed-rewards: 1
23    default:
24      drop1:
25        command: "give %player% netherite_ingot 2"
26        chance: 1.0
27        message: "&c[#2] Great job!"
28
29  position-3:
30    guaranteed-rewards: 1
31    default:
32      drop1:
33        command: "give %player% netherite_ingot 1"
34        chance: 1.0
35
36  everyone-else-who-contributed:
37    min-damage: 100.0
38    default:
39      drop1:
40        command: "give %player% emerald 1"
41        chance: 1.0
ℹ️ Note
A mob can only be in one top-damage system at a time. If a mob is in top3, it will not use top5 or custom files.

Priority Order

1
Is the mob in rewardtop3? → Use Top-3 system
2
Is the mob in rewardtop5? → Use Top-5 system
3
Is the mob in any topNdamage.yml? → Use that TopX system
4
Does the mob have drops in config.yml? → Use standard drops