Skip to content

Wiki io en

pjscruggs edited this page Nov 11, 2026 · 2 revisions

Raknetify2 · Ido (Idia)

Lingvo

Plura ludanti

Retkonekti per RakNet por klienti e servili di Minecraft.

Deskargar · GitHub

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

Adjutar servero

  1. Plura ludanti

  2. Adjutar servero

  3. Adreso di servero

    Adreso di servero
    RakNet · UDP raknet;play.example.com:25565
    TCP play.example.com:25565
  4. Finitaĵo

  5. Enirar servero

F3 · Raknetify2

F3
RakNet · UDP Aktiva · MTU 1400
TCP Neaktiva

Velocity / BungeeCord

  1. Kliento · Raknetify2 → UDP → Velocity / BungeeCord · Raknetify2
  2. Velocity / BungeeCord → TCP → Servilo
Nombro di pordo · 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

Konekto expiris

Adreso di servero UDP
raknet;play.example.com:25580 play.example.com:25580 → NAT → 192.0.2.10:25570
Servilo · 192.0.2.10 25570/udp

config/raknetify2-compatibility.json

Servilo / Velocity / BungeeCord

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

Simple Voice Chat

Servilo 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

Adreso di servero trustedProxies RakNet
192.0.2.10 · PROXY v2 / UDP ["192.0.2.10"] ✓
192.0.2.11 · PROXY v2 / UDP ["192.0.2.10"] ✗
Kliento → RakNet / UDP ["192.0.2.10"] ✗

config/raknetify2-proxy-protocol.json

{"trustedProxies":["192.0.2.10"]}

Minecraft ≥ 1.20.5 · /transfer

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

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

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

PacketOrdering

Minecraft
ui Selekti
entity Skeleto
world_interaction Inventaro
effects Partikuli
chunk Bloki

PacketOrdering.java

Versiono kekonciliebla!

Raportar erori

Chefpagino

Raknetify2

Raknetify2 uzas RakNet per UDP por la multludanta modo di Minecraft. La trafiko dividas su inter plura kanali. Se un kanalo devas vartar paketo qua perdesis, la cetera kanali povas durar sendar datumi. Pro to la ludo povas respondar dum la retroveno di perdita datumi o la transfero di peci di la mondo.

Raknetify2 esas nedependante mantenata brancho di Raknetify, qua esis origine developita da ishland. La brancho suportas plu nova versioni di Minecraft e mantenas la transporto, la ligo kun la diversa platformi e la testi di kunfuncionado.

Por komencar

  1. Kontrolez la kunfuncionado di Minecraft e di la modi.
  2. Selektez la arkivo e instalez ol en vua sistemo.
  3. Konektez vu per adreso quale raknet;play.example.com.

Guidili por servisti

Autori di modi povas uzar la interfaco por ordinar paketi por deklarar dependi inter sua propra mesaji e la trafiko di Minecraft.

Ligili di la projeto

Raknetify2 uzas la licenco MIT e konservas la originala avizi pri autor-yuri. Lua retala parto bazesas sur Raknetify e netty-raknet.

Instalado

Deskargez versiono de GitHub Releases. Ante la instalado kontrolez qua versiono di Minecraft e qua modul-kargilo esas necesa por ta versiono.

Loko di la instalado Arkivo Dokumentuyo
Kliento o servilo Fabric raknetify2-fabric-*.jar mods
Kliento o servilo Forge raknetify2-forge-*.jar mods
Kliento o servilo NeoForge raknetify2-neoforge-*.jar mods
Servilo Spigot o Paper raknetify2-spigot-*.jar plugins
Prokurilo Velocity raknetify2-velocity-*.jar plugins
Prokurilo BungeeCord raknetify2-bungee-*.jar plugins

Klozez la kliento o haltez la servilo ante remplasigar lua JAR. Ek la sama instalado forigez la originala JAR di Raknetify e omna plu anciena JAR di Raknetify2 ante adjuntar la nova.

La dokumentuyi di la kliento apartenas a la instanco o mod-paketo di Minecraft quan vu startigas. Ti di la servilo o prokurilo apartenas a lua propra instalado. Se la kargilo ne ja kreis la bezonata dokumentuyo, kreez ol.

Rekta konekto a servilo

  1. Instalez la klientala modo por vua kargilo.
  2. Instalez la korespondanta servil-modo, o la adjuntilo Spigot/Paper sur kunfuncionanta servilo.
  3. Sequez la guidilo pri retfiltro e rutizilo por permisar UDP-konekti a la servilo.
  4. Ristartigez la kliento e la servilo.
  5. Adjuntez servil-adreso quale raknet;play.example.com o raknet;play.example.com:25565.

Adresi sen la prefixo raknet; uzas TCP.

Instalar nur la klientala modo ne donas RakNet a fora servilo. La administranto di la servilo devas furnisar RakNet-adreso. Ludanti qui konektas su a la servilo di altru ordinare ne bezonas regulo por eniranta plusendo en sua rutizilo.

Velocity e BungeeCord

