Sobre el Proyecto
🚀 ¿Qué es KEKE RANKEDS?
Plataforma integral para venta y automatización de rangos en Minecraft. Incluye tienda web con PayPal, panel admin seguro, automatización total con plugin propio, integración Discord y trazabilidad completa en MySQL.
✨ Características principales
- 🛒 Tienda web con productos de rango (Keke, Keke+, Premium)
- 🛡️ Panel admin para gestión y verificación de compras
- 🤖 Automatización: el plugin detecta compras pagadas y aplica el rango automáticamente usando LuckPerms
- 🎮 Integración con Discord para asignar roles especiales
- 📝 Logs y auditoría de todas las acciones
- 🔒 Seguridad: sin RCON ni puertos abiertos, claves separadas para admin y servidor
🛒 Flujo de compra
- Usuario compra un rango y paga por PayPal.
- Admin verifica el pago y marca la compra como "paid".
- Plugin detecta la compra y ejecuta el comando LuckPerms.
- Estado se actualiza a "applied" y se registra el log.
- Si el jugador tiene Discord vinculado, recibe el rol "Sponsor".
🛠️ Tecnologías utilizadas
- Frontend: Next.js 15, React, Lucide Icons
- Backend: Node.js, Prisma ORM, API REST
- Base de datos: MySQL (purchases, store_products, purchase_logs, ranked_players)
- Minecraft: Plugin Bukkit/Spigot 1.12.2 (RankedDiscord)
- Discord: JDA para roles
- Hosting: Vercel (web), Sparked Host (MC server)
- Seguridad: Sin RCON, claves separadas para admin y servidor
🧪 Pruebas y validación
- Ver productos en /store
- Acceder al panel admin en /admin/purchases
- Crear compra de prueba (SQL o web)
- Esperar 30 segundos y verificar que el rango se aplica automáticamente
- Confirmar en consola, panel admin y base de datos
🎯 ¿Para quién es?
- Servidores Minecraft que buscan profesionalizar la venta de rangos
- Admins que quieren automatizar y asegurar el proceso
- Comunidades que desean integración con Discord y trazabilidad
📚 Documentación y recursos
- Guías de instalación y configuración en los archivos .md del repositorio
- Archivos SQL para estructura de base de datos
- Código fuente completo y plugin RankedDiscord