Wiki oc fr

Raknetify2 · Occitan (Occitània)

Lenga

• Acuèlh
• Installacion
• Velocity e BungeeCord
• Configuracion del parafuòc e del rotador
• Compatibilitat
• Mòde ordenat
• Transferiments automatics
• Redireccion UDP e protocòl PROXY
• Simple Voice Chat
• Resolucion de problèmas
• Integracion amb d'autres mods
• Servidors mandataris UDP

Multijogaire

Connexions de ret amb RakNet pels clients e servidors de Minecraft.

Telecargar · GitHub

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

Servidor nòu

1. Multijogaire

2. Servidor nòu

3. Adreça del servidor

   	Adreça del servidor
   RakNet · UDP	raknet;play.example.com:25565
   TCP	play.example.com:25565

4. Acabat

5. Rejónher

F3 · Raknetify2

	F3
RakNet · UDP	Actiu · MTU 1400
TCP	Inactiu

Velocity / BungeeCord

1. Client · Raknetify2 → UDP → Velocity / BungeeCord · Raknetify2
2. Velocity / BungeeCord → TCP → Servidor

	Numerò del pòrt · 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

Temps d'espèra passat

Adreça del servidor	UDP
raknet;play.example.com:25580	play.example.com:25580 → NAT → 192.0.2.10:25570
Servidor · 192.0.2.10	25570/udp

config/raknetify2-compatibility.json

Servidor / Velocity / BungeeCord

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

Simple Voice Chat

Servidor	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

Adreça del servidor	trustedProxies	RakNet
192.0.2.10 · PROXY v2 / UDP	["192.0.2.10"]	✓
192.0.2.11 · PROXY v2 / UDP	["192.0.2.10"]	✗
Client → RakNet / UDP	["192.0.2.10"]	✗

config/raknetify2-proxy-protocol.json

{"trustedProxies":["192.0.2.10"]}

Minecraft ≥ 1.20.5 · /transfer

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

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

2. Servidor B · play.example.com · server.properties → accepts-transfers=true

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

PacketOrdering

	Minecraft
ui	Opcions
entity	Esqueleta
world_interaction	Inventari
effects	Particulas
chunk	Blòcs

PacketOrdering.java

Version incompatibla!

• Fabric · compatibility.json · gameVersions / runtimes / depends
• Forge / NeoForge / Spigot / Paper · GitHub Releases

Senhalar un bug

Acuèlh

Raknetify2

Raknetify2 utiliza RakNet sus UDP pel multijogaire de Minecraft. Despartís las donadas entre mantes canals, cadun amb son pròpri òrdre de liurason. Se se pèrd un paquet, los autres canals pòdon contunhar a transmetre lors donadas. Las interaccions en jòc pòdon aital restar fluidas pendent la retransmission de las donadas mancantas o lo transferiment de tròces.

Raknetify2 es un bifurcacion de Raknetify, creat per ishland. Es mantengut separadament e pren en carga de las versions mai recentas de Minecraft. Sa mantenença cobrís lo transpòrt ret, l'integracion a las diferentas plataformas e los tèstes de compatibilitat.

Primièrs pas

1. Verificar la compatibilitat de Minecraft e de las mods.
2. Causir e installar la version a telecargar.
3. Connectatz-vos amb una adreça coma raknet;play.example.com.

Guidas pels servidors

• Velocity e BungeeCord
• Configuracion del parafuòc e del rotador
• Transferiments automatics
• Redireccion UDP e protocòl PROXY
• Partejar un pòrt UDP amb Simple Voice Chat
• Resolucion de problèmas e senhalament dels bugs

Los autors de mods pòdon utilizar l'interfàcia d'ordonançament dels paquets per declarar las dependéncias entre lors messatges personalizats e lo trafic de Minecraft.

Ligams del projècte

• Telecargaments
• Còdi sorsa
• Seguit dels problèmas
• Verificacions de compilacion e de compatibilitat

Raknetify2 es distribuit jos licéncia MIT e consèrva las mencions de dreches d'autor d'origina. Son jaç ret s'apieja sus Raknetify e netty-raknet.

Installacion

Telecargatz una version dempuèi la pagina de las versions sus GitHub. Abans de l'installar, verificatz la version de Minecraft e lo cargador de mods requerits.

Tipe d'installacion	Fichièr	Dorsièr
Client o servidor Fabric	raknetify2-fabric-*.jar	mods
Client o servidor Forge	raknetify2-forge-*.jar	mods
Client o servidor NeoForge	raknetify2-neoforge-*.jar	mods
Servidor Spigot o Paper	raknetify2-spigot-*.jar	plugins
Servidor mandatari Velocity	raknetify2-velocity-*.jar	plugins
Servidor mandatari BungeeCord	raknetify2-bungee-*.jar	plugins

Barratz lo client o paratz lo servidor abans de remplaçar son fichièr JAR. Retiratz lo JAR del Raknetify d'origina e tot ancian JAR de Raknetify2 d'aquela installacion abans d'i apondre lo nòu fichièr.

Costat client, utilizatz los dorsièrs de l'instància de Minecraft o del paquet de mods que lançatz. Costat servidor o servidor mandatari, utilizatz los dorsièrs de l'installacion correspondenta. Se lo cargador a pas encara creat lo dorsièr necessari, creatz-lo.

Connexion dirècta a un servidor

1. Installatz lo mod client correspondent a vòstre cargador de mods.
2. Installatz lo mod servidor correspondent, o lo modul Spigot/Paper se vòstre servidor o pren en carga.
3. Seguissètz la guida de configuracion del parafuòc e del rotador per autorizar las connexions UDP al servidor.
4. Reaviatz lo client e lo servidor.
5. Causissètz «Servidor nòu» puèi sasissètz una adreça coma raknet;play.example.com o raknet;play.example.com:25565.

Una adreça sens lo prefix raknet; utiliza TCP.

Installar lo mod sus vòstre client sufís pas a activar RakNet sus un servidor distant. L'administrador del servidor i deu configurar un ponch d'accès RakNet. Per rejónher lo servidor de qualqu'un d'autre, avètz generalament cap de redireccion de pòrt dintrant a configurar sus vòstre rotador.