Instalez la korespondanta adjuntilo di la prokurilo e la klientala modo. Videz Velocity e BungeeCord por la askultilo, la plusendo a la interna servili, la limiti di aceso e la adreso por la ludanti.

Aparta UDP-pordo por askultar

Por rekta Minecraft-servilo selektez la konvenanta Java-argumento infra. Por prokurilo videz la askultili di Velocity e BungeeCord.

Platformo Java-argumento Permisata pordi
Servilo Fabric, Forge o NeoForge -Draknetify.fabric.portOverride=25570 De 1 til 65534
Servilo Spigot o Paper -Draknetify.spigot.portOverride=25570 De 1 til 65535

Forge e NeoForge uzas la sama kodexo por askultar. Do la nomo di la proprietajo kontenas fabric. Remplasigez 25570 per la bezonata UDP-pordo.

Spigot / Paper ≥ 0.1.0-beta.1.431

Pozez la argumento ante -jar en la Java-komando o en la fako por JVM-argumenti che vua furnisanto. Ristartigez la servilo e permisez UDP ye la selektita pordo. Se la publika pordo anke esas 25570, konektez vu per raknet;play.example.com:25570. Se rutizilo chanjas la pordo, uzez lua publika pordo en la adreso di la kliento. La TCP-pordo ne chanjas.

Che Spigot/Paper la UDP-askultilo uzas la sama lokala adreso kam la TCP-askultilo di Minecraft. Nevalida valoro o ja okupita UDP-pordo impedas la starto di RakNet. Kontrolez la adreso e UDP-pordo en la starto-jurnalo. Por riuzar la numero di la TCP-pordo, forigez la argumento e ristartigez.

Rutizilo o UDP-prokurilo povas anke exterigar altra publika UDP-pordo e plusendar de ol a la nuna askultilo sen chanjar la Java-argumenti di la servilo.

Developala versioni

En GitHub Actions apertez sucesoza exekuto di main e deskargez lua arkivo Artifacts. GitHub postulas konto por deskargar tala arkivi. Uzez la instalado-tabelo supre por selektar la JAR.

Velocity e BungeeCord

Velocity e BungeeCord trovesas inter la ludanti e la interna Minecraft-servili. Instalez Raknetify2 sur la prokurilo e sur omna kliento qua konektos su per RakNet.

Kliento Raknetify2 --UDP--> Velocity o BungeeCord --TCP--> interna servilo

La interna servili ne bezonas Raknetify2 por ta voyo. Li tamen bezonas la modi, adjuntili e plusendo-suporto postulata da vua reto. Raknetify2 ne tradukas versioni di Minecraft e ne chanjas la kontrolo di konti che la prokurilo.

Instalar la adjuntilo di la prokurilo

  1. Verifikez ke ordinara TCP-konekto tra la prokurilo funkcionas, inkluzante la kontrolo di identeso e la chanjo inter interna servili.
  2. Haltez la prokurilo e deskargez la korespondanta adjuntilo de GitHub Releases.
  3. Pozez raknetify2-velocity-*-all.jar o raknetify2-bungee-*-all.jar en la dokumentuyo plugins di la prokurilo. Forigez ek ol omna plu anciena adjuntilo Raknetify o Raknetify2.
  4. Instalez la konvenanta klientala modo Raknetify2 per la guidilo pri instalado.
  5. Kontrolez la infra opcionaji di la askultilo, ristartigez la prokurilo e serchez erori pri la RakNet-askultilo en lua jurnalo.
  6. Permisez publika UDP a la prokurilo e restriktez la ludo-pordi di la interna servili segun la guidilo pri retfiltro e rutizilo.

Uzez kunfuncionanta versioni di Raknetify2 che la kliento e la prokurilo. Ante mixar versioni lektez Kunfuncionado.

Velocity

La opciono bind en velocity.toml selektas la Minecraft-adreso e TCP-pordo di Velocity. Por UDP Raknetify2 ordinare uzas la sama numero. La enskribi sub [servers] identigas la interna servili. Konservez lia TCP-adresi. Videz la konfigurala refero di Velocity.

Por uzar aparta UDP-pordo, adjuntez ca JVM-argumento ante -jar en la starto-komando di Velocity:

-Draknetify.velocity.portOverride=25570

Remplasigez 25570 per la selektita pordo. To chanjas la UDP-pordo di RakNet ma konservas la TCP-pordo di Velocity e la adresi di la interna servili. Ristartigez Velocity pos la chanjo.

Konfigurez la plusendo di informi pri ludanti e che Velocity e che lua interna servili. Uzez moderna plusendo se la interna programo suportas ol, e gardez lua sekreto konfidence. Sequez la instrucioni por vua servilo en la guidilo di Velocity pri plusendo di informi pri ludanti.

BungeeCord

En config.yml di BungeeCord, la valoro host sub singla enskribo listeners identigas la Minecraft-adreso e TCP-pordo. Raknetify2 ordinare adjuntas UDP ye la sama numero. La enskribi servers kontenas la TCP-adresi di la interna servili. Ta adresi ne esas la publika adreso por ludanti. Videz la guidilo pri konfigururo di BungeeCord.

