Comandos do yPlugins

O yPlugins possui comandos para consultar os plugins da conta, registrar e entregar itens personalizados, salvar patterns e integrar as configurações do servidor com o yStore Plus.

Comando principal e alias

O comando principal é /yplugins. O alias /ystore aceita os mesmos subcomandos:

/yplugins upload <token>
/ystore upload <token>

Nesta página, argumentos entre < > são obrigatórios e argumentos entre [ ] são opcionais. Substitua os argumentos pelos valores desejados, sem esses sinais. No console, digite os comandos sem a / inicial.

Permissões

Todos os comandos exigem yplugins.admin, inclusive quando executados pelo alias /ystore. Alguns subcomandos também exigem uma permissão adicional:

Comandos disponíveis

Consultar os plugins da conta

/yplugins

Sem argumentos, o comando exibe a quantidade e os nomes dos plugins vinculados à conta autenticada no yPlugins.

Registrar e entregar itens

Registrar o item em mãos

/yplugins additem

Execute dentro do jogo, segurando o item que deseja registrar. O yPlugins salva o item no arquivo items.yml, dentro da sua pasta de dados, e exibe no chat um identificador único com o prefixo [YSTORE_ITEM].

Exemplo de identificador:

[YSTORE_ITEM]2f90e488-8a8d-4c98-9929-51c8153c756d

Esse identificador pode ser usado nas configurações dos plugins compatíveis. Veja também Item Register e ItemStack Builder.

Entregar um item registrado

/yplugins getitem <id> <quantia> [jogador]

• id: identificador completo gerado pelo additem, incluindo o prefixo [YSTORE_ITEM].
• quantia: quantidade positiva de itens a entregar.
• jogador: nome exato do jogador online que receberá o item. Se omitido, o próprio executor recebe o item.

Para receber um item registrado:

/yplugins getitem [YSTORE_ITEM]2f90e488-8a8d-4c98-9929-51c8153c756d 1

Para entregar quatro unidades a outro jogador:

/yplugins getitem [YSTORE_ITEM]2f90e488-8a8d-4c98-9929-51c8153c756d 4 Steve

Substitua o identificador de exemplo por um ID salvo no seu servidor. Ao executar pelo console, informe o destinatário. Se o inventário do destinatário não comportar todos os itens, o excedente é dropado na localização dele.

Criar patterns

Um pattern é uma estrutura de blocos salva a partir de uma área selecionada, para uso por recursos compatíveis com esse formato.

Obter a ferramenta de seleção

/yplugins wand

O jogador recebe um machado de ouro de seleção. Com ele em mãos, clique nos blocos que representam os dois cantos da área:

• Botão esquerdo: define a posição 1 (POS1).
• Botão direito: define a posição 2 (POS2).

Salvar a seleção

/yplugins setpattern <nome>

Depois de definir as duas posições, informe o nome do pattern:

/yplugins setpattern arena

O comando salva os blocos da região entre as posições em patterns/arena.yml, dentro da pasta de dados do yPlugins. Após salvar, as duas posições da seleção são limpas; selecione novamente para criar outro pattern.

Integração com o yStore Plus

Enviar configurações para o painel

/yplugins upload <token>

Permissões: yplugins.admin e ystore.upload.

O comando compacta os arquivos .yml e .yaml das pastas dos plugins da conta e envia as configurações para um projeto no yStore Plus. As pastas yCore e yPlotCore são ignoradas.

1. No painel do Plus, acesse Novo Projeto → Do Servidor para gerar o token de upload.
2. Copie o comando gerado e execute no jogo ou no console.
3. Aguarde o envio e confira o resumo de arquivos importados ou atualizados.
4. Abra o projeto no painel para editar as configurações.

Dentro do jogo, o comando exibe o progresso na actionbar e, quando há um projeto identificado na resposta, oferece um link clicável para abri-lo. O menu de relatório de upload pode ser aberto automaticamente conforme a configuração do yPlugins.

Veja o passo a passo em Importação via servidor.

Aplicar configurações no servidor

/yplugins applyconfig <token>

Permissões: yplugins.admin e ystore.applyconfig.

O comando baixa o pacote de configurações do yStore Plus e extrai os arquivos na pasta plugins/ do servidor.

1. Abra o projeto no painel do Plus e use Aplicar no Servidor para gerar o token de aplicação.
2. Copie o comando gerado e execute no jogo ou no console.
3. Confira o resumo de arquivos novos, modificados e sem alteração.
4. Recarregue os plugins compatíveis com /yplugins reload <plugin> ou reinicie o servidor para que as alterações sejam utilizadas.

Dentro do jogo, o resumo permite clicar nos plugins com alterações para solicitar o recarregamento. Conforme a configuração do yPlugins, também pode ser entregue um livro de relatório e aberto um menu com os detalhes da aplicação. O recarregamento exige a permissão ystore.reload, além de yplugins.admin.

Se a database global estiver habilitada no yPlugins, seus parâmetros são aplicados às configurações importadas durante a extração.

Veja o passo a passo em Aplicar no Servidor.

Recarregar as configurações de um plugin

/yplugins reload <plugin>

Permissões: yplugins.admin e ystore.reload.

Informe o nome do plugin que deseja recarregar:

/yplugins reload yClans

O comando utiliza o sistema de recarregamento registrado pelo próprio plugin. Apenas plugins com suporte a esse sistema podem ser recarregados por ele.

Se o plugin não estiver registrado para recarregamento automático ou ocorrer um erro durante a operação, o comando informa o motivo e orienta reiniciar o servidor para aplicar as alterações.

Mensagens comuns

Se o comando não responder, confira a permissão yplugins.admin. Para upload, applyconfig e reload, verifique também a permissão específica do subcomando.