Skip to content

Wiki ast es

pjscruggs edited this page Nov 11, 2026 · 2 revisions

Raknetify2 · Asturianu (Asturies)

Llingua

Multixugador

Conexones de rede con RakNet pa veceros y sirvidores de Minecraft.

Baxar · GitHub

Minecraft Raknetify2 Veceru / Sirvidor
Fabric mods/raknetify2-fabric-*.jar Veceru / Sirvidor
Forge mods/raknetify2-forge-*.jar Veceru / Sirvidor
NeoForge mods/raknetify2-neoforge-*.jar Veceru / Sirvidor
Spigot / Paper plugins/raknetify2-spigot-*.jar Sirvidor
Velocity plugins/raknetify2-velocity-*.jar Velocity
BungeeCord plugins/raknetify2-bungee-*.jar BungeeCord

Amestar sirvidor

  1. Multixugador

  2. Amestar sirvidor

  3. Direición del sirvidor

    Direición del sirvidor
    RakNet · UDP raknet;play.example.com:25565
    TCP play.example.com:25565
  4. Fecho

  5. Xunise al sirvidor

F3 · Raknetify2

F3
RakNet · UDP Activu · MTU 1400
TCP Inactivu

Velocity / BungeeCord

  1. Veceru · Raknetify2 → UDP → Velocity / BungeeCord · Raknetify2
  2. Velocity / BungeeCord → TCP → Sirvidor
Númberu de puertu · UDP Java
Fabric / Forge / NeoForge 1–65534 -Draknetify.fabric.portOverride=25570
Spigot / Paper ≥ 0.1.0-beta.1.431 1–65535 -Draknetify.spigot.portOverride=25570
Velocity 1–65534 -Draknetify.velocity.portOverride=25570
BungeeCord 1–65534 -Draknetify.bungee.portOverride=25570

Escosó'l tiempu d'espera

Direición del sirvidor UDP
raknet;play.example.com:25580 play.example.com:25580 → NAT → 192.0.2.10:25570
Sirvidor · 192.0.2.10 25570/udp

config/raknetify2-compatibility.json

Sirvidor / Velocity / BungeeCord

JSON
① ② ③ {"mode":"ordered"}
① ∥ ② ∥ ③ {"mode":"multichannel"}

Simple Voice Chat

Sirvidor Raknetify2 · UDP 25565 Simple Voice Chat
Fabric / Forge / NeoForge config/raknetify2-voicechat.json · {"enabled":true} config/voicechat/voicechat-server.properties · port=-1
Spigot / Paper config/raknetify2-voicechat.json · {"enabled":true} plugins/voicechat/voicechat-server.properties · port=-1

Simple Voice Chat · Velocity / BungeeCord

PROXY protocol v2 · UDP

Direición del sirvidor trustedProxies RakNet
192.0.2.10 · PROXY v2 / UDP ["192.0.2.10"] ✓
192.0.2.11 · PROXY v2 / UDP ["192.0.2.10"] ✗
Veceru → RakNet / UDP ["192.0.2.10"] ✗

config/raknetify2-proxy-protocol.json

{"trustedProxies":["192.0.2.10"]}

Minecraft ≥ 1.20.5 · /transfer

  1. Sirvidor A · Fabric / Forge / NeoForge · config/raknetify2-transfers.json

    {"destinations":[{"host":"play.example.com","tcpPort":25565,"udpPort":25570}]}
  2. Sirvidor B · play.example.com · server.properties → accepts-transfers=true

  3. Sirvidor A · /transfer play.example.com 25565 Alex → Veceru (Alex) → RakNet · play.example.com:25570

PacketOrdering

Minecraft
ui Opciones
entity Cadarma
world_interaction Inventario
effects Partícules
chunk Bloques

PacketOrdering.java

¡Versión incompatible!

Informar de fallos

Entamu

Raknetify2

Raknetify2 usa RakNet sobro UDP nel multixugador de Minecraft. Distribúi'l tráficu ente delles canales, cada unu col so propiu orde d'entrega. Si se pierde un paquete nuna canal, los demás pueden siguir tresmitiendo. Asina, les interacciones nel xuegu pueden siguir respondiendo con normalidá mientres se recuperen los datos perdíos o se tresfieren chunks.

Raknetify2 ye una bifurcación de Raknetify, creáu por ishland, y caltiense de forma independiente. Añede compatibilidá con versiones más recién de Minecraft y encárgase del tresporte de rede, la integración coles distintes plataformes y les pruebes de compatibilidá.

Primeros pasos

  1. Comprueba la compatibilidá de Minecraft y de los mods.
  2. Escueyi qué ficheru descargar ya instálalo.
  3. Conéctate con una direición como raknet;play.example.com.

Guíes pa sirvidores

Los autores de mods pueden usar la interfaz d'ordenación de paquetes pa declarar qué relaciones d'orde tienen de respetase ente los sos mensaxes personalizaos y el tráficu de Minecraft.

Enllaces del proyectu

Raknetify2 distribúise so la llicencia MIT y caltien los avisos de derechos d'autor orixinales. El so implementación de rede básase en Raknetify y en netty-raknet.

Instalación

Descarga una versión dende la páxina de versiones en GitHub. Antes d'instalala, comprueba qué versión de Minecraft y qué cargador de mods rique.

Tipu d'instalación Ficheru Carpeta
Cliente o sirvidor Fabric raknetify2-fabric-*.jar mods
Cliente o sirvidor Forge raknetify2-forge-*.jar mods
Cliente o sirvidor NeoForge raknetify2-neoforge-*.jar mods
Sirvidor Spigot o Paper raknetify2-spigot-*.jar plugins
Proxy Velocity raknetify2-velocity-*.jar plugins
Proxy BungeeCord raknetify2-bungee-*.jar plugins

