Skip to content

Wiki sk sk

Jump to bottom
pjscruggs edited this page Nov 11, 2026 · 2 revisions

Raknetify2 · Slovenčina (Slovensko)

Jazyk

Hra viacerých hráčov

Sieťové spojenia cez RakNet pre klientov a servery Minecraftu.

Stiahnuť · GitHub

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

Pridať server

  1. Hra viacerých hráčov

  2. Pridať server

  3. Adresa servera

    Adresa servera
    RakNet · UDP raknet;play.example.com:25565
    TCP play.example.com:25565

  4. Hotovo

  5. Pripojiť sa

F3 · Raknetify2

F3
RakNet · UDP Aktívne · MTU 1400
TCP Neaktívne

Velocity / BungeeCord

  1. Klient · Raknetify2 → UDP → Velocity / BungeeCord · Raknetify2
  2. Velocity / BungeeCord → TCP → Server
Číslo portu · 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

Časový limit vypršal

Adresa servera UDP
raknet;play.example.com:25580 play.example.com:25580 → NAT → 192.0.2.10:25570
Server · 192.0.2.10 25570/udp

config/raknetify2-compatibility.json

Server / Velocity / BungeeCord

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

Simple Voice Chat

Server 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

Adresa servera trustedProxies RakNet
192.0.2.10 · PROXY v2 / UDP ["192.0.2.10"] ✓
192.0.2.11 · PROXY v2 / UDP ["192.0.2.10"] ✗
Klient → RakNet / UDP ["192.0.2.10"] ✗

config/raknetify2-proxy-protocol.json

{"trustedProxies":["192.0.2.10"]}

Minecraft ≥ 1.20.5 · /transfer

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

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

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

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

PacketOrdering

Minecraft
ui Možnosti
entity Kostlivec
world_interaction Inventár
effects Časticové efekty
chunk Kocky

PacketOrdering.java

Nekompatibilná verzia!

Nahlásiť chyby

Domov

Raknetify2

Raknetify2 používa pri hre viacerých hráčov v Minecrafte protokol RakNet cez UDP. Prenos rozdeľuje do kanálov, každý s vlastným poradím paketov. Ak sa na jednom kanáli paket stratí, ostatné kanály môžu ďalej prenášať údaje. Hra tak môže reagovať na vaše akcie, kým sa chýbajúce údaje posielajú znova alebo sa prenášajú časti sveta.

Raknetify2 je nezávisle udržiavaný fork Raknetify, pôvodne vyvinutý ishland, ktorý pridáva podporu pre novšie verzie Minecraft a udržiava transport, integráciu platformy a testy kompatibility.

Ako začať

  1. Skontrolujte kompatibilitu Minecraft a mod.
  2. Vyberte stiahnutú položku a nainštalujte ju.
  3. Pripojte sa s adresou, ako je raknet;play.example.com.

Príručky k serverom

Autori modifikácií môžu použiť Rozhranie na objednávanie paketov na deklarovanie závislostí medzi vlastnými payloadmi a Minecraft prevádzkou.

Odkazy na projekty

Raknetify2 používa Licencia MIT a zachováva pôvodné autorské práva, jeho sieťová implementácia je založená na Raknetify a netty-raknet.

Inštalácia

Stiahnite si správu z GitHub Releases. Skontrolujte Minecraft Pred inštaláciou skontrolujte požiadavky verzie a načítavača pre dané vydanie.

Kde inštalujete Súbor Priečinok
Klient alebo server Fabric raknetify2-fabric-*.jar mods
Klient alebo server Forge raknetify2-forge-*.jar mods
Klient alebo server NeoForge raknetify2-neoforge-*.jar mods
Server Spigot alebo Paper raknetify2-spigot-*.jar plugins
Velocity proxy raknetify2-velocity-*.jar plugins
BungeeCord proxy raknetify2-bungee-*.jar plugins

Zatvorte klienta alebo zastavte server pred nahradením jeho JAR.Odstráňte pôvodný Raknetify JAR a všetky staršie Raknetify2 JAR z rovnakej inštalácie pred pridaním nového súboru.

Klientske priečinky patria inštancii Minecraft alebo modpacku, ktorý spustíte. Serverové a proxy priečinky patria serveru alebo proxy inštalácii. Vytvorte príslušný priečinok, ak ho váš zavádzač ešte nevytvoril.

Priame serverové pripojenie

  1. Nainštalujte klienta mod pre váš nakladač.
  2. Nainštalujte zodpovedajúci server mod, alebo Spigot / Paper plugin na kompatibilný server.
  3. Postupujte podľa Konfigurácia firewallu a routera pre povolenie pripojenia UDP k serveru.
  4. Reštartujte klienta a server.
  5. Pridajte adresu servera, napríklad raknet;play.example.com alebo raknet;play.example.com:25565.

Adresy bez predpony raknet; používajú TCP.

Samotná inštalácia klientskeho modulu nepridá podporu RakNet na vzdialený server, prevádzkovateľ servera musí poskytnúť koncový bod RakNet. Hráči, ktorí sa pripájajú na server niekoho iného, zvyčajne nepotrebujú pravidlá pre presmerovanie prichádzajúcich routerov.

Velocity a BungeeCord

Nainštalujte zodpovedajúci proxy plugin a klientsky mod.Nasledujte Velocity a BungeeCord pre nastavenie počúvača, backend forwarding, prístupové obmedzenia a adresu, ktorú by mali hráči používať.

