Empezar

Introducción

Qué es ExyliaProxyUtils, qué permite hacer a los servidores de una red y cómo está organizada esta documentación.

ExyliaProxyUtils es la mitad de ExyliaLib que vive en el proxy. Un servidor backend por sí solo no puede ejecutar /server, encontrar a un jugador que está en otro servidor ni hacer que un teletransporte aterrice al otro lado de la red. ExyliaLib pide esas cosas por Redis; este plugin, instalado en el proxy, las responde. Es gratuito, y su código y sus versiones están en GitHub.

Un mismo jar funciona en Velocity y en BungeeCord. No tiene comandos, permisos ni menús propios: todo lo que hace se lo piden los plugins de Exylia de los backends, por un canal de Redis.

Qué hace

Comandos en el proxy

Las líneas player-proxy: y console-proxy: que todo plugin de Exylia acepta en sus listas de comandos se ejecutan aquí, como el jugador o como la consola del proxy.

Teletransportes entre servidores

Mueve a un jugador a otro servidor y le pasa una nota al destino, para que el teletransporte aterrice junto a alguien en vez de en el spawn.

Búsquedas en la red

Encuentra a cualquier jugador conectado y su servidor, y la lista completa para autocompletar.

Expulsiones en toda la red

Desconecta a un jugador esté donde esté; así expulsa y banea ExyliaStaff entre servidores.

Plugins de sanciones en el proxy

Cada sanción que LiteBans, LibertyBans, AdvancedBan o BanManager hacen en el proxy va a un stream de Redis que lee ExyliaStaff, y su historial se puede importar.

Baneos al entrar

Los jugadores que ExyliaStaff ha baneado se rechazan en el proxy, antes de llegar a ningún servidor.

Requisitos

Requisito	Detalle
Proxy	Velocity 3.4 o superior, o BungeeCord (compilado contra la API 1.21) y sus forks.
Java	21
Redis	El mismo Redis que usan todos los backends, accesible desde el proxy.
Backends	ExyliaLib 1.106.0 o superior con Redis activado en algún `database.yml`. Las ExyliaLib anteriores hablaban con el plugin 1.x por plugin messages y no pueden hablar con la 2.x.
Opcional, en el proxy	LiteBans, LibertyBans, AdvancedBan (solo BungeeCord), BanManager.

Por qué Redis y no plugin messages

Un plugin message viaja por la conexión de un jugador, y un cliente modificado puede escribir uno. Un puente construido sobre ellos tiene que confiar en que el proxy filtre los bytes del cliente antes de que lleguen a un backend; un solo control olvidado y un jugador ejecuta comandos de consola en el proxy. Redis está del lado de la propia red: solo un backend puede publicar ahí, y funciona aunque no haya nadie conectado. Las versiones 1.x usaban plugin messages; la 2.0.0 no.

Cómo leer esta documentación

Empezar

La instalación, el único archivo que hay que rellenar y cómo comprobar que los backends llegan al proxy.

Funciones

Qué responde cada módulo, los plugins de sanciones en el proxy, el control al entrar y las actualizaciones automáticas.

Referencia

Qué se puede ejecutar a través del proxy, permisos, cada clave de configuración, el protocolo, la parte de desarrolladores y las preguntas frecuentes.

Convenciones

Los identificadores entre < y > son variables: player-proxy:server <nombre> significa player-proxy:server lobby.
<prefix> es el key-prefix de Redis de la red, exylia salvo que lo hayas cambiado.
server-id es el nombre de un backend en la red, definido en database.redis de su database.yml. En el proxy, ese mismo servidor tiene que llamarse igual.

¿Falta algo en esta página? Dínoslo en Discord