Cierra'l cliente o deten el sirvidor antes de sustituyir el so JAR. Retira d'esa instalación el JAR del Raknetify orixinal y cualesquier JAR anterior de Raknetify2 antes d'añedir el nuevu.

Nel cliente, usa les carpetes de la instancia de Minecraft o del paquete de mods que vaigas empecipiar. Nel sirvidor o'l proxy, usa les carpetes de la instalación correspondiente. Si'l cargador entá nun creó la carpeta que precises, créala.

Conexón directa a un sirvidor

  1. Instala'l mod de cliente correspondiente al to cargador de mods.
  2. Instala'l mod de sirvidor correspondiente o, si tienes un sirvidor compatible, el complementu de Spigot/Paper.
  3. Sigue la guía de configuración del cortafueos y del enrutador pa dexar les conexones UDP al sirvidor.
  4. Reinicia'l cliente y el sirvidor.
  5. Escueye «Amestar sirvidor» ya introduz una direición como raknet;play.example.com o raknet;play.example.com:25565.

Les direiciones ensin el prefixu raknet; usen TCP.

Si solo instales el mod nel to cliente, el sirvidor remotu nun adquier compatibilidá con RakNet. El so alministrador tien qu'habilitar un puntu d'accesu RakNet. Pa entrar nel sirvidor d'otra persona de normal nun fai falta redirixir puertos d'entrada nel to enrutador.

Velocity y BungeeCord

Instala'l complementu correspondiente nel proxy y el mod nel cliente. Consulta Velocity y BungeeCord pa configurar la escucha, el reunvíu d'información a los sirvidores de xuegu, les restricciones d'accesu y la direición que tienen d'usar los xugadores.

Usar un puertu d'escucha UDP distintu

Si los xugadores conéctense directamente al sirvidor Minecraft, utiliza l'argumentu de Java que correspuenda na tabla. Si alministres un proxy, consulta la configuración d'escucha de Velocity y BungeeCord.

Plataforma Argumentu de Java Puertos almitíos
Sirvidor Fabric, Forge o NeoForge -Draknetify.fabric.portOverride=25570 De 1 a 65534
Sirvidor Spigot o Paper -Draknetify.spigot.portOverride=25570 De 1 a 65535

Forge y NeoForge comparten el códigu d'escucha con Fabric, polo que'l nome de la so propiedá tamién contien fabric. Sustitúi 25570 pol puertu UDP que quieras usar.

Spigot / Paper ≥ 0.1.0-beta.1.431

Añede l'argumentu antes de -jar nel comandu de Java o nel campu d'argumentos de la JVM del to provisor d'agospiamientu. Reinicia'l sirvidor y dexa UDP nel puertu d'escucha escoyíu. Si'l puertu públicu tamién ye 25570, conéctate a raknet;play.example.com:25570. Si un enrutador camuda'l númberu de puertu, indica'l puertu públicu na direición qu'uses nel cliente. El puertu TCP conserva'l so valor.

En Spigot/Paper, RakNet escucha en UDP na mesma direición local que Minecraft en TCP. Si'l puertu indicáu nun ye válidu o'l puertu UDP ta ocupáu, RakNet nun s'empecipia. Consulta nel rexistru d'arranque en qué direición y puertu escucha UDP. Pa volver usar el númberu de puertu TCP, quita l'argumentu y reinicia el sirvidor.

Un enrutador o un proxy UDP tamién puede esponer un puertu UDP públicu distintu y redirixilo al puertu d'escucha esistente ensin modificar los argumentos de Java del sirvidor.

Versiones de desenvolvimientu

En GitHub Actions, abre una execución de main que terminara correchamente y descarga l'ficheru del apartáu Artifacts. GitHub esixe una cuenta pa descargar estos arquivos. Utiliza la tabla d'instalación anterior pa identificar el JAR que precises.

Velocity y BungeeCord

Velocity y BungeeCord actúen como intermediarios ente los xugadores y los sirvidores de xuegu de Minecraft. Instala Raknetify2 nel proxy y en cada cliente que vaiga conectase por aciu RakNet.

Cliente Raknetify2 --UDP--> Velocity o BungeeCord --TCP--> sirvidor de xuegu

Pa esta modalidá de conexón, los sirvidores de xuegu pueden funcionar ensin Raknetify2. Siguen precisando los mods, complementos y mecanismos de reunvíu que rica la to rede. Raknetify2 nun traduz ente versiones de Minecraft nin camuda la autenticación de cuentes del proxy.

Instalar el complementu nel proxy

  1. Comprueba que les conexones TCP normales al traviés del proxy funcionen, incluyida la autenticación y el cambéu ente sirvidores de xuegu.
  2. Deten el proxy y descarga el complementu correspondiente dende la páxina de versiones en GitHub.
  3. Asitia raknetify2-velocity-*-all.jar o raknetify2-bungee-*-all.jar na carpeta plugins del proxy. Retira d'esa carpeta cualesquier versión anterior del complementu Raknetify o Raknetify2.
  4. Instala'l mod de Raknetify2 fayadizu pal cliente según la guía d'instalación.
  5. Revisa la configuración d'escucha que se describe de siguío. Reinicia'l proxy y comprueba nel so rexistru si RakNet tuvo problemes al abrir el puertu d'escucha.
  6. Dexa'l tráficu UDP públicu escontra'l proxy y acuta l'accesu a los puertos de los sirvidores de xuegu según la guía de configuración del cortafueos y del enrutador.

Utiliza versiones compatibles de Raknetify2 nel cliente y nel proxy. Consulta Compatibilidá antes de combinar versiones distintes.

Velocity

En velocity.toml, l'axuste bind determina la direición y el puertu TCP nos que Velocity escucha conexones de Minecraft. De normal Raknetify2 usa ese mesmu númberu de puertu en UDP. Les entraes de [servers] identifiquen los sirvidores de xuegu. Dexa nelles les direiciones TCP de esos sirvidores. Consulta la referencia de configuración de Velocity.