Velocity e BungeeCord

Installatz lo modul correspondent sul servidor mandatari e lo mod sul client. Consultatz la guida Velocity e BungeeCord per configurar l'escota de servidor mandatari, la transmission de las informacions de connexion als servidors de jòc, las restriccions d'accèsses e l'adreça a comunicar als jogaires.

Utilizar un pòrt d'escota UDP distint

Per un servidor Minecraft a lo qual los jogaires se connèctan dirèctament, utilizatz l'argument Java correspondent çai jos. S'administratz un servidor mandatari, consultatz los paramètres d'escota de Velocity e BungeeCord.

Plataforma	Argument Java	Pòrts acceptats
Servidor Fabric, Forge o NeoForge	-Draknetify.fabric.portOverride=25570	De 1 a 65534
Servidor Spigot o Paper	-Draknetify.spigot.portOverride=25570	De 1 a 65535

Forge e NeoForge utilizan lo meteis còdi d'escota que Fabric. Lo nom de lor proprietat conten doncas tant fabric. Remplaçatz 25570 pel pòrt UDP volgut.

Spigot / Paper ≥ 0.1.0-beta.1.431

Apondètz l'argument abans -jar dins l'ordena Java, o dins lo camp dels arguments de la JVM en çò de vòstra albergador. Reaviatz lo servidor e autorizatz UDP sul pòrt causit. Se lo pòrt public es egalament lo 25570, connectatz-vos amb raknet;play.example.com:25570. Se lo rotador modifica lo numèro de pòrt, indicatz lo pòrt public dins l'adreça del servidor costat client. Lo pòrt TCP consèrva sa valor.

Sus Spigot/Paper, RakNet escota en UDP sus la meteissa adreça locala que lo servidor Minecraft en TCP. Una valor incorrècta o un pòrt UDP ja ocupat empedís lo aviada de RakNet. Lo jornal de aviada indica l'adreça e lo pòrt d'escota UDP. Per reütilizar lo numèro de pòrt TCP, suprimissètz l'argument e reaviatz lo servidor.

Un rotador o un servidor mandatari UDP pòt tanben expausar un autre pòrt UDP public e o redirigir cap al pòrt d'escota existent, sens modificar los arguments Java del servidor.

Versions de desvolopament

Dins GitHub Actions, dobrissètz una execucion capitada de la branca main e telecargatz son archiu jos Artifacts. GitHub exigís un compte per telecargar aqueles fichièrs. Lo quadre d'installacion çai sus indica quin JAR causir dins l'archiu.

Velocity e BungeeCord

Velocity e BungeeCord servisson d'intermediaris entre los jogaires e los servidors de jòc Minecraft. Installatz Raknetify2 sul servidor mandatari e sus cada client que utilizarà RakNet.

Client Raknetify2 --UDP--> Velocity o BungeeCord --TCP--> servidor de jòc

Per aquel tipe de connexion, los servidors de jòc pòdon foncionar sens Raknetify2. Devon pasmens dispausar de mods, dels moduls e dels mecanismes de transmission de las informacions de connexion requerits per vòstra ret. Raknetify2 convertís pas los protocòls entre versions de Minecraft e modifica pas la faiçon dont lo servidor mandatari autentifica los comptes.

Installar lo modul sul servidor mandatari

1. Verificatz que las connexions TCP ordinàrias via vòstre servidor mandatari foncionen, inclusent l'autentificacion e lo passatge d'un servidor de jòc a l'autre.
2. Paratz lo servidor mandatari e telecargatz lo modul correspondent sus la pagina de las versions sus GitHub.
3. Plaçatz raknetify2-velocity-*-all.jar o raknetify2-bungee-*-all.jar dins lo dorsièr plugins del servidor mandatari. Retiratz d'aquel dorsièr tota anciana version del modul Raknetify o Raknetify2.
4. Installatz lo mod Raknetify2 adaptat a vòstre client en seguent lo guida d'installacion.
5. Verificatz los paramètres d'escota çai jos, reaviatz lo servidor mandatari e recercatz dins son jornal d'eventualas errors a la dubertura del pòrt RakNet.
6. Autorizatz lo trafic UDP public cap al servidor mandatari e limitatz l'accès als pòrts de jòc dels servidors en seguent la guida de configuracion del parafuòc e del rotador.

Utilizatz de versions compatiblas de Raknetify2 sul client e lo servidor mandatari. Consultatz la pagina Compatibilitat abans d'associar de versions diferentas.

Velocity

Dins velocity.toml, lo paramètre bind definís l'adreça e lo pòrt TCP sus los quals Velocity escota las connexions Minecraft. Raknetify2 utiliza normalament lo meteis numèro de pòrt en UDP. Las intradas de la seccion [servers] designan los servidors de jòc. Laissatz-i lors adreças TCP. Consultatz la documentacion dels paramètres de Velocity.

Per utilizar un pòrt UDP distint, apondètz aquel argument de la JVM abans -jar dins l'ordena de aviada de Velocity:

-Draknetify.velocity.portOverride=25570

Remplaçatz 25570 pel pòrt de vòstra causida. Sol lo pòrt UDP de RakNet cambi. Velocity consèrva son pòrt TCP e las adreças dels servidors de jòc. Reaviatz Velocity après aver modificat l'argument.

Configuratz la transmission de las informacions dels jogaires sus Velocity e sus cada servidor de jòc. Se lo logicial del servidor de jòc o permet, utilizatz lo mòde modèrne de transmission e gardatz sa clau secreta confidenciala. Las etapas pròprias a cada logicial figuran dins lo guida de transmission de las informacions dels jogaires de Velocity. Mantenètz egalament las restriccions d'accèsses del parafuòc dels servidors de jòc.

BungeeCord

Dins lo fichièr config.yml de BungeeCord, la valor host de cada intrada de listeners definís l'adreça e lo pòrt TCP sus los quals lo servidor mandatari escota las connexions Minecraft. Raknetify2 i apond normalament l'escota en UDP sul meteis numèro de pòrt. La seccion servers conten las adreças TCP dels servidors de jòc. Aqueles paramètres son descriches dins lo guida de configuracion de BungeeCord.

