Plugin de Minecraft Tebex

🔌 Acerca de Tebex

Tebex es un plugin de Minecraft que conecta un servidor en funcionamiento con una tienda web de Tebex para que las compras en línea se entreguen automáticamente en el juego. Implementa la API oficial de Tebex Plugin y ofrece procesamiento del lado del servidor para las compras de la tienda (objetos, rangos, comandos, suscripciones) en las plataformas de servidor compatibles.

🎯 Propósito

El objetivo principal de Tebex es automatizar la entrega de las compras realizadas en una tienda web de Tebex. Los propietarios de servidores usan el plugin para conectar su servidor de juego con la tienda, ejecutar los comandos del servidor configurados cuando las compras se procesan y proporcionar a los jugadores enlaces de compra e información relacionada con la tienda dentro del juego.

⚙️ Características

• Procesamiento automático de pedidos: el plugin consulta Tebex y ejecuta los comandos del servidor configurados para entregar las compras cuando los jugadores están en línea.
• Conexión a la tienda mediante clave secreta: conecta un servidor a una tienda usando un comando de clave secreta del lado del servidor.
• Comandos en el juego para checkout e información de la tienda, para crear enlaces de pago o ver datos de la tienda.
• Comandos de admin y depuración para enviar enlaces, forzar comprobaciones, actualizar datos de paquetes y activar el registro de depuración.
• Compatibilidad con varias plataformas mediante builds oficiales para las plataformas de servidor más comunes.

🧩 Para quién es

• Propietarios de servidores que venden objetos, rangos o suscripciones a través de una tienda web de Tebex.
• Administradores que necesitan procesamiento automatizado de compras en línea en Bukkit/Spigot/Paper y otras plataformas compatibles.
• Redes que quieren una integración oficial y mantenida entre una tienda web y sus servidores de juego.

🏗️ Casos de uso de ejemplo

• Un servidor vende objetos cosméticos en su tienda de Tebex y el plugin entrega automáticamente los objetos al jugador la próxima vez que entra.
• Un admin genera un enlace de pago para un donante mediante un comando dentro del juego y se lo envía al jugador.
• Una compra en la tienda ejecuta un comando para añadir a un jugador a un grupo de permisos o conceder una suscripción temporal.

⌨️ Comandos

🔐 Permisos

Todos los comandos usan un nodo de permiso que coincide exactamente con el nombre del comando, tal como se documenta. Los valores predeterminados no se especifican en la documentación oficial.

⚙️ Instalación

📥 Configuración

• Descarga la build oficial del plugin para tu plataforma de servidor.
• Coloca el JAR del plugin en el directorio plugins/ de tu servidor (o mods/ para plataformas modded compatibles).
• Reinicia el servidor y comprueba la consola para confirmar que el plugin se cargó.
• Como administrador del servidor, ejecuta el comando de clave secreta para conectar el servidor con tu tienda.

📦 Dependencias

• No se documentan dependencias en tiempo de ejecución en las notas oficiales de instalación. Compilar el proyecto requiere un entorno de desarrollo Java.

🧠 Notas técnicas

• Se proporcionan builds oficiales para varias plataformas de servidor y el proyecto lo mantiene el equipo de Tebex.
• El plugin consulta el servicio de Tebex y ejecuta los comandos del servidor configurados para procesar las compras en tu plataforma de servidor.
• El repositorio y las builds oficiales tienen licencia GPL-3.0.

🤝 Cuándo es útil este plugin

Si administras una tienda web de Tebex y necesitas procesamiento fiable y oficial de compras del lado del servidor (objetos, rangos o comandos), el plugin de Tebex ofrece la integración y las herramientas dentro del juego para conectar tu servidor con la tienda y automatizar la entrega sin scripts personalizados.