Pa usar un puertu UDP distintu, añede esti argumentu de la JVM antes de -jar nel comandu d'entamu de Velocity:

-Draknetify.velocity.portOverride=25570

Sustitúi 25570 pol puertu escoyíu. Asina camudes el puertu UDP de RakNet ensin modificar el puertu TCP de Velocity nin les direiciones de los sirvidores de xuegu. Reinicia Velocity dempués de modificar l'argumentu.

Configura'l reunvíu d'información de los xugadores tantu en Velocity como nos sos sirvidores de xuegu. Si'l software del sirvidor de xuegu almite la manera de reunvíu modernu, úsalo y calten de callao la clave de reunvíu. Sigue les instrucciones pal to sirvidor na guía de reunvíu d'información de los xugadores de Velocity. Calten amás les restricciones del cortafueos en los sirvidores de xuegu.

BungeeCord

Nel ficheru config.yml de BungeeCord, el valor de host en cada entrada de listeners define una direición y un puertu TCP d'escucha para Minecraft. Raknetify2 suel añedir UDP n'ese mesmu númberu de puertu. En servers figuren les direiciones TCP de los sirvidores de xuegu. Consulta la guía de configuración de BungeeCord.

Pa usar un puertu UDP distintu, añede esti argumentu de la JVM antes de -jar nel comandu d'entamu de BungeeCord:

-Draknetify.bungee.portOverride=25570

L'axuste afecta a tol procesu del proxy. Si Minecraft escucha en delles direiciones, comprueba nel rexistru d'arranque cuálos son les direiciones y los puertos reales de RakNet antes d'añedir riegles al cortafueos. Reinicia BungeeCord en camudando l'argumentu.

Calten la autenticación de cuentes nel proxy. Pa los sirvidores de xuegu Spigot, la guía de reunvíu de direiciones IP de BungeeCord combina ip_forward: true nel proxy con settings.bungeecord: true nel sirvidor de xuegu. El reunvíu por sí solo nun torga que daquién se conecte directamente al sirvidor de xuegu. Acuta l'accesu según les instrucciones del cortafueos.

Escoyer la direición que van usar los xugadores

Dambos proxys almiten puertos de 1 a 65534 nesti axuste. Los valores non válidos ignórense, asina que comprueba nel rexistru d'arranque qué puertu UDP abrióse. Pa volver usar el númberu de puertu d'escucha de Minecraft, quita l'argumentu y reinicia el proxy.

Los xugadores conéctense al nome de equipu públicu y al puertu UDP del proxy, por casu raknet;play.example.com:25570. Si un enrutador camuda'l númberu de puertu, usa'l so puertu UDP públicu na direición del cliente. Les direiciones ensin el prefixu raknet; siguen usando'l puertu d'escucha TCP del proxy.

Asigna puertos UDP distintos a Query, Geyser y los otros servicios UDP. Camudar un puertu TCP nun resuelve un conflictu entre sockets UDP.

Simple Voice Chat y otros relés UDP

Simple Voice Chat usa'l so propiu complementu de proxy y el so propiu puertu UDP en Velocity y BungeeCord. Consulta la guía de Simple Voice Chat pa proxys pa configuralos.

Si hai un relé UDP delantre del proxy Minecraft qu'unvia cabeceres del protocolu PROXY v2, configura Raknetify2 según la guía de reunvíu UDP y protocolu PROXY. Instalar Velocity o BungeeCord ensin ese relé nun rique esta configuración.

Comprobar la conexón

Fexe una prueba dende fora de la to rede local con un cliente Raknetify2. Entra al traviés del proxy, camuda ente los sirvidores de xuegu qu'uses y verifica que se caltienen la identidá y los permisos del xugador.

  • Si TCP funciona al traviés del proxy pero s'escosa'l tiempu d'espera de RakNet, comprueba'l puertu d'escucha UDP del proxy, el puertu públicu, les rutes IPv4 y IPv6 y les riegles del cortafueos.
  • Si dambos tresportes fallen cuando'l proxy se conecta a un sirvidor de xuegu, comprueba la direición TCP, les riegles d'accesu y la configuración de reunvíu d'información de los xugadores nesi sirvidor.
  • Si'l proxy indica que'l puertu UDP ta ocupáu, comprueba si lu usa Query, Geyser, un proxy de voz o otru procesu.

Al informar d'un problema, inclúi rexistros del proxy y del sirvidor de xuegu que correspuendan al mesmu intentu de conexón. En Solución de problemes indíquense les versiones que tienes d'especificar.

Configuración del cortafueos y del enrutador

Esta guía va dirixida a quien alministren sirvidores. Raknetify2 precisa una ruta UDP operativa hasta'l sirvidor o proxy qu'acepte les conexones RakNet. De forma predeterminada usa'l mesmu númberu de puertu que Minecraft en TCP.

Si los xugadores tán na mesma rede local, usa la direición local del sirvidor y dexa UDP nel cortafueos d'esa máquina. Precises redirixir puertos nel enrutador cuando'l tráficu d'Internet tien que travesar el so NAT IPv4.

Escoyer el destín y el puertu

Sirvidor directu

Dirixe'l tráficu UDP públicu a la máquina qu'executa'l sirvidor Minecraft con Raknetify2. Usa como destino'l puertu d'escucha UDP de RakNet nesi sirvidor y déxalo nel cortafueos de la máquina. Caltien la ruta TCP esistente pa les conexones normales de Minecraft.

Por casu, si Raknetify2 escucha nel puertu UDP 25570, redirixe'l puertu UDP públicu a la direición local del sirvidor nel puertu 25570. El puertu TCP del sirvidor puede siguir siendo 25565. Pa escoyer otru puertu UDP, consulta la configuración d'escucha del sirvidor directu.

