Repository navigation
Wiki ast es
- Entamu
- Instalación
- Velocity y BungeeCord
- Configuración del cortafueos y del enrutador
- Compatibilidá
- Mou ordenáu
- Tresferencies automátiques
- Reunvíu UDP y protocolu PROXY
- Simple Voice Chat
- Solución de problemes
- Integración con otros mods
- Proxys UDP
Conexones de rede con RakNet pa veceros y sirvidores de Minecraft.
| 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 |
-
Multixugador
-
Amestar sirvidor
-
Direición del sirvidor
Direición del sirvidor RakNet · UDP raknet;play.example.com:25565TCP play.example.com:25565 -
Fecho
-
Xunise al sirvidor
| F3 | |
|---|---|
| RakNet · UDP | Activu · MTU 1400 |
| TCP | Inactivu |
- Veceru · Raknetify2 → UDP → Velocity / BungeeCord · Raknetify2
- 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 |
| 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 |
Sirvidor / Velocity / BungeeCord
| JSON | |
|---|---|
| ① ② ③ | {"mode":"ordered"} |
| ① ∥ ② ∥ ③ | {"mode":"multichannel"} |
| 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
| 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"]}-
Sirvidor A · Fabric / Forge / NeoForge ·
config/raknetify2-transfers.json{"destinations":[{"host":"play.example.com","tcpPort":25565,"udpPort":25570}]} -
Sirvidor B ·
play.example.com·server.properties→accepts-transfers=true -
Sirvidor A ·
/transfer play.example.com 25565 Alex→ Veceru (Alex) → RakNet ·play.example.com:25570
| Minecraft | |
|---|---|
ui |
Opciones |
entity |
Cadarma |
world_interaction |
Inventario |
effects |
Partícules |
chunk |
Bloques |
- Fabric · Minecraft / Java · English
- Forge / NeoForge / Spigot / Paper · GitHub Releases
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á.
- Comprueba la compatibilidá de Minecraft y de los mods.
- Escueyi qué ficheru descargar ya instálalo.
- Conéctate con una direición como
raknet;play.example.com.
- Velocity y BungeeCord
- Configuración del cortafueos y del enrutador
- Tresferencies automátiques
- Reunvíu UDP y protocolu PROXY
- Compartir un puertu UDP con Simple Voice Chat
- Solución de problemes ya informes d'erros
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.
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.
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.
- Instala'l mod de cliente correspondiente al to cargador de mods.
- Instala'l mod de sirvidor correspondiente o, si tienes un sirvidor compatible, el complementu de Spigot/Paper.
- Sigue la guía de configuración del cortafueos y del enrutador pa dexar les conexones UDP al sirvidor.
- Reinicia'l cliente y el sirvidor.
- Escueye «Amestar sirvidor» ya introduz una direición como
raknet;play.example.comoraknet;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.
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.
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.
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 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.
- Comprueba que les conexones TCP normales al traviés del proxy funcionen, incluyida la autenticación y el cambéu ente sirvidores de xuegu.
- Deten el proxy y descarga el complementu correspondiente dende la páxina de versiones en GitHub.
- Asitia
raknetify2-velocity-*-all.jaroraknetify2-bungee-*-all.jarna carpetapluginsdel proxy. Retira d'esa carpeta cualesquier versión anterior del complementu Raknetify o Raknetify2. - Instala'l mod de Raknetify2 fayadizu pal cliente según la guía d'instalación.
- 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.
- 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.
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.
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.
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 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.
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.
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.
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.
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.
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 |
P'agospiar un sirvidor detrás d'un enrutador IPv4:
- 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.
- Añede una riegla de redireición UDP pal puertu públicu que van usar los xugadores.
- Nel destín de la riegla, indica la direición local d'esa máquina y el puertu d'escucha UDP de RakNet.
- 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.
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.
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.
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.
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.
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 · 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.
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.
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.
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.
-
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.
-
Nel directoriu de trabayu d'esi sirvidor o proxy, crea l'ficheru
config/raknetify2-compatibility.json. Si'l directoriuconfignun esiste, créalu. -
Añede esti conteníu:
{"mode": "ordered"} -
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.
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.
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.
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;.
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.
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.
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.
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.
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.
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.
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.
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.
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.
-
Nel directoriu del sirvidor, crea l'ficheru
config/raknetify2-voicechat.jsoncon esti conteníu:{"enabled": true} -
Establez
port=-1na configuración de sirvidor de Simple Voice Chat. En sirvidores con mods, l'ficheru yeconfig/voicechat/voicechat-server.properties. En Spigot/Paper yeplugins/voicechat/voicechat-server.properties. -
Dexa vacíu
bind_addresssi 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. -
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.
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.
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.
Comprueba estos puntos n'orde:
- El cliente tien el mod Raknetify2 fayadizu pal so cargador y la so versión de Minecraft.
- Raknetify2 ta instaláu nel sirvidor o proxy qu'acepta la conexón y empecipióse ensin erros al abrir el puertu d'escucha.
- La direición empieza por
raknet;y usa el puertu UDP públicu. - El provisor d'agospiamientu, el enrutador y el cortafueos de la máquina dexen UDP nesi puertu.
- 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.
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.
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.
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.
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.
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.
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.
| 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.
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.
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.
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.