Plugin Minecraft Tebex

🔌 Sobre o Tebex

O Tebex é um plugin do Minecraft que conecta um servidor em execução a uma loja virtual Tebex para que compras online sejam entregues automaticamente no jogo. Ele implementa a API oficial do Tebex Plugin e oferece processamento no servidor para compras da loja (itens, patentes, comandos, assinaturas) em plataformas de servidor compatíveis.

🎯 Objetivo

O objetivo principal do Tebex é automatizar a entrega das compras feitas em uma loja virtual Tebex. Donos de servidor usam o plugin para conectar o servidor do jogo à loja, executar comandos configurados do servidor quando as compras são processadas e fornecer aos jogadores links de compra e informações relacionadas à loja no jogo.

⚙️ Recursos

• Processamento automático de pedidos: o plugin consulta o Tebex e executa os comandos configurados do servidor para entregar as compras quando os jogadores estão online.
• Conexão com a loja via chave secreta: conecte um servidor a uma loja usando um comando de chave secreta no lado do servidor.
• Comandos no jogo para checkout e informações da loja, para criar links de pagamento ou ver dados da loja.
• Comandos de admin e debug para enviar links, forçar verificações, atualizar dados de pacotes e ativar o registro de debug.
• Suporte a várias plataformas por meio de builds oficiais para as plataformas de servidor mais comuns.

🧩 Para quem é

• Donos de servidor que vendem itens, patentes ou assinaturas por meio de uma loja virtual Tebex.
• Administradores que precisam de processamento automatizado de compras online no Bukkit/Spigot/Paper e em outras plataformas compatíveis.
• Redes que querem uma integração oficial e mantida entre uma loja virtual e seus servidores de jogo.

🏗️ Casos de uso de exemplo

• Um servidor vende itens cosméticos em sua loja Tebex e o plugin entrega automaticamente os itens ao jogador na próxima vez que ele entrar.
• Um admin gera um link de pagamento para um doador por meio de um comando no jogo e o envia ao jogador.
• Uma compra na loja executa um comando para adicionar um jogador a um grupo de permissões ou conceder uma assinatura temporária.

⌨️ Comandos

🔐 Permissões

Todos os comandos usam um nó de permissão que corresponde exatamente ao nome do comando, conforme documentado. Os valores padrão não são especificados pela documentação oficial.

⚙️ Instalação

📥 Configuração

• Baixe a build oficial do plugin para a sua plataforma de servidor.
• Coloque o JAR do plugin no diretório plugins/ do seu servidor (ou mods/ para plataformas modded compatíveis).
• Reinicie o servidor e verifique o console para confirmar que o plugin foi carregado.
• Como administrador do servidor, execute o comando da chave secreta para conectar o servidor à sua loja.

📦 Dependências

• Nenhuma dependência em tempo de execução é documentada nas notas oficiais de instalação. Para compilar o projeto, é necessário um ambiente de desenvolvimento Java.

🧠 Notas técnicas

• Builds oficiais são fornecidas para várias plataformas de servidor e o projeto é mantido pela equipe do Tebex.
• O plugin consulta o serviço Tebex e executa comandos configurados do servidor para processar compras na sua plataforma de servidor.
• O repositório e as builds oficiais são licenciados sob GPL-3.0.

🤝 Quando este plugin é útil

Se você administra uma loja virtual Tebex e precisa de processamento confiável e oficial das compras no lado do servidor (itens, patentes ou comandos), o plugin Tebex oferece a integração e as ferramentas no jogo para conectar seu servidor à loja e automatizar a entrega sem scripts personalizados.