Velocity o BungeeCord

Dirixe'l tráficu UDP públicu a la máquina qu'executa Velocity o BungeeCord col complementu Raknetify2. Utiliza como destín de la redireición el puertu d'escucha UDP de RakNet nel proxy. Caltien la ruta TCP pública que yá usa'l proxy pa les conexones normales de Minecraft.

El proxy conéctase a los sirvidores de xuegu Minecraft por aciu TCP. Instalar Raknetify2 nel proxy nun rique abrir a los xugadores los puertos UDP de los sirvidores de xuegu.

Conexón Accesu que se debe dexar
De los xugadores al proxy UDP públicu al puertu d'escucha de RakNet, amás del puertu d'escucha TCP públicu esistente
Del proxy a los sirvidores de xuegu Puertos TCP de Minecraft de los sirvidores de xuegu, accesibles namá dende les máquines qu'executen los proxys previstos
De los xugadores directamente a los puertos de los sirvidores de xuegu Caltener bloquiáu esti accesu, tamién por IPv6

Si'l proxy y los sirvidores de xuegu execútense directamente nuna máquina dedicada qu'alministres, puedes faer que los sirvidores de xuegu escuchen en direiciones de bucle local y configurar el proxy por que se conecte a elles. Si tán en máquines distintes, utiliza un cortafueos o una rede privada aisllada por que solo los proxys puedan aportar por TCP a los sirvidores de xuegu. Los contenedores y los agospiamientos xestionaos precisen restricciones equivalentes afeches a la so rede. Consulta la guía de seguridá de los sirvidores de xuegu de Velocity y la guía del cortafueos de BungeeCord.

El reunvíu d'información de los xugadores y el cortafueos compleméntense. Si puede aportase directamente al sirvidor de xuegu, ye posible saltase los controles d'entamu de sesión del proxy. Pa instalar el complementu, configurar el reunvíu o camudar el puertu UDP, consulta Velocity y BungeeCord.

Númberos de puertu públicos y locales

Si'l enrutador traduz los puertos, el puertu públicu pue ser distintu del puertu d'escucha:

Axuste Puertu que se debe usar
Direición del sirvidor introducida nel cliente Puertu UDP públicu
Puertu esternu de la riegla de redireición del enrutador Puertu UDP públicu
Puertu internu de la riegla de redireición del enrutador Puertu d'escucha UDP de RakNet
Puertu local nel cortafueos de la máquina Puertu d'escucha UDP de RakNet

Redireición de puertos IPv4

P'agospiar un sirvidor detrás d'un enrutador IPv4:

  1. Pescuda la direición IPv4 local de la máquina qu'acepta les conexones RakNet. Usa una reserva DHCP o una direición estática fayadiza por que la riegla de redireición siga apuntando a esa máquina.
  2. Añede una riegla de redireición UDP pal puertu públicu que van usar los xugadores.
  3. Nel destín de la riegla, indica la direición local d'esa máquina y el puertu d'escucha UDP de RakNet.
  4. Nel cortafueos de la máquina, dexa'l tráficu UDP entrante nel puertu d'escucha.

Por casu, si'l sirvidor escucha nel puertu UDP 25565, la riegla puede usar el puertu públicu 25565, la direición de destín 192.168.1.100 y el puertu de destín 25565. Sustitúi la direición d'exemplu pola direición local real del to sirvidor.

Caltien la riegla TCP esistente pa les conexones normales de Minecraft. Una riegla que solo redirixe TCP nun tresmite UDP.

Si la redireición sigue ensin funcionar

Comprueba si otru enrutador o'l to provisor d'Internet fai NAT primero que'l tráficu llegue al to enrutador. Si alministres dos enrutadores en serie, configura la redireición en dambos. Si'l to provisor usa NAT compartíu ente clientes (CGNAT), pregúnta-y si puede date una direición IPv4 pública o usa un agospiamientu o túnel qu'almita UDP entrante. Les riegles de el to enrutador nun configuren el NAT del provisor. La guía de redireición de puertos de TP-Link esplica'l requisitu d'una direición pública na interfaz WAN.

Riegles del cortafueos IPv6

Dexa'l puertu UDP escoyíu tanto nel cortafueos IPv6 del enrutador como nel de la máquina. Usa como destino la direición IPv6 de la máquina qu'acepta les conexones RakNet.

Comprueba que la direición IPv6 asociada al nome de equipu apunta a esa máquina. Si la so direición IPv6 camuda, actualiza'l rexistru DNS y cualesquier riegla del cortafueos qu'especifique la direición antigua.

Si un nome de equipu publica direiciones IPv4 y IPv6, cada direición anunciada precisa una ruta que funcione. Si un xugador consigue entrar y otru non, comprueba les riegles de dambos protocolos.

Si la redireición IPv4 camuda'l númberu de puertu, asegúrate de que'l puertu introducíu polos xugadores tamién llega al serviciu qu'escucha en IPv6. La traducción de puertos IPv4 nun configura la ruta IPv6.

Provisores d'agospiamientu y túneles

El provisor o'l túnel tien qu'almitir UDP na direición y el puertu públicos que comuniques a los xugadores. Comprueba los puertos asignaos y les riegles del so cortafueos de rede, amás del cortafueos del sirvidor.

Si un proxy UDP adicional reunvia les direiciones de los clientes por aciu el protocolu PROXY v2, sigue la guía de reunvíu UDP y protocolu PROXY y llinda l'accesu al puertu d'escucha UDP de destín al proxy d'enfotu.

Comprobar la conexón

Conéctate dende fora de la rede local del sirvidor con un cliente Raknetify2 actualizáu usando una direición como raknet;play.example.com:25565. Indica nella'l puertu UDP públicu.