Samostatný UDP listener port

Pre priamy Minecraft server nastavte príslušný Java argument nižšie, pre proxy operátorov použite Nastavenie poslucháča Velocity a BungeeCord.

Platforma Java argument Akceptované porty
Server Fabric, Forge alebo NeoForge -Draknetify.fabric.portOverride=25570 1 až 65534
Server Spigot alebo Paper -Draknetify.spigot.portOverride=25570 1 až 65535

Forge a NeoForge používajú zdieľaný kód počúvača, takže ich názov vlastnosti obsahuje aj fabric, nahradiť 25570 s požadovaným portom UDP.

Spigot / Paper ≥ 0.1.0-beta.1.431

Pridajte argument pred -jar v príkaze Java, alebo v poli argumentov JVM vášho hostiteľa. Reštartujte server a povoľte UDP na vybranom listening port. Ak je verejný port tiež 25570, pripojte sa s raknet;play.example.com:25570. Ak router prekladá port, použite jeho verejný port v klientskej adrese. Port TCP zostane na svojej existujúcej hodnote.

Na Spigot/Paper, UDP listener si ponecháva lokálnu bind adresu Minecraft TCP listenera. Neplatné override alebo obsadený UDP port bráni RakNet v spustení. Skontrolujte boot log pre viazanú UDP adresu a port. Odstráňte argument a reštartujte pre návrat na TCP listener číslo portu.

Router alebo UDP proxy môže tiež odhaliť iný verejný UDP port a presmerovať ho na existujúci listener bez zmeny Java argumentov servera.

Vývojové zostavy

Otvorte úspešné spustenie main v GitHub Actions a stiahnite jeho Artifacts archív. GitHub vyžaduje účet na stiahnutie artefaktov pracovného postupu. Použite inštalačnú tabuľku vyššie na výber JAR z archívu.

Velocity a BungeeCord

Velocity a BungeeCord sa nachádzajú medzi hráčmi a backend Minecraft servermi, nainštalujte Raknetify2 na proxy a na každého klienta, ktorý sa bude pripájať cez RakNet.

Raknetify2 klient --UDP--> Velocity alebo BungeeCord --TCP--> backend server

Backend servery nepotrebujú Raknetify2 pre túto cestu pripojenia, ale stále potrebujú mods, pluginy a podporu forwardingu, ktorú vyžaduje vaša sieť. Raknetify2 neprekladá verzie Minecraft ani nemení overenie účtu proxy.

Nainštalujte zásuvný modul proxy

  1. Skontrolujte, či bežné pripojenia TCP cez proxy fungujú, vrátane overovania a prepínania medzi backend servermi.
  2. Zastavte proxy a stiahnite zodpovedajúci plugin z GitHub Releases.
  3. Umiestnite raknetify2-velocity-*-all.jar alebo raknetify2-bungee-*-all.jar do priečinka plugins proxy servera a odstráňte všetky staršie Raknetify alebo Raknetify2 pluginy z tohto priečinka.
  4. Nainštalujte príslušný Raknetify2 klient mod pomocou Návod na inštaláciu.
  5. Skontrolujte nastavenia poslucháča nižšie, reštartujte server proxy a skontrolujte, či v jeho denníku nie sú chyby poslucháča RakNet.
  6. Povoľte verejnú UDP komunikáciu na proxy a obmedzte backend herné porty ako je popísané v Konfigurácia firewallu a routera.

Použite kompatibilné verzie Raknetify2 na kliente a proxy serveri. Pred zmiešaním verzií skontrolujte Kompatibilita.

Velocity

Nastavenie bind v velocity.toml vyberá adresu Minecraft a port TCP pre Velocity. Raknetify2 zvyčajne používa rovnaké číslo portu pre UDP. Položky [servers] identifikujú backend servery. Udržujte tieto položky nasmerované na backend TCP adresy. Pozrite si Odkaz na konfiguráciu pre Velocity.

Ak chcete použiť samostatný UDP port, pridajte tento JVM argument pred -jar v Velocity spúšťací príkaz:

-Draknetify.velocity.portOverride=25570

Nahraďte 25570 vami zvoleným portom, čím zmeníte port RakNet na UDP a zároveň zachováte port TCP a backend adresy Velocity. Po zmene argumentu reštartujte Velocity.

Nastavte presmerovanie prehrávača na Velocity aj na jeho backendoch. Používajte moderné presmerovanie, ak ho backendový softvér podporuje, a udržujte jeho presmerovanie tajné. Postupujte podľa pokynov špecifických pre backend v Informácie o hráčovi pre Velocity. Udržujte obmedzenia firewallu backendu na mieste spolu s presmerovaním.

BungeeCord

V BungeeCord config.yml, host hodnota pod každým listeners záznamom identifikuje Minecraft počúvaciu adresu a TCP port. Raknetify2 zvyčajne pridáva UDP na toto číslo portu. servers záznamy obsahujú backend TCP adresy. Tieto nastavenia sú popísané v Sprievodca konfiguráciou BungeeCord.

Pre samostatný UDP port pridajte tento JVM argument pred -jar v BungeeCord spúšťacom príkaze:

-Draknetify.bungee.portOverride=25570