Per utilizar un pòrt UDP distint, apondètz aquel argument de la JVM abans -jar dins l'ordena de aviada de BungeeCord:

-Draknetify.bungee.portOverride=25570

Aquel reglatge s'aplica a l'ensems del procès del servidor mandatari. Tant Minecraft escota sus mantas adreças, verificatz dins lo jornal de aviada las adreças e pòrts realament utilizats per RakNet abans d'apondre de règlas al parafuòc. Reaviatz BungeeCord après aver modificat l'argument.

Conservatz l'autentificacion dels comptes sul servidor mandatari. Pels servidors de jòc Spigot, lo guida de transmission de las adreças IP de BungeeCord assòcia ip_forward: true sul servidor mandatari a settings.bungeecord: true sul servidor de jòc. Aqueles reglatges sols empedisson pas las connexions dirèctas al servidor de jòc. Limitatz-ne l'accès en seguent los instruccions relativas al parafuòc.

Causir l'adreça a comunicar als jogaires

Suls dos servidors mandataris, lo pòrt de remplaçament deu èsser compreses entre 1 e 65534. Tota valor incorrècta es ignorada. Verificatz dins lo jornal de aviada quin pòrt UDP es estat dobèrt. Per tornar al numèro de pòrt de Minecraft, suprimissètz l'argument e reaviatz lo servidor mandatari.

Los jogaires sasisson lo nom d'òste public del servidor mandatari e son pòrt UDP, per exemple raknet;play.example.com:25570. S'un rotador modifica lo numèro de pòrt, indicatz son pòrt UDP public dins l'adreça costat client. Una adreça sens lo prefix raknet; contunha d'utilizar lo pòrt d'escota TCP del servidor mandatari.

Atribuissètz de pòrts UDP distints a Query, Geyser e als autres servicis UDP. Cambiar lo pòrt TCP resòlv pas un conflicte entre dos servicis UDP.

Simple Voice Chat e relais UDP suplementaris

Sus Velocity e BungeeCord, Simple Voice Chat utiliza son pròpri modul de servidor mandatari e son pròpri pòrt UDP. Consultatz los instruccions per Simple Voice Chat darrièr un servidor mandatari.

S'un relai UDP plaçat devent vòstre servidor mandatari Minecraft envia de las entèstas PROXY protocòl v2, configuratz Raknetify2 en seguent la guida Redireccion UDP e protocòl PROXY. Velocity e BungeeCord sols necessitan pas aquela configuracion.

Verificar la connexion

Fachas un ensag dempuèi l'exterior de vòstra ret locala amb un client Raknetify2. Connectatz-vos via lo servidor mandatari, passatz d'un de vòstres servidors de jòc a l'autre e verificatz que l'identitat del jogaire e sas permissions son conservadas.

• Se la connexion TCP via lo servidor mandatari fonciona mas que RakNet expire sens responsa, verificatz lo pòrt d'escote UDP del servidor mandatari, lo pòrt public, las rotas IPv4 e IPv6 e las règlas del pare-fuòc.
• Se las doas mòdas de transpòrt fracassan quand lo servidor mandatari tenda de jónher un servidor de jòc, verificatz l'adreça TCP d'aquel servidor, sas règlas d'accèsses e sos paramètres de transmission de las informacions dels jogaires.
• Se lo servidor mandatari senhala que lo pòrt UDP es ocupat, verificatz tant Query, Geyser, un servidor mandatari vocal o un autre procès l'utilize ja.

Se senhalatz un problèma, jonhètz los jornals del servidor mandatari e del servidor de jòc correspondent a la meteissa temptativa de connexion. La pagina Resolucion de problèmas indica quinas versions cal precisar.

Configuracion del parafuòc e del rotador

Aqueste guida s'adreça als administradors de servidors. Per utilizar Raknetify2, los paquets UDP devon poder aténher lo servidor o lo servidor mandatari que accèpta las connexions RakNet. Per defaut, utiliza lo meteis numèro de pòrt que Minecraft en TCP.

Se los jogaires son sus la meteissa ret locala, utilizatz l'adreça locala del servidor e autorizatz UDP dins lo parafuòc de la maquina que l'alberga. Una redireccion de pòrt sul rotador es necessari se lo trafic provenent d'Internet deu traversar lo NAT IPv4 de çò rotador.

Causir la destinacion e lo pòrt

Connexion dirècta al servidor

Dirigissètz lo trafic UDP public cap a la maquina que alberga lo servidor Minecraft equipat de Raknetify2. Lo pòrt de destinacion es lo pòrt d'escota UDP de RakNet sus aquel servidor. Autorizatz aquel pòrt dins lo parafuòc de la maquina. Conservatz la rota TCP existenta per las connexions Minecraft ordinàrias.

Per exemple, tant Raknetify2 escota sul pòrt UDP 25570, redirigissètz lo pòrt UDP public cap al pòrt 25570 de l'adreça locala del servidor. Lo pòrt TCP del servidor pòt restar a 25565. Per causir un autre pòrt UDP, consultatz los paramètres d'escota d'un servidor dirècte.

Velocity o BungeeCord

Dirigissètz lo trafic UDP public cap a la maquina que executa Velocity o BungeeCord amb lo modul Raknetify2. La destinacion de la redireccion es lo pòrt d'escota UDP de RakNet sul servidor mandatari. Conservatz la rota TCP publica existenta cap al servidor mandatari per las connexions Minecraft ordinàrias.

Lo servidor mandatari se connècta als servidors de jòc Minecraft en TCP. Installar Raknetify2 sul servidor mandatari necessita pas de dobrir als jogaires los pòrts de jòc UDP dels servidors situats darrièr el.

Connexion	Accès a autorizar
De jogaires cap al servidor mandatari	Accès UDP public al pòrt d'escota de RakNet, en mai de l'accès TCP public existent
De servidor mandatari cap als servidors de jòc	Pòrts TCP de Minecraft suls servidors de jòc, accessibles unicament dempuèi las maquinas albergant las servidors mandataris previstes
De jogaires dirèctament cap als pòrts dels servidors de jòc	Manténer aquel accès blocat, i compreses en IPv6