Por aparta UDP-pordo adjuntez ca JVM-argumento ante -jar en la starto-komando di BungeeCord:

-Draknetify.bungee.portOverride=25570

La chanjo koncernas la tota prokurila procedo. Se existas plura Minecraft-askultili, kontrolez la efektiva RakNet-adresi en la starto-jurnalo ante adjuntar retfiltrala reguli. Ristartigez BungeeCord pos chanjar la argumento.

Konservez la kontrolo di konti che la prokurilo. Por interna Spigot-servili la guidilo di BungeeCord pri IP-plusendo uzas kune ip_forward: true che la prokurilo e settings.bungeecord: true che la servilo. La plusendo sola ne impedas rekta aceso a la interna servilo. Restriktez ta aceso segun la guidilo pri retfiltro.

Selektar la adreso por la ludanti

Amba prokurili aceptas pordi de 1 til 65534. Nevalida valori ignoresas. Kontrolez la efektiva UDP-pordo en la starto-jurnalo. Por riuzar la pordo di la Minecraft-askultilo, forigez la argumento e ristartigez.

Ludanti konektas su a la publika ret-nomo e UDP-pordo di la prokurilo, exemple raknet;play.example.com:25570. Se rutizilo chanjas pordi, uzez lua publika UDP-pordo en la klientala adreso. Adresi sen raknet; duras uzar la TCP-askultilo di la prokurilo.

Gardez Query, Geyser e cetera UDP-servi sur aparta UDP-pordi. Chanjar nur TCP-pordo ne liberigas okupita UDP-pordo.

Vochala babilo e plu multa UDP-plusendo

Simple Voice Chat uzas sua propra prokuril-adjuntilo e UDP-pordo che Velocity e BungeeCord. Por ta aranjo videz la guidilo pri vochala prokurili.

Se aparta UDP-relayilo ante la Minecraft-prokurilo sendas kap-informi di PROXY-protokolo v2, konfigurez Raknetify2 segun UDP-plusendo e PROXY-protokolo. Nur instalar Velocity o BungeeCord ne postulas ta konfigururo.

Kontrolar la konekto

Testez de exter vua lokala reto per Raknetify2-kliento. Konektez vu tra la prokurilo, chanjez inter la interna servili e verifikez ke la identeso e permisi di la ludanto restas korekta.

  • Se TCP tra la prokurilo funcionas ma RakNet atingas la tempo-limito, kontrolez la UDP-askultilo di la prokurilo, lua publika pordo, la voyi per IPv4 e IPv6 e la reguli di la retfiltro.
  • Se amba transporti falius kande la prokurilo konektas su a servilo, kontrolez la TCP-adreso di ta servilo, lua aceso-reguli e la plusendo di informi pri ludanti.
  • Se la prokurilo raportas ke UDP-pordo esas okupita, serchez Query, Geyser, vochala prokurilo o altra procedo qua ja askultas ye ol.

Por raporto donez la jurnali di la prokurilo e di la interna servilo de la sama konekto-provo. Videz Rezolvo di problemi por la bezonata informi pri versioni.

Konfigurado di la retfiltro e di la rutizilo

Ca guidilo esas por administranti di servili. Raknetify2 bezonas funkcionanta UDP-voyo til la servilo o prokurilo qua aceptas RakNet. Ordinare la UDP-askultilo uzas la numero di la TCP-pordo di Minecraft.

En la sama lokala reto uzez la lokala adreso di la servilo e permisez UDP en lua retfiltro. Plusendo di pordi che la rutizilo esas necesa kande trafiko de Internet devas trairar lua IPv4-NAT.

Selektar la destino e la pordo

Rekta servilo

Direktez la publika UDP-trafiko a la mashino qua exekutas la Minecraft-servilo kun Raknetify2. La destino esas la UDP-pordo di lua RakNet-askultilo. Permisez ta pordo en la retfiltro di la mashino. Konservez la TCP-voyo por ordinara Minecraft-konekti.

Se Raknetify2 askultas ye UDP 25570, plusendez de la publika UDP-pordo a la lokala adreso di la servilo ye 25570. TCP povas restar ye 25565. Por chanjar la UDP-pordo videz la opcionaji di la rekta servilo.

Velocity o BungeeCord

Plusendez la publika UDP-trafiko a la mashino qua exekutas Velocity o BungeeCord kun la adjuntilo Raknetify2. Uzez la UDP-pordo di lua RakNet-askultilo kom destino. Konservez anke la publika TCP-voyo di la prokurilo por ordinara Minecraft-konekti.

La prokurilo konektas su a la interna Minecraft-servili per TCP. Adjuntar Raknetify2 a la prokurilo ne postulas apertar UDP-ludopordi di la interna servili a la ludanti.

Konekto Aceso permisenda
Ludanti a la prokurilo Publika UDP a la RakNet-askultilo, plus la nuna publika TCP-askultilo
Prokurilo a la interna servili La TCP-pordi di la interna Minecraft-servili devas esar acesebla nur de la selektita prokurili
Ludanti rekte a la ludopordi di la interna servili Gardez ta aceso blokita, anke per IPv6