Prepísanie sa týka celého proxy procesu. V prípade konfigurácie s viacerými Minecraft poslucháčmi, pred pridaním pravidiel firewallu skontrolujte skutočné koncové body RakNet v protokole spustenia. Po zmene argumentu reštartujte BungeeCord.

Zachovať autentifikáciu účtu na serveri proxy. Pre backendy Spigot spáruje Sprievodca IP forwarding BungeeCord ip_forward: true na proxy so settings.bungeecord: true na backende. Samotné presmerovanie nezabráni niekomu pripojiť sa priamo na backend. Obmedziť prístup backendu pomocou Pokyny pre firewall.

Vyberte adresu, ktorú hráči používajú

Obidve proxy override akceptujú porty od 1 po 65534. Neplatné hodnoty sú ignorované, takže skontrolujte viazaný port UDP v štartovacom protokole. Odstráňte argument a reštartujte, aby ste sa vrátili na číslo portu počúvača Minecraft.

Hráči sa pripájajú na verejný názov proxy servera a port UDP, napríklad raknet;play.example.com:25570. Keď smerovač prekladá porty, používa v klientskej adrese verejný port UDP. Adresy bez predpony raknet; naďalej používajú počúvanie TCP proxy servera.

Nechajte Query, Geyser a ďalšie UDP služby na samostatných UDP portoch.Odlišný TCP port nevyrieši konflikt UDP socket.

Hlasový chat a ďalšie presmerovanie UDP

Simple Voice Chat používa svoj vlastný proxy plugin a UDP port na Velocity a BungeeCord, nasledujte Hlasový chat proxy návod pre toto nastavenie.

Ak je pred vaším Minecraft proxy samostatné UDP relé a posiela PROXY protokol v2 hlavičky, nastavte Raknetify2 pomocou UDP forwarding a PROXY protokol.Inštalácia Velocity alebo BungeeCord sama o sebe nevyžaduje túto konfiguráciu.

Skontrolujte pripojenie

Otestujte mimo lokálnej siete s klientom Raknetify2, pripojte sa cez proxy, prepnite medzi backend servermi, ktoré používate, a overte, či identita hráča a povolenia zostávajú správne.

  • Ak TCP cez proxy funguje, ale RakNet timeout, skontrolujte proxy UDP počúvanie, verejný port, IPv4 a IPv6 trasy, a pravidlá firewallu.
  • Ak oba prenosy zlyhajú, keď sa proxy pripojí k backendu, skontrolujte adresu TCP backendu, pravidlá prístupu a konfiguráciu presmerovania prehrávača.
  • Ak server proxy hlási obsadený port UDP, skontrolujte, či nie je k nemu viazaný proces Query, Geyser, hlasový server proxy alebo iný proces.

Pre správy zahrňte protokoly servera proxy aj servera backend z toho istého pokusu o pripojenie.Pozrite si Riešenie problémov pre informácie o verzii, ktoré treba zahrnúť.

Konfigurácia firewallu a routera

Tento návod je určený pre prevádzkovateľov serverov. Raknetify2 potrebuje funkčnú UDP trasu na server alebo proxy prijímajúce RakNet pripojenia. Predvolené nastavenie používa rovnaké číslo portu ako TCP listener Minecraft.

Pre hráčov v rovnakej lokálnej sieti použite lokálnu adresu servera a umožnite UDP prejsť cez firewall hostiteľa.Presmerovanie portu routera je potrebné, keď internetová prevádzka musí prejsť cez router IPv4 NAT.

Vyberte si destináciu a prístav

Priamy server

Poslať verejnú UDP komunikáciu na stroj s Minecraft serverom s Raknetify2. Cieľový port je RakNet UDP počúvanie servera. Povoliť tento port v hostiteľskom firewallu servera. Ponechať existujúcu TCP trasu pre bežné Minecraft pripojenia.

Napríklad, ak Raknetify2 počúva na UDP 25570, presmerujte verejný port UDP na lokálnu adresu servera na port 25570. Port servera TCP môže zostať na 25565. Pozrite si Nastavenia počúvača direct-server pre výber iného portu UDP.

Velocity alebo BungeeCord

Poslať verejnú UDP prevádzku na stroj s Velocity alebo BungeeCord s Raknetify2 proxy pluginom. Použiť proxy RakNet UDP počúvanie ako cieľ presmerovania. Zachovať proxy existujúce verejné TCP trasy pre bežné Minecraft pripojenia.

Proxy sa pripája k backend Minecraft serverom cez TCP, pridanie Raknetify2 do proxy nevyžaduje otvorenie backend herných UDP portov hráčom.

Pripojenie Prístup k povoleniu
Hráči na proxy Verejné UDP na RakNet poslucháča, plus existujúce verejné TCP poslucháča
Proxy na backend servery Backend Minecraft TCP porty, dosiahnuteľné len z určených proxy hostiteľských zariadení
Hráči priamo do backend herných portov Udržujte blokované, vrátane cez IPv6

Keď proxy a backend bežia priamo na vyhradenom počítači, ktorý ovládate, backendové počúvacie zariadenia môžu používať adresy loopback s proxy nakonfigurovaným tak, aby ich tam dosiahli. Naprieč počítačmi obmedzte backend TCP prístup k proxy hostiteľom pomocou firewallu alebo izolovanej súkromnej siete. Kontajnery a spravované hostiteľské zariadenia potrebujú ekvivalentné obmedzenia pre ich rozloženie siete. Pozrite si Bezpečnostná príručka pre backend Velocity a Sprievodca firewallom BungeeCord.