Se lo servidor mandatari e los servidors de jòc viran dirèctament sus una maquina dedicada qu'administratz, podètz far escotar los servidors de jòc sus de adreças de boclatge e configurar lo servidor mandatari pels i jónher. Se viran sus mantas maquinas, limitatz l'accès TCP als sols servidors mandataris per mejan d'un parafuòc o d'una ret privada isolada. Pels contenedors e los alotjaments gerits, aplicatz de restriccions equivalentas adaptadas a vòstra ret. Consultatz lo guida de securizacion dels servidors de jòc de Velocity e lo guida del parafuòc de BungeeCord.

La transmission de las informacions dels jogaires e las restriccions del parafuòc se complètan. Una connexion dirècta a un servidor de jòc pòt entornejar los contraròtles d'autentificacion del servidor mandatari. Per installar lo modul, configurar la transmission de las informacions o modificar lo pòrt UDP, consultatz la guida Velocity e BungeeCord.

Pòrts publics e pòrts locals

Se lo rotador efectua una traduccion de pòrts, lo pòrt public pòt diferir del pòrt d'escota:

Paramètre	Pòrt a utilizar
Adreça del servidor sasida dins lo client	Pòrt UDP public
Pòrt extèrn de la règla de redireccion sul rotador	Pòrt UDP public
Pòrt intèrn de la règla de redireccion sul rotador	Pòrt d'escota UDP de RakNet
Pòrt local de la règla del parafuòc de la maquina	Pòrt d'escota UDP de RakNet

Redireccion de pòrt en IPv4

Per albergar un servidor darrièr un rotador IPv4:

1. Notatz l'adreça IPv4 locala de la maquina que accèpta las connexions RakNet. Reservatz aquela adreça dins la configuracion DHCP o atribuissètz-li una adreça estatica apropriada per que la règla de redireccion contunhe de designar la meteissa maquina.
2. Apondètz una règla de redireccion UDP pel pòrt public que los jogaires utilizaràn.
3. Indicatz coma destinacion l'adreça locala d'aquela maquina e lo pòrt d'escota UDP de RakNet.
4. Dins o parafuòc de la maquina, autorizatz lo trafic UDP dintrant sul pòrt d'escota.

Per exemple, se lo servidor escota sul pòrt UDP 25565, la règla pòt utilizar lo pòrt public 25565, l'adreça de destinacion 192.168.1.100 e lo pòrt de destinacion 25565. Remplaçatz l'adreça de l'exemple per l'adreça locala reala de vòstre servidor.

Conservatz la règla TCP existenta per las connexions Minecraft ordinàrias. Una règla de redireccion limitada a TCP transmet pas los paquets UDP.

Se la redireccion fracassa totjorn

Verificatz s'un autre rotador o vòstre fornisseire d'accès efectua una traduccion d'adreças (NAT) en amont de vòstra rotador. S'administratz doas rotadors ne sèria, configuratz la redireccion sus cadun d'eles. Se vòstre fornisseire utiliza un NAT partejat entre abonats (CGNAT), demandatz-li una adreça IPv4 publica, o utilizatz un alotjament o un tunèl capable de recebre de trafic UDP. Las règlas de vòstra rotador permeton pas de configurar lo NAT del fornisseire. Lo guida de redireccion de pòrt de TP-Link explica per qué cal una adreça publica costat WAN.

Règlas del parafuòc IPv6

Autorizatz lo pòrt UDP causit dins lo parafuòc IPv6 del rotador e dins aquel de la maquina. Utilizatz coma destinacion l'adreça IPv6 de la maquina que accèpta las connexions RakNet.

Verificatz que lo nom d'òste congèdie ben a l'adreça IPv6 d'aquela maquina. Se càmbia, actualizatz l'enregistrament DNS e las règlas del parafuòc que designan aquela adreça.

Quand un nom d'òste publica de las adreças IPv4 e IPv6, caduna deu permetre de jónher lo servidor. Se cèrts jogaires arriban a se connectar e d'autres non, verificatz las règlas dels dos protocòls.

Se la redireccion IPv4 modifica lo numèro de pòrt, verificatz que lo pòrt sasit pels jogaires permet egalament de jónher lo servici en IPv6. La traduccion de pòrt IPv4 configura pas la rota IPv6.

Albergadors e tunèls

Lo albergador o lo fornisseire del tunèl deu préner en carga UDP sus l' adreça e lo pòrt publics comunicats als jogaires. Verificatz los pòrts que vos a atribuits e las règlas de son parafuòc ret, aital coma o parafuòc del servidor.

S'un autre servidor mandatari UDP transmet las adreças dels clients per mejan de PROXY protocòl v2, seguissètz la guida Redireccion UDP e protocòl PROXY e reservatz l'accès al pòrt d'escota UDP de destinacion a çò servidor mandatari de fisança.

Verificar la connexion

Dempuèi l'exterior de la ret locala del servidor, connectatz-vos amb un client Raknetify2 a jorn e una adreça coma raknet;play.example.com:25565. Indicatz dins aquela adreça lo pòrt UDP public.

Verificatz lo trajècte amb una veritabla connexion RakNet. Una analisi UDP restada sens responsa pòt donar un resultat indeterminat, que un servici operacional pòt ignorar una comanda que reconeis pas. La documentacion de Nmap sus l'analisi UDP explica aquel comportament.

Una connexion TCP capitada confirma unicament que lo trajècte TCP foncione. Se la connexion RakNet expira sens responsa, verificatz lo pòrt d'escota, la destinacion de la redireccion, lo pòrt UDP e las règlas del parafuòc en seguent lo guida de resolucion de problèmas.

Compatibilitat

Verificatz la compatibilitat de la version que telecargatz. La branca de desvolopament pòt ja préner en carga de las versions o de las configuracions encara absentas de las versions distribuidas.

Versions de Minecraft e de Java

