Plugin Minecraft

O plugin MinePag executa no console do servidor os comandos configurados nos produtos (VIP, itens, chaves, permissões) e anuncia as compras no chat. Ele busca as entregas na MinePag: não abre portas no servidor nem precisa de IP fixo.

Cada comando é executado no máximo uma vez, mesmo que o servidor caia no meio da entrega.

CompatibilidadeCopiar link da seção

O mesmo arquivo MinePag.jar funciona em todas as plataformas. No Spigot, as mensagens usam cores no formato legado, e formatações mais avançadas são removidas.

Jogadores Bedrock que entram pelo Floodgate também recebem as compras: o nick deles começa com . (por exemplo, .Steve).

InstalaçãoCopiar link da seção

PareamentoCopiar link da seção

Parear liga o servidor à sua loja. Você faz isso uma vez por servidor.

minepag pair ABCD1234

Depois de parear, use o servidor no benefício Comando no Minecraft dos produtos. Veja Comandos do Minecraft.

Onde fica o tokenCopiar link da seção

O pareamento troca o código por um token exclusivo do servidor, salvo em plugins/MinePag/data/credentials.yml. Só o usuário do sistema que roda o servidor consegue ler esse arquivo.

Trocar de máquina ou de lojaCopiar link da seção

• Mudou o servidor de máquina: na página do servidor no painel, clique em Gerar novo código e rode minepag pair <código> na máquina nova. O token antigo continua valendo até o novo pareamento e depois é revogado.
• Quer ligar o servidor a outra loja: gere o código na outra loja e rode minepag pair <código> de novo.
• Quer desconectar pelo próprio servidor: rode minepag unpair confirm no console. O token é revogado na MinePag e o credentials.yml é apagado. As compras ficam na fila até um novo pareamento.

Situações do servidorCopiar link da seção

Na página do servidor, a Zona de perigo tem três ações:

• Pausar entregas: o plugin para de receber comandos e passa a consultar a MinePag a cada 5 minutos. O minepag status mostra "pausado no painel da MinePag". As compras ficam na fila. Ao clicar em Retomar entregas, o plugin volta sozinho na próxima consulta; para não esperar, rode minepag forcecheck no console.
• Revogar token: desconecta o plugin na hora. Use quando o credentials.yml vazou ou o servidor mudou de dono. Exige digitar o nome do servidor.
• Remover servidor: cancela os comandos que ainda não foram entregues e tira o servidor dos benefícios dos produtos. O histórico continua em Todas as entregas. Exige digitar o nome do servidor.

Como o plugin entregaCopiar link da seção

• O plugin busca as entregas a cada 30 segundos (ou no intervalo que a MinePag pedir) e também logo depois que um jogador entra no servidor.
• Comandos que exigem o jogador online esperam ele entrar. Se o benefício exige espaço no inventário, o jogador recebe um aviso no chat e a entrega acontece quando houver espaço.
• Se o jogador sai ou fica sem espaço no momento da execução, o plugin devolve o comando como adiado: ele volta para a fila sem gastar tentativa.
• Antes de executar, o plugin grava o comando em plugins/MinePag/data/journal.db. Se o servidor cair durante a execução, o comando não é repetido: ele aparece no painel como resultado incerto para você conferir.
• Cada resultado é confirmado à MinePag. Se a internet cair, as confirmações ficam guardadas e são enviadas depois.
• Se a MinePag ficar fora do ar, o plugin espera cada vez mais entre as tentativas (até 5 minutos).

ComandosCopiar link da seção

O comando também responde por /mpag. No console, use sem a barra: minepag status.

PermissõesCopiar link da seção

Para dar o acesso administrativo a uma equipe sem torná-la operadora, use um plugin de permissões. Com o LuckPerms:

lp group moderador permission set minepag.admin.status true
lp group moderador permission set minepag.admin.forcecheck true

Configuração (config.yml)Copiar link da seção

O arquivo fica em plugins/MinePag/config.yml. Depois de editar, rode minepag reload.

Anúncios de compraCopiar link da seção

Quando um cliente compra um produto com comando no Minecraft, o servidor anuncia a compra no chat, uma vez por pedido:

Steve comprou VIP Ouro! Apoie o servidor em https://minhaloja.minepag.app

Para ligar ou desligar por servidor, use a opção Anunciar compras no chat do servidor na página do servidor no painel, ou announcements.enabled no config.yml. O painel mostra os anúncios recentes e se cada um já foi exibido.

Um anúncio que o servidor não buscar em até 1 hora expira sem ser exibido, para não anunciar compras antigas quando o servidor volta.

Personalizar as mensagensCopiar link da seção

As mensagens ficam em messages.pt-BR (e messages.en) e usam MiniMessage, como <green>texto</green>. No anúncio de compra, você pode usar:

messages:
  pt-BR:
    announcement: "<gold><player></gold> <gray>comprou</gray> <yellow><product></yellow><gray>! Garanta o seu em</gray> <aqua><store_url></aqua>"
    announcement-no-store: "<gold><player></gold> <gray>comprou</gray> <yellow><product></yellow><gray>! Obrigado pelo apoio.</gray>"

A mensagem announcement-no-store é usada quando a loja ainda não tem vitrine publicada. Os valores vindos da loja nunca são interpretados como formatação: um produto chamado <red>VIP aparece como texto.

SegurançaCopiar link da seção

• Lista fixa: os comandos abaixo nunca são executados, inclusive dentro de execute ... run e return run. A lista vale para o comando raiz, com ou sem namespace (op e minecraft:op), ou para um prefixo com argumentos (lp editor). Ela é a mesma na MinePag e no plugin e não pode ser reduzida.
• Comandos extras: para bloquear outros comandos no seu servidor, acrescente-os em delivery.blocked-commands.
• Dupla checagem: a MinePag também recusa comandos perigosos antes de enviá-los ao servidor. Um comando bloqueado vai para Tentativas esgotadas com o motivo "O comando está na lista de comandos proibidos" e fica registrado nos logs de auditoria.
• Nick validado: antes de qualquer comando, o plugin confere o nick do jogador: de 3 a 16 letras, números ou _ (Java), ou . seguido de até 15 caracteres (Bedrock pelo Floodgate). Isso impede que um nick malicioso injete argumentos no comando.
• Conexão: a comunicação com a MinePag usa HTTPS e não segue redirecionamentos.

A lista fixa de comandos bloqueados:

op, deop, stop, restart, reload, rl, whitelist, ban-ip, pardon-ip, save-off, transfer, sudo, esudo, plugman,
minepag, mpag, lp editor, luckperms editor, lp import, luckperms import

Exemplo de comandos extras no config.yml:

delivery:
  blocked-commands:
    - kill
    - eco reset

Solução de problemasCopiar link da seção

Código abertoCopiar link da seção

O plugin tem código aberto, sob a licença Apache 2.0, no repositório minepag/minecraft-plugin. Ali você confere o que ele executa no seu servidor e de onde sai cada MinePag.jar: as releases são compiladas pelo GitHub Actions a partir do código publicado.

O protocolo entre o plugin e a MinePag está descrito em minecraft-agent.openapi.json. Para relatar uma falha de segurança, siga o SECURITY.md do repositório; não abra uma issue pública.