Presmerovanie prehrávača a obmedzenia firewallu spolupracujú. Priamy backend prístup môže obísť prihlasovacie kontroly proxy. Pre inštaláciu pluginu, nastavenia presmerovania a prepísanie portu UDP, nasledujte Velocity a BungeeCord.

Verejné a miestne čísla portov

Verejný port a port poslucháča sa môžu líšiť, keď smerovač prekladá medzi nimi:

Nastavenie Port na použitie
Adresa klientskeho servera Verejný port UDP
Externý port pravidla presmerovania smerovača Verejný port UDP
Interný port pravidla presmerovania smerovača RakNet poslucháč UDP port
Lokálny port hostiteľského firewallu RakNet poslucháč UDP port

Presmerovanie portov IPv4

Pre hosting za routerom IPv4:

  1. Nájdite lokálnu adresu IPv4 počítača, ktorý prijíma pripojenia RakNet, použite rezerváciu DHCP alebo vhodnú statickú adresu, aby pravidlo preposielania naďalej smerovalo na tento počítač.
  2. Pridať pravidlo UDP forwarding pre verejný port, ktorý budú hráči používať.
  3. Nastavte cieľ pravidla na lokálnu adresu počítača a RakNet počúvacieho zariadenia na port UDP.
  4. Povoliť prichádzajúce UDP na počúvanie portu v hostiteľskom firewallu.

Ak napríklad server počúva na porte UDP 25565, pravidlo môže mať verejný port 25565, cieľovú adresu 192.168.1.100 a cieľový port 25565. Namiesto adresy z príkladu zadajte skutočnú miestnu adresu svojho servera.

Ponechajte existujúce pravidlo TCP pre bežné pripojenia k Minecraftu. Samotné presmerovanie TCP neprenáša prevádzku UDP.

Ak preposielanie stále zlyháva

Skontrolujte, či nejaký iný router alebo váš ISP vykonáva NAT pred tým, ako trafik dosiahne váš router. Ak máte dva routery, ktoré ovládáte, presmerovanie musí pokrývať oboch. Ak váš ISP používa carrier-grade NAT, pýtajte sa, či môže poskytnúť javný IPv4 adresám alebo použite hostingovú službu alebo tunel, ktorý podporuje prichodzące UDP. Pravidlo presmerovania vášho routera nemôže nakonfigurovať NAT vášho ISP. Pozrite si TP-Link's port forwarding guidance] pre požiadavku na javnú WAN adresu.

Pravidlá firewallu IPv6

Povoľte vybraný port UDP cez firewall routera IPv6 aj cez firewall hostiteľa a zacieľte na adresu IPv6 počítača, ktorý prijíma pripojenia RakNet.

Skontrolujte, či je názov hostiteľa IPv6 Adresa ukazuje na tento počítač. Ak je IPv6 Ak sa adresa zmení, aktualizujte DNS záznam a všetky pravidlá firewallu špecifické pre adresu.

Názov hostiteľa, ktorý zverejňuje adresy IPv4 a IPv6, potrebuje pracovnú trasu pre každú zverejnenú adresu.Skontrolujte obe sady pravidiel, keď sa jeden hráč môže pripojiť a druhý nie.

Ak IPv4 forwarding zmení číslo portu, uistite sa, že hráči portu zadávajú aj počúvacie zariadenie IPv6.IPv4 port translation nekonfiguruje IPv6 trasu.

Poskytovatelia hostingu a tunely

Poskytovateľ alebo tunel musí podporovať UDP na verejnom koncovom bode, ktorý dáte hráčom, skontrolujte jeho pridelenie portov a pravidlá sieťového firewallu, ako aj vlastný firewall servera.

Ak ďalší server UDP proxy preposiela adresy klientov pomocou protokolu PROXY v2, postupujte podľa pokynov UDP forwarding a PROXY protokol a obmedzte prístup prijímajúceho počúvacieho zariadenia UDP na dôveryhodný server proxy.

Skontrolujte pripojenie

Pripojte sa z miesta mimo lokálnej siete servera s aktualizovaným klientom Raknetify2, pomocou adresy ako raknet;play.example.com:25565, použite verejný port UDP na tejto adrese.

Na overenie trasy použite skutočné pripojenie RakNet. Skenovanie UDP, ktoré nedostane žiadnu odpoveď, môže hlásiť nepresvedčivý výsledok, pretože pracovná služba môže zahodiť neznámu sondu. Dokumentácia scanu Nmapu UDP vysvetľuje toto správanie.

Úspešné pripojenie TCP potvrdzuje iba trasu TCP.Ak vyprší čas RakNet, skontrolujte počúvanie, cieľ presmerovania, port UDP a pravidlá firewallu pomocou Sprievodca riešením problémov.

Kompatibilita

Skontrolujte kompatibilitu pre konkrétne vydanie, ktoré sťahujete Vývojová vetva môže obsahovať podporu, ktorá sa ešte neobjavila vo vydaní.

Verzie Minecraft a Java

Verzie Minecraft a Java · English

Požiadavka na Java deklarovaná Raknetify2 je minimálna, Minecraft alebo nahrávač môžu vyžadovať novší runtime. Vyberte verziu Java, ktorá spĺňa všetky tri.

Klientske a serverové verzie

