Sistema de grupos

Os grupos do EliteMobs permitem entrar juntos em masmorras, partilhar progresso de objetivos de abate próximos, disputar equipamento Elite e ver o estado dos restantes membros. Os convites normais permitem até cinco membros. Os grupos existem apenas durante a sessão: os membros nunca são guardados e um jogador é removido imediatamente ao sair do grupo ou desligar-se.

O sistema está ativo por predefinição em Party.yml e todos os comandos usam a permissão elitemobs.party (predefinição: true).

Criar e entrar num grupo

Comando	Descrição
/em party create	Cria um grupo contigo como líder
/em party invite <player>	Convida um jogador online; qualquer membro pode convidar, e convidar sem grupo cria um
/em party accept	Aceita o convite atual ainda válido
/em party leave	Sai do grupo atual
/em party menu	Abre os controlos de grupo baseados em inventário
/em party hideinteractionhint	Oculta permanentemente, só para ti, as dicas de grupo do clique direito

Um grupo normal tem um líder e até quatro membros convidados (MAX_MEMBERS é 5). Os grupos formados automaticamente nas masmorras podem ultrapassar este limite para incluir todos os jogadores admitidos. Se o líder sair, o membro seguinte assume a liderança. Os convites expiram após 60 segundos por predefinição. Cada jogador só pode ter um convite ativo; outro convite não o substitui. Sair do grupo ou desligar-se invalida os convites enviados por esse membro. O grupo dissolve-se quando sai o último membro.

Dicas de convite por clique direito