Se la prokurilo e la interna servili exekutesas rekte sur la sama mashino quan vu kontrolas, la interna servili povas askultar ye lokala loopback-adresi, e la prokurilo povas atingar li ibe. Inter diferanta mashini, permisez TCP a la interna servili nur de la prokurili, per retfiltro o izolita privata reto. Por kontenili e ret-servi administrata da altri, aplikez equivalanta limiti segun la aranjo di la reto. Videz la guidilo di Velocity pri sekurigo di interna servili e la guidilo di BungeeCord pri retfiltro.

La plusendo di informi pri ludanti e la retfiltro laboras kune. Rekta aceso a la interna servilo povas evitar la eniro-kontrolo di la prokurilo. Por instalar la adjuntili, konfigurar plusendo e selektar altra UDP-pordo, videz Velocity e BungeeCord.

Publika e lokala pordo-numeri

La publika pordo e la askultila pordo povas diferar, se la rutizilo tradukas inter li:

Opciono Pordo uzenda
Servil-adreso en la kliento Publika UDP-pordo
Extera pordo di la plusendo-regulo che la rutizilo Publika UDP-pordo
Interna pordo di la plusendo-regulo che la rutizilo UDP-pordo di la RakNet-askultilo
Lokala pordo en la retfiltro di la mashino UDP-pordo di la RakNet-askultilo

Plusendo di IPv4-pordi

Por gastigar servilo dop IPv4-rutizilo:

  1. Trovez la lokala IPv4-adreso di la mashino qua aceptas RakNet. Uzez rezervuro di DHCP o fixa adreso apta por la reto, por ke la regulo dure atingez la sama mashino.
  2. Adjuntez UDP-plusendo-regulo por la publika pordo uzota da la ludanti.
  3. Kom destino di la regulo pozez la lokala adreso di ta mashino e la UDP-pordo di la RakNet-askultilo.
  4. Permisez eniranta UDP ye la askultila pordo en la retfiltro di la mashino.

Por servilo qua askultas ye UDP 25565 la regulo povas havar publika pordo 25565, destino-adreso 192.168.1.100 e destino-pordo 25565. Remplasigez la exemplo-adreso per la vera lokala adreso di vua servilo.

Konservez la nuna TCP-regulo por ordinara Minecraft-konekti. Regulo qua plusendas nur TCP ne portas UDP.

Se la plusendo ankore ne funkcionas

Kontrolez ka altra rutizilo o vua Internet-furnisanto uzas NAT ante ke la paketi atingas vua rutizilo. Se vu kontrolas du rutizili, konfigurez la plusendo en amba. Se la furnisanto uzas komuna NAT por sua klienti, demandez publika IPv4-adreso o uzez servilo o tunelo qua aceptas eniranta UDP. Vua regulo ne povas konfigurar la NAT di la furnisanto. Videz la guidilo di TP-Link pri la bezono di publika WAN-adreso.

Reguli di IPv6-retfiltro

Permisez la selektita UDP-pordo en la IPv6-retfiltro di la rutizilo e en la retfiltro di la mashino. Uzez la IPv6-adreso di la mashino qua aceptas RakNet.

Kontrolez ke la IPv6-adreso di la ret-nomo direktas a ta mashino. Se lua IPv6-adreso chanjas, aktualigez la DNS-enskribo e la retfiltrala reguli por ta adreso.

Se ret-nomo publikigas e IPv4 e IPv6, omna publikigita adreso bezonas funkcionanta voyo. Kontrolez amba reguli se un ludanto povas konektar su e altra ne povas.

Se la IPv4-plusendo chanjas la pordo-numero, verifikez ke la pordo skribita da la ludanti anke atingas la IPv6-askultilo. Tradukar la IPv4-pordo ne konfiguras la IPv6-voyo.

Gastiganti e tuneli

La furnisanto o tunelo devas suportar UDP ye la publika adreso donita a la ludanti. Kontrolez lua pordo-atribuaji e lua retfiltrala reguli, e la retfiltro di la servilo ipsa.

Se plu un UDP-prokurilo plusendas la adresi di klienti per PROXY-protokolo v2, sequez UDP-plusendo e PROXY-protokolo e permisez aceso a la recevanta UDP-askultilo nur de la fidata prokurilo.

Kontrolar la konekto

Konektez vu de exter la lokala reto di la servilo per aktualigita Raknetify2-kliento, per adreso quale raknet;play.example.com:25565. Uzez la publika UDP-pordo en ta adreso.

Por verificar la voyo uzez vera RakNet-konekto. Senresponda UDP-probo ne donas certa konkluzo, nam funkcionanta servo povas ignorar nekonocata probo. La dokumento di Nmap pri UDP-probi explikas to.

Suceso per TCP konfirmas nur la TCP-voyo. Se RakNet atingas la tempo-limito, kontrolez la askultilo, la plusendo-destino, la UDP-pordo e la retfiltrala reguli per la guidilo pri rezolvo di problemi.

Kunfuncionado