Ak je to možné, použite rovnakú verziu Raknetify2 na klientovi a serveri alebo proxy prijímajúcom jeho pripojenie. Pred zmiešaním verzií skontrolujte poznámky k vydaniu. Šifrované pripojenia RakNet vyžadujú podporu protokolu overeného šifrovania na oboch koncoch. Pôvodné zostavy Raknetify a Raknetify2 z obdobia pred zavedením tohto protokolu nemôžu vytvoriť tieto šifrované pripojenie k aktualizovaným partnerom.

Raknetify2 nesie existujúci herný protokol Minecraft, pripojenie rôznych verzií Minecraft vyžaduje kompatibilné nastavenie prekladu protokolu.

Ďalšie mods

Ďalšie mods · English

Pre zlyhanie vo väčšom modpacku, sledujte Sprievodca riešením problémov a zahrňte kompletné verzie vo vašom reporte.

Poradie

Poradie

Normálne, Raknetify2 nechá nezávislé paketové kanály pokračovať, kým jeden kanál čaká na chýbajúce dáta. Ordered mode umiestni všetky Minecraft pakety na jeden kanál, takže chýbajúci paket zadrží každý neskorší paket v tomto smere, kým nie je znovu prenášaný. Toto zachováva poradie očakávané niektorými anti-cheat softvérmi, ale dáva Raknetify2 schopnosť udržať nesúvisiacu hernú prevádzku počas čakania.

Povolenie usporiadaného režimu

  1. Nainštalujte na server alebo proxy prijímajúce pripojenia RakNet a na každého klienta RakNet zostavu Raknetify2, ktorá podporuje usporiadaný režim.

  2. Vytvorte config/raknetify2-compatibility.json v súvislosti s pracovným adresárom daného servera alebo proxy. Vytvorte adresár config, ak neexistuje.

  3. Pridajte nasledovné:

    {"mode": "ordered"}

  4. Reštartujte server alebo server proxy.

Klienti automaticky sledujú nastavenie servera, hráči nemusia vytvárať konfiguračný súbor ani meniť adresu servera RakNet.

Všetky Minecraft pakety používajú jeden spoľahlivý usporiadaný kanál v každom smere, vrátane oddeľovačov zväzkov a prechodov sveta.

Nastavenia proxy servera

Keď sa hráči pripájajú cez Velocity alebo BungeeCord, nastavte ordered mode na tomto proxy, aj keď anti-cheat beží na backend serveri.

Politika sa aplikuje na backendové switche. V riadenom režime proxy posiela keepalive žiadosti backendu na skutočného klienta namiesto toho, aby ich odpovedal lokálne.

Kontrola nastavenia

Pri prvom pripojení RakNet, konzola hlási:

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

Úspešná výmena kompatibility tiež zaznamenáva ordered compatibility negotiated, po ktorom nasleduje adresa partnera.

Nechajte povolené kontroly proti podvádzaniu a overte si svoje konkrétne nastavenie.

Pre starších klientov

Klienti RakNet, ktorí nepodporujú usporiadaný režim, sa nemôžu pripojiť k serveru, ktorý ho vyžaduje.Aktualizujte Raknetify2 na týchto klientoch alebo sa pripojte pomocou bežnej adresy servera alebo proxy servera TCP a portu bez predpony raknet;.

Návrat do viackanálového režimu

Zmeňte súbor na:

{"mode": "multichannel"}

Potom reštartujte server alebo proxy a odstránením súboru obnovte viackanálový režim po reštarte.

Problémy s konfiguráciou

Súbor musí obsahovať presne jedno nastavenie s názvom mode, s hodnotou buď "ordered" alebo "multichannel", pričom hodnoty sú citlivé na veľkosť písmen.

Neplatná alebo nečitateľná konfigurácia odmieta pripojenia RakNet. Opravte súbor a reštartujte proces.

Ak konzola stále hlási multichannel, skontrolujte, či je súbor v pracovnom adresári servera alebo proxy prijímajúceho pripojenie RakNet, potom reštartujte tento proces.

Automatické prevody

Servery Fabric, Forge a NeoForge môžu vybrať RakNet pri prenose schopného klienta na nakonfigurovaný cieľ. Toto používa natívnu podporu prenosu Minecraft, ktorá bola zavedená v Java Edition 1.20.5. Skontrolujte, či vaše vydanie Raknetify2 podporuje verziu Minecraft a nahrávač na každom konci.

Na odosielajúci server a klienta nainštalujte Raknetify2, cieľ musí poskytovať kompatibilný RakNet listener a prijímať prichádzajúce Minecraft prenosy.

Táto konfigurácia sa vzťahuje na transfery odoslané tromi mod loadermi uvedenými vyššie.Spigot/Paper, Velocity, a BungeeCord pluginy nečítajú tento transfers súbor.

Konfigurácia odosielacieho servera

Vytvorte config/raknetify2-transfers.json v adresári odosielacieho servera:

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

Nahraďte príkladové hostname a porty hodnotami vášho cieľa, potom reštartujte odosielajúci server a ďalšie ciele sa dostanú do rovnakého poľa.

Pole Význam
host Cieľový názov hostiteľa alebo IP adresa bez prefixu prenosu alebo portu
tcpPort Cieľový prístav v pôvodnej žiadosti o transfer
udpPort Verejný port RakNet, na ktorý by mal prenášaný klient kontaktovať