Per Fabric, telecargatz lo fichièr compatibility.json de la meteissa version que vòstra JAR. Recercatz vòstra version de Minecraft dins gameVersions, puèi consultatz las dependéncias indicadas per depends dins l'intrada correspondenta de runtimes. Aquel fichièr JSON servís de referéncia. O podètz laissar en defòra del dorsièr mods.

Per Forge, NeoForge e Spigot/Paper, consultatz las versions requeridas pel fichièr distribuit e indicadas sus sa pagina de telecargament. La compatibilitat amb un cargador garantiguèt pas la compatibilitat amb los autres.

La version de Java indicada per Raknetify2 es un minim. Minecraft o lo cargador de mods pòt exigir una version mai recenta. Causissètz una version de Java que respond a las tres exigéncias.

Versions del client e del servidor

Dins la mesura del possible, utilizatz la meteissa version de Raknetify2 sul client e sul servidor o lo servidor mandatari a lo qual se connècta. Abans d'associar de versions diferentas, consultatz las nòtas de version. Per chifrar la connexion RakNet, las doas extremitats devon préner en carga lo protocòl de chiframent autentificat. Lo Raknetify d'origina e las versions de Raknetify2 anterioras a aquel protocòl pòdon pas establir aquel tipe de connexion chifrada amb d'installacions a jorn.

Raknetify2 transpòrta las donadas del protocòl de jòc de Minecraft. Per religar de versions diferentas de Minecraft, cal un dispositiu de traduccion de protocòl compatible.

Autres mods

La procediment de compilacion verifica subretot la compatibilitat amb Polymer, Krypton, PacketFixer e Fast IP Ping. Los tèstes pòrtan sus las versions e las combinasons qu'aquel procediment definís. Per examinar una combinason precisa, consultatz los resultats associats a la version de Raknetify2 que interèssa.

S'encontratz un problèma dins un paquet de mods mai important, seguissètz lo guida de resolucion de problèmas. Indicatz dins vòstra senhalament las versions exactas de totes los mods.

Mòde ordenat

Mòde ordenat

En temps normal, los canals de Raknetify2 son independents. Quand un canal espèra de donadas mancantas, los autres contunhan a transmetre lors paquets. En mòde ordenat, totes los paquets Minecraft passan per un sol canal. La pèrda d'un paquet blòca doncas totes los paquets seguents dins lo meteis sens fins a sa retransmission. Aquel mòde presèrva l'òrdre esperat per cèrts logicials antitricha, mas lo trafic de jòc sens rapòrt amb lo paquet perdut deu el tanben esperar.

Activar lo mòde ordenat

1. Installatz una version de Raknetify2 prent en carga lo mòde ordenat sul servidor o lo servidor mandatari que accèpta las connexions RakNet aital coma sus cada client RakNet.

2. Dins lo repertòri de trabalh d'aquel servidor o de çò servidor mandatari, creatz lo fichièr config/raknetify2-compatibility.json. Se lo dorsièr config existís pas, creatz-lo.

3. Apondètz lo contengut seguent:

   {"mode": "ordered"}

4. Reaviatz lo servidor o lo servidor mandatari.

Los clients adòptan automaticament lo reglatge del servidor. Los jogaires pòdon conservar lor adreça de servidor RakNet e an pas cap de fichièr de configuracion a crear.

Dins cada sens, totes los paquets Minecraft manlèvan un meteis canal fisable e ordenat, inclusent los delimitadors de grops de paquets e los paquets de cambiament de mond.

Configuracion amb un servidor mandatari

Quand los jogaires se connèctan per Velocity o BungeeCord, configuratz lo mòde ordenat sul servidor mandatari, e mai se lo logicial antitricha fonciona sus un servidor de jòc.

Lo reglatge rèsta en vigor quand un jogaire passa d'un servidor de jòc a l'autre. En mòde ordenat, lo servidor mandatari transmet las demandas de manten de connexion del servidor de jòc al client del jogaire al luòc d'i respondre el meteis.

Verificar lo reglatge

Durant la primièra connexion RakNet, la consòla aficha:

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

Se las doas extremitats s'acòrdan sus aquel mòde, lo jornal aficha tant ordered compatibility negotiated, seguit de l'adreça de l'autra extremitat.

Gardatz los contraròtles antitricha actius e verificatz lo foncionament de vòstra pròpria installacion.

Clients ancians

Un client RakNet que pren pas ne carga lo mòde ordenat pòt pas rejónher un servidor que l'exigís. Metètz Raknetify2 a jorn sus aquel client o connectatz-vos amb l'adreça e lo pòrt TCP abituals del servidor o del servidor mandatari, sens lo prefix raknet;.

Tornar al mòde multicanal

Remplaçatz lo contengut del fichièr per:

{"mode": "multichannel"}

Reaviatz puèi lo servidor o lo servidor mandatari. Podètz egalament suprimir lo fichièr puèi reaviar per restablir lo mòde multicanal.

Problèmas de configuracion

Lo fichièr deu conténer un sol paramètre nomenat mode, dont la valor deu èsser "ordered" o "multichannel". Respectatz las majusculas e los minusculs.

Se la configuracion es incorrècta o illegibla, las connexions RakNet son refusadas. Corregissètz lo fichièr e reaviatz lo procès.

Se la consòla indica totjorn multichannel, verificatz que lo fichièr se tròbe ben jol repertòri de trabalh del servidor o del servidor mandatari que accèpte la connexion RakNet, puèi reaviatz aquel procès.

Transferiments automatics

Los servidors Fabric, Forge e NeoForge pòdon causir RakNet quand transferisson un client compatible cap a una destinacion configurada. Utilizan per aquò los transferiments integrats a Minecraft dempuèi Java Edition 1.20.5. Verificatz que vòstra version de Raknetify2 pren en carga la version de Minecraft e lo cargador de mods de cada costat.

Installatz Raknetify2 sul servidor a l'origina del transferiment e sul client. Lo servidor de destinacion deu dispausar d'un pòrt d'escota RakNet compatible e acceptar las demandas de transferiment dintrantas de Minecraft.

