EliteMobs
Licença
O código-fonte do EliteMobs está abrangido pela licença GPLV3, e este wiki é fornecido sob a licença CC0.
Sinta-se à vontade para redistribuir e modificar a informação contida neste wiki.
Versões
Esta documentação destina-se à linha de código atual do EliteMobs 10 (10.6.x).
A árvore de código-fonte atual é compilada com a API 1.21.4 do Minecraft e o Java 21.
O EliteMobs 10 inclui o atual sistema de progressão de perícias de arma, a gestão de conteúdo com integração Nightbreak e o novo fluxo de configuração construído em torno de /em initialize e /em setup. Os jogadores Bedrock (via Geyser) conseguem ver bosses e NPCs com modelos personalizados, e o EliteMobs expõe uma API LocationOwnership entre plugins para que outros plugins que incorporem (shading) o MagmaCore possam perguntar se uma localização é propriedade/protegida pelo EliteMobs e a que tipo de conteúdo pertence.
Se estiver a executar intencionalmente uma versão principal mais antiga do EliteMobs, trate esta secção do wiki como documentação da linha atual e verifique o comportamento mais antigo nesse ramo mais antigo.
Para que serve o EliteMobs?
O EliteMobs visa estender o end-game do Minecraft implementando vários conteúdos relacionados com bosses.
Isto significa:
- Bosses Dinâmicos (Mobs com Nível)
- Bosses Personalizados
- Eventos
- Arenas
- Masmorras Baseadas em Mundo
- Masmorras Instanciadas
- Masmorras Dinâmicas
- Masmorras Aleatórias de Mundo Aberto (com integração do BetterStructures)
- Itens Personalizados (Itens/Loot Elite)
- Perícias de Arma e Bónus de Perícia
- ... e muito mais!
O plugin não pretende substituir o conteúdo vanilla do Minecraft, mas sim complementá-lo, permitindo que os jogadores optem por não usar o conteúdo do EliteMobs, se assim o desejarem. Os itens do EliteMobs normalmente não afetam o PvP nem o combate vanilla do Minecraft, uma vez que os seus bónus de dano e de defesa só se aplicam durante o combate com o EliteMobs.
Como começar
Novo no EliteMobs? Existem dois pontos de partida distintos:
- os donos de servidores devem concluir o fluxo de configuração com
/em initialize, associar um token Nightbreak com/nightbreaklogin <token>e depois gerir o conteúdo com/em setup - os jogadores usam
/eme/agdepois de o dono do servidor ter concluído a configuração
O seu Nível de Combate é a média das suas 2 melhores perícias de arma e da sua perícia de armadura. Isto determina a dificuldade dos elites que aparecem à sua volta, por isso o seu poder cresce naturalmente à medida que joga. O equipamento é largado pelos elite mobs e escala com o seu nível — os itens de nível 20 e inferior não têm restrições de perícia, por isso os novos jogadores podem equipar livremente tudo o que encontrarem no início.
Use /em para abrir o menu principal do jogador. Na linha de código atual, ele abre o fluxo de estado/menu para os jogadores, e continua a ser o principal ponto de acesso para lojas, missões, perícias, teletransportes e muito mais.
À medida que sobe de nível, desbloqueará Bónus de Perícia — habilidades de combate especiais associadas a cada tipo de arma. Estes desbloqueiam-se nos níveis de perícia 10, 25, 50 e 75, e pode selecionar até 3 bónus ativos por arma. Consulte a página do Sistema de Perícias para todos os detalhes sobre como funcionam as perícias e a subida de nível, e a página dos Bónus de Perícia para a lista completa de habilidades.
Visão geral dos recursos do EliteMobs
Nesta secção, vamos dar uma olhadela a alguns dos principais recursos que o EliteMobs tem para oferecer, o que são e como os pode desativar. Para uma lista completa de recursos, consulte esta página.
Também pode consultar esta página para descobrir a forma pretendida como os jogadores devem interagir com o EliteMobs.
Bosses Dinâmicos
Os Bosses Dinâmicos são um dos principais recursos do EliteMobs. Substituem uma percentagem dos spawns vanilla do Minecraft por spawns de Elite Mobs.
Os Elites são mobs mais resistentes, concebidos para desafiar os jogadores e recompensá-los com possíveis drops de loot ao serem derrotados. O nível dos Elites é determinado pelo Nível de Combate do jogador, que no EliteMobs 10 é calculado puramente a partir dos níveis de perícia de arma e armadura (a média das suas duas perícias de arma mais altas e da perícia de armadura). Quanto melhor for o seu loot, mais útil ele é em combate, mas o equipamento que usa já não define o nível dos elites que aparecem à sua volta.
Isto significa que os níveis dos Elites são determinados pelo nível de combate do jogador (a sua progressão de perícias), e o sistema de combate usa um escalonamento exponencial em que a cada 5 níveis equivale a 2x de poder.
Pode ajustar a dificuldade dos elites modificando os valores damageToEliteMobMultiplierV2 e damageToPlayerMultiplierV2 em MobCombatSettings.yml. Pode encontrar mais informações sobre isto aqui.
Se desejar desativar este recurso por completo, pode fazê-lo definindo o valor doNaturalEliteMobSpawning como false.
Exemplo Visual
Itens/Loot Elite
O EliteMobs apresenta itens gerados aleatoriamente que podem ser encontrados em lojas ou largados pelos Elites. Existem também itens personalizados que normalmente se encontram em masmorras e noutro conteúdo Elite.
Os itens elite são tal como os itens vanilla, exceto que normalmente vêm equipados com extras e são mais poderosos do que qualquer coisa que possa encontrar no Minecraft vanilla. Alguns itens elite terão estatísticas chamadas Elite Sharpness e Elite Defense, e estas estatísticas só se aplicam quando os jogadores estão a lutar contra Elites, não afetando os mobs vanilla.
Os itens elite também podem ter encantamentos, Encantamentos Personalizados e efeitos de poção.
Pode desativar os itens elite abrindo o ItemSettings.yml e definindo o valor doEliteMobsLoot como false. (Não recomendado, torna impossível a progressão de níveis ao estilo MMORPG.)
Exemplo Visual
Eventos
Os Eventos são encontros únicos no EliteMobs que podem ser acionados aleatoriamente com base num temporizador ou por ações específicas do jogador, como minerar um bloco ou cortar uma árvore.
Estes encontros apresentam Elites únicos e personalizados que representam um desafio maior e oferecem loot valioso ao serem derrotados.
Os jogadores recebem notificações no chat quando ocorre um evento, com a opção de acompanhar a vida e a localização do Elite através de uma ligação clicável. Se o Elite não for derrotado dentro de um determinado período de tempo, o evento termina e o Elite desaparece (despawn).
Pode desativar todos os eventos abrindo o events.yml e definindo os valores actionEventsEnabled e timedEventsEnabled como false.
Se quiser desativar eventos individuais, pode ir a ~plugins\EliteMobs\customevents. Aí encontrará configurações para cada evento e pode desativar qualquer evento abrindo a sua configuração e definindo o valor isEnabled como false.
Exemplo Visual
Guilda dos Aventureiros
A Guilda dos Aventureiros é um mundo hub adicional que pode instalar e é também um conjunto de comandos que os jogadores podem usar.
Se o mundo hub não estiver instalado, os jogadores terão de usar comandos; caso contrário, executar comandos com o mundo hub instalado teletransportará os jogadores para o mundo hub, onde podem interagir com NPCs em vez de terem de escrever comandos.
Que comandos? O EliteMobs tem vários comandos que os jogadores podem usar para vender e comprar itens, reparar itens, encantar itens e muito mais. Saiba mais sobre o conjunto de comandos atual aqui.
A Guilda dos Aventureiros também inclui NPCs especiais, como NPCs de jogos de azar (Blackjack, Cara ou Coroa, Slots, Maior/Menor) e um NPC de Loja de Flechas para comprar flechas especiais.
Para mais informações sobre a Guilda dos Aventureiros e como instalar o mundo hub, consulte esta página.
Exemplo Visual
Perícias de Arma e Progressão de Equipamento
A partir do EliteMobs 10, o antigo sistema de níveis/ranks de guilda e de prestígio foi substituído por um sistema de perícias de arma. Existem 9 tipos de perícia -- Espadas, Machados, Arcos, Bestas, Tridentes, Enxadas, Maças, Lanças e Armadura -- que sobem de nível através do combate. Cada tipo de arma tem bónus de perícia únicos que se desbloqueiam em diferentes limiares de nível, com tipos de bónus que incluem passivo, condicional, proc, acumulável (stacking) e com tempo de recarga (cooldown). Os jogadores podem selecionar até 3 bónus de perícia ativos por tipo de arma.
O equipamento é agora restrito pelo nível de perícia, em vez do rank de guilda. Os jogadores não podem equipar equipamento acima do seu nível de perícia, o que evita o power-leveling e garante uma progressão equilibrada.
Este sistema, combinado com o encantamento de vinculação à alma (soulbind), mantém o equilíbrio do servidor e fomenta o apego dos jogadores ao loot que adquiriram.
Exemplo Visual
Arenas
As Arenas são desafios baseados em vagas (waves) onde os jogadores podem entrar em combate. Um ou vários jogadores podem juntar-se a uma arena e enfrentar vagas de inimigos cada vez mais difíceis, com recompensas que melhoram à medida que o desafio avança.
Ao instalar o mundo hub da Guilda dos Aventureiros, os jogadores ganham acesso à Wood League Arena, uma arena gratuita acessível através da interação com um NPC no mundo hub ou através do menu /em.
Pode obter arenas adicionais em: Itch.io ou subscrevendo o Patreon.
Pode desativar as arenas indo a ~plugins\EliteMobs\customarenas
e depois abrindo a configuração da arena, por exemplo wood_league.yml, e localizando o valor isEnabled e definindo-o como false.
Exemplo Visual
Masmorras de Mundo
As Masmorras de Mundo são conteúdo personalizado adicional que pode descarregar para o EliteMobs. As masmorras normalmente têm bosses Elite personalizados, mundos personalizados, loot personalizado e poderes de boss personalizados.
Todas as masmorras de mundo são masmorras localizadas no seu próprio mundo, o que significa que, quando os jogadores acedem a elas, são teletransportados para um mundo que não tem nada para além dessa masmorra.
Existem vários tipos de masmorras de mundo; para saber mais sobre os tipos, clique aqui.
Todas as masmorras de mundo têm um nível definido, e qualquer jogador que tente as masmorras deve estar por volta desse nível para obter a melhor experiência.
Pode obter masmorras em: Itch.io ou subscrevendo o Patreon. Existem várias masmorras gratuitas que pode descarregar aqui.
Pode desativar masmorras individuais indo a ~plugins\EliteMobs\content_packages e abrindo a configuração da masmorra que deseja desativar, definindo o valor isEnabled como false.
Exemplo Visual
Masmorras Instanciadas
As Masmorras Instanciadas diferem das Masmorras de Mundo de várias formas. São instanciadas, o que significa que um novo mundo é criado dinamicamente a partir de um modelo (blueprint), proporcionando aos jogadores e aos seus amigos uma experiência de masmorra privada, semelhante às encontradas nos MMOs.
As Masmorras Instanciadas oferecem várias dificuldades com poderes de boss únicos, vida aumentada e loot superior à medida que a dificuldade aumenta. Introduzem também funções, permitindo que os jogadores adotem funções de tank ou DPS com base no equipamento que têm equipado (o equipamento específico de função é exclusivo das Masmorras Instanciadas). Saiba mais sobre como funciona a dificuldade aqui.
Adicionalmente, os jogadores podem ressuscitar-se mutuamente dentro das Masmorras Instanciadas, permitindo-lhes retomar rapidamente a batalha se agirem com rapidez suficiente.
Pode obter masmorras instanciadas em: Itch.io ou subscrevendo o Patreon. Existem masmorras instanciadas gratuitas que pode descarregar aqui.
Pode desativar masmorras individuais indo a ~plugins\EliteMobs\dungeonpackages e abrindo a configuração da masmorra que deseja desativar, definindo o valor isEnabled como false.
Exemplo Visual
Masmorras Dinâmicas
As Masmorras Dinâmicas são um novo tipo de masmorra introduzido no EliteMobs 9.6.0. Ao contrário das Masmorras de Mundo ou das Masmorras Instanciadas com níveis de dificuldade fixos, as Masmorras Dinâmicas permitem que os jogadores selecionem o seu próprio nível de dificuldade antes de entrar.
Assim que os jogadores escolhem uma dificuldade, todos os mobs dentro da masmorra são definidos para corresponder ao nível selecionado. O menu de seleção de dificuldade baseia-se na sua progressão atual de perícias e equipamento, com recomendações fornecidas para opções mais fáceis ou mais difíceis, para o ajudar a fazer a melhor escolha para o seu nível.
Este sistema proporciona flexibilidade para que jogadores em diferentes fases de progressão experimentem o mesmo conteúdo num nível de desafio adequado. Quer procure uma jogatina casual ou um desafio hardcore, as Masmorras Dinâmicas adaptam-se às suas preferências.
Pode obter masmorras dinâmicas em: Itch.io ou subscrevendo o Patreon.
Pode desativar masmorras individuais indo a ~plugins\EliteMobs\dungeonpackages e abrindo a configuração da masmorra que deseja desativar, definindo o valor isEnabled como false.
Exemplo Visual
Aventuras
As Aventuras representam o conteúdo adicional mais expansivo disponível para o EliteMobs, ostentando um vasto mundo completo com uma história cativante e uma infinidade de missões para os jogadores embarcarem.
Com centenas de bosses, poderes e itens personalizados, as Aventuras oferecem uma experiência de jogo imersiva. As missões dentro das Aventuras funcionam de forma semelhante às dos MMOs tradicionais, atribuindo aos jogadores objetivos como derrotar mobs, localizar itens, interagir com NPCs, ou qualquer combinação destes.
As Aventuras são tão grandes que têm até outras sub-masmorras ou sub-arenas localizadas no seu interior.
Embora as Aventuras normalmente recomendem um intervalo de níveis definido para os jogadores, aconselha-se que os jogadores comecem a sua aventura na extremidade inferior da escala de níveis para um aproveitamento ótimo.
Pode obter aventuras em: Itch.io ou subscrevendo o Patreon.
Pode desativar aventuras individuais indo a ~plugins\EliteMobs\dungeonpackages e abrindo a configuração da aventura que deseja desativar, definindo o valor isEnabled como false. As Aventuras podem ter sub-masmorras e sub-arenas adicionais que vêm com elas, por isso certifique-se de que as desativa também se estiver a desativar uma aventura.
Exemplo Visual
Teletransportes por Buraco de Minhoca
O EliteMobs também apresenta teletransportadores simples de A para B chamados buracos de minhoca (wormholes). Verá estes maioritariamente usados no mundo hub da Guilda dos Aventureiros como forma de teletransportar os jogadores de lá para uma masmorra ou de volta ao spawn do servidor.
Têm normalmente a forma de um hexágono, cubo ou diamante feito de partículas. Estas partículas podem por vezes causar lag aos clientes bedrock, por isso talvez queira desativar os efeitos de partículas abrindo o Wormholes.yml e definindo noParticlesMode como true.
Pode criar os seus próprios buracos de minhoca e usá-los como quiser. Clique aqui para descobrir como.
Exemplo Visual
Conteúdo Personalizado
O EliteMobs também lhe oferece a oportunidade de criar o seu próprio conteúdo, incluindo bosses, masmorras, poderes, NPCs, missões, arenas, e muito mais! Pode encontrar guias para criar outros tipos de conteúdo para além dos listados acima no menu da barra lateral do wiki.
Para a experiência de criação de conteúdo mais fácil e eficiente, recomendamos usar a WebApp. Esta ferramenta permite-lhe gerar ficheiros de configuração prontos a usar sem necessidade de percorrer extensivamente o wiki para garantir a correção, particularmente se estiver a considerar criar poderes de boss em EliteScript. Aceda à WebApp aqui.
Para uma personalização visual aprimorada, o EliteMobs integra-se com o FreeMinecraftModels, permitindo-lhe usar modelos 3D totalmente personalizados para bosses, adereços (props) e mobília. Esta integração permite que os criadores de conteúdo concebam experiências visuais únicas para além das entidades padrão do Minecraft. Recomenda-se o FreeMinecraftModels 2.3.14+ para total compatibilidade com o conteúdo mais recente do EliteMobs.
Para Administradores e Donos de Servidores
Este plugin foi concebido para servidores de sobrevivência e do tipo sobrevivência (como Skyblock, Skywars e variantes de sobrevivência fortemente modificadas).
O plugin destina-se a ser facilmente utilizável simplesmente arrastando e largando o jar do plugin no servidor. As definições predefinidas são as que eu uso nos meus próprios servidores e estão sujeitas a alterações ao longo do tempo.
No entanto! A personalização tem sido uma prioridade máxima ao longo de todo o processo de desenvolvimento do EliteMobs. Quase todos os aspetos do plugin podem ser traduzidos, personalizados, desativados ou modificados.
Para outros programadores
Apesar da natureza GPLV3 e open-source deste projeto, não procuro nem aceitarei, de momento, quaisquer adições ou alterações de código. Acolho de bom grado os forks do plugin e teria imenso prazer em ver o que poderia fazer com eles; no entanto, este é o meu primeiro grande projeto de programação e, como tal, é também uma experiência de aprendizagem.
No entanto! Não interprete isto como uma afirmação de que estou acima de qualquer crítica ou de que não ouço feedback - muito pelo contrário, adoro quando as pessoas apontam formas melhores de realizar coisas que fiz no plugin. Desejo que este projeto seja algo que escrevi do início ao fim, sem trechos de código de que não tenha conhecimento ou que não compreenda.