Kontrolez la kunfuncionado por la versiono quan vu deskargas. La developala brancho povas ja suportar kozi qui ne esas inkluzita en publikigita versiono.

Versioni di Minecraft e Java

Versioni di Minecraft e Java · English

La Java-versiono deklarita da Raknetify2 esas minimumo. Minecraft o la kargilo povas postular plu nova exekutilo. Selektez Java-versiono qua satisfacas omna tri postuli.

Versioni di kliento e servilo

Se posible uzez la sama versiono di Raknetify2 che la kliento e che la servilo o prokurilo qua aceptas lua konekto. Ante mixar versioni lektez la publikigo-noti. Por cifrita RakNet-konekto amba extremi devas suportar la protokolo por autentikigita cifrado. La originala Raknetify e anciena versioni di Raknetify2 de ante ta protokolo ne povas facar tala cifrita konekti kun aktualigita extremi.

Raknetify2 portas la ordinara ludala protokolo di Minecraft. Por konektar diversa Minecraft-versioni vu bezonas kunfuncionanta tradukilo di protokoli.

Altra modi

Altra modi · English

Por eroro en plu granda mod-paketo sequez la guidilo pri rezolvo di problemi. Inkluzez en la raporto la plena versioni di la modi.

Ordinita modo

Ordinita modo

Ordinare Raknetify2 lasas la nedependanta kanali continuar dum un kanalo vartas mankanta datumi. En ordinita modo omna Minecraft-paketi trairas un kanalo. Perdita paketo haltigas omna posta paketi en ta direciono til lua risendo. To konservas la ordino expektata da kelka kontre-trompala programi, ma dum la varto anke la cetera ludo-trafiko devas haltar.

Aktivigar ordinita modo

  1. Instalez versiono di Raknetify2 qua suportas ordinita modo sur la servilo o prokurilo qua aceptas RakNet-konekti e sur singla RakNet-kliento.

  2. Kreez config/raknetify2-compatibility.json sub la labor-dokumentuyo di ta servilo o prokurilo. Se config ne existas, kreez ol.

  3. Adjuntez la sequanta kontenajo:

    {"mode": "ordered"}
  4. Ristartigez la servilo o prokurilo.

La klienti automate sequas la selekto di la servilo. Ludanti ne bezonas krear konfigurala arkivo nek chanjar sua RakNet-adreso.

En singla direciono omna Minecraft-paketi uzas un fidinda ordinita kanalo, inkluzante lim-marki di paketo-grupi e chanji di mondo.

Aranjo kun prokurilo

Se la ludanti konektas su tra Velocity o BungeeCord, konfigurez ordinita modo sur ta prokurilo, anke se la kontre-trompala programo exekutesas sur interna servilo.

La regulo restas valida dum chanji inter interna servili. En ordinita modo la prokurilo sendas la vivi-kontrolo di la interna servilo a la vera kliento, vice respondar loke.

Verifikar la opciono

Ye la unesma RakNet-konekto la konzolo montras:

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

Pos sucesoza interkonsento pri kunfuncionado la jurnalo anke montras ordered compatibility negotiated e pose la adreso di la korespondanto.

Lasez la kontre-trompala kontroli aktiva e testez vua propra aranjo.

Plu anciena klienti

RakNet-klienti sen suporto por ordinita modo ne povas konektar su a servilo qua postulas ol. Aktualigez Raknetify2 che ta klienti, o konektez vu per la ordinara TCP-adreso e pordo di la servilo o prokurilo sen la prefixo raknet;.

Rivenar a plurkanala modo

Chanjez la arkivo tale:

{"mode": "multichannel"}

Pose ristartigez la servilo o prokurilo. Forigar la arkivo anke rihavas plurkanala modo pos ristarto.

Problemi pri konfigururo

La arkivo devas kontenar precize un opciono nomita mode, kun valoro "ordered" o "multichannel". Granda e mikra literi diferas.

Nevalida o nelegebla konfigururo igas la servilo refuzar RakNet-konekti. Korektigez la arkivo e ristartigez la procedo.

Se la konzolo ankore montras multichannel, verifikez ke la arkivo esas en la labor-dokumentuyo di la servilo o prokurilo qua aceptas RakNet, e ristartigez ta procedo.

Automata transferi

Servili Fabric, Forge e NeoForge povas selektar RakNet por transferar apta kliento a konfigurita destino. To uzas la transfero-suporto di Minecraft, introduktita en Java Edition 1.20.5. Kontrolez ke vua versiono di Raknetify2 suportas la Minecraft-versiono e la kargilo che amba extremi.

Instalez Raknetify2 che la sendanta servilo e la kliento. La destino devas furnisar kunfuncionanta RakNet-askultilo e permisar eniranta Minecraft-transferi.

Ca konfigururo koncernas transferi sendita da la tri kargili supre. La adjuntili Spigot/Paper, Velocity e BungeeCord ne lektas ca transfero-arkivo.

Konfigurar la sendanta servilo

Kreez config/raknetify2-transfers.json en la dokumentuyo di la sendanta servilo:

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