Aquela configuracion concernís los transferiments enviats pels tres cargadors de mods çai sus. Los moduls Spigot/Paper, Velocity e BungeeCord legisson pas aquel fichièr de transferiments.

Configurar lo servidor a l'origina del transferiment

Dins lo repertòri del servidor a l'origina del transferiment, creatz lo fichièr config/raknetify2-transfers.json:

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

Remplaçatz lo nom d'òste e los pòrts de l'exemple per aqueles de vòstra destinacion, puèi reaviatz lo servidor a l'origina del transferiment. Apondètz los autres destinacions dins lo meteis quadre.

Camp	Significacion
host	Nom d'òste o adreça IP de destinacion, sens prefix de transpòrt ni pòrt
tcpPort	Pòrt de destinacion dins la demanda de transferiment iniciala
udpPort	Pòrt RakNet public a lo qual lo client transferit se deu connectar

Los numèros dels pòrts TCP e UDP pòdon èsser identics. S'un rotador modifica lo pòrt UDP, indicatz lo pòrt public dins aquel fichièr. Escrivètz los pòrts jos forma de nombres JSON.

Adreçatz las demandas de transferiment al nom d'òste e al pòrt TCP abituals de la destinacion. Raknetify2 verifica se lo client anóncia la presa ne carga dels transferiments automatics. Tant es lo cas e que la destinacion correspond a una intrada del fichièr, causís lo pòrt UDP configurat. Pels autres clients o las destinacions sens correspondéncia, la demanda consèrva son adreça iniciala.

La recerca pòrta sul nom d'òste e lo pòrt TCP de la demanda de transferiment. Ten compte de las escrituras equivalentas d'una adreça IPv6 e ignòra la brisa del nom d'òste aital coma lo ponch final del nom DNS. Cap de resolucion DNS es efectuada. Dos noms d'òste que congèdian a la meteissa adreça necessitan doncas doas intradas. Los caractèrs generics son pas preses en carga.

Configurar la destinacion

Se la destinacion utiliza lo fichièr server.properties de Minecraft, indicatz-i accepts-transfers=true e reaviatz-la. Un servidor mandatari de destinacion pòt dispausar de son pròpri reglatge de transferiment. Per defaut, Minecraft refusa los transferiments dintrants e mai se los jogaires se pòdon connectar dirèctament.

Lo pòrt d'escota RakNet de la destinacion, la redireccion UDP publica e o parafuòc de la maquina devon ja èsser configurats. Lo fichièr de transferiments del servidor d'origina servís a causir l'adreça transmesa al client.

Se lo nom d'òste publica los dos tipes d'adreça, verificatz los trajèctes IPv4 e IPv6 fins a la destinacion. Testatz primièrament una connexion RakNet dirècta a aquela destinacion abans de cercar la causa d'un problèma de transferiment automatic.

Mantenètz los contraròtles d'autentificacion e d'accès de la destinacion. La configuracion dels transferiments acòrda pas cap de drech d'accès als jogaires e remplaça pas l'autentificacion del servidor.

Errors de configuracion e desactivacion

Un camp mancant o desconegut, un pòrt incorrècte o una destinacion en doble provòca una error de configuracion al aviada. Consultatz lo jornal del servidor per identificar l'error, corregissètz lo JSON, puèi reaviatz.

Per desactivar la seleccion automatica, suprimissètz lo fichièr de configuracion o indicatz-i {"destinations": []}, puèi reaviatz lo servidor a l'origina dels transferiments. Sas demandas de transferiment conservaràn lors adreças inicialas.

Redireccion UDP e protocòl PROXY

Un servidor mandatari UDP pòt retransmetre lo trafic RakNet e conservar l'adreça d'origina del client gràcias al protocòl PROXY v2. Activatz aquela foncion quand un servidor mandatari UDP en amont envia las entèstas d'aquel protocòl a vòstre pòrt d'escota. Una simpla redireccion de pòrt sus un rotador la necessita pas.

Sul servidor o lo servidor mandatari Minecraft que recep lo trafic UDP redirigit, creatz lo fichièr config/raknetify2-proxy-protocol.json:

{
  "trustedProxies": ["192.0.2.10"]
}

Remplaçatz l'exemple per l'adreça IP sorsa reala del servidor mandatari UDP o per una plaja d'adreças en notacion CIDR que controtlatz. L'adreça deu correspondre a la que vei lo destinatari après tota traduccion d'adreças intermediària. Sasissètz dirèctament una adreça IPv4 o IPv6. Los noms d'òste DNS son refusats. Reaviatz lo servidor o lo servidor mandatari de destinacion.

Configuratz lo servidor mandatari que retransmet los paquets per qu'envie las entèstas del protocòl PROXY v2 en UDP. Raknetify2 accèpta las adreças dels clients transmesas que se provengan de las sorsas indicadas. Quand aquela configuracion es activada, las connexions RakNet dirèctas desprovesidas d'aquelas entèstas son refusadas. La configuracion de l'escota TCP es conservada.

Servidors mandataris de fisança e contraròtle d'accès

Cada servidor mandatari de la lista es autorizat a fornir las adreças dels clients. Dins o parafuòc del servidor de destinacion, limitatz l'accès al pòrt UDP al sol servidor mandatari previst. Indicatz las plajas d'adreças de fisança las mai estrechas possiblas per vòstra ret.

Lo fichièr deu conténer unicament la proprietat trustedProxies, amb almens una intrada. Un quadre vuèg es una error. Un fichièr incorrècte empedís RakNet de dobrir son pòrt d'escota.

Per restablir las connexions UDP dirèctas, suprimissètz lo fichièr e reaviatz lo servici d'escota. Adaptatz a l'encòp la configuracion del servidor mandatari en amont e las règlas del parafuòc al nòu trajècte.

Se las connexions fracassan après l'activacion, verificatz l'adreça sorsa reala del servidor mandatari tala que la vei lo servidor de destinacion, la plaja d'adreças de fisança e lo mand de las entèstas del protocòl PROXY v2 per UDP pel servidor mandatari.

Per installar un servidor mandatari Minecraft e configurar sos servidors de jòc, consultatz Velocity e BungeeCord.

Simple Voice Chat