Comprueba la ruta con una conexón RakNet real. Un escanio UDP que nun recibe respuesta puede dar una resultancia indeterminada, una y bones un serviciu operativu puede refugar una sonda que nun reconoz. La documentación de Nmap sobre escanio UDP esplica esti comportamientu.

Una conexón TCP correcta solo confirma que funciona la ruta TCP. Si s'escosa'l tiempu d'espera de RakNet, comprueba'l puertu d'escucha, el destín de la redireición, el puertu UDP y les riegles del cortafueos cola guía de solución de problemes.

Compatibilidá

Comprueba la compatibilidá de la versión concreta que descargues. La caña de desenvolvimientu puede incluyir funciones qu'inda nun formen parte de nenguna versión publicada.

Versiones de Minecraft y de Java

Versiones de Minecraft y de Java · English

La versión de Java qu'indica Raknetify2 ye'l mínimu que precisa'l mod. Minecraft o'l cargador pueden riquir una versión más recién. Escueye una versión de Java que cumpla los trés requisitos.

Versiones del cliente y del sirvidor

Siempres que puedas, usa la mesma versión de Raknetify2 nel cliente y nel sirvidor o proxy que recibe la conexón. Consulta les notes de la versión antes de combinar versiones distintes. Pa cifrar una conexón RakNet, dambos estremos tienen d'almitir el protocolu de cifráu autenticáu. El Raknetify orixinal y les versiones de Raknetify2 anteriores a la introducción d'esi protocolu nun pueden establecer estes conexones cifraes con instalaciones actualizaes.

Raknetify2 tresporta'l protocolu de xuegu de Minecraft. Pa conectar versiones distintes de Minecraft fai falta un sistema compatible de traducción de protocolos.

Otros mods

Otros mods · English

Si tienes problemes nun paquete de mods más grande, sigue la guía de solución de problemes. Indica nel informe les versiones esactes de toos los mods.

Mou ordenáu

Mou ordenáu

De normal les canales de paquetes de Raknetify2 son independientes: cuando una canal espera datos perdíos, los demás pueden siguir avanzando. En mou ordenáu tolos paquetes de Minecraft viaxen por un únicu canal. Si se pierde un paquete, tolos posteriores que viaxen nel mesmu sentíu esperen a que se retresmita. Esto caltien l'orde qu'esperen dellos sistemes antitrampes, a cuenta de que'l tráficu de xuegu ensin rellacionar tamién tenga qu'esperar.

Activar el mou ordenáu

  1. Instala una versión de Raknetify2 qu'almita el mou ordenáu nel sirvidor o proxy qu'acepta les conexones RakNet y en cada cliente RakNet.

  2. Nel directoriu de trabayu d'esi sirvidor o proxy, crea l'ficheru config/raknetify2-compatibility.json. Si'l directoriu config nun esiste, créalu.

  3. Añede esti conteníu:

    {"mode": "ordered"}
  4. Reinicia'l sirvidor o'l proxy.

Los clientes adopten l'axuste del sirvidor automáticamente. Los xugadores nun precisen crear un ficheru de configuración nin camudar la direición RakNet del sirvidor.

Tolos paquetes de Minecraft, incluyíos los allindiadores de grupos de paquetes y los cambeos de mundu, usen una única canal fiable y ordenáu en cada sentíu.

Instalaciones con proxy

Si los xugadores conéctense al traviés de Velocity o BungeeCord, configura el mou ordenáu nesi proxy, anque'l sistema antitrampes s'execute nun sirvidor de xuegu.

L'axuste sigue aplicándose al camudar de sirvidor de xuegu. En mou ordenáu, el proxy reunvia les solicitúes de caltenimientu de conexón del sirvidor de xuegu al cliente del xugador en llugar de respondeles él mesmu.

Comprobar l'axuste

Na primer conexón RakNet, la consola amuesa:

Raknetify2 compatibility: ordered (updated clients required, genuine acknowledgements)

Si dambos estremos axusten correchamente la manera de compatibilidá, nel rexistru tamién apaez ordered compatibility negotiated, siguíu de la direición del otru estremu.

Calten activaos los controles antitrampes y prueba la to propia configuración.

Veceros antiguos

Los clientes RakNet que nun almiten el mou ordenáu nun pueden conectase a un sirvidor que lu esixa. Actualiza Raknetify2 nesos clientes o conéctate a la direición y el puertu TCP habituales del sirvidor o del proxy ensin el prefixu raknet;.

Volver al mou multicanal

Sustitúi'l conteníu del ficheru por:

{"mode": "multichannel"}

Dempués, reinicia'l sirvidor o'l proxy. Tamién puedes esaniciar l'ficheru y reiniciar pa restablecer el mou multicanal.

Problemes de configuración

L'ficheru tien de contener un únicu axuste llamáu mode, col valor "ordered" o "multichannel". Los valores estremen ente mayúscules y minúscules.

Si la configuración nun ye válida o non puede lleese, refúguense les conexones RakNet. Corrixe l'ficheru y reinicia el procesu.

Si la consola sigue indicando multichannel, comprueba que l'ficheru tea sol directoriu de trabayu del sirvidor o proxy que recibe la conexón RakNet. Dempués, reinicia esi procesu.

Tresferencies automátiques

Los sirvidores Fabric, Forge y NeoForge pueden escoyer RakNet al tresferir un cliente compatible a un destín configuráu. Pa ello utilicen les tresferencies que Minecraft incorpora dende Java Edition 1.20.5. Comprueba que la to versión de Raknetify2 sía compatible cola versión de Minecraft y el cargador de cada estremu.

Instala Raknetify2 nel sirvidor qu'unvia la tresferencia y nel cliente. El destín tien d'escuchar conexones RakNet compatibles y aceptar tresferencies entrantes de Minecraft.

