Documentación | xSpeed Proxy

Documentación v1.0.0

Introducción a xSpeed

xSpeed es un fork optimizado de Velocity 3.5.0 pensado para redes de Minecraft hispanohablantes. Ofrece seguridad integrada, comandos nativos y una configuración completamente en español sin depender de plugins adicionales.

💡 Tip: xSpeed es compatible con todos los backends Spigot, Paper, Purpur y sus forks. No se requieren cambios en los servidores backend.

Requisitos del Sistema

Asegúrate de cumplir con el entorno mínimo antes de instalar:

✔ Java 21 o superior (OpenJDK o GraalVM)
✔ Mínimo 512 MB de RAM dedicada al proxy
✔ Linux (recomendado) o Windows Server 2019+
✔ Puerto 25565 libre y accesible

⚠️ Java 17 puede funcionar pero no está oficialmente soportado. Se recomienda Java 21 para máximo rendimiento.

Instalación

Sigue estos pasos para arrancar xSpeed desde cero:

1. Descargar el JAR

● bash

$ mkdir xspeed-proxy && cd xspeed-proxy
$ wget https://xspeed.bio/jar/xSpeed-v1.0.0.jar

2. Primera ejecución

● bash

$ java -Xms512M -Xmx512M -jar xSpeed-v1.0.0.jar nogui
[INFO] Iniciando xSpeed v1.0.0...
[INFO] Cargando configuración desde xspeed.toml
[OK]   Escuchando en 0.0.0.0:25565
[OK]   Anti-VPN activado
[OK]   ¡xSpeed listo! Servidores registrados: 2

📂 Archivos generados: Al ejecutarse por primera vez, se crea xspeed.toml con la configuración por defecto lista para editar.

Configuración Base

El archivo principal xspeed.toml controla todo el comportamiento del proxy:

xspeed.toml

[red]
  bind        = "0.0.0.0:25565"
  motd        = "<#a5f3fc>xSpeed <gray>| <white>Proxy v1.0.0"
  max-players = 1000
  online-mode = true

[servidores]
  lobby      = "127.0.0.1:25566"
  survival   = "127.0.0.1:25567"
  minijuegos = "127.0.0.1:25568"

[antivpn]
  enabled      = true
  kick-message = "<red>Las conexiones VPN no están permitidas."
  whitelist    = []

[mantenimiento]
  enabled = false
  mensaje = "<yellow>El servidor está en mantenimiento."

Anti-VPN

El sistema Anti-VPN de xSpeed detecta rangos de IP de proveedores de VPN, proxies y hosting usando una base de datos actualizable.

xspeed.toml — Sección antivpn

[antivpn]
  enabled      = true
  kick-message = "<red>Conexión bloqueada: VPN detectada."
  whitelist    = ["1.2.3.4", "5.6.7.8"]  # IPs exentas

Comandos

Comando	Descripción	Permiso
`/hub`	Envía al jugador al lobby principal.	`xspeed.command.hub`
`/ping`	Muestra la latencia actual en ms.	Sin permiso
`/xspeed reload`	Recarga la configuración sin reiniciar.	`xspeed.admin`
`/mantenimiento`	Activa/desactiva el modo bloqueo.	`xspeed.admin`
`/find <jugador>`	Muestra en qué servidor está un jugador.	`xspeed.admin`

Permisos

xSpeed gestiona todos los permisos a través de LuckPerms o cualquier plugin de permisos compatible con Velocity. Los nodos siguen la convención xspeed.categoria.accion.

Nodo	Descripción	Por defecto
`xspeed.command.hub`	Usar el comando /hub y /lobby.	Todos
`xspeed.command.ping`	Ver la propia latencia con /ping.	Todos
`xspeed.command.server`	Listar servidores y conectarse con /server.	Todos
`xspeed.command.reload`	Recargar la configuración en caliente.	OP
`xspeed.command.info`	Ver información de versión del proxy.	OP
`xspeed.command.plugins`	Listar plugins cargados en el proxy.	OP
`xspeed.admin`	Acceso completo a todos los comandos admin.	OP
`xspeed.antivpn.bypass`	Omitir el bloqueo de Anti-VPN.	Nadie
`xspeed.mantenimiento.bypass`	Conectar durante el modo mantenimiento.	OP

💡 Tip: Usa xspeed.* para dar acceso total a un grupo de administradores sin configurar cada nodo individualmente.

MiniMessage

xSpeed usa la librería Adventure MiniMessage para formatear todos los textos. Permite gradientes RGB, colores hex y etiquetas interactivas.

Ejemplos MiniMessage

<gradient:#a5f3fc:#c4b5fd>Texto con gradiente cyan-purple</gradient>
<#ff6b6b>Color HEX personalizado</#ff6b6b>
<rainbow>Texto arcoíris animado</rainbow>
<bold><underlined>Negrita y subrayado</underlined></bold>
<hover:show_text:'Info extra'>Texto con tooltip</hover>

Feedback del Proxy

xSpeed emite diferentes tipos de mensajes en consola al iniciarse y durante la operación. Esto es lo que significa cada tipo:

✔ [OK]

Operación completada con éxito. El servicio está activo y funcional.

ℹ [INFO]

Información general sobre el estado del proxy o una acción en curso.

⚠ [WARN]

Advertencia no crítica. El proxy sigue funcionando pero algo requiere atención.

✖ [ERROR]

Error crítico. Revisa la configuración o los logs extendidos para diagnosticar.

Salida de consola esperada al iniciar correctamente:

xspeed.log — Inicio

[INFO] xSpeed v1.0.0 arrancando...
[INFO] Cargando xspeed.toml
[OK]   Configuración válida
[OK]   Anti-VPN: base de datos cargada (14,231 rangos)
[OK]   Servidores registrados: lobby, survival, minijuegos
[OK]   Escuchando en 0.0.0.0:25565
[INFO] ¡xSpeed listo para recibir conexiones!