Pular para o conteúdo principal

O que é o Plugin Altis?

O Altis é o plugin oficial da caBRAPI para servidores Minecraft Spigot/Paper. Ele conecta automaticamente as compras realizadas na sua loja caBRAPI ao servidor, entregando produtos de forma automatizada — sem precisar de intervenção manual.

Funcionalidades

  • Entrega automática de produtos ao jogador ao entrar no servidor
  • Execução de comandos personalizados no console ou como jogador
  • Verificação de inventário cheio antes da entrega de itens físicos
  • Suporte ao nLogin para servidores com autenticação
  • Notificações via Webhook do Discord
  • Verificação periódica de pagamentos pendentes (modo console)
  • Prevenção de duplicidade com registro de pagamentos processados
  • Suporte das versões 1.16.x até 1.21.x e 26.x

📦 Requisitos

Download do Plugin

  1. Acesse a página de Releases do Altis no GitHub.
  2. Baixe o arquivo .jar da versão mais recente.

🚀 Instalação

  1. Coloque o arquivo .jar baixado na pasta plugins/ do seu servidor.
  2. Inicie ou reinicie o servidor.
  3. O plugin criará automaticamente a estrutura:
  1. Verifique no console se o plugin carregou corretamente — você verá o banner ALTIS by caBRAPI e o status das configurações.

⚙️ Configuração

Edite o arquivo plugins/altis/config.yml com os dados da sua loja:

Referência completa do config.yml

Obtendo suas credenciais

  1. Acesse o painel da caBRAPI.
  2. Navegue até Configurações da Loja.
  3. Copie o Store ID e a API Key.
  4. Cole os valores no config.yml do plugin.
  5. Execute /cabrapi reload no jogo ou reinicie o servidor.

🎮 Comandos e Permissões

A permissão cabrapi.admin é concedida automaticamente para OPs (default: op).

🧩 Configurando Produtos no Painel

Para que o plugin entregue itens automaticamente, cada produto precisa de metadados no formato minecraft. Essa configuração é feita no painel da caBRAPI, na seção de edição do produto, campo MetaData.

Exemplo básico

Campos disponíveis

💡 Dica: Use {player} nos comandos e na mensagem — ele será substituído automaticamente pelo nickname do jogador no momento da ativação.

Modos de Execução

Modo Console (run: console)

Os comandos são executados diretamente no console do servidor (nível de OP). Ideal para:
  • Qualquer ação que não dependa do jogador estar online
O modo console não suporta verificação de inventário. Produtos em modo console são processados tanto na autenticação do jogador quanto na verificação periódica de fundo.

Modo Jogador (run: player)

A ativação ocorre quando o jogador se autentica no servidor (ao entrar ou ao fazer login no nLogin). Útil para:
  • Entrega de itens com verificação de inventário
  • Qualquer ação que dependa do jogador estar online

🔄 Verificação de Pagamentos Pendentes

O plugin verifica pagamentos pendentes em dois cenários:
  1. Ao entrar no servidor — processa todos os pagamentos pendentes daquele jogador automaticamente.
  2. Periodicamente (a cada check-interval minutos) — processa pagamentos de produtos configurados como run: console, mesmo que o jogador esteja offline.
Os pagamentos já processados são armazenados em plugins/altis/data/processed.yml para evitar duplicidade.

🔐 Suporte a nLogin

Se o seu servidor utiliza o plugin nLogin para autenticação, o Altis detecta automaticamente e aguarda o jogador fazer login (NLoginLoginEvent) antes de processar os pagamentos pendentes. Se o nLogin não estiver presente, o plugin usa o evento padrão PlayerJoinEvent.
Nenhuma configuração adicional é necessária — a detecção é totalmente automática.

🌐 Discord Webhook (opcional)

Para receber notificações no Discord sempre que um jogador comprar algo:

Placeholders disponíveis

🎨 Cores Disponíveis nas Mensagens

Combine com formatação: &l (negrito), &n (sublinhado), &o (itálico), &k (mágico), &m (riscado).

📘 Exemplos Práticos

Exemplo 1: Kit inicial com itens físicos

O plugin verifica se o jogador tem 4 slots vagos antes de entregar. Se o inventário estiver cheio, uma mensagem de aviso é enviada. A verificação de inventário funciona apenas no modo player.

Exemplo 2: Cargo VIP com LuckPerms

Exemplo 3: Comando executado como jogador autenticado

O jogador precisa estar autenticado no servidor para receber, pois os comandos são executados como ele. A ativação ocorre no momento do login/join.

🔧 Solução de Problemas