Sus Fabric, Forge, NeoForge, Spigot e Paper, Raknetify2 pòt partejar son pòrt d'escota UDP amb Simple Voice Chat sul servidor.

Installatz Simple Voice Chat sul servidor e sus cada client que desira utilizar lo chat vocal. Pels autres reglatges, seguissètz lo guida de configuracion del servidor de Simple Voice Chat.

Plaçatz lo fichièr de Raknetify2 dins lo dorsièr config situat a l'arraïc del servidor, i compreses sus Spigot/Paper. Lo fichièr pròpri a Simple Voice Chat rèsta a l'emplaçament indicat çai jos per vòstra plataforma.

Partejar lo pòrt de jòc

1. Dins lo repertòri del servidor, creatz lo fichièr config/raknetify2-voicechat.json amb lo contengut seguent:

   {"enabled": true}

2. Dins la configuracion servidor de Simple Voice Chat, indicatz port=-1. Sus un servidor amb de mods, lo fichièr se tròba dins config/voicechat/voicechat-server.properties. Sus Spigot/Paper, se tròba dins plugins/voicechat/voicechat-server.properties.

3. Laissatz bind_address vuèg s'una sola adreça d'escota RakNet correspond. Se lo servidor escota sus mantas adreças per aquel meteis pòrt UDP, indicatz l'adreça locala de la que desiratz partejar.

4. Reaviatz lo servidor e executatz /voicechat test <PLAYERNAME> per un jogaire connectat.

Tant RakNet utiliza un autre pòrt que Minecraft, indicatz explicitament aquel pòrt UDP local dins lo paramètre vocal port a la plaça de -1. Per exemple, tant RakNet escota sul pòrt UDP local 25570, indicatz port=25570.

Entresenhatz voice_host se los clients devon utilizar una adreça o un pòrt public diferent. Se vòstre rotador redirigís lo pòrt UDP public 25580 cap al pòrt UDP local 25570, indicatz port=25570 e voice_host=play.example.com:25580. L'adreça publica se règla dins voice_host. Lo paramètre bind_address selecciona l'adreça d'escota locala.

Raknetify2 fornís lo socket UDP partejat per medi de l'API de Simple Voice Chat. Simple Voice Chat se carga de l'autentificacion e del chiframent de las convèrsas vocalas. Los jogaires pòdon utilizar lo chat vocal que lor connexion de jòc passa per TCP o per RakNet.

Autras servicis UDP e servidors mandataris

Reservatz de pòrts UDP distints a Query e a Geyser. Lo despartiment del socket es previst unicament per Simple Voice Chat.

Lo despartiment del socket s'aplica pas al servidor mandatari vocal sus Velocity o BungeeCord. Seguissètz lo guida de configuracion del servidor mandatari de Simple Voice Chat e atribuissètz al servidor mandatari vocal son pròpri pòrt UDP. Amb lo modul de servidor mandatari vocal oficial, tota valor publica de remplaçament de voice_host deu èsser definida dins la configuracion vocala del servidor mandatari. Çò modul ignòra los reglatges voice_host dels servidors de jòc.

Per un tunèl UDP generic, entresenhatz voice_host amb lo nom d'òste public e lo pòrt UDP que redirigisson cap a aquel servidor.

Desactivar lo despartiment o resòlvre un conflicte de sockets

Se lo jornal indica No RakNet listener matches the voice bind address and port, verificatz que RakNet a aviat e que lo pòrt e l'adreça d'escote de servici vocal correspondan ben a aqueles de RakNet sus la maquina.

Se lo jornal indica Multiple RakNet listeners match the voice bind address, causissètz una de las adreças localas correspondentas dins bind_address, puèi reaviatz.

Un sol modul Simple Voice Chat pòt fornir lo socket UDP utilizat pel servici vocal. Se lo jornal de aviada senhala qu'un autre modul fornís ja lo socket, causissètz l'integracion que desiratz utilizar.

Per desactivar lo despartiment dins Raknetify2, indicatz {"enabled": false} dins son fichièr de configuracion vocala o suprimissètz aquel fichièr. Atribuissètz un pòrt UDP distint a Simple Voice Chat, adaptatz las règlas de parafuòc o de redireccion, puèi reaviatz lo servidor.

Resolucion de problèmas

La connexion TCP fonciona, mas lo retard de connexion RakNet expira

Verificatz los ponches seguents dins l'òrdre:

1. Lo client utiliza lo mod Raknetify2 adaptat a son cargador e a sa version de Minecraft.
2. Raknetify2 es installat sul servidor o lo servidor mandatari que accèpta la connexion e a aviat sens error de dubertura del pòrt d'escota.
3. L'adreça comença per raknet; e utiliza lo pòrt UDP public.
4. Lo albergador, lo rotador e o parafuòc de la maquina autorizan totes UDP sus aquel pòrt.
5. Las adreças IPv4 e IPv6 associadas al nom d'òste designan la bona maquina e las règlas del parafuòc permeton d'i accedir.

Una connexion TCP capitada confirma unicament que lo trajècte TCP foncione. Seguissètz la guida de configuracion del parafuòc e del rotador per verificar la redireccion UDP e l'accès IPv6. Se lo protocòl PROXY es activat, los clients devon passar per un servidor mandatari declarat de fisança per aténher lo pòrt d'escota.

Adreça ja utilizada

Verificatz s'un autre procès utiliza lo pòrt UDP. Query, Geyser e los autres servicis UDP devon dispausar de lors pròpris pòrts. Simple Voice Chat pòt utilizar lo despartiment del pòrt de jòc.

Podètz causir un autre pòrt UDP local dins los paramètres d'escota d'un servidor dirècte o dins los paramètres de Velocity e BungeeCord. Verificatz la version minimala requerida per aquel reglatge sus Spigot/Paper. Cambiar unicament lo pòrt public del rotador resòlv pas lo conflicte de sockets sus la maquina.

La connexion dirècta fonciona, mas los transferiments fracassan

Connectatz-vos dirèctament a la destinacion amb son adreça prefixada per raknet;. S'aquela connexion fracassa, reglatz primièrament lo problèma d'escota o de rotatge a destinacion.

