Saltar al contenido principal

¿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.x a 1.21.x y 26.x

📦 Requisitos

Descarga del Plugin

  1. Accede a la página de Releases de Altis en GitHub.
  2. Descarga el archivo .jar de la versión más reciente.

🚀 Instalación

  1. Coloca el archivo .jar descargado en la carpeta plugins/ de tu servidor.
  2. Inicia o reinicia el servidor.
  3. El plugin creará automáticamente la estructura:
  1. 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 archivo plugins/altis/config.yml con los datos de tu tienda:

Referencia completa del config.yml

Obteniendo tus credenciales

  1. Accede al panel de caBRAPI.
  2. Navega a Configuraciones de la Tienda.
  3. Copia el Store ID y la API Key.
  4. Pega los valores en el config.yml del plugin.
  5. Ejecuta /cabrapi reload en el juego o reinicia el servidor.

🎮 Comandos y Permisos

El permiso cabrapi.admin se 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 formato minecraft. 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:
  1. Al entrar al servidor — procesa todos los pagos pendientes de ese jugador automáticamente.
  2. Periódicamente (cada check-interval minutos) — procesa pagos de productos configurados como run: 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.

🔧 Solución de Problemas

🔗 Enlaces útiles