Esta configuración aplícase a les tresferencies qu'unvien los trés cargadores anteriores. Los complementos de Spigot/Paper, Velocity y BungeeCord nun lleen esti ficheru de tresferencies.

Configurar el sirvidor d'orixe

Nel directoriu del sirvidor d'orixe, crea l'ficheru config/raknetify2-transfers.json:

{
  "destinations": [
    {
      "host": "play.example.com",
      "tcpPort": 25565,
      "udpPort": 25570
    }
  ]
}

Sustitúi'l nome de equipu y los puertos del exemplu polos del to destín. Dempués, reinicia'l sirvidor d'orixe. Si tienes más destinos, amiéstalos a la mesma llista.

Campu Significáu
host Nome de equipu o direición IP de destín, ensin prefixu de tresporte nin puertu
tcpPort Puertu de destín de la solicitú de tresferencia orixinal
udpPort Puertu RakNet públicu al que tien de conectase'l cliente tresferíu

Los númberos de puertu TCP y UDP pueden coincidir. Si un enrutador camuda'l númberu de puertu UDP, indica'l puertu públicu nesti ficheru. Escribe los puertos como númberos JSON.

Unvia les solicitúes de tresferencia al nome de equipu y al puertu TCP habituales del destín. Raknetify2 comprueba si'l cliente anuncia qu'almite tresferencies automátiques. Si les almite y el destín coincide con una entrada, escueye'l puertu UDP configuráu. Pa los otros clientes o destinos, caltiense la direición de tresferencia orixinal.

La comparanza utiliza'l nome de equipu y el puertu TCP de la solicitú. Al comparar nomes de equipu, ignórense les diferencies ente mayúscules y minúscules y el puntu DNS final. Tamién se normalicen les formes equivalentes d'escribir una direición IPv6. Nun se realicen consultes DNS. Dos nomes que se resuelven a la mesma direición precisen entraes independientes. Nun s'almiten comodinos.

Configurar el destín

Si'l destín usa l'ficheru server.properties de Minecraft, establez accepts-transfers=true y reinícialo. Si ye un proxy, puede tener un axuste de tresferencies propiu. De forma predeterminada Minecraft refuga les tresferencies entrantes anque pueda entrase directamente nel sirvidor.

El puertu d'escucha RakNet del destín, la redireición UDP pública y el cortafueos de la máquina tienen de tar configuraos de mano. L'ficheru de tresferencies del sirvidor d'orixe determina qué direición s'unvia al cliente.

Si'l nome de equipu del destín publica direiciones IPv4 y IPv6, comprueba dambes rutes. Antes d'investigar problemes cola tresferencia automática, prueba una conexón RakNet directa al destín.

Calten los controles d'accesu y entamu de sesión del destín. Esta configuración nun da accesu a los xugadores nin sustitúi la autenticación del sirvidor.

Erros de configuración y desactivación

Si falta un campu, hai campos desconocíos, puertos non válidos o destinos duplicaos, produzse un erru de configuración al empecipiase'l sirvidor. Consulta'l rexistru pa identificar l'erru, corrixe'l JSON y reinicia.

Pa desactivar la selección automática, esanicia l'ficheru de configuración o usa {"destinations": []}. Dempués, reinicia'l sirvidor d'orixe. Les sos solicitúes de tresferencia van caltener les direiciones orixinales.

Reunvíu UDP y protocolu PROXY

Un proxy UDP puede reunviar el tráficu RakNet y caltener la direición orixinal del cliente por aciu el protocolu PROXY v2. Activa esta función si un proxy UDP asitiáu antes del to sirvidor unvia eses cabeceres al puertu d'escucha. Para una redireición de puertos normal nel enrutador nun fai falta activala.

Nel sirvidor o proxy Minecraft que recibe'l tráficu UDP reunviáu, crea l'ficheru config/raknetify2-proxy-protocol.json:

{
  "trustedProxies": ["192.0.2.10"]
}

Sustitúi l'exemplu pola direición IP d'orixe real del proxy UDP o por un intervalu CIDR que controles. La direición tien de coincidir cola que ve'l serviciu receptor dempués de cualesquier NAT entemediu. Almítense direiciones IPv4 y IPv6 escrites directamente. Los nomes de equipu DNS refúguense. Reinicia'l sirvidor o proxy receptor.

Configura'l proxy que reunvia el tráficu por qu'unvie cabeceres del protocolu PROXY v2 para UDP. Raknetify2 solo acepta direiciones de clientes tresmitíes polos oríxenes de la llista. Mientres esta configuración tea activa, refúguense les conexones RakNet directes que nun incluyan eses cabeceres. La configuración d'escucha TCP caltiense.

Enfotu y control d'accesu

Cada proxy de la llista ta autorizáu a indicar les direiciones de los clientes. Acuta l'accesu al puertu UDP de destín nel so cortafueos por que solo pueda llegar el proxy previstu. Llinda los intervalos de direiciones d'enfotu tanto como dexe la to rede.

L'ficheru tien de contener namá trustedProxies con siquier una entrada. Una llista vacida produz un erru. Si l'ficheru nun ye válidu, RakNet nun puede abrir el so puertu d'escucha.

Pa volver a les conexones UDP directes, esanicia l'ficheru y reinicia el serviciu d'escucha. Actualiza tamién el reunvíu del proxy anterior y les riegles del cortafueos pa la nueva ruta.

Si les conexones fallen dempués d'activar esta función, comprueba la direición d'orixe real del proxy tal como lu ve'l sirvidor de destín, l'intervalu d'enfotu configuráu y si el proxy unvia cabeceres PROXY v2 para UDP.

Pa instalar un proxy Minecraft y configurar los sirvidores de xuegu, consulta Velocity y BungeeCord.

Simple Voice Chat