Clicar com o botão direito noutro jogador mostra uma dica de uma linha no chat, com botões clicáveis [INVITE] e [Don't show again]. A dica é ignorada quando o alvo é um NPC, não tem elitemobs.party, já tem um convite pendente, já pertence a um grupo, ou quando o teu próprio grupo está cheio. Cada jogador tem um tempo de espera pessoal de playerInteractionHintCooldownSeconds (300 por predefinição), e /em party hideinteractionhint desativa a dica permanentemente para esse jogador (guardado nos dados persistentes do jogador).

Menu de grupo em inventário

Jogadores de Bedrock, servidores com onlyUseBedrockMenus ativo e jogadores que desligaram menus em livro recebem pedidos em inventário. Os botões de convite e confirmação continuam a ser enviados no chat, além de abrir o inventário. A dica de clique direito usa o inventário em vez do chat. Os controlos incluem convites, um seletor com 45 cabeças por página e confirmações de entrada em masmorra. /em party menu abre-os para jogadores com elitemobs.party enquanto os grupos estiverem ativos; uma confirmação pendente tem prioridade, seguida de um convite pendente.

Entrar juntos em masmorras

Masmorras instanciadas e dinâmicas

Quando qualquer membro escolhe uma masmorra instanciada, o EliteMobs guarda a lista completa e inicia uma confirmação clicável. O iniciador fica automaticamente pronto e recebe CANCEL caso tenha escolhido a masmorra errada; os restantes recebem READY e DECLINE com um token exclusivo daquele lançamento.

A mensagem identifica a masmorra e a dificuldade; nas masmorras dinâmicas também mostra o nível escolhido. A confirmação dura 30 segundos por predefinição. Só pode existir uma confirmação ou entrada em curso por grupo.

Antes de mover alguém, o EliteMobs valida o grupo completo:

• todos estão online e continuam no mesmo grupo
• a masmorra tem vagas suficientes
• todos têm a permissão do pacote, quando configurada
• ninguém está noutra instância
• a instância e o mundo podem ser preparados
• a verificação cancelável MatchJoinEvent do EliteMobs aceita todos os membros

Uma recusa, expiração, alteração da lista ou falha de validação cancela a entrada do grupo inteiro. O EliteMobs não admite propositadamente apenas parte do grupo. Se a clonagem do mundo já estiver em fila, a reserva mantém-se até ter sucesso, falhar ou ser cancelada.

PlayerJoinDungeonEvent não faz parte dessa verificação: é uma notificação não cancelável emitida apenas depois da admissão. Os comandos no chat são /em party ready <token> e /em party decline <token>; o token impede que um botão antigo confirme outro lançamento.

Os desafios pessoais de encantamento continuam a solo

As masmorras de desafio de encantamento não levam o grupo porque o desafio controla temporariamente o item do iniciador.

Grupos depois da admissão

Quando entra um segundo participante que não é espectador, os jogadores admitidos na masmorra são reunidos num grupo. A entrada a solo mantém a pertença existente e não cria um grupo de uma pessoa. Um grupo previamente formado é preservado se todos os seus membros pertencerem à masmorra; caso contrário, os jogadores admitidos são reagrupados a partir dos grupos anteriores.

Isto acontece depois da admissão, pelo que uma entrada recusada ou cancelada não altera a pertença. Remover a masmorra elimina a associação, mas o grupo de sessão continua disponível para a próxima masmorra.

Masmorras de mundo aberto

Escolher uma masmorra de mundo aberto valida a lista completa, as permissões do pacote e o estado de instância antes de iniciar a contagem normal de teletransporte de cada membro. As verificações canceláveis de teletransporte têm de aceitar todos primeiro. Com o temporizador ativo, cada membro ainda pode cancelar a sua contagem ao mover-se, pelo que não há garantia de chegada de todo o grupo.

Progresso de missão partilhado

Quando um membro recebe crédito por um abate, os membros próximos recebem progresso para objetivos de abate ativos correspondentes, incluindo os associados a um chefe personalizado. Devem estar online, no mesmo mundo e dentro de sharedProgressRange (128 blocos por predefinição).

As missões continuam pessoais. O grupo não aceita nem entrega missões, não recebe a recompensa de outro membro e não partilha itens de recolha, diálogo de NPC ou participação em arenas. Os destinatários do progresso partilhado precisam dos dados carregados. Numa partida que já passou da espera ou do início, é excluído o membro que não estava na lista de participantes inicial. A proximidade continua obrigatória; a verificação não compara separadamente a instância do destinatário com a instância de origem do abate.

Saque do grupo

Quando pelo menos dois membros estão próximos, equipamento Elite normal, especial e equipamento personalizado elegível entram numa votação de Necessidade / Ganância. O equipamento gerado normal exige que um atacante direto elegível cause pelo menos 10% da vida máxima do elite; os membros próximos admitidos não têm de atingir esse limiar individualmente. Moedas, Pergaminhos Elite e itens personalizados que não são equipamento continuam pessoais.

Cada item guarda os membros elegíveis quando foi adicionado. Os bloqueios de chefes são aplicados antes da votação. A janela termina após 60 segundos sem um novo item; novos itens reiniciam esse período, mas lootVoteMaximumLifetimeSeconds limita a votação a 120 segundos por predefinição.

Barra lateral do grupo

Enquanto um jogador pertence ao grupo, a barra lateral combinada mostra:

• o líder e os membros numa ordem estável
• saúde atual/máxima em números e um marcador de estado abatido
• vidas restantes dos membros na mesma masmorra instanciada
• a missão acompanhada pelo jogador, quando há espaço
• sugestões alternadas para /em party invite <player> e /em party leave

sidebarEnabled: false desativa apenas esta barra combinada. Os grupos continuam a funcionar e é usado o painel normal de missões EliteMobs. Formatos de linha, marcadores de estado abatido/vidas e intervalo de rotação configuram-se em Party.yml. Os números de saúde usam um gradiente integrado; as chaves mantidas sidebarHealthGlyph e sidebarHealth*Color não controlam esta apresentação numérica.

Definições principais

Chave	Predefinição	Objetivo
enabled	true	Ativa grupos de sessão
sharedProgressRange	128.0	Alcance no mesmo mundo para progresso e saque
inviteTimeoutSeconds	60	Duração dos convites (mínimo 5)
dungeonReadyCheckTimeoutSeconds	30	Duração da confirmação (mínimo 5)
lootVoteMaximumLifetimeSeconds	120	Duração máxima da votação (mínimo 60)
sidebarEnabled	true	Ativa a barra combinada
sidebarRotationSeconds	10	Segundos entre sugestões (mínimo 3)
playerInteractionHintsEnabled	true	Mostra a dica de grupo ao clicar com o botão direito noutro jogador
playerInteractionHintCooldownSeconds	300	Tempo mínimo até o mesmo jogador voltar a receber a dica de clique direito (mínimo 1)

Consulta Definições de configuração do EliteMobs para as chaves atuais das mensagens e da barra lateral.