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.xaté1.21.xe26.x
📦 Requisitos
Download do Plugin
- Acesse a página de Releases do Altis no GitHub.
- Baixe o arquivo
.jarda versão mais recente.
🚀 Instalação
- Coloque o arquivo
.jarbaixado na pastaplugins/do seu servidor. - Inicie ou reinicie o servidor.
- O plugin criará automaticamente a estrutura:
- 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 arquivoplugins/altis/config.yml com os dados da sua loja:
Referência completa do config.yml
Obtendo suas credenciais
- Acesse o painel da caBRAPI.
- Navegue até Configurações da Loja.
- Copie o Store ID e a API Key.
- Cole os valores no
config.ymldo plugin. - Execute
/cabrapi reloadno jogo ou reinicie o servidor.
🎮 Comandos e Permissões
A permissãocabrapi.adminé concedida automaticamente para OPs (default: op).
🧩 Configurando Produtos no Painel
Para que o plugin entregue itens automaticamente, cada produto precisa de metadados no formatominecraft. 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:- Ao entrar no servidor — processa todos os pagamentos pendentes daquele jogador automaticamente.
- Periodicamente (a cada
check-intervalminutos) — processa pagamentos de produtos configurados comorun: 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.