Raknetify2 puede compartir el so puertu d'escucha UDP con Simple Voice Chat en sirvidores Fabric, Forge, NeoForge, Spigot y Paper.

Instala Simple Voice Chat nel sirvidor y nos clientes que vaigan usar el charra de voz. Pal restu de los axustes, consulta'l so guía de configuración del sirvidor.

Asitia l'ficheru de Raknetify2 nel directoriu config asitiáu nel raigañu del sirvidor, tamién en Spigot/Paper. L'ficheru de Simple Voice Chat permanez nel allugamientu que correspuenda a la to plataforma, como s'indica de siguío.

Compartir el puertu de xuegu

  1. Nel directoriu del sirvidor, crea l'ficheru config/raknetify2-voicechat.json con esti conteníu:

    {"enabled": true}
  2. Establez port=-1 na configuración de sirvidor de Simple Voice Chat. En sirvidores con mods, l'ficheru ye config/voicechat/voicechat-server.properties. En Spigot/Paper ye plugins/voicechat/voicechat-server.properties.

  3. Dexa vacíu bind_address si hai un únicu serviciu d'escucha RakNet que coincida. Si'l sirvidor escucha en delles direiciones nesi puertu UDP, indica la direición local que quies compartir.

  4. Reinicia'l sirvidor y executa /voicechat test <PLAYERNAME> pa un xugador conectáu.

Si RakNet escucha nun puertu distintu del de Minecraft, indica esi puertu UDP local nel axuste de voz port en llugar d'usar -1. Por casu, si RakNet escucha nel puertu UDP local 25570, usa port=25570.

Configura voice_host cuando'l cliente precise una direición o un puertu públicu distintu. Si'l enrutador redirixe'l puertu UDP públicu 25580 al puertu UDP local 25570, usa port=25570 y voice_host=play.example.com:25580. La direición pública va en voice_host. L'axuste bind_address escueye la direición local d'escucha.

Raknetify2 apurre'l socket UDP compartíu por aciu la API de Simple Voice Chat. Simple Voice Chat ocúpase de la autenticación y el cifráu de la voz. Los xugadores pueden usar el charra de voz tanto si xueguen al traviés de TCP como si lo faen al traviés de RakNet.

Otros servicios UDP y proxys

Acuta puertos UDP distintos para Query y Geyser. La integración de socket compartíu solo almite Simple Voice Chat.

La integración nun comparte'l socket del proxy de voz en Velocity nin en BungeeCord. Sigue la guía de configuración del proxy de Simple Voice Chat y asigna al proxy de voz el so propiu puertu UDP. Col complementu oficial del proxy de voz, cualesquier valor públicu de voice_host que quieras afitar tien de dir na configuración de voz del proxy. El complementu ignora los axustes de voice_host de los sirvidores de xuegu.

Si utilices un túnel UDP xenéricu, indica en voice_host el nome de equipu y el puertu UDP públicos que conducen a esti sirvidor.

Desactivar l'usu compartíu o resolver un conflictu de sockets

Si'l rexistru amuesa No RakNet listener matches the voice bind address and port, comprueba que RakNet arrincara correchamente y que'l puertu y la direición d'escucha del serviciu de voz coincidan colos de RakNet nesa máquina.

Si apaez Multiple RakNet listeners match the voice bind address, escueye una de les direiciones locales coincidentes en bind_address y reinicia.

Solo un complementu de Simple Voice Chat puede apurrir el socket UDP. Si al arrincar indícase qu'otru complementu yá lo apurre, escueye cuál de les dos integraciones quies usar.

Pa desactivar la integración de Raknetify2, establez {"enabled": false} nel so ficheru de configuración de voz o esanicia l'ficheru. Asigna a Simple Voice Chat otru puertu UDP, actualiza les riegles del cortafueos o de redireición y reinicia el sirvidor.

Solución de problemes

TCP funciona, pero s'escosa'l tiempu d'espera de RakNet

Comprueba estos puntos n'orde:

  1. El cliente tien el mod Raknetify2 fayadizu pal so cargador y la so versión de Minecraft.
  2. Raknetify2 ta instaláu nel sirvidor o proxy qu'acepta la conexón y empecipióse ensin erros al abrir el puertu d'escucha.
  3. La direición empieza por raknet; y usa el puertu UDP públicu.
  4. El provisor d'agospiamientu, el enrutador y el cortafueos de la máquina dexen UDP nesi puertu.
  5. Les direiciones IPv4 y IPv6 del nome de equipu apunten a la máquina prevista y les sos riegles de cortafueos dexen l'accesu.

Una conexón TCP correcta solo confirma que funciona la ruta TCP. Consulta la configuración del cortafueos y del enrutador pa comprobar la redireición UDP y l'accesu IPv6. Si ta activáu'l protocolu PROXY, los clientes tienen de llegar al puertu d'escucha al traviés d'un proxy configuráu como d'enfotu.

Direición n'usu

Comprueba si otru procesu usa'l puertu UDP. Query, Geyser y los otros servicios UDP precisen los sos propios puertos. Simple Voice Chat almite'l usu compartíu del puertu.

Puedes escoyer otru puertu UDP local na configuración d'escucha del sirvidor directu o na configuración de Velocity y BungeeCord. Comprueba qué versión de Spigot/Paper rique esti axuste. Camudar namá'l puertu públicu del enrutador nun resuelve un conflictu de sockets na máquina.

Puede entrase directamente, pero les tresferencies fallen

Conéctate directamente al destín usando la so direición col prefixu raknet;. Si la conexón falla, corrixe primero'l serviciu d'escucha de destín o la ruta de rede.

Si les conexones directes funcionen, comprueba que'l destín acepte tresferencies entrantes. Un sirvidor Minecraft qu'utiliza server.properties precisa l'axuste accepts-transfers=true. Una conexón directa nun pon a prueba esi axuste.

