Pular para o conteúdo principal

MMOCore

Classes, níveis, profissões, habilidades e pontos de passagem do MMOCore como fatos, objetivos e ações do TypeWriter.

Pagasv1.3RPG e progressão

Visão geral​

A extensão MMOCore conecta o plugin de RPG MMOCore ao TypeWriter. Ela expõe o perfil de um jogador no MMOCore (classe, nível, pontos, atributos, profissões, habilidades, árvore de habilidades, waypoints, party e guilda) como facts e variáveis do TypeWriter, para que seus diálogos, quests e audiences possam reagir a ele.

Ela também adiciona objetivos de quest que acompanham eventos do MMOCore (experiência de profissão, nível de profissão, uso de habilidades), ações que controlam o sistema de waypoints e a experiência de profissão, e duas entries de grupo para que uma party ou uma guilda possa compartilhar o progresso de quests.

A maioria das entries apenas lê dados. Nada é armazenado pela própria extensão: todo valor vem ao vivo do MMOCore quando o TypeWriter o solicita.

Recursos​

  • Facts de perfil — leia nível, experiência, pontos, vida, mana, stamina e stellium com um único valor selecionável.
  • Facts de classe e profissão — verifique a classe atual, o nível da classe e o nível ou a experiência de qualquer profissão.
  • Facts de habilidade — leia o nível de uma habilidade de classe, se ela está desbloqueada e se um slot de habilidade está vinculado.
  • Facts da árvore de habilidades — leia o nível de um nó da árvore de habilidades, ou verifique se ele está desbloqueado ou no máximo.
  • Waypoints — desbloqueie, bloqueie ou teletransporte um jogador para um waypoint do MMOCore e verifique se um está desbloqueado.
  • Objetivos de quest — objetivos de experiência de profissão, nível de profissão e uso de habilidade para quests do TypeWriter.
  • Party e guilda — contagem de membros como facts; nome, tag, id, dono e membros da guilda como variáveis.
  • Grupos — compartilhe facts do TypeWriter em uma party ou guilda do MMOCore.
  • Variáveis de lista — habilidades desbloqueadas, nós desbloqueados, waypoints, habilidades vinculadas, amigos e a cadeia de lançamento ativa.

Instalação​

  1. Instale o MMOCore e sua biblioteca MythicLib no servidor.
  2. Certifique-se de que a extensão oficial Quest do TypeWriter está instalada. Os três objetivos a exigem.
  3. Obtenha a extensão nas lojas (veja os botões no painel de resumo acima) e coloque o JAR em plugins/Typewriter/extensions/.
  4. Reinicie o servidor. Na inicialização, o console imprime [MMOCoreExtension] MMOCoreExtension enhancements initialized successfully.

Primeiros passos​

Crie uma etapa de quest que é concluída quando o jogador atinge o nível 10 na profissão de mineração e então desbloqueia um waypoint:

  1. No painel web do TypeWriter, abra uma page sequence e adicione uma ação Unlock Waypoint. Defina waypointId como o id do waypoint do MMOCore, por exemplo spawn_town.
  2. Abra (ou crie) uma page static com a sua quest e adicione um Profession Level Objective.
  3. Preencha quest com a entry da sua quest, display com o texto exibido no rastreador de quests, profession com o id da profissão (por exemplo mining) e level com 10.
  4. Defina onComplete como a ação Unlock Waypoint do passo 1.
  5. Publique. Quando um jogador com a quest ativa atingir o nível, o waypoint é desbloqueado.

Para usar a classe do jogador em uma condição de diálogo, adicione um Class Fact com classId definido como o id da classe do MMOCore. Ele retorna 1 quando o jogador tem essa classe e 0 caso contrário, então você pode usá-lo em um criterion com value definido como 1.

Nível da classe principal

Deixe profession vazio em Profession Level Objective ou em Add Profession Experience para ter como alvo o nível e a experiência da classe principal em vez de uma profissão.

Como funciona​

Facts e variáveis são lidos sob demanda. Os objetivos escutam eventos do MMOCore (ganho de experiência, subida de nível, uso de habilidade) e só contam para jogadores que correspondem aos criteria do objetivo e têm a quest ativa. Os objetivos de experiência e de uso de habilidade guardam seu progresso no fact que você liga, que deve ser um fact persistente (armazenável em cache), como um fact permanente ou de sessão.

Placeholders​

O campo waypointId das ações de waypoint aceita placeholders do PlaceholderAPI. Eles são resolvidos para o jogador antes de o waypoint ser procurado.

CampoAceita
waypointId de Unlock Waypoint, Lock Waypoint e Warp WaypointUm id de waypoint, ou um placeholder que retorne um.

Entries​

38 entradas, geradas a partir do código-fonte da extensão.

Ações5
Objetivos3
Fatos15
Variáveis13
Grupos2

Solução de problemas​

A extensão não carrega. O MMOCore e o MythicLib devem estar instalados e ativados, e a extensão Quest do TypeWriter deve estar presente. Verifique no console, na inicialização, o primeiro erro.

Um fact sempre retorna 0. O jogador não tem perfil no MMOCore (por exemplo, um NPC do Citizens) ou o id está errado. classId, professionId, skillId, fullId e waypointId devem corresponder à configuração do MMOCore. Class Fact ignora maiúsculas e minúsculas em classId; os demais ids são passados ao MMOCore exatamente como escritos.

Nada acontece quando uma ação é executada. As ações de waypoint registram um aviso como Attempted to unlock unknown waypoint '...' for <player> quando o id não existe no MMOCore. Verifique o id na configuração de waypoints do MMOCore. Add Profession Experience não faz nada, silenciosamente, quando o id da profissão é desconhecido.

O objetivo de experiência ou de uso de habilidade nunca avança. Ligue um fact persistente em fact, garanta que a quest em quest esteja ativa para o jogador e que o jogador corresponda aos criteria. No objetivo de uso de habilidade, skillIds recebe ids de skill handlers do MMOCore, e requireSuccess ignora usos que falharam.

Um objetivo de profissão conta todas as profissões. Em Profession Exp Objective, um profession vazio aceita experiência de qualquer profissão. Preencha-o para acompanhar uma profissão.

O warp não tem efeito ou custa caro demais. Warp Waypoint usa o próprio warp do MMOCore com stelliumCost. O custo é tratado pelo MMOCore, então o jogador precisa de stellium suficiente e as regras do waypoint se aplicam.

Extensões relacionadas​

  • MMOItems — a integração companheira para itens e criação do MMOItems.