Se las connexions dirèctas foncionan, verificatz que la destinacion accèpte los transferiments dintrants. Un servidor Minecraft que utiliza server.properties i deu definir accepts-transfers=true. Una connexion dirècta permet pas de validar aquel reglatge.

Comparatz puèi lo nom d'òste e lo pòrt TCP de la demanda de transferiment a las valors del fichièr config/raknetify2-transfers.json del servidor d'origina. Verificatz que lo fichièr es estat cargat après un reaviada e que lo client pren en carga los transferiments RakNet automatics. Consultatz la pagina Transferiments automatics.

Errors de chiframent o de protocòl

Verificatz las versions de Raknetify2 a las doas extremitats de la connexion. Quand una version modifica lo protocòl chifrat, actualizatz a l'encòp lo client e lo servidor o lo servidor mandatari. Conservatz los paramètres d'autentificacion del servidor pendent lo diagnostic.

Problèmas pròpris a un mod

Anotatz l'accion que activa lo problèma, per exemple dobrir un inventari, recebre un paquet de ressorsas, cambiar de mond o far aparéisser una entitat. Se possible, comparatz lo resultat de la meteissa accion en TCP e en RakNet sus una installacion de tèst distinta.

Cèrts messatges personalizats dependon de l'òrdre dels paquets de Minecraft. Los autors de mods pòdon declarar aquelas dependéncias a l'ajuda de la interfàcia d'ordonançament dels paquets.

Senhalar un bug

Dobrissètz un tiquet dins lo esplech de seguiment dels problèmas de Raknetify2 en indicant los elements seguents:

• Versions de Minecraft, de Java, del cargador de mods e de Raknetify2 a las doas extremitats.
• Versions dels logicials servidor e servidor mandatari, i compreses tot servidor mandatari de redireccion UDP.
• Autres mods installats e lors versions.
• Etapas permetent de reprodusir lo problèma e resultat esperat.
• Resultat de las meteissas etapas en TCP.
• Extraches pertinents dels jornals del client, del servidor e del servidor mandatari per la meteissa temptativa.

Abans de publicar vòstres jornals, retiratz los getam d'accèsses, los mots de passa e tota autra informacion privada. Conservatz los messatges d'excepcion e las tralhas de pila necessàrias al diagnostic.

Integracion amb d'autres mods

Amb Raknetify2, un mod pòt precisar quinas donadas de Minecraft devon restar ordenadas pertocant sos messatges personalizats. Utilizatz aquela possibilitat se lo tractament d'un messatge necessita una entitat, un tròç, un inventari o un autre element de l'estat del jòc establit per de paquets anteriors.

Grops d'ordonançament

Grop	Trafic associat
ui	Menuts e interaccions independents del mond
entity	Aparicion, supression e desplaçament d'entitats
world_interaction	Inventaris e autres interaccions dependentas del mond
effects	Sons e particulas
chunk	Actualizadas del terrenh, dels blòcs e de l'esclairatge

Cada grop consèrva una liurason fisabla e ordenada sus son canal. L'òrdre relatiu dels paquets de grops diferents pòt cambiar a la recepcion. Causissètz lo grop en foncion de las donadas dont vòstre messatge depend.

Integracion facultativa amb Fabric

Declaratz un fornisseire al ponch de dintrada raknetify:packet_channels del fichièr fabric.mod.json de vòstre mod. Lo fornisseire implementa Consumer<BiConsumer<String, String>> amb los tipes del JDK. Recep una foncion d'enregistrament que accèpta l'identificant d'un messatge personalizat e un grop d'ordonançament.

Integratz aquela intrada dins vòstras metadonadas existentas en remplaçant lo nom de classa pel nom complet de vòstra classa de fornisseire, paquet compreses:

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

Conservatz la rèsta de vòstre fichièr fabric.mod.json, inclusent los ponches d'intrada ja definits. L'exemple illustre sonque la part a integrar.

Per exemple, una extension que gerís los desplaçaments de las entitats pòt enregistrar example:entity_path dins lo grop entity. La documentacion de l'API PacketOrdering presenta l'implementacion del fornisseire.

En l'abséncia de Raknetify2, Fabric sona pas aquel ponch de dintrada. Los fornisseires devon declarar los identificants e los grops pendent l'inicializacion, sens presumir qu'un autre mod a ja acabat la siá.

Foncionament de l'enregistrament

Los mods Forge e NeoForge aital coma los moduls de servidor o de servidor mandatari pòdon sonar PacketOrdering.register(identifier, group) pendent lor inicializacion tant Raknetify2 es disponible. La classa es com.ishland.raknetify.api.PacketOrdering. Enregistratz vòstras declaracions abans d'acceptar las connexions dels jogaires. Se l'integracion es facultativa, velhatz a çò que vòstre còdi non carga cap de classa de Raknetify2 en son abséncia.

Las declaracions s'aplican a las nòvas connexions. Las connexions existentas consèrvan las règlas recebudas a lor dubertura. Podètz repetir una declaracion identica. Associar un autanplan identificant a dos grops diferents es refusat.

Los identificants de messatges devon utilizar un espaci de noms personalizat valid. L'espaci de noms minecraft es reservat. Lo limit es de 128 declaracions per l'ensemble d'un ponch de connexion, inclusent las règlas integradas e las declaracions d'autres mods. Un identificant pòt comptar fins a 255 caractèrs ASCII e deu respectar la sintaxi de los identificants amb espaci de noms de l'API.

Las doas extremitats RakNet a jorn escàmbian lors declaracions a la dubertura de la connexion. Se lo servidor o lo servidor mandatari a pas cap de règla locala per un messatge, pòt utilizar aquela declarada per l'autra extremitat. Las règlas localas son prioritàrias e las declaracions recebudas son valablas unicament per aquela connexion.

Servidors mandataris UDP

Consultatz la pagina Redireccion UDP e protocòl PROXY pels relais UDP e la transmission de las adreças dels clients.

Per configurar un servidor mandatari Minecraft, consultatz Velocity e BungeeCord.

English (US)