Čísla portov TCP a UDP môžu byť rovnaké. Ak router prekladá port UDP, použite verejný port v tomto súbore. Porty zapíšte ako čísla JSON.

Posielajte prenosy na bežné meno destinácie a TCP port. Raknetify2 kontroluje, či klient deklaruje podporu automatického prenosu. Pre schopného klienta a zodpovedajúcu destináciu si vyberie nakonfigurovaný UDP port. Iné klienty a nezodpovedajúce destinácie zachovávajú pôvodnú adresu prenosu.

Pri hľadaní sa používa názov hostiteľa a port TCP z požiadavky na prenos. Veľké písmená v názve hostiteľa, posledná bodka DNS a ekvivalentný pravopis IPv6 sú normalizované. Vyhľadávania DNS sa nezúčastňujú hľadania, takže dva rôzne názvy hostiteľa, ktoré sa riešia na rovnakú adresu, potrebujú samostatné položky. Zástupné znaky nie sú podporované.

Nastavenie cieľa

Pre cieľový server, ktorý používa server.properties Minecraft, nastavte accepts-transfers=true a reštartujte ho. Cieľový proxy server môže mať svoje vlastné transferové nastavenie. Minecraft štandardne odmieta prichádzajúce transfery, aj keď funguje normálne priame spojenie.

Cieľový RakNet listener, verejné UDP forwarding a host firewall musia byť už nakonfigurované.Odchádzajúci server transfers file vyberá adresu odoslanú klientovi.

Skontrolujte cieľové trasy IPv4 a IPv6, ak názov hostiteľa zverejňuje oba typy adries.Otestujte bežné priame pripojenie RakNet k cieľu pred skúmaním správania automatického prenosu.

Na cieľovom serveri ponechajte zapnutú kontrolu prihlásenia a prístupových práv. Táto konfigurácia hráčom neudeľuje prístup ani nenahrádza overenie totožnosti na serveri.

Chyby konfigurácie a vypnutie

Chýbajúce polia, neznáme polia, neplatné porty a duplicitné cieľové miesta spôsobujú chybu konfigurácie počas inicializácie.Pomocou denníka servera identifikujte chybu, opravte JSON a reštartujte.

Ak chcete vypnúť automatický výber, odstráňte konfiguračný súbor alebo použite {"destinations": []} a potom reštartujte odosielajúci server, ktorého požiadavky na prenos si ponechajú svoje pôvodné adresy.

UDP forwarding a PROXY protokol

UDP proxy môže presmerovať RakNet prevádzku a zachovať pôvodnú adresu klienta pomocou protokolu PROXY v2. Povoľte túto funkciu, keď upstream UDP proxy posiela tieto hlavičky do vášho počúvacieho zariadenia. Bežné presmerovanie portov smerovača to nevyžaduje.

Na serveri alebo Minecraft proxy prijímajúce presmerované UDP prevádzky, vytvorte config/raknetify2-proxy-protocol.json:

{
  "trustedProxies": ["192.0.2.10"]
}

Nahraďte príklad skutočnou zdrojovou IP adresou proxy servera UDP alebo rozsahom CIDR, ktorý ovládate. Adresa sa musí zhodovať s tým, čo prijímajúci poslucháč vidí po akomkoľvek zasahovaní NAT. Literály IPv4 a IPv6 sú akceptované. Názvy hostiteľa DNS sú odmietnuté. Reštartujte prijímajúci server alebo proxy.

Nastavte forwarding proxy na odosielanie protokolu PROXY v2 hlavičky pre UDP. Raknetify2 prijíma presmerované klientske adresy len z uvedených zdrojov. Priame RakNet pripojenia bez týchto hlavičiek sú odmietnuté, kým je táto konfigurácia povolená. TCP poslucháč si zachováva svoju existujúcu konfiguráciu.

Dôvera a prístup

Každý proxy server v zozname môže oznámiť adresu klienta. Vo firewalle cieľového servera povoľte prístup k jeho portu UDP iba určenému proxy serveru. Rozsah dôveryhodných adries obmedzte na najmenší rozsah, aký vaša sieť potrebuje.

Súbor musí obsahovať len trustedProxies, s aspoň jednou položkou. Prázdne pole je chyba. Neplatný súbor zabráni počúvaniu RakNet v spustení.

Ak sa chcete vrátiť k priamym pripojeniam UDP, odstráňte súbor a reštartujte poslucháč Aktualizujte správanie upstream forwarding a pravidlá firewallu pre novú trasu súčasne.

Ak po zapnutí tejto funkcie zlyhá pripojenie, skontrolujte skutočnú zdrojovú adresu proxy servera na serveri, nakonfigurovaný dôveryhodný rozsah a či proxy server vydáva hlavičky protokolu UDP PROXY v2.

Pre inštaláciu proxy servera Minecraft a konfiguráciu backendu, postupujte podľa Velocity a BungeeCord.

Simple Voice Chat

Raknetify2 môže zdieľať svoj server UDP poslucháč s Simple Voice Chat na Fabric, Forge, NeoForge, Spigot a Paper.

Nainštalujte Simple Voice Chat na server a na každého klienta, ktorý chce hlasový chat a nasledujte jeho Sprievodca nastavením servera pre zvyšok konfigurácie.

