1.18 - 26.2 ✅ RoyTopMobs ⭐ Ranking Damage Reward For MythicM
2026.4.2Easy Config ✅ Support SQLite and MySQL ✅ Discord Webhook Support For Announcement
- Tested MC versions
- 1.18, 1.19, 1.20, 1.21, 26.1, 26.2
RoyTopMobs (v2026.4)
Advanced World Boss System • Damage Leaderboards • Dynamic Rewards
Supports Minecraft Spigot / Paper / Purpur 1.18.2 – 1.21.x+ • MythicMobs 5.12.1+
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Overview
RoyTopMobs is an enterprise-grade Minecraft server plugin engineered to turn boss encounters into competitive, high-stakes community events. It accurately tracks real-time damage dealt to MythicMobs and vanilla entities, generates tiered rankings, broadcasts rich announcements, manages persistent cooldowns, and executes custom console and player rewards.
Designed from the ground up for modern Minecraft servers, RoyTopMobs features modular multi-file configurations, native TEXT_DISPLAY floating holograms, rich Discord Webhooks, asynchronous SQLite & MySQL database persistence, and multi-language support (English & Vietnamese).
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
⚡ Key Features
• Modular Multi-File Boss Configuration: Add unlimited custom boss configurations inside the tracked-mob/ directory. Each boss possesses its own spawn triggers, condition requirements, title/sound broadcasts, top-damage reward commands, hologram timers, and Discord webhooks.
• Accurate Damage & Percentage Tracking: Tracks melee attacks, arrows, tridents, and projectiles. Computes exact damage contribution percentages relative to the boss's true maximum health.
• Exclusive RoyTopMobs Entity Tracking (PDC): Uses Minecraft PersistentDataContainer (PDC) tagging to track only mobs summoned by RoyTopMobs (/rtm spawn, respawn timers, or fixed schedules). Mobs spawned from external commands (/mm mobs spawn, /summon) or natural spawners are completely ignored.
• Boss Leash / Tether Range (spawn.lease-range): Prevent bosses from wandering too far from their arenas. If a boss moves further than the configured distance from its spawn point (or enters another world), it is automatically teleported back.
• Persistent Respawn Cooldowns (respawn-data.yml): Cooldown timestamps and boss states persist across server restarts and /rtm reload commands. Bosses will never prematurely respawn after a reboot.
• Flexible Multi-Tiered Rewards:
- Tiered ranking rewards for Top #1 to Top #N fighters.
- Participation rewards with customizable minimum damage qualification thresholds.
- Final blow (last-hit) killer rewards.
- Console and player command dispatching with dynamic placeholders (%player%, {damage}, {percentage}, {mobname}).
• Rich Discord Webhook Embeds: Sends automated Discord embed alerts on boss spawn, boss defeat, and reward distribution with clean multi-line ranking leaderboards.
• Native Floating Hologram Countdowns: Supports Minecraft 1.19.4+ TEXT_DISPLAY entities out-of-the-box (no external hologram plugin required!), with support for FancyHolograms, DecentHolograms, and 1.18.2 ArmorStand fallbacks.
• Customizable Hologram Height Offset (hologram.y-offset): Configure the exact floating altitude above the boss spawn point.
• Line-of-Sight Spawn Point Setting: /rtm setspawn <mob_id> uses raycasting to automatically lock onto the targeted block in the player's crosshairs.
• Full RGB Hex & Gradient Support: Supports MiniMessage tags, hex colors (&#RRGGBB, #RRGGBB), and multi-stop nested gradients (<gradient:#FF4500:#FFA500>Text</gradient>) with formatting preservation.
• Async Database Statistics (HikariCP): Asynchronously records player kills, lifetime damage, and leaderboards using high-performance SQLite or MySQL.
• Automatic Configuration Migration (ConfigMigrator): Automatically detects and inserts new configuration keys into existing files upon plugin updates without overwriting custom settings.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
PlaceholderAPI Placeholders
| Placeholder | Description / Output |
| Returns the boss display name with full RGB hex colors and gradients. |
| Returns the plain boss display name stripped of all color codes (for tab/scoreboard). |
| Returns whether the boss is currently alive (Yes or No). |
| Returns the formatted time remaining until respawn (e.g. 4m 30s) or Ready. |
| Returns the full colorized respawn countdown message configured in language files. |
| Returns remaining kill condition requirements (e.g. ZOMBIE: 3/10, SKELETON: 0/5). |
| Returns the full formatted damage leaderboard line for rank position . |
| Returns the player username at rank position . |
| Returns the raw damage value dealt by the player at rank position . |
| Returns the comma-formatted damage (e.g. 15,250.50) dealt by rank position . |
| Returns the damage percentage (e.g. 32.5%) dealt relative to boss max health. |
| Returns the viewing player's total lifetime kills for that specific boss from the database. |
| Returns the viewing player's total lifetime damage dealt to that specific boss. |
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
⚙️ Commands & Permissions
| Command | Description | Permission Node | Default |
| Reloads all configuration files, language strings, and mob definitions. | | OP |
| Toggles damage tracking globally on the server. | | OP |
| Spawns a tracked boss mob at its configured spawn point or target block. | | OP |
| Silently despawns active boss mob instances without rewards or death broadcasts. | | OP |
| Sets the boss spawn point on the targeted block in the player's crosshairs. | | OP |
| Deletes the saved spawn point and removes its hologram timer. | | OP |
| Displays the in-game command help menu. | None | Everyone |
* Admin notification permission:
roytopmob.update
(Receive update notifications on join).
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Default Configuration Files
⚙️ 1. Main Configuration (config.yml)
# ==============================================================================
# RoyTopMobs Main Configuration (v2026.4)
# ==============================================================================
# Language selection: en (English) or vi (Vietnamese)
# The corresponding language file is loaded from message/en.yml or message/vi.yml
message: en
# bStats metrics settings
metrics:
enabled: true
server-uuid: ''
log-startup: true
error-reporting: true
# Database configuration (Stores player kills, total damage, and statistics)
# Supported types: SQLITE (local database file) or MYSQL (remote database with connection pool)
database:
type: SQLITE # SQLITE or MYSQL
sqlite:
file: "database.db"
mysql:
host: "localhost"
port: 3306
database: "roytopmobs"
username: "root"
password: ""
use-ssl: false
pool:
maximum-pool-size: 10
minimum-idle: 2
connection-timeout: 30000
# Global placeholder settings (used when generating PlaceholderAPI values)
placeholder:
damage-format: "#,###.##"
percentage-format: "#.#"
no-data: "No data"
no-player: "No player"
ready: "Ready"
spawned-yes: "Yes"
spawned-no: "No"2. English Language File (message/en.yml)
# ==============================================================================
# RoyTopMobs English Language File (en.yml)
# ==============================================================================
# Supports: Standard color codes (&a, &c), Hex Colors (#RRGGBB, &#RRGGBB),
# Gradients: <gradient:#color1:#color2>Text</gradient>
# ==============================================================================
prefix: "<gradient:#FFA500:#FF4500>&l[RoyTopMobs]</gradient> &8» "
reload: "<gradient:#00FF7F:#00CED1>&l✔</gradient> &aAll configurations and mob data have been reloaded successfully!"
toggle-on: "<gradient:#00FF7F:#00CED1>&l✔</gradient> &aDamage tracking has been globally enabled!"
toggle-off: "<gradient:#FF4500:#DC143C>&l✖</gradient> &cDamage tracking has been globally disabled!"
no-permission: "<gradient:#FF4500:#DC143C>&l✖</gradient> &cYou do not have permission to execute this command!"
only-players: "<gradient:#FF4500:#DC143C>&l✖</gradient> &cOnly in-game players can execute this command!"
mob-not-tracked: "<gradient:#FF4500:#DC143C>&l✖</gradient> &cBoss &e{mobtype} &cis not configured in the tracked-mob folder!"
spawn-success: "<gradient:#00FF7F:#00CED1>&l✔</gradient> &aSpawned boss &e{mobtype} &asuccessfully at your location!"
spawn-fail: "<gradient:#FF4500:#DC143C>&l✖</gradient> &cFailed to spawn boss &e{mobtype}&c! Please check configuration."
despawn-success: "<gradient:#00FF7F:#00CED1>&l✔</gradient> &aSilently despawned &e{count} &ainstance(s) of boss &e{mobtype}&a!"
despawn-none: "<gradient:#FF4500:#DC143C>&l✖</gradient> &cNo active instances of boss &e{mobtype} &cwere found on the server!"
setspawn-success: "<gradient:#00FF7F:#00CED1>&l✔</gradient> &aSpawn location saved for boss &e{mobtype}&a!"
deletespawn-success: "<gradient:#00FF7F:#00CED1>&l✔</gradient> &aSpawn location deleted for boss &e{mobtype}&a!"
deletespawn-fail: "<gradient:#FF4500:#DC143C>&l✖</gradient> &cFailed to delete spawn location for boss &e{mobtype}&c!"
usage-spawn: "&eUsage: &f/roytopmob spawn <mob_id>"
usage-despawn: "&eUsage: &f/roytopmob despawn <mob_id>"
usage-setspawn: "&eUsage: &f/roytopmob setspawn <mob_id>"
usage-deletespawn: "&eUsage: &f/roytopmob deletespawn <mob_id>"
help-menu:
- "&8&m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
- "<gradient:#FFA500:#FF4500>&l ROYTOPMOBS COMMAND SYSTEM (v2026.4)</gradient>"
- "&8&m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
- " &e• &f/rtm reload &8- &7Reloads all configurations and mob files"
- " &e• &f/rtm toggle &8- &7Toggles server-wide damage tracking"
- " &e• &f/rtm spawn <mob_id> &8- &7Spawns a boss immediately"
- " &e• &f/rtm despawn <mob_id> &8- &7Silently despawns a boss without rewards"
- " &e• &f/rtm setspawn <mob_id> &8- &7Saves current location as spawn point"
- " &e• &f/rtm deletespawn <mob_id> &8- &7Deletes saved spawn point"
- " &e• &f/rtm help &8- &7Displays this help menu"
- "&8&m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
actionbar:
format: "<gradient:#FFA500:#FFFF00>⚔ Damage:</gradient> &f{damage} &7(&e{percentage}%&7)"
messages:
respawn-countdown: "&c✦ &e{mobname} &7will respawn in: &f{time}&7!"
mob-ready: "&aReady"
threshold-min-damage: "&cYou need to deal at least &e{damage} &cdamage to {mobname} to qualify for rankings!"
threshold-max-damage: "&cYou reached the maximum tracked damage cap (&e{damage}&c) for {mobname}!"
spawn-condition-failed: "&cSummon conditions for {mobname} have not been met!"
participation-reward-received: "&aYou received a participation reward!"
lasthit-reward-received: "&e{player} &areceived the final hit reward!"Similar projects
Plugin →Let Me Despawn
Improves performance by tweaking mob despawn rules. Say bye to pesky unintentional persistent mobs.
25MSueta
JourneyMap
Real-time map used for mapping in-game or your browser as you explore.
14.7MSueta
Emotecraft
Create your own emotes in Minecraft.
7.5MSueta
Simple Tpa
A simple tpa plugin which sends requests
5.4MSueta
Common Network
Forge and Fabric Unified Networking Solution
3.9MSueta
Set Home
A lightweight plugin for players to set their homes.
3.8MSueta