Skip to main content

Announcement Priority System

The Announcement Priority System manages how important EliteMobs messages are. These are currently only used to manage the messages sent by Custom Boss spawns.

Short-form cheat sheet:

  • Level 0: Silent (DEFAULT) - Only damagers see death messages
  • Level 1: Chat messages + Tracking (if messages/locationMessage configured)
  • Level 2: Same as Level 1 (no functional difference)
  • Level 3: Level 1 features + Discord announcements (requires DiscordSRV)

How it works:

Note: You need to set your Custom Boss up with this priority system if you want to use a non-default value. Click here to learn how to do that.

Level 0​

Forces the Custom Boss to be silent. This means:

  • No spawn messages will be sent
  • No escape messages will be sent
  • Death messages are sent ONLY to players who damaged the boss (not server-wide)
  • Boss tracking is disabled even if locationMessage is configured

Level 1​

The default priority for custom bosses is actually Level 0 (silent). You must explicitly set announcementPriority: 1 to enable chat messages.

The Custom Boss will be able to send messages in chat if they are configured to do it. They will send spawn, death and escape messages if they are configured to have them.

By default, spawn messages broadcast to all players on the server. You can configure EliteMobs to only broadcast to players in the same world as the boss by enabling the 'Only broadcast event message in event worlds' setting in events.yml (announcementBroadcastWorldOnly: true).

Boss tracking is also enabled at this level if a locationMessage is configured. Players can click on chat to track it when it spawns, or they can use the /em menu to track it.

Tracking Requirements​

For boss tracking to work at Priority 1 or 2, the following must be configured:

  • Set announcementPriority to 1 or higher
  • Add a locationMessage field to your custom boss configuration
  • Ensure the server config has showCustomBossLocation enabled (default: true)

The locationMessage can include placeholders:

  • $distance - Shows distance to the boss
  • $location - Shows boss coordinates

Level 2​

Level 2 functions identically to Level 1. Both levels enable boss tracking if a locationMessage is configured. Priority 2 exists for organizational purposes but does not provide additional functionality beyond Priority 1.

Note: Tracking requires both an announcement priority of 1 or higher AND a configured locationMessage field.

Level 3​

The Custom Boss will have the same behavior as in Level 2, and will also send messages to the Discord room configured to send notifications about EliteMobs. The page on how to set this feature up can be found here. The messages on discord will be the same as the chat messages - spawn/death/escape

Message Types​

Custom bosses can have three types of announcements:

  • Spawn messages (spawnMessage) - Sent when the boss spawns
  • Death messages (deathMessage) - Sent when the boss is killed
  • Escape messages (escapeMessage) - Sent when the boss despawns/escapes

Each message type must be configured separately in your boss file. The announcement priority level controls whether these messages are sent and who receives them.

Example Configuration​

# Silent boss - only damagers see death message
announcementPriority: 0
deathMessage: '&c$name has been defeated!'

# Chat announcements with tracking
announcementPriority: 1
spawnMessage: '&4$name &chas spawned!'
deathMessage: '&a$name &2has been slain by $damager1name!'
escapeMessage: '&e$name &6has escaped!'
locationMessage: '&6$name &eis $distance blocks away at $location'

# Discord integration
announcementPriority: 3
spawnMessage: '&4$name &chas spawned!'
locationMessage: '&6Track $name at $location'