Remplasigez la exemplo di ret-nomo e pordi per la valori di vua destino, e ristartigez la sendanta servilo. Adjuntez plu multa destini a la sama listo.

Fako Senco
host Ret-nomo o IP-adreso di la destino, sen transporto-prefixo nek pordo
tcpPort Pordo di la destino en la originala transfero-demando
udpPort Publika RakNet-pordo quan la transferita kliento devas kontaktar

TCP e UDP povas havar la sama pordo-numero. Se rutizilo chanjas la UDP-pordo, uzez la publika pordo en ca arkivo. Skribez pordi kom JSON-numeri.

Sendez la transfero al ordinara ret-nomo e TCP-pordo di la destino. Raknetify2 kontrolas ka la kliento anoncas suporto por automata transferi. Por apta kliento e korespondanta destino ol selektas la konfigurita UDP-pordo. Por altra klienti o ne korespondanta destini la originala adreso restas.

La komparo uzas la ret-nomo e TCP-pordo di la transfero-demando. Por la komparo oni normaligas granda e mikra literi, finala DNS-punto e equivalanta skribmanieri di IPv6. La komparo ne konsultas DNS: du diferanta nomi kun la sama adreso bezonas du enskribi. Maski por nomi ne aceptesas.

Preparar la destino

Por destino qua uzas server.properties di Minecraft, pozez accepts-transfers=true e ristartigez ol. Destino-prokurilo povas havar propra transfero-opciono. Ordinare Minecraft refuzas eniranta transferi, anke kande rekta konekto funkcionas.

La RakNet-askultilo di la destino, lua publika UDP-plusendo e lua retfiltro devas ja esar konfigurita. La transfero-arkivo di la sendanta servilo selektas la adreso sendota a la kliento.

Se la ret-nomo di la destino publikigas amba tipi di adresi, kontrolez lua IPv4- e IPv6-voyi. Testez ordinara rekta RakNet-konekto a la destino ante investigar la automata transfero.

Konservez omna identeso- e eniro-kontroli di la destino. Ca konfigururo ne donas aceso a ludanti e ne remplasigas la identeso-kontrolo di la servilo.

Erori di konfigururo e desaktivigo

Mankanta o nekonocata faki, nevalida pordi e duopla destini produktas konfigurala eroro ye la starto. Trovez la eroro en la servil-jurnalo, korektigez la JSON e ristartigez.

Por desaktivigar la automata selekto, forigez la arkivo o uzez {"destinations": []} e ristartigez la sendanta servilo. Lua transfero-demandi konservos sua originala adresi.

UDP-plusendo e PROXY-protokolo

UDP-prokurilo povas plusendar RakNet-trafiko e konservar la originala adreso di la kliento per PROXY-protokolo v2. Aktivigez to kande la UDP-prokurilo sendas tala kap-informi a vua askultilo. Ordinara pordo-plusendo che rutizilo ne bezonas to.

Sur la servilo o Minecraft-prokurilo qua recevas la plusendita UDP-trafiko, kreez config/raknetify2-proxy-protocol.json:

{
  "trustedProxies": ["192.0.2.10"]
}

Remplasigez la exemplo per la vera fontala IP-adreso di la UDP-prokurilo o per CIDR-intervalo quan vu kontrolas. La adreso devas esar ta quan vidas la askultilo pos eventuala NAT. Litera IPv4- e IPv6-adresi aceptesas, DNS-nomi refuzesas. Ristartigez la servilo o prokurilo.

Konfigurez la plusendanta prokurilo por sendar kap-informi di PROXY-protokolo v2 por UDP. Raknetify2 aceptas la plusendita adresi di klienti nur de la fonti en la listo. Dum ta konfigururo aktivas, rekta RakNet-konekti sen la kap-informi refuzesas. La listo identigas la prokurili, ne la ludanti. La TCP-askultilo konservas lua nuna opcionaji.

Fido e aceso

Singla listigita prokurilo esas fidata por deklarar adresi di klienti. En la retfiltro di la interna servilo permisez aceso a lua UDP-pordo nur de la destinita prokurilo. Limitez la fidata adres-intervali tam strikte kam vua reto permisas.

La arkivo devas kontenar nur trustedProxies kun adminime un enskribo. Vakua listo esas eroro. Nevalida arkivo impedas la starto di la RakNet-askultilo.

Por riuzar rekta UDP-konekti forigez la arkivo e ristartigez la askultilo. Samtempe adaptez la plusendo che la prokurilo e la retfiltrala reguli a la nova voyo.

Se la konekto falias pos aktivigo, kontrolez la vera fontala adreso di la prokurilo vidata che la interna servilo, la fidata adres-intervalo e ka la prokurilo sendas kap-informi por UDP segun PROXY-protokolo v2.

Por instalar Minecraft-prokurilo e konfigurar interna servili videz Velocity e BungeeCord.

Simple Voice Chat

Raknetify2 povas partigar lua servila UDP-askultilo kun Simple Voice Chat che Fabric, Forge, NeoForge, Spigot e Paper.

