Velocity

Vamos a conectar un lobby y un survival detrás de Velocity. El jugador entra por una dirección y cambia de servidor sin salir de la red. El ejemplo coloca los tres procesos en una misma máquina: es una topología pequeña que permite entender qué debe quedar público y qué debe permanecer privado.

Última revisión: 2 de octubre de 2026. Referencia consultada: la descarga oficial ofrece Velocity 4.2.1-SNAPSHOT; la documentación actual pide Java 25. Es una compilación de desarrollo, no una versión estable que debamos etiquetar como tal. Los archivos se revisaron contra la documentación; no se ejecutó una red Minecraft durante esta revisión.

Prepara los tres procesos

Necesitas dos servidores Paper que ya arranquen y una cuenta Java válida. Usa la misma versión de Minecraft en ambos al comenzar. Para Paper 26.1 o posterior, la documentación recomienda Java 25; la rama 1.20–1.21.11 usa Java 21. Comprueba java -version en la terminal que va a iniciar cada proceso.

Crea carpetas separadas proxy, lobby y survival. Descarga Velocity desde PaperMC, guarda el JAR en proxy y renómbralo velocity.jar. Ejecuta allí:

java -Xms512M -Xmx1G -jar velocity.jar

Cuando termine de generar velocity.toml y forwarding.secret, escribe end en la consola del proxy. Los tamaños de memoria son un punto de partida para este laboratorio, no una garantía para una red con cientos de jugadores.

Configura el recorrido

Modifica estas claves del velocity.toml generado, conservando el resto del archivo. Las primeras cuatro pertenecen al nivel raíz: colócalas antes de las tablas TOML, no dentro de [servers].

bind = "0.0.0.0:25565"
online-mode = true
player-info-forwarding-mode = "modern"
forwarding-secret-file = "forwarding.secret"

[servers]
lobby = "127.0.0.1:25566"
survival = "127.0.0.1:25567"
try = ["lobby"]

try determina dónde entra inicialmente el jugador. El proxy realiza la autenticación; los backends reciben su identidad mediante forwarding moderno. Ese formato requiere Minecraft 1.13 o posterior: esta receta no sirve para una red de clientes 1.8.

En lobby/server.properties, cambia las líneas existentes:

server-ip=127.0.0.1
server-port=25566
online-mode=false

En survival aplica lo mismo con server-port=25567. El modo offline se limita a estos backends privados; el proxy mantiene online-mode=true. No abras esos dos puertos en el router. Si están en contenedores o máquinas distintas, localhost deja de representar el backend: utiliza una red privada y reglas que admitan únicamente al proxy antes de continuar.

Haz que Paper reconozca al proxy

En cada config/paper-global.yml, mezcla este bloque con el existente. Sustituye el marcador por el contenido exacto de proxy/forwarding.secret y mantenlo privado:

proxies:
  velocity:
    enabled: true
    online-mode: true
    secret: "PEGA_AQUI_EL_SECRETO_GENERADO"

En spigot.yml, settings.bungeecord debe permanecer en false. No combines forwarding legacy y moderno. Paper 1.18.2 o anterior utiliza otras claves en paper.yml; no copies este bloque allí esperando el mismo resultado.

Comprueba la red

Reinicia los dos Paper y después Velocity. Conecta Minecraft a localhost:25565 desde esa máquina. Debes aparecer en lobby y poder entrar a survival con /server survival, si tu cuenta tiene permitido ese comando del proxy. Prueba también /server lobby.

Desde otra máquina, el acceso directo a los backends debe fallar. Esa prueba verifica el aislamiento; entrar correctamente por el proxy no demuestra por sí solo que los puertos privados estén protegidos.

Si aparece un error de forwarding, compara los secretos y confirma que reiniciaste Paper después de editar YAML. Si el proxy rechaza la conexión a survival, revisa el puerto y que el proceso esté encendido. Si cambian UUID o skins al pasar de servidor, comprueba los tres ajustes de online-mode y que no siga activo BungeeCord forwarding.

Antes de añadir plugins de red, conserva una copia de la configuración funcional y registra el número de build del proxy. Así podrás distinguir un error de conexión de uno introducido por un plugin.

Fuentes y documentación

• Instalación de Velocity y requisitos de Java.

• Forwarding moderno y configuración de Paper.

• Aislamiento de backends y referencia de velocity.toml.

• Requisitos actuales de Paper.

Proyecto y desarrollador: Velocity, equipo PaperMC. Descarga oficial: PaperMC. Licencia: GPL-3.0 en el repositorio de Velocity. Paper pertenece al mismo equipo y se obtiene desde su página de descarga; sus componentes tienen licencias documentadas en el repositorio. Esta publicación distribuye la explicación y el diagrama original de The Silencers, sin adjuntar JAR de terceros.

Logo oficial de Velocity: imagen enlazada desde el sitio de PaperMC. Fuente de la imagen. El banner y el diagrama explicativo son originales de The Silencers.