Comandos do Minecraft
Configure os comandos de um produto, com marcadores, jogador offline, espaço no inventário e comandos de revogação.
O benefício Comando no Minecraft executa comandos no console dos servidores pareados quando o pagamento é confirmado. Antes de configurar, instale o plugin e pareie o servidor.
Configurar o benefício
Abra o produto
Em Catálogo › Produtos, abra o produto e adicione o benefício Comando no Minecraft.
Escreva os comandos de entrega
Em Comandos de entrega, escreva um comando por linha, sem a barra inicial (se você digitar /, ela é removida). Use os botões de marcador para inserir {player}, {uuid}, {order} e {quantity}. Embaixo de cada linha, o painel mostra uma prévia com valores de exemplo.
Cada benefício aceita até 20 comandos, com até 1.000 caracteres cada, sem quebras de linha. Os comandos rodam na ordem da lista.
Escolha os servidores
Deixe ligado Executar em todos os servidores pareados ou desligue e marque os servidores na lista Servidores.
Defina quando o comando roda
- Esperar o jogador entrar no servidor: ligado por padrão. Necessário para itens no inventário. Desligue para cash, ranks e permissões, que funcionam com o jogador offline.
- Espaços livres no inventário (opcional): quantos espaços o jogador precisa ter livres, de 0 a 36. A entrega espera ele liberar espaço.
Opcional: adicione comandos de revogação
Clique em Adicionar comandos de revogação e escreva os comandos que desfazem a entrega. Eles rodam quando o acesso é revogado: reembolso total, contestação, cancelamento ou fim da assinatura, conforme as opções de Revogar o acesso quando do benefício.
Marcadores
| Marcador | Valor | Exemplo |
|---|---|---|
{player} | Nick do jogador que recebe a compra | Steve |
{uuid} | UUID do jogador | 8667ba71-b85a-4004-af54-457a9734eed7 |
{order} | Número do pedido | 1042 |
{quantity} | Quantidade comprada do item | 2 |
Qualquer outro texto entre chaves é recusado ao salvar: "Use apenas os marcadores {player}, {uuid}, {order} e {quantity}."
Os comandos rodam uma vez por item do pedido, não uma vez por unidade. Para entregar a quantidade comprada, use {quantity} no próprio comando:
give {player} minecraft:diamond {quantity}Jogador da entrega
O jogador que recebe os comandos é definido assim:
- Nick digitado no checkout. Se os comandos usam
{player}ou{uuid}, o produto precisa de um campo obrigatório Nick do Minecraft no checkout; sem ele, o produto não pode ser publicado. O cliente pode digitar o nick de outra pessoa para dar a compra de presente. - Conta vinculada. Se o nick digitado é o mesmo da conta do Minecraft que o cliente vinculou, a entrega usa também o UUID verificado. Se o cliente não digitou nick nenhum, a entrega usa a conta vinculada.
Se a compra não tem nick nem conta vinculada, nenhum comando é criado. Assim que o cliente vincular a conta do Minecraft, as entregas dessa compra são criadas para o jogador vinculado.
Servidores com modo online desativado
Em servidores sem autenticação da Mojang (offline mode), qualquer pessoa pode entrar com qualquer nick. Um comando que espera o jogador online roda para quem estiver usando aquele nick. O painel mostra se o servidor está com o modo online ativado na página do servidor.
Jogador offline
| Opção | O que acontece |
|---|---|
| Esperar o jogador entrar no servidor ligado | O comando só é enviado ao servidor quando o jogador está online nele. Enquanto isso, a entrega fica Na fila sem gastar tentativa. Se ele sair no meio da entrega, o comando volta para a fila. |
| Esperar o jogador entrar no servidor desligado | O comando roda na próxima busca do plugin, com o jogador online ou não. Use para comandos que funcionam com o jogador offline, como os do LuckPerms e de economia. |
Mesmo com a opção desligada, um comando que usa {uuid} espera o jogador entrar quando a MinePag ainda não conhece o UUID dele (cliente sem conta vinculada). O plugin pega o UUID quando o jogador está online.
Espaços livres no inventário só vale quando a entrega espera o jogador online. Se faltar espaço, o jogador vê no chat "Você tem uma compra para receber! Libere 2 espaço(s) no inventário." e a entrega acontece quando houver espaço.
Vários servidores
Cada servidor escolhido executa todos os comandos do benefício. Com Executar em todos os servidores pareados, a compra vale para os servidores da loja que não estão pausados no momento do pagamento. Um servidor adicionado depois não recebe compras antigas.
Cuidado com redes que compartilham dados
Se os servidores da rede compartilham o banco do LuckPerms ou da economia, executar em todos os servidores aplica o comando várias vezes. Um eco give em três servidores dá o triplo do saldo. Nesses casos, escolha um único servidor.
Exemplos
VIP permanente com LuckPerms
Comandos de entrega, com Esperar o jogador entrar no servidor desligado:
lp user {player} parent add vip
broadcast {player} agora é VIP!Comando de revogação:
lp user {player} parent remove vipVIP de 30 dias
Para um VIP com prazo, você tem três caminhos:
- Duração no benefício: em uma compra única, preencha Duração do acesso em dias com
30. Os comandos de entrega rodam na confirmação do pagamento e, ao fim do prazo, a MinePag roda os comandos de revogação. O acesso aparece como Expirado. - Assinatura: venda o produto com preço recorrente. Os comandos de entrega rodam quando a assinatura começa, as renovações mantêm o acesso sem repetir os comandos, e os de revogação rodam quando a assinatura termina. Veja Assinaturas.
- Prazo no próprio plugin de permissões: em uma compra única, use um comando com duração:
lp user {player} parent addtemp vip 30dItens no inventário
Com Esperar o jogador entrar no servidor ligado e Espaços livres no inventário em 2:
give {player} minecraft:diamond_sword 1
give {player} minecraft:golden_apple {quantity}Dinheiro no jogo (EssentialsX)
Com Esperar o jogador entrar no servidor desligado e um único servidor escolhido:
eco give {player} 5000Comandos bloqueados
Por segurança, alguns comandos nunca são executados, mesmo que estejam no benefício: op, deop, stop, restart, reload, rl, whitelist, ban-ip, pardon-ip, save-off, transfer, sudo, esudo, plugman, minepag, mpag e os editores e importadores do LuckPerms (lp editor, luckperms editor, lp import, luckperms import). A MinePag e o plugin usam a mesma lista. O painel avisa enquanto você digita ("O plugin bloqueia o comando "op" por segurança.") e não deixa salvar o benefício.
Uma entrega com comando bloqueado vai direto para Tentativas esgotadas e fica registrada nos logs de auditoria. A lista completa e como ampliá-la estão em Plugin Minecraft › Segurança.
Quando um comando falha
- O servidor recusou o comando (por exemplo, um plugin que não está instalado): a entrega vai direto para Tentativas esgotadas, com a resposta do console no detalhe, e a loja recebe uma notificação. O plugin nunca executa duas vezes o mesmo comando, então repetir sozinho não adiantaria. Corrija a causa e use Reprocessar entrega: a MinePag cria uma entrega nova para o comando e a página passa a mostrar essa entrega. A anterior fica no histórico como substituída.
- O servidor caiu durante a execução: a entrega vai para Tentativas esgotadas com o aviso de resultado incerto. O plugin nunca repete esse comando sozinho. Confira no jogo e use Marcar como entregue ou Reprocessar entrega (que também cria uma entrega nova).
- O plugin não confirmou a execução em 2 minutos: a entrega volta para a fila e conta uma tentativa.
Cada comando do benefício é uma entrega separada, mas eles rodam na ordem da lista: enquanto um comando espera nova tentativa (por exemplo, o jogador ainda não entrou), os seguintes do mesmo benefício esperam também. Se um comando esgotar as tentativas, os seguintes continuam. Benefícios diferentes da mesma compra são enviados na ordem do produto, mas um não espera o outro.
Em servidores no modo offline (sem conta original ou atrás de um proxy sem encaminhamento de UUID), o jogador é reconhecido pelo nick: a MinePag usa o UUID de quem entrou com aquele nick.
Veja como agir em cada caso em Acompanhar entregas.