Použite adresár config najvyššej úrovne servera pre súbor Raknetify2, vrátane Spigot/Paper.Vlastný súbor Simple Voice Chat zostáva v umiestnení špecifickom pre platformu nižšie.

Zdieľanie herného portu

  1. Vytvorte config/raknetify2-voicechat.json v adresári servera s týmto obsahom:

    {"enabled": true}

  2. Nastavte port=-1 v konfigurácii servera Simple Voice Chat. Na modifikovaných serveroch je to config/voicechat/voicechat-server.properties, na Spigot/Paper je to plugins/voicechat/voicechat-server.properties.

  3. Nechajte pole bind_address prázdne, ak existuje jeden zodpovedajúci poslucháč RakNet.Ak má server viac poslucháčov na tomto porte UDP, nastavte ho na lokálnu adresu poslucháča, ktorý chcete zdieľať.

  4. Reštartujte server a spustite /voicechat test <PLAYERNAME> pre pripojeného hráča.

Ak počúvacie zariadenie RakNet používa iný port ako Minecraft, nastavte hlas port na lokálny port UDP explicitne namiesto použitia -1.Napríklad počúvajúce zariadenie RakNet na lokálnom porte UDP 25570 potrebuje port=25570.

Nastavte voice_host, ak klienti potrebujú inú verejnú adresu alebo port. Pre router, ktorý presmeruje verejnú UDP 25580 na lokálnu UDP 25570, použite port=25570 a voice_host=play.example.com:25580. Verejná adresa patrí do voice_host. Nastavenie bind_address vyberá lokálny počúvač.

Raknetify2 poskytuje zdieľaný UDP socket cez API Simple Voice Chat, Simple Voice Chat sa stará o hlasovú autentifikáciu a šifrovanie, hráči môžu používať hlasový chat s hernými pripojeniami TCP alebo RakNet.

Ďalšie služby a proxy servery UDP

Udržujte Query a Geyser na samostatných UDP portoch. Integrácia zdieľaných soket podporujú iba Simple Voice Chat.

Integrácia nezdieľa soket hlasového proxy na Velocity alebo BungeeCord. Postupujte podľa Sprievodca nastavením proxy Simple Voice Chat a dajte hlasovému proxy vlastný port UDP. S oficiálnym pluginom hlasového proxy, nastavte akékoľvek verejné prepísanie voice_host v hlasovej konfigurácii proxy. Tento plugin ignoruje nastavenia voice_host backend serverov.

Pre všeobecný tunel UDP nastavte voice_host na verejný názov hostiteľa a port UDP, ktorý presmeruje na tento server.

Vypnutie zdieľania alebo vyriešenie konfliktu soket

Ak denník hlási No RakNet listener matches the voice bind address and port, overte, či RakNet začal úspešne a že hlasový port a viazanie adresy zodpovedajú jeho lokálny poslucháč.

Ak hlási Multiple RakNet listeners match the voice bind address, vyberte špecifickú zodpovedajúcu lokálnu adresu v bind_address a reštartujte.

Iba jeden plugin Simple Voice Chat môže dodávať socket UDP.Ak sa pri spustení zobrazí hlásenie, že iný plugin už dodáva socket, vyberte, ktorú integráciu socketov použiť.

Ak chcete vypnúť integráciu Raknetify2, nastavte {"enabled": false} v konfigurácii hlasu alebo odstráňte tento súbor, dajte Simple Voice Chat samostatný port UDP, aktualizujte jeho firewall alebo pravidlá presmerovania a reštartujte server.

Riešenie problémov

TCP funguje, ale RakNet časy von

Skontrolujte ich v poradí:

  1. Klient má správny Raknetify2 mod pre jeho loader a Minecraft verziu.
  2. Server alebo proxy prijímajúce pripojenie má Raknetify2 nainštalovaný a spustený bez chyby počúvania.
  3. Adresa začína raknet; a používa verejný port UDP.
  4. Poskytovateľ hostingu, smerovač a hostiteľský firewall umožňujú UDP na tomto porte.
  5. IPv4 a IPv6 adresy hostname vedú k zamýšľanému hostiteľovi a majú funkčné pravidlá firewallu.

Úspešné pripojenie TCP potvrdzuje iba trasu TCP.Posledujte Konfigurácia firewallu a routera na kontrolu presmerovania UDP a prístupu IPv6. Ak je povolený protokol PROXY, klienti musia dosiahnuť poslucháča prostredníctvom nakonfigurovaného dôveryhodného proxy.

Adresa už používaná

Skontrolujte, či nie je iný proces, ktorý používa port UDP. Query, Geyser a ďalšie služby UDP potrebujú vlastné porty. Simple Voice Chat môže používať port Integrácia so zdieľaným portom.

Môžete si vybrať iný lokálny port UDP pomocou Nastavenia počúvača direct-server alebo Nastavenia Velocity a BungeeCord, skontrolujte verziu požadovanú pre nastavenie Spigot/Paper. Zmena iba verejného portu routera ponechá konflikt lokálneho socketu na mieste.

Pripojenie funguje, ale prenosy zlyhávajú

Pripojte sa priamo k cieľu pomocou adresy raknet;, ak to zlyhá, najprv opravte cieľový počúvací program alebo sieťovú trasu.

Ak fungujú priame spojenia, skontrolujte, či cieľový server prijíma prichádzajúce prenosy. Server Minecraft používajúci server.properties potrebuje accepts-transfers=true. Priame spojenia netestujú toto nastavenie.

