Minecraft Plugin Documentation
MythicMobs RequiredAPI 1.21+

FAQ & Troubleshooting

Answers to common questions and problems. If you are stuck, this is the first place to look.

General Questions

Q:Do I need LuckPerms?

No. LuckPerms is optional. Without it, all players are treated as the default group. Just configure everything under default in your drop and quest configs.

Q:Do I need PlaceholderAPI?

No. PlaceholderAPI is optional. Without it, all plugin features work normally — you just cannot use %mythicdrop_...% placeholders in scoreboards or GUIs.

Q:Do I need to restart the server to apply config changes?

No! Run /mythicdrop reload after editing any config file. No restart needed.

Q:Where is player quest progress saved?

In plugins/MythicDropRefactored/quest_data.yml. This is created automatically and updated as players progress. It persists across server restarts.

Drop / Reward Problems

Q:Players aren't getting any drops when they kill a mob

Check these things in order:

  1. Mob name: The section name in config.yml must exactly match the MythicMobs internal mob name (case-sensitive). Example: SkeletonKing is not the same as skeletonking
  2. reward-processing: Make sure at least one of these is true:
    yaml
    reward-processing:
      most-damage: false
      last-hit: true    # At least one should be true
  3. Top-damage system: If the mob is in top3damage.yml or similar, it will not use config.yml drops unless use-standard-rewards: true is set.
  4. Enable debug mode: Set activate-debug: true in debug.yml and reload. Check your console for detailed output.
Q:VIP players are getting 'default' rewards instead of VIP rewards
  1. LuckPerms is installed and working (/lp info to verify)
  2. The player actually has the VIP group (/lp user <name> info)
  3. The group name in your config exactly matches the LuckPerms group name (case-sensitive)
  4. The player was online when the mob died (offline lookups fall back to "default")
Q:Commands in rewards aren't working

Test the command manually in your server console first (replace %player% with a real name). If it works manually but not from the plugin, check:

  • The command does not start with /
  • %player% is typed exactly as shown (not %Player% or {player})
  • The player is online when the reward runs

Quest Problems

Q:Quest kills aren't being counted
  1. Mob name: The mob-name in quests.yml must exactly match the MythicMobs mob name
  2. Quest completed: Completed quests do not track further progress
  3. Debug mode: Enable activate-debug: true in debug.yml to see detailed quest tracking logs
Q:The quest GUI shows items in wrong slots

The slot field controls the position. Slots go from 0 (top-left) to 44 (bottom-right of row 5). Make sure no two quests share the same slot number, and that all slots are between 0 and 44.

Q:The quest GUI is empty or doesn't open
  1. Make sure quests.yml has at least one quest configured
  2. Run /mythicdrop reload after saving changes
  3. Check the console for YAML syntax errors (indentation mistakes are common)

Arena Problems

Q:The boss isn't spawning when I create an arena
  1. The mob name in /marena setspawn must exactly match the MythicMobs name
  2. MythicMobs is installed and working (test with /mm mobs spawn <mobname>)
  3. Make sure you are standing in a valid location (not inside a block)
Q:The boss isn't respawning after it dies
  1. The respawn value is in seconds (e.g., 60 = 1 minute)
  2. Make sure respawn is greater than 0
  3. Check the console for errors related to ArenaManager

YAML Syntax Help

Most config problems are caused by incorrect YAML formatting. Here are the most common mistakes:

Use spaces, not tabs

yaml
1# WRONG — TAB characters break YAML!
2SkeletonKing:
3	drops:         # ← TAB character
4
5# CORRECT — 2 spaces per indent level
6SkeletonKing:
7  drops:

Missing colon

yaml
# WRONG
mob-name "SkeletonKing"

# CORRECT
mob-name: "SkeletonKing"

Wrong list format

yaml
1# WRONG
2rewardtop3:
3  SkeletonKing
4
5# CORRECT
6rewardtop3:
7  - SkeletonKing

Special characters need quotes

If a value contains :, #, [, ], wrap it in quotes:

yaml
# Without quotes, the [ breaks YAML parsing
message: "&a[VIP] You got a reward!"   # Quotes needed around the value
💡 Tip
Use an online YAML validator (search "YAML validator") to check your config files for syntax errors before reloading.