Sistema de Prioridade de Anúncios

O Sistema de Prioridade de Anúncios gerencia o quão importantes são as mensagens do EliteMobs. Ele é usado pelos Bosses Customizados (mensagens de spawn / morte / fuga e rastreamento) e pelos Eventos Customizados (startMessage / endMessage).

Os dois usam caminhos de código diferentes e se comportam de forma diferente na prioridade 2 — veja Eventos customizados usam um caminho diferente no final desta página.

Resumo rápido:

• Nível 0: Silencioso (padrão para bosses sem mensagens configuradas) - Apenas quem causa dano vê as mensagens de morte
• Nível 1: Mensagens no chat + Rastreamento (se messages/locationMessage estiverem configurados)
• Nível 2: Idêntico ao Nível 1 para Bosses Customizados (sem comportamento separado)
• Nível 3: Recursos do Nível 1 + anúncios no Discord (requer DiscordSRV)

Como funciona:

Nota: Você precisa configurar seu Boss Customizado com este sistema de prioridade se quiser usar um valor diferente do padrão. Clique aqui para aprender como fazer isso.

Nível 0

Força o Boss Customizado a ficar silencioso. Isso significa que:

• Nenhuma mensagem de spawn será enviada
• Nenhuma mensagem de fuga será enviada
• As mensagens de morte são enviadas APENAS para os jogadores que causaram dano ao boss (não para todo o servidor)
• O rastreamento do boss é desativado mesmo que o locationMessage esteja configurado

Nível 1

Um boss com mensagens mas sem announcementPriority fica silencioso

Se você não definir announcementPriority de forma alguma, o boss recebe a prioridade 0 — silencioso — independentemente de ter mensagens de spawn, morte ou fuga configuradas. Configurar apenas as mensagens não é suficiente; você também precisa definir announcementPriority: 1 (ou superior). Isso pega muita gente de surpresa: as mensagens estão lá, são interpretadas corretamente, e nada é jamais transmitido.

O Boss Customizado poderá enviar mensagens no chat se estiver configurado para isso. Ele enviará mensagens de spawn, morte e fuga se estiver configurado para tê-las.

Por padrão, as mensagens de spawn são transmitidas para todos os jogadores do servidor. Você pode configurar o EliteMobs para transmitir apenas aos jogadores que estão no mesmo mundo que o boss, habilitando a configuração 'Only broadcast event message in event worlds' no events.yml (announcementBroadcastWorldOnly: true).

O rastreamento do boss também é habilitado neste nível se um locationMessage estiver configurado. Os jogadores podem clicar no chat para rastreá-lo quando ele spawna, ou podem usar o menu /em para rastreá-lo.

Requisitos de Rastreamento

Para que o rastreamento de boss funcione na Prioridade 1 ou 2, o seguinte deve estar configurado:

• Defina announcementPriority como 1 ou superior
• Adicione um campo locationMessage à configuração do seu boss customizado
• Garanta que a configuração do servidor tenha showCustomBossLocation habilitado (padrão: true)

O locationMessage pode incluir placeholders:

• $distance - Mostra a distância até o boss
• $location - Mostra as coordenadas do boss

Nível 2

Para Bosses Customizados, o Nível 2 se comporta de forma idêntica ao Nível 1 — não há um caminho de código separado para a prioridade 2. Cada tipo de mensagem segue as mesmas regras nas prioridades 1 e 2:

• As mensagens de spawn são transmitidas para todo o servidor, a menos que announcementBroadcastWorldOnly: true esteja definido, caso em que vão apenas para os jogadores no mundo do boss.
• As mensagens de morte são transmitidas para todo o servidor para qualquer prioridade de 1 ou superior.
• As mensagens de fuga são sempre enviadas apenas para os jogadores no mundo do boss para qualquer prioridade de 1 ou superior.

O rastreamento do boss também é habilitado neste nível se um locationMessage estiver configurado.

Nota: O rastreamento requer tanto uma prioridade de anúncio de 1 ou superior QUANTO um campo locationMessage configurado.

Nível 3

O Boss Customizado terá o mesmo comportamento do Nível 1 e também enviará mensagens para a sala do Discord configurada para enviar notificações sobre o EliteMobs. A página sobre como configurar este recurso pode ser encontrada aqui. As mensagens no Discord serão as mesmas que as mensagens do chat - spawn/morte/fuga

Eventos customizados usam um caminho diferente

Os eventos customizados (customevents/*.yml) também têm um announcementPriority, mas as suas startMessage e endMessage passam por uma rotina diferente e mais simples. O comportamento dela é:

Prioridade	Para onde vai a mensagem	Discord
0	Apenas jogadores no mundo do evento	Não
1	Todo o servidor, a menos que announcementBroadcastWorldOnly: true no events.yml, caso em que apenas o mundo do evento	Não
2	Apenas jogadores no mundo do evento (o ramo de transmissão para todo o servidor está escrito para a prioridade 1 exatamente)	Não
3+	Apenas jogadores no mundo do evento	Sim

Portanto, para eventos — ao contrário dos bosses — a prioridade 2 não é a mesma que a prioridade 1, e prioridades de 3 ou superiores não transmitem para todo o servidor mesmo quando announcementBroadcastWorldOnly é false. O announcementPriority para eventos assume o padrão 0.

Tipos de Mensagem

Bosses customizados podem ter três tipos de anúncios:

• Mensagens de spawn (spawnMessage) - Enviadas quando o boss spawna
• Mensagens de morte (deathMessage) - Enviadas quando o boss é morto
• Mensagens de fuga (escapeMessage) - Enviadas quando o boss desaparece/foge

Cada tipo de mensagem deve ser configurado separadamente no arquivo do seu boss. O nível de prioridade de anúncio controla se essas mensagens são enviadas e quem as recebe.

Exemplo de Configuração

# 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'