RoyTopMob
Advanced MythicMobs Damage Ranking & Reward System
▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬
✨ Overview
RoyTopMobs is a premium-grade Minecraft server utility that brings competitive boss fights to your RPG, Survival, or Factions server!
By tracking damage dealt by players to
MythicMobs , it establishes real-time ranking tables, displays countdown holograms for respawning bosses, triggers summon requirements, sends webhook embeds to Discord, and automatically runs console commands to distribute top-rank, participation, and last-hit rewards.
Click to expand...
Real-time damage rankings & customizable titles and sounds when the boss falls!
▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬
Key Features
Flexible Damage Tracker: Tracks melee attacks, projectiles, and arrow shots with precision.
Fault-Tolerant Hologram Integration: Works out-of-the-box with DecentHolograms or FancyHolograms to display animated boss respawn timers directly in-game.
Summoning & Kill Conditions: Establish requirements requiring players to kill a specified number of vanilla or custom Mythic Mobs before a boss will spawn.
Command-Based Rewards: Dispatch commands from the console for Top #1 to #N damage dealers, participation prizes, and final blows.
Robust Config Auto-Migration: Automatically scans and merges new keys on updates without resetting or wiping server settings.
Asynchronous Discord Webhooks: Rich, beautiful embed cards are sent to your Discord channel when bosses spawn or die. Zero lag or thread block.
PAPI Hooking & Offline Support: View data in scoreboards, holographic displays, or inventory menus. Renders offline player names correctly instead of showing "Unknown".
▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬
PlaceholderAPI Integration
Placeholder
Description
%roytopmobs_spawned_<mob>%
Returns Yes or No based on spawn status.
%roytopmobs_cooldown_<mob>%
Renders time remaining or "Ready".
%roytopmobs_respawn_<mob>%
Formatted text timer announcement.
%roytopmobs_<mob>_needed%
Lists remaining summoning kills (e.g. ZOMBIE: 3/10).
%roytopmobs_top_<mob>_<1-5>%
Shows top damage dealer username, damage, and percentage.
▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬
⚙️ Commands & Permissions
Command
Description
Permission
Default
/roytopmob reload
Reloads all plugin configurations
roytopmob.reload
OP
/roytopmob toggle
Toggles damage tracking globally
roytopmob.toggle
OP
/roytopmob spawn <mob>
Spawns a tracked boss at player cursor
roytopmob.spawn
OP
/roytopmob setspawn <mob>
Saves the location coordinate in spawns.yml
roytopmob.setspawn
OP
/roytopmob deletespawn <mob>
Deletes the boss spawn point
roytopmob.deletespawn
OP
/roytopmob help
Prints command list
-
All
Other permissions: roytopmob.update (allows receiving update warnings in chat on join)
▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬
Default Configuration
Spoiler: Click to view config.yml file
Code (YAML):
messages :
top-title
:
"&6&lTop Damage Dealers"
top-subtitle
:
"&e{player} &7- &f{damage}"
reload
:
"&aConfig reloaded successfully!"
toggle-on
:
"&aDamage tracking enabled"
toggle-off
:
"&cDamage tracking disabled"
no-permission
:
"&cYou don't have permission to use this command"
mob-killed
:
"&aMob &e{mobname} &ahas been killed!"
respawn-countdown
:
"&a{mobname} will respawn in {time}!"
mob-ready
:
"&aReady"
metrics :
enabled
: true
server-uuid
: ''
log-startup
: true
error-reporting
: true
display :
actionbar :
enabled
: true
format
:
"&6Damage: &f{damage} &7(&e{percentage}%&7)"
update-interval
: 20
top-damage :
header
:
"&8&m--------------------&r"
killer-format
:
"&7➤ &c{mobname} &7was defeated by &f{killer}"
top-header
:
"&6&lTop Damage Dealers:"
player-format
:
"&7{position}. &f{player} &8» &e{damage} &7(&f{percentage}%&7)"
footer
:
"&8&m--------------------&r"
reward-broadcast :
enabled
: true
rewards-header
:
"&a&lRewards given:"
reward-format
:
"&7• &f{player} &7received rewards for #{position}"
spawn-title :
enabled
: true
title
:
"&c✦ &l{mobname} &c✦"
subtitle
:
"&7has appeared at &f{location}"
fade-in
: 10
stay
: 40
fade-out
: 10
sound :
enabled
: true
type
: ENTITY_ENDER_DRAGON_GROWL
volume
: 1.0
pitch
: 1.0
death-title :
enabled
: true
title
:
"&c☠ &l{mobname} &c☠"
subtitle
:
"&7was defeated by &f{killer}"
fade-in
: 10
stay
: 40
fade-out
: 10
sound :
enabled
: true
type
: ENTITY_WITHER_DEATH
volume
: 1.0
pitch
: 1.0
respawn-hologram :
enabled
: true
lines
: -
"&c✦ &l{mobname} &c✦"
- "&7Respawning in
:
&f{time}"
tracked-mobs :
EliteSkeleton :
display-name
:
"&c&lElite Skeleton"
announcement
: -
""
-
"&c&lElite Skeleton &7has appeared at &f{location}!"
-
""
death-message
: -
"&8&m &r"
-
"&7➤ &c{mobname} &7was defeated by &f{killer}"
-
"&8&m &r"
respawn :
enabled
: true
time
: 300
rewards :
top-1
: -
"give {player} diamond 5"
-
"eco give {player} 5000"
top-2
: -
"give {player} diamond 3"
-
"eco give {player} 3000"
top-3
: -
"give {player} diamond 2"
-
"eco give {player} 2000"
participation-reward :
enabled
: true
min-damage
: 200
commands
: -
"give {player} diamond 1"
lasthit-reward :
enabled
: true
min-damage
: 200
commands
: -
"give {player} diamond 1"
▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬
Dependencies & System Requirements
▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬
Installation & Upgrade Guides
Spoiler: First Time Installation
Download `RoyTopMobs-1.3.2.jar`
Place the `.jar` inside your server's `/plugins` folder
Restart your server. Config folder and default files will generate.
Set spawn coordinates for your bosses using `/rtm setspawn <mobname>`!
Spoiler: Upgrade Guide from Version 1.3.1
Upgrading is extremely simple:
Shut down your server or stop the server process.
Delete `RoyTopMobs-1.3.1.jar` from your `/plugins` folder.
Drag and drop `RoyTopMobs-1.3.2.jar` in its place.
Start your server! Our config auto-migration system will automatically add the new messages (`toggle-on`, `toggle-off`) to your config file without overriding your edits.
▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬
❓ Frequently Asked Questions (FAQ)
Spoiler: Holograms are not showing, what do I do?
Ensure you have either
DecentHolograms or
FancyHolograms installed, and that
Code (YAML):
hologram.provider
in your `config.yml` is set to either
DECENT or
FANCY (not
NONE ).
Spoiler: Can I track custom damage from projectiles or bows?
Yes! In 1.3.2, the damage engine intercepts events from projectiles (e.g. arrows, tridents) and attributes the damage directly to the shooter player.
Spoiler: Does it support Folia?
Yes, this plugin integrates FoliaLib, allowing compatibility for high-performance multithreaded server environments.
▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬
Support & Feedback
If you encounter any issues or have questions, please contact us on Discord:
Join our Support Discord Server
❤️ Donation
If you appreciate our plugins, consider buying us a coffee:
Donate via PayPal
▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬
Thank you for downloading and utilizing RoyTopMobs ! Please leave a ⭐⭐⭐⭐⭐ review if you love the plugin!