Dempués compara'l nome de equipu y el puertu TCP de la tresferencia colos de config/raknetify2-transfers.json nel sirvidor d'orixe. Comprueba que l'ficheru cargárase en reiniciando y que'l cliente almita tresferencies RakNet automátiques. Consulta Tresferencies automátiques.

Erros de cifráu o de protocolu

Comprueba les versiones de Raknetify2 en dambos estremos de la conexón. Cuando una versión camude'l protocolu cifráu, actualiza al empar el cliente y el sirvidor o proxy. Calten la configuración de autenticación del sirvidor mientres investigues el problema.

Fallos rellacionaos con un mod

Anota qué acción provoca'l fallu, por casu abrir un inventariu, recibir un paquete de recursos, camudar de mundu o xenerar una entidá. Cuando sía posible, repite la mesma acción nuna instalación de prueba estreme y compara les resultancies con TCP y RakNet.

Dellos mensaxes personalizaos dependen del orde de los paquetes de Minecraft. Los autores de mods pueden declarar estes dependencies por aciu la interfaz d'ordenación de paquetes.

Informar de fallos

Abre una incidencia nel rexistru d'incidencies de Raknetify2 ya inclúi:

  • Les versiones de Minecraft, Java, el cargador de mods y Raknetify2 en dambos estremos.
  • Les versiones del software del sirvidor y del proxy, incluyíu cualesquier proxy de reunvíu UDP.
  • Los demás mods instalaos y les sos versiones.
  • Los pasos pa reproducir el problema y la resultancia qu'esperabes.
  • Si los mesmos pasos funcionen con TCP.
  • Estractos pertinentes de los rexistros del cliente, del sirvidor y del proxy correspondientes al mesmu intentu.

Antes de xubir los rexistros, esanicia los tokens d'accesu, contraseñes y otra información privada. Caltien los mensaxes d'esceición y les traces de pila necesarios pa diagnosticar el problema.

Integración con otros mods

Con Raknetify2, los mods pueden indicar qué paquetes de Minecraft tienen de caltener el so orde respeuto a los sos mensaxes personalizaos. Utiliza esta función si pa procesar un mensaxe ye necesariu que paquetes anteriores crearen una entidá o un chunk, preparáu un inventariu o establecíu dalgún otru estáu del xuegu.

Grupos d'ordenación

Grupu Tráficu rellacionáu
ui Menúes ya interacciones independientes del mundu
entity Apaición, eliminación y movimientu d'entidaes
world_interaction Inventarios y otres interacciones que dependen del mundu
effects Soníos y partícules
chunk Actualizaciones del terrén, los bloques y el llume

Cada grupu caltien una entrega fiable y ordenada dientro de la so canal. Los paquetes de grupos distintos pueden llegar n'otru orde relativu. Escueye'l grupu que correspuenda a los datos de los que dependa'l to mensaxe.

Integración opcional con Fabric

Declara un provisor nel puntu d'entrada raknetify:packet_channels del ficheru fabric.mod.json del to mod. El provisor implementa Consumer<BiConsumer<String, String>> con tipos del JDK. Recibe una función de rexistru qu'acepta l'identificador d'un mensaxe personalizáu y un grupu d'ordenación.

Integra esta entrada nes tos metadatos actuales. Sustitúi'l nome de la clase pol nome completu de la clase del to provisor, incluyíu'l paquete:

{
  "entrypoints": {
    "raknetify:packet_channels": [
      "com.example.mod.OrderingProvider"
    ]
  }
}

Caltien el restu del ficheru fabric.mod.json, incluyíos los puntos d'entrada esistentes. L'exemplu amuesa solo un fragmentu de los metadatos.

Por casu, una estensión que xestione'l movimientu d'entidaes puede rexistrar example:entity_path nel grupu entity. La documentación de la API PacketOrdering incluyi la implementación del provisor.

Si Raknetify2 nun ta instaláu, Fabric nun invoca esti puntu d'entrada. Los provisores tienen de declarar los identificadores y los grupos mientres la inicialización, ensin depender de qu'otru mod yá terminara de aniciase.

Funcionamientu del rexistru

Los mods de Forge y NeoForge y los complementos de sirvidor o de proxy pueden llamar a PacketOrdering.register(identifier, group) mientres la inicialización cuando Raknetify2 tea disponible. La clase ye com.ishland.raknetify.api.PacketOrdering. Rexistra les declaraciones antes d'aceptar conexones de xugadores. Si la integración ye opcional, evita qu'el so códigu cargue clases de Raknetify2 cuando falte esa dependencia.

Les declaraciones aplíquense a les conexones nueves. Les conexones esistentes caltienen les riegles que recibieron al establecese. Déxase repitir una declaración idéntica. Non puede asignase un mesmu identificador a grupos distintos.

Los identificadores de mensaxes tienen d'usar un espaciu de nomes personalizáu válidu. L'espaciu de nomes minecraft ta reserváu. La llende de cada estremu ye de 128 declaraciones en total, incluyíes les riegles integraes y los rexistros d'otros mods. Los identificadores almiten hasta 255 calteres ASCII y tienen de siguir la sintaxis d'identificadores con espaciu de nomes de la API.

Los estremos RakNet actualizaos intercambien les sos declaraciones al establecer la conexón. Si un sirvidor o proxy nun tien una riegla local pa un mensaxe, puede usar la declaración del otru estremu. Les riegles locales tienen prioridá y les declaraciones recibíes solo aplíquense a esa conexón.

Proxys UDP

Pa los relés UDP y el reunvíu de direiciones de clientes, consulta Reunvíu UDP y protocolu PROXY.

Pa configurar un proxy de Minecraft, consulta Velocity y BungeeCord.

English (US)

Clone this wiki locally