Nexo
Visão geral
O Nexo adiciona itens, blocos e móveis personalizados ao seu servidor. Esta extensão os traz para o TypeWriter: uma quest pode pedir que os jogadores quebrem um minério personalizado ou coloquem o seu móvel, uma sequence pode começar quando um jogador atinge um bloco, e os criteria podem verificar o que um jogador segura ou observa.
Tudo é endereçado pelo id de item do Nexo, por exemplo ruby_ore ou oak_chair. Você continua definindo o conteúdo no Nexo; esta extensão apenas o lê e reage a ele.
Recursos
- Eventos de blocos — quebrar, colocar, interagir, dano (um jogador começa a minerar) e drop de loot para blocos personalizados.
- Eventos de móveis — quebrar, colocar, interagir e dano para móveis, com um filtro opcional de id do BetterModel.
- Objectives de contagem — quebre ou coloque blocos e móveis personalizados como objective de quest.
- Ferramentas de inventário de itens — dê ou remova itens do Nexo e reaja a pegá-los, soltá-los ou consumi-los.
- Facts de itens — item na mão, quantidade de itens e se o item na mão usa uma determinada mecânica.
- Facts do mundo — bloco observado ou pisado, móvel observado, estado de luz do móvel e o tempo necessário para quebrar um bloco.
- Variáveis — ids e propriedades dos itens na mão e dos blocos e móveis em vista, além de listas de registro e de tags.
- Entry de som — use um id de som do Nexo onde quer que o TypeWriter peça um som.
Instalação
- Instale o Nexo no seu servidor. Esta extensão não carrega sem ele.
- Confirme que as extensões Quest e Basic do TypeWriter estão instaladas.
- Baixe a extensão nas lojas (veja os botões no painel acima) e coloque o JAR em
plugins/Typewriter/extensions/. - Reinicie o servidor.
Primeiros passos
Este passo a passo inicia uma sequence quando um jogador clica com o botão direito em um bloco personalizado e conta móveis para uma quest.
- Em uma página de sequence, adicione um evento Nexo Block Interact.
- Defina
blockIdcom o id do bloco no Nexo, definaactioncomoRIGHT_CLICKe vinculetriggersàs entries a executar, por exemplo um diálogo. - Para uma tarefa de contagem, crie uma quest e um fact de progresso e depois adicione um objective Place Furniture.
- Defina
quest,fact,itemcom o id do móvel eamountcomo5. Preenchadisplaycom a linha do rastreador e vinculeonCompletea uma sequence de recompensa, se quiser uma. - Clique em Publish e teste com um jogador que tenha a quest ativa.
A variável Registry IDs lista todos os ids de itens, blocos ou móveis que o Nexo carregou. A variável Tag Items lista os itens de uma tag do Nexo.
Como funciona
Os eventos repassam às entries disparadas o que aconteceu: o id do bloco ou móvel, sua posição e, no caso de móveis, o id do BetterModel. O evento de drop de loot também informa quantas pilhas e itens foram soltos.
Os objectives contam cada posição uma vez por jogador, então colocar e quebrar o mesmo lugar novamente não soma. Eles só contam enquanto o jogador tem a quest vinculada ativa. As ações canceladas são ignoradas.
O filtro betterModelId nos eventos e objectives de móveis corresponde à chave bettermodel_id do móvel na sua configuração do Nexo. Deixe-o vazio para ignorá-lo.
Configuração
As linhas de objective no rastreador de quests são construídas a partir de dois snippets do TypeWriter:
| Snippet | Padrão |
|---|---|
advancedQuest.display | <display> <dark_gray>(<gray><current><dark_gray>/<gray><required><dark_gray>) |
advancedQuest.completed | <green>✔</green> <st><display></st> <dark_gray>(<gray><current><dark_gray>/<gray><required><dark_gray>) |
Entries
35 entradas, geradas a partir do código-fonte da extensão.
Ações2
- Nexo Give Item ActionGive a Nexo item to the player
- Nexo Remove Item ActionRemove a Nexo item from the player
Eventos12
- Nexo on Customblock Break EventTriggers when a Nexo custom block is broken
- Nexo on Customblock Damage EventTriggers when a player starts breaking a Nexo custom block
- Nexo on Customblock Drop Loot EventTriggers when a Nexo custom block drops loot
- Nexo on Customblock Interact EventTriggers when a Nexo custom block is interacted with
- Nexo on Customblock Place EventTriggers when a Nexo custom block is placed
- Nexo on Furniture Break EventTriggers when a Nexo furniture is broken
- Nexo on Furniture Damage EventTriggers when a player hits a Nexo furniture
- Nexo on Furniture Interact EventTriggers when a Nexo furniture is interacted with
- Nexo on Furniture Place EventTriggers when a Nexo furniture is placed
- Nexo on Item Consume EventTriggers when the player consumes a Nexo item
- Nexo on Item Drop EventTriggers when the player drops a Nexo item
- Nexo on Item Pickup EventTriggers when the player picks up a Nexo item
Objetivos4
- Nexo Break Customblock ObjectiveAn objective to break Nexo custom blocks
- Nexo Break Furniture ObjectiveAn objective to break Nexo furniture
- Nexo Place Customblock ObjectiveAn objective to place Nexo custom blocks
- Nexo Place Furniture ObjectiveAn objective to place Nexo furniture
Fatos8
- Nexo Break Time FactTicks this player needs to break the Nexo block they are looking at
- Nexo Furniture Light State FactWhether the Nexo furniture the player looks at is lit
- Nexo Holding Item FactWhether the player is holding a Nexo item
- Nexo Item Count FactHow many of a Nexo item the player carries
- Nexo Item Has Mechanic FactWhether the held Nexo item uses a given mechanic
- Nexo Looking at Block FactWhether the player is looking at a Nexo custom block
- Nexo Looking at Furniture FactWhether the player is looking at Nexo furniture
- Nexo Standing on Block FactWhether the player is standing on a Nexo custom block
Variáveis8
- Nexo Furniture Property VariableA property of the Nexo furniture the player is looking at
- Nexo Item in Hand ID VariableThe Nexo ID of the item the player holds
- Nexo Item Property VariableA property of the Nexo item the player holds
- Nexo Looking at Block ID VariableThe Nexo ID of the block the player is looking at
- Nexo Looking at Furniture ID VariableThe Nexo ID of the furniture the player is looking at
- Nexo Registry Ids VariableThe list of IDs Nexo has loaded
- Nexo Standing on Block ID VariableThe Nexo ID of the block the player stands on
- Nexo Tag Items VariableThe Nexo items carrying a given tag
Sons1
- Nexo SoundNexo Sound
Solução de problemas
A extensão não aparece no painel. O Nexo não está instalado ou não foi ativado. Toda entry chama a API do Nexo, então a extensão se recusa a carregar sem o plugin.
Um evento nunca dispara. Use exatamente o id de item do Nexo (ruby_ore). Um id vazio corresponde a qualquer coisa. Se você preencheu location, apenas essa posição de bloco corresponde. Os eventos cancelados por outro plugin são ignorados. No caso de móveis, um betterModelId que não corresponde ao bettermodel_id do móvel bloqueia o evento.
O objective não avança. O jogador deve ter a quest vinculada ativa, e fact deve estar definido. Cada posição de bloco conta apenas uma vez por jogador.
As variáveis de registro ou de tags estão vazias. O Nexo carrega seus itens em segundo plano. Essas variáveis não retornam nada até que o Nexo termine de carregar, então não as leia durante a inicialização do servidor.
Um fact sempre retorna 0. O item ou bloco não é do Nexo. Os facts de bloco verificam o primeiro bloco dentro de range blocos (5 por padrão). O fact de tempo de quebra retorna 0 quando o bloco alvo não é quebrável pelo Nexo. O fact de mecânica precisa do id exato da mecânica do Nexo.
O Give Item não entrega nada. O itemId é desconhecido para o Nexo, então nenhum item é construído. As sobras que não cabem são soltas aos pés do jogador, a menos que dropOverflow esteja desativado.
Extensões relacionadas
- ItemsAdder e Craft Engine — a mesma integração para os outros plugins de conteúdo personalizado.