Instalez Simple Voice Chat sur la servilo e che singla kliento qua bezonas vochala babilo. Sequez lua guidilo pri preparado di la servilo por la cetera opcionaji.

Pozez la arkivo di Raknetify2 en la supra dokumentuyo config di la servilo, anke che Spigot/Paper. La propra arkivo di Simple Voice Chat restas en la loko indikata infra por la platformo.

Partigar la ludo-pordo

  1. Kreez config/raknetify2-voicechat.json en la servila dokumentuyo kun ca kontenajo:

    {"enabled": true}
  2. En la servila konfigururo di Simple Voice Chat pozez port=-1. Por servili kun modi la arkivo esas config/voicechat/voicechat-server.properties. Por Spigot/Paper ol esas plugins/voicechat/voicechat-server.properties.

  3. Lasez bind_address vakua se nur un RakNet-askultilo konvenas. Se la servilo havas plura askultili ye ta UDP-pordo, pozez la lokala adreso di l'askultilo quan vu volas partigar.

  4. Ristartigez la servilo e exekutez /voicechat test <PLAYERNAME> por konektita ludanto.

Se RakNet askultas ye altra pordo kam Minecraft, pozez la vera lokala UDP-pordo kom valoro di port vice -1. Exemple, por lokala UDP 25570 pozez port=25570.

Pozez voice_host se la klienti bezonas altra publika adreso o pordo. Se rutizilo plusendas publika UDP 25580 a lokala UDP 25570, uzez port=25570 e voice_host=play.example.com:25580. La publika adreso apartenas a voice_host. bind_address indikas lokala adreso.

Raknetify2 furnisas la komuna UDP-soketo per la API di Simple Voice Chat. Simple Voice Chat kontrolas identeso e cifrado por la vocho. Ludanti povas uzar la vocho kun ludo-konekto sive per TCP sive per RakNet.

Altra UDP-servi e prokurili

Gardez Query e Geyser ye aparta UDP-pordi. La komuna soketo suportas nur Simple Voice Chat.

La integruro ne partigas la soketo di vochala prokurilo che Velocity o BungeeCord. Sequez la prokurilo-guidilo di Simple Voice Chat e donez propra UDP-pordo a la vochala prokurilo. Kun la oficiala vochala adjuntilo, selektez la publika voice_host en la konfigururo di la vochala prokurilo. Ta adjuntilo ignoras la opciono voice_host di la interna servili.

Por ordinara UDP-tunelo pozez kom voice_host la publika ret-nomo e UDP-pordo qui plusendas a ca servilo.

Desaktivigar la komuna soketo o rezolvar konflikto

Se la jurnalo montras No RakNet listener matches the voice bind address and port, verifikez ke RakNet startis e ke la vochala pordo e adreso korespondas a lua lokala askultilo.

Se ol montras Multiple RakNet listeners match the voice bind address, selektez preciza korespondanta lokala adreso en bind_address e ristartigez.

Nur un adjuntilo di Simple Voice Chat povas furnisar lua UDP-soketo. Se ye la starto altra adjuntilo ja furnisas soketo, selektez qua integruro devas furnisar ol.

Por desaktivigar la integruro di Raknetify2, pozez {"enabled": false} en lua vochala konfigururo o forigez la arkivo. Donez a Simple Voice Chat aparta UDP-pordo, adaptez la retfiltro o plusendo e ristartigez la servilo.

Rezolvo di problemi

TCP funkcionas ma RakNet atingas la tempo-limito

Kontrolez la sequanta punti en ta ordino:

  1. La kliento havas la justa Raknetify2-modo por lua kargilo e Minecraft-versiono.
  2. Raknetify2 esas instalita sur la servilo o prokurilo qua aceptas la konekto e startis sen eroro di la askultilo.
  3. La adreso komencas per raknet; e uzas la publika UDP-pordo.
  4. La gastiganto, la rutizilo e la retfiltro di la mashino omni permisas UDP ye ta pordo.
  5. La IPv4- e IPv6-adresi di la ret-nomo direktas a la justa mashino e havas funkcionanta retfiltrala reguli.

Suceso per TCP konfirmas nur la TCP-voyo. Kontrolez UDP-plusendo e IPv6-aceso per la guidilo pri retfiltro e rutizilo. Se PROXY-protokolo esas aktiva, klienti devas atingar la askultilo tra konfigurita fidata prokurilo.

Adreso ja uzata

Serchez altra procedo qua uzas la UDP-pordo. Query, Geyser e cetera UDP-servi bezonas propra pordi. Simple Voice Chat povas uzar la komuna pordo.

Vu povas selektar altra lokala UDP-pordo per la opcionaji di la rekta servilo o di Velocity e BungeeCord. Por Spigot/Paper kontrolez la postulata versiono. Chanjar nur la publika pordo che rutizilo ne liberigas la lokala soketo.

Rekta eniro funkcionas ma transfero falias

Konektez vu rekte a la destino per lua raknet;-adreso. Se to falias, unesme korektigez l'askultilo o la retala voyo di la destino.

Se rekta konekto funkcionas, kontrolez ka la destino aceptas eniranta transferi. Minecraft-servilo kun server.properties bezonas accepts-transfers=true. Rekta eniro ne testas ta opciono.

