Core - Velocity Plugin

Un plugin avanzado para Velocity que permite la conexión de jugadores entre servidores Minecraft con conteo de jugadores en tiempo real.

✨ Características

• Conexión entre servidores: Permite conectar jugadores entre servidores backend a través de plugin messaging
• Conteo de jugadores en tiempo real: Obtiene el número de jugadores conectados a cada servidor
• Integración con Selector: Funciona perfectamente con el plugin Selector para Paper/Spigot
• Logging detallado: Logs completos para debugging y monitoreo
• Configuración flexible: Fácil de configurar y personalizar

🚀 Instalación

Requisitos

• Velocity 3.0.0 o superior
• Java 17 o superior
• Servidores backend configurados en velocity.toml

Pasos de instalación

1. Descarga el plugin

   # Compila el proyecto
   mvn clean package

2. Instala en Velocity

   • Copia target/Core-1.0.0.jar a la carpeta plugins/ de tu servidor Velocity
   • Reinicia Velocity

3. Configura los servidores Edita velocity.toml para agregar tus servidores backend:

   [servers]
   lobby = "localhost:25565"
   survival = "localhost:25566"
   creative = "localhost:25567"

4. Instala el plugin Selector (opcional pero recomendado)

   • Instala el plugin Selector en tus servidores Paper/Spigot
   • Configura la GUI de selección de servidores

⚙️ Configuración

El plugin no requiere configuración adicional. Todas las configuraciones se hacen en:

• velocity.toml - Configuración de servidores Velocity
• config.yml del plugin Selector - Configuración de la GUI

📖 Uso

Con el plugin Selector (Recomendado)

1. Los jugadores usan el comando /servidores o el item compass para abrir la GUI
2. La GUI muestra todos los servidores disponibles con el conteo de jugadores en tiempo real
3. Al hacer clic en un servidor, el jugador es conectado automáticamente

Sin el plugin Selector

El plugin Core maneja automáticamente las conexiones cuando recibe mensajes de plugin desde servidores backend.

🔧 Funcionamiento técnico

Canales de comunicación

• Canal principal: serverconnector:main
• Mensajes soportados:
  • PlayerCount - Solicita conteo de un servidor específico
  • PlayerCountAll - Solicita conteo de todos los servidores
  • Connect - Conecta un jugador a un servidor específico

Formato de mensajes

PlayerCount

SubChannel: "PlayerCount"
ServerName: String (nombre del servidor)

PlayerCountAll

SubChannel: "PlayerCountAll"

Connect

SubChannel: "Connect"
ServerName: String (nombre del servidor destino)

Arquitectura

Cliente Minecraft → Servidor Paper (Selector) → Velocity (Core) → Servidor destino

1. El cliente solicita abrir la GUI
2. Selector solicita conteos a Velocity
3. Velocity responde con los conteos
4. Selector muestra la GUI con información actualizada
5. Cliente hace clic en un servidor
6. Selector envía mensaje "Connect" a Velocity
7. Velocity conecta al jugador al servidor destino

📋 Comandos

El plugin Core no registra comandos directamente. Usa el plugin Selector para la interfaz de usuario.

🔍 Logs y debugging

El plugin proporciona logs detallados para debugging:

[Core] PLUGIN MESSAGE RECIBIDO
[Core] SubChannel recibido: Connect
[Core] SOLICITUD DE CONEXIÓN:
[Core]   Jugador: PlayerName
[Core]   Servidor destino: serverName

Posibles problemas

1. Mensaje "Connect" no llega: Verifica que el canal esté registrado en ambos plugins
2. Servidor no encontrado: Verifica que el nombre del servidor coincida con velocity.toml
3. Sin respuesta de player count: Verifica la conexión entre Paper y Velocity

🤝 Integración con Selector

Para una experiencia completa, instala el plugin Selector en tus servidores Paper/Spigot.

Características de Selector

• GUI intuitiva para selección de servidores
• Conteo de jugadores en tiempo real
• Items personalizables
• Soporte para heads de jugadores
• Efectos de sonido y títulos

📄 Licencia

Este proyecto está bajo la licencia MIT. Ver LICENSE para más detalles.

👥 Soporte

Para soporte técnico:

• Revisa los logs detallados del plugin
• Verifica la configuración de Velocity
• Asegúrate de que los nombres de servidores coincidan

🛠️ Desarrollo

Compilación

mvn clean compile

Empaquetado

mvn clean package

Dependencias

• Velocity API
• Adventure API (para mensajes)
• Guava (para ByteStreams)

📝 Notas de versión

v1.0.0

• Primera versión estable
• Soporte completo para conexiones y conteo de jugadores
• Integración completa con Selector
• Logging detallado
• Configuración automática