¿Qué es el Plugin Altis?
Altis es el plugin oficial de caBRAPI para servidores Minecraft Spigot/Paper. Conecta automáticamente las compras realizadas en tu tienda caBRAPI al servidor, entregando productos de forma automatizada, sin necesidad de intervención manual.Funcionalidades
- Entrega automática de productos al jugador al entrar al servidor
- Ejecución de comandos personalizados en la consola o como jugador
- Verificación de inventario lleno antes de la entrega de ítems físicos
- Soporte a nLogin para servidores con autenticación
- Notificaciones mediante Webhook de Discord
- Verificación periódica de pagos pendientes (modo consola)
- Prevención de duplicidad con registro de pagos procesados
- Soporte de las versiones
1.16.xa1.21.xy26.x
📦 Requisitos
Descarga del Plugin
- Accede a la página de Releases de Altis en GitHub.
- Descarga el archivo
.jarde la versión más reciente.
🚀 Instalación
- Coloca el archivo
.jardescargado en la carpetaplugins/de tu servidor. - Inicia o reinicia el servidor.
- El plugin creará automáticamente la estructura:
- Verifica en la consola si el plugin se cargó correctamente — verás el banner ALTIS by caBRAPI y el estado de las configuraciones.
⚙️ Configuración
Edita el archivoplugins/altis/config.yml con los datos de tu tienda:
Referencia completa del config.yml
Obteniendo tus credenciales
- Accede al panel de caBRAPI.
- Navega a Configuraciones de la Tienda.
- Copia el Store ID y la API Key.
- Pega los valores en el
config.ymldel plugin. - Ejecuta
/cabrapi reloaden el juego o reinicia el servidor.
🎮 Comandos y Permisos
El permisocabrapi.adminse concede automáticamente a los OPs (default: op).
🧩 Configurando Productos en el Panel
Para que el plugin entregue ítems automáticamente, cada producto necesita metadatos en formatominecraft. Esta configuración se realiza en el panel de caBRAPI, en la sección de edición del producto, campo MetaData.
Ejemplo básico
Campos disponibles
💡 Consejo: Usa {player} en los comandos y en el mensaje — se sustituirá automáticamente por el nickname del jugador en el momento de la activación.
Modos de Ejecución
Modo Consola (run: console)
Los comandos se ejecutan directamente en la consola del servidor (nivel de OP). Ideal para:
- Cualquier acción que no dependa de que el jugador esté en línea
El modo consola no admite verificación de inventario. Los productos en modo consola se procesan tanto en la autenticación del jugador como en la verificación periódica en segundo plano.
Modo Jugador (run: player)
La activación ocurre cuando el jugador se autentica en el servidor (al entrar o al iniciar sesión en nLogin). Útil para:
- Entrega de ítems con verificación de inventario
- Cualquier acción que dependa de que el jugador esté en línea
🔄 Verificación de Pagos Pendientes
El plugin verifica pagos pendientes en dos escenarios:- Al entrar al servidor — procesa todos los pagos pendientes de ese jugador automáticamente.
- Periódicamente (cada
check-intervalminutos) — procesa pagos de productos configurados comorun: console, incluso si el jugador está desconectado.
Los pagos ya procesados se almacenan en plugins/altis/data/processed.yml para evitar duplicidad.
🔐 Soporte a nLogin
Si tu servidor utiliza el plugin nLogin para autenticación, Altis lo detecta automáticamente y espera a que el jugador inicie sesión (NLoginLoginEvent) antes de procesar los pagos pendientes.
Si nLogin no está presente, el plugin usa el evento estándar PlayerJoinEvent.
No se requiere ninguna configuración adicional — la detección es totalmente automática.
🌐 Discord Webhook (opcional)
Para recibir notificaciones en Discord cada vez que un jugador compre algo:Placeholders disponibles
🎨 Colores Disponibles en los Mensajes
Combina con formato:
&l (negrita), &n (subrayado), &o (cursiva), &k (mágico), &m (tachado).
📘 Ejemplos Prácticos
Ejemplo 1: Kit inicial con ítems físicos
El plugin verifica si el jugador tiene 4 slots vacíos antes de entregar. Si el inventario está lleno, se envía un mensaje de aviso. La verificación de inventario solo funciona en modo player.
Ejemplo 2: Cargo VIP con LuckPerms
Ejemplo 3: Comando ejecutado como jugador autenticado
El jugador debe estar autenticado en el servidor para recibir, ya que los comandos se ejecutan como él. La activación ocurre en el momento del login/join.