Pose komparez la ret-nomo e TCP-pordo di la transfero kun config/raknetify2-transfers.json che la sendanta servilo. Verifikez ke la arkivo lektesis pos ristarto e ke la kliento suportas automata RakNet-transferi. Videz Automata transferi.

Erori pri cifrado o protokolo

Kontrolez la Raknetify2-versioni che amba extremi. Se nova versiono chanjas la cifrita protokolo, aktualigez kune la kliento e la servilo o prokurilo. Dum la sercho konservez la identeso-kontroli di la servilo.

Erori di aparta modi

Notez la ago qua produktas la eroro, exemple apertar inventario, recevar moyeno-paketo, chanjar mondo o aparigar ento. Se praktike posibla, komparez la sama ago per TCP e RakNet en aparta test-instalo.

Kelka propra mesaji dependas de la ordino di ordinara paketi. Autori di modi povas deklarar tala dependi per la interfaco por ordinar paketi.

Raportar eroro

Apertez raporto en la eror-registro di Raknetify2 e inkluzez:

  • Versioni di Minecraft, Java, la kargilo e Raknetify2 che amba extremi.
  • Program-versioni di la servilo e prokurilo, inkluzante eventuala UDP-plusendilo.
  • Altra instalita modi e lia versioni.
  • La agi por riproduktar la problemo e la rezultajo quan vu expektis.
  • Ka la sama agi sucedas per TCP.
  • Konvenanta extraktaji de la klientala, servila e prokurila jurnali de la sama provo.

Ante sendar jurnali, forigez aceso-jetoni, pasvorti e cetera privata informi. Konservez la mesaji pri ecepti e la listo di program-voki bezonata por trovar la kauzo.

Integrado di modi

Per Raknetify2 modo povas deklarar qua trafiko di Minecraft devas konservar sua ordino kun lua propra mesaji. Uzez to kande por traktar mesajo oni bezonas ento, peco di mondo, inventario o altra stando kreita da plu frua paketi.

Grupi por ordinado

Grupo Trafiko koncernata
ui Menui e interagi nedependanta de la mondo
entity Aparo, forigo e movo di enti
world_interaction Inventarii e cetera interagi dependanta de la mondo
effects Soni e partikuli
chunk Aktualigo di tereno, bloki e lumo

En sua kanalo singla grupo garantias livrado en la originala ordino. Paketi de diferanta grupi povas interarivar en diferanta relativa ordino. Selektez la grupo di la datumi de qui la mesajo dependas.

Neforsata integrado kun Fabric

Adjuntez furnisilo sub la enir-punto raknetify:packet_channels en fabric.mod.json di vua modo. La furnisilo implementas Consumer<BiConsumer<String, String>> per tipi di la JDK. Ol recevas registrilo qua aceptas identigilo di propra mesajo e nomo di ordino-grupo.

Adjuntez ca enskribo a la nuna metadatumi e remplasigez la klas-nomo per la plena nomo di vua furnisilo:

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

Konservez la cetera kontenajo di fabric.mod.json, inkluzante la enir-punti ja existanta. La exemplo esas nur fragmento di la arkivo.

Exemple, extenso por movo di enti povas registrar example:entity_path en grupo entity. La dokumento di la PacketOrdering-API montras la kodexo di la furnisilo.

Se Raknetify2 ne esas instalita, Fabric ne vokas ta enir-punto. Furnisili devas deklarar identigili e grupi dum inicialigo, sen supozar ke altra modo ja finis sua propra inicialigo.

Reguli por registrado

Modi Forge e NeoForge ed adjuntili di servilo o prokurilo povas vokar PacketOrdering.register(identifier, group) dum inicialigo se Raknetify2 esas disponebla. La klaso esas com.ishland.raknetify.api.PacketOrdering. Registrez ante aceptar ludanto-konekti. Se la integruro esas neforsata, evitez kargar Raknetify2-klasi kande la dependajo ne esas instalita.

Deklari aplikesas a nova konekti. Ja aperta konekti konservas la reguli recevita ye la establo. Oni povas ripetar identa deklaro. Konfliktanta grupi por la sama identigilo refuzesas.

Identigili di mesaji bezonas valida propra nom-spaco. La nom-spaco minecraft esas rezervita. Singla extremo aceptas maximume 128 deklari, inkluzante enkodigita reguli e registri di altra modi. Identigilo povas kontenar maximume 255 ASCII-signi e devas sequar la sintaxo di Minecraft.

Aktualigita RakNet-extremi interchanjas deklari dum la establo di la konekto. Se servilo o prokurilo ne havas lokala regulo por mesajo, ol povas uzar la deklaro di la altra extremo. Lokala reguli havas prioritato, e la deklari di la korespondanto koncernas nur ta konekto.

UDP-prokurili

Por UDP-plusendili e plusendita klientala adresi videz UDP-plusendo e PROXY-protokolo.

Por preparar Minecraft-prokurilo videz Velocity e BungeeCord.

English (US)

Clone this wiki locally