Potom porovnajte transfer hostname a port TCP s config/raknetify2-transfers.json na odosielacom serveri. Overte, že súbor bol načítaný po reštarte a že klient podporuje automatické prenosy RakNet. Pozri Automatické prevody.

Chyby šifrovania alebo protokolu

Skontrolujte verzie Raknetify2 na oboch koncoch pripojenia, aktualizujte klienta a server alebo proxy spoločne, keď vydanie zmení šifrovaný protokol. Zachovávajte nastavenia overovania servera počas vyšetrovania.

Zlyhania špecifické pre mod

Zaznamenajte, ktorá akcia spôsobila zlyhanie, ako napríklad otvorenie inventára, prijatie balíka zdrojov, zmena sveta alebo spawning entity.Porovnajte rovnakú akciu na TCP a RakNet pomocou samostatnej testovacej inštalácie, ak je to praktické.

Niektoré vlastné payloady závisia od poradia vanilla paketov, ktoré môžu autori mod deklarovať cez Rozhranie na objednávanie paketov.

Nahlásiť chybu

Otvorte problém v Sledovanie problémov Raknetify2 a zahrňte:

  • Minecraft, Java, loader a Raknetify2 verzie na oboch koncoch.
  • Verzie serverového a proxy softvéru, vrátane akéhokoľvek UDP forwarding proxy.
  • Ostatné nainštalované mody a ich verzie.
  • Kroky na reprodukciu problému a čo ste očakávali, že sa stane.
  • Či rovnaké kroky fungujú aj na TCP.
  • Relevantné klientske, serverové a proxy protokoly z rovnakého pokusu.

Pred nahratím denníkov odstráňte prístupové tokeny, heslá a iné súkromné informácie a zachovávajte správy o výnimkách a stopy zásobníkov potrebné na diagnostiku problému.

Integrácia s Mod

V Raknetify2 môžu mody určiť, ktoré pakety Minecraftu musia prísť v správnom poradí s ich vlastnými správami. Použite to, keď spracovanie správy vyžaduje entitu, časť sveta, inventár alebo iný stav vytvorený skoršími paketmi.

Objednávanie skupín

Skupina Súvisiaca návštevnosť
ui Svetovo nezávislé menu a interakcie
entity Vznik, odstránenie a presun entity
world_interaction Zásoby a iné interakcie závislé od sveta
effects Zvuky a častice
chunk Aktualizácie terénu, blokov a osvetlenia

Všetky skupiny udržiavajú spoľahlivé usporiadané doručovanie v rámci svojho kanála. Pakety v rôznych skupinách môžu prísť v rôznom relatívnom poradí. Vyberte skupinu zodpovedajúcu závislosti payloadu.

Voliteľná integrácia Fabric

Pridajte poskytovateľa pod vstupným bodom raknetify:packet_channels v fabric.mod.json vášho módu. Poskytovateľ implementuje Consumer<BiConsumer<String, String>> pomocou typov JDK, dostane registrátor, ktorý prijíma vlastný identifikátor payload a objednávaciu skupinu.

Zlúčte túto položku do existujúcich metaúdajov a nahraďte názov triedy úplným názvom poskytovateľa:

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

Zachovať zvyšok vášho fabric.mod.json, vrátane jeho existujúcich vstupných bodov.Toto je fragment súboru metadát.

Napríklad rozšírenie pohybu entity môže zaregistrovať example:entity_path so skupinou entity.Dokumentácia k PacketOrdering API zahŕňa implementáciu poskytovateľa.

Fabric ponechá tento vstupný bod nevyvolaný, keď Raknetify2 Poskytovatelia by mali deklarovať identifikátory a skupiny počas inicializácie bez toho, aby sa spoliehali na to, že iný mod dokončí svoju vlastnú inicializáciu.

Správanie pri registrácii

Forge a NeoForge mods, server alebo proxy pluginy, môžu volať PacketOrdering.register(identifier, group) počas inicializácie, keď je Raknetify2 k dispozícii. trieda je com.ishland.raknetify.api.PacketOrdering. Register pred prijatím pripojenia hráča, a udržať voliteľný integračný kód z načítania Raknetify2 triedy, keď závislosť chýba.

Deklarácie sa vzťahujú na nové pripojenia. Existujúce pripojenia si zachovávajú pravidlá, ktoré dostali pri nastavovaní. Opakovanie identickej deklarácie je povolené. Konfliktné skupiny pre rovnaký identifikátor sú odmietnuté.

Identifikátory payloadu musia používať platný vlastný priestor názvov. Priestor názvov minecraft je vyhradený. Obmedzenie pre celý koncový bod sú deklarácie 128 vrátane vstavaných pravidiel a registrácií z iných mods. Identifikátory môžu obsahovať až 255 ASCII znaky pomocou syntax identifikátora priestoru názvov API.

Aktualizované RakNet Server alebo proxy server môže použiť deklaráciu partnera, ak nemá žiadne lokálne pravidlo pre dané užitočné zaťaženie. Lokálne pravidlá majú prednosť a deklarácie partnera zostávajú v rozsahu daného pripojenia.

Proxy servery UDP

Pozri UDP forwarding a PROXY protokol pre UDP relé a presmerované klientske adresy.

Pre nastavenie Minecraft proxy, pozri Velocity a BungeeCord.

English (US)

Clone this wiki locally