Minecraft Plugin Documentation
MythicMobs RequiredAPI 1.21+

Drops Configuration

File: plugins/MythicDropRefactored/config.yml

This is the main configuration file. It controls what happens when a player kills a MythicMob — what commands run, what items they get, and which player is eligible.

Basic Structure

config.yml
1reward-processing:
2  most-damage: false
3  last-hit: true
4
5SkeletonKing:
6  flexible-reward-mode: false
7  drops:
8    default:
9      drop1:
10        command: "give %player% diamond 1"
11        chance: 1.0
12        message: "&b&lYou got a diamond!"

reward-processing — Who Gets the Reward?

This section controls which player receives the drop when the mob dies.

yaml
reward-processing:
  most-damage: false   # true = player who dealt the most total damage
  last-hit: true       # true = player who landed the killing blow
SettingValueEffect
most-damagetrueHighest total damage dealer gets the reward
most-damagefalseIgnore total damage
last-hittrueKilling blow player gets the reward
last-hitfalseIgnore the killing blow
💡 Tip
For solo mobs, use last-hit: true. For boss fights with multiple players, use the Top Damage system instead.

Mob Drop Sections

Each MythicMob gets its own section, using its exact internal MythicMobs name as the key (case-sensitive).

yaml
1SkeletonKing:         # Must match the mob name in MythicMobs exactly
2  flexible-reward-mode: false
3  drops:
4    default:          # Player group from LuckPerms
5      drop1:          # Any unique name for this reward
6        command: "give %player% diamond 1"
7        chance: 1.0
8        message: "&b&lYou got a diamond!"

flexible-reward-mode

ValueBehavior
falseOnly the first drop that passes its chance is given. Stops there.
trueEvery drop rolls its own chance independently. Player can get multiple drops.

Drop Entry Fields

yaml
drop1:                              # Unique name (can be anything)
  command: "give %player% stone 1"  # Console command (%player% = player name)
  chance: 0.5                       # 0.0 = never, 1.0 = always
  message: "&aYou got stone!"       # Optional chat message

chance values

1.0
100%
Always
0.5
50%
Half the time
0.25
25%
1-in-4
0.0
0%
Never

LuckPerms Groups

Inside drops, you define player groups. Different groups get different rewards.

yaml
1drops:
2  default:     # Players in the "default" LuckPerms group (everyone without a rank)
3    drop1:
4      command: "give %player% diamond 1"
5      chance: 1.0
6      message: "&aYou got a diamond!"
7
8  vip:         # Players in the "vip" LuckPerms group
9    drop1:
10      command: "give %player% diamond 3"
11      chance: 1.0
12      message: "&b[VIP] You got 3 diamonds!"
â„šī¸ Note
If you do not use LuckPerms, just use default as your only group. All players will use it.

Full Working Example

config.yml
1reward-processing:
2  most-damage: false
3  last-hit: true
4
5# Skeleton King Boss
6SkeletonKing:
7  flexible-reward-mode: true    # All drops roll independently
8  drops:
9    default:                    # Non-VIP players
10      gold_reward:
11        command: "give %player% gold_ingot 5"
12        chance: 1.0
13        message: "&eYou got 5 gold ingots!"
14      diamond_bonus:
15        command: "give %player% diamond 1"
16        chance: 0.25            # 25% chance to also get a diamond
17        message: "&bBonus! You got a diamond!"
18      money_reward:
19        command: "eco give %player% 200"
20        chance: 1.0
21        message: "&a+$200"
22
23    vip:                        # VIP players get better rewards
24      gold_reward:
25        command: "give %player% gold_ingot 10"
26        chance: 1.0
27        message: "&eVIP: You got 10 gold ingots!"
28      diamond_bonus:
29        command: "give %player% diamond 3"
30        chance: 0.5
31        message: "&bVIP Bonus! You got 3 diamonds!"
32      money_reward:
33        command: "eco give %player% 500"
34        chance: 1.0
35        message: "&a+$500"
36
37# Cave Spider
38CaveSpider:
39  flexible-reward-mode: false   # Stop after first successful drop
40  drops:
41    default:
42      common:
43        command: "give %player% string 4"
44        chance: 0.8
45        message: "&7You got some string."
46      rare:
47        command: "give %player% spider_eye 1"
48        chance: 0.2
49        message: "&cRare drop! Spider Eye!"
âš ī¸ Warning
After editing config.yml, always run /mythicdrop reload to apply changes!

Common Mistakes

ProblemSolution
Mob name doesn't matchCopy the exact name from MythicMobs config — it's case-sensitive
Players not getting dropsCheck reward-processing settings; make sure mob name matches
Wrong group rewardsCheck LuckPerms group names — they must match exactly
Command not workingTest the command in console first, replacing %player% with a real name