Repository navigation
Wiki cs cz
- Domů
- Instalace
- Velocity a BungeeCord
- Konfigurace firewalla a routeru
- Souhlasnost
- Seřazený režim
- Automatické převody
- Přesměrování UDP a PROXY protokol
- Simple Voice Chat
- Řešení problémů
- Integrace modů
- UDP proxyy
Síťová spojení přes RakNet pro klienty a servery Minecraftu.
| 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 |
-
Hra více hráčů
-
Přidat server
-
Adresa serveru
Adresa serveru RakNet · UDP raknet;play.example.com:25565TCP play.example.com:25565 -
Hotovo
-
Připojit se
| F3 | |
|---|---|
| RakNet · UDP | Aktivní · MTU 1400 |
| TCP | Neaktivní |
- Klient · Raknetify2 → UDP → Velocity / BungeeCord · Raknetify2
- 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 |
| Adresa serveru | UDP |
|---|---|
raknet;play.example.com:25580 |
play.example.com:25580 → NAT → 192.0.2.10:25570
|
Server · 192.0.2.10
|
25570/udp |
Server / Velocity / BungeeCord
| JSON | |
|---|---|
| ① ② ③ | {"mode":"ordered"} |
| ① ∥ ② ∥ ③ | {"mode":"multichannel"} |
| 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
| Adresa serveru | 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"]}-
Server A · Fabric / Forge / NeoForge ·
config/raknetify2-transfers.json{"destinations":[{"host":"play.example.com","tcpPort":25565,"udpPort":25570}]} -
Server B ·
play.example.com·server.properties→accepts-transfers=true -
Server A ·
/transfer play.example.com 25565 Alex→ Klient (Alex) → RakNet ·play.example.com:25570
| Minecraft | |
|---|---|
ui |
Možnosti |
entity |
kostlivec |
world_interaction |
Inventář |
effects |
Částice |
chunk |
Bloky |
- Fabric · Minecraft / Java · English
- Forge / NeoForge / Spigot / Paper · GitHub Releases
Raknetify2 používá pro hru více hráčů v Minecraftu protokol RakNet nad UDP. Provoz rozděluje do několika kanálů, z nichž každý zachovává vlastní pořadí paketů. Při ztrátě paketu v jednom kanálu mohou ostatní dál přenášet data. Hra tak může reagovat na akce hráče i při opětovném odesílání chybějících dat nebo přenosu chunků světa.
Raknetify2 je samostatně udržovaný fork modu Raknetify, jehož původním autorem je ishland. Přidává podporu novějších verzí Minecraftu a udržuje přenosovou vrstvu, integrace s platformami a testy kompatibility.
- Ověřte kompatibilitu Minecraftu a modů.
- Vyberte si stažení a nainstalujte ho.
- Připojte se k adrese jako
raknet;play.example.com.
- Velocity a BungeeCord
- Konfigurace firewalla a routeru
- Automatické převody
- Přesměrování UDP a PROXY protokol
- Sdílení portu UDP se Simple Voice Chat
- Řešení problémů a hlášení chyb
Autori modů mohou použít rozhraní pro řazení paketů k deklarování závislostí mezi vlastními náplněmi a provozem v Minecraftu.
Raknetify2 používá licenci MIT a zachovává původní oznámení o autorských právech. Jeho síťové provedení je založeno na Raknetify a netty-raknet.
Stáhněte verzi z GitHub Releases. Před instalací zkontrolujte verzi Minecraftu a požadavky na loader na tuto verzi.
| Kde se instalujete | Soubor | Složka |
|---|---|---|
| Fabric klient nebo server | raknetify2-fabric-*.jar |
mods |
| Forge client nebo server | raknetify2-forge-*.jar |
mods |
| NeoForge klient nebo server | raknetify2-neoforge-*.jar |
mods |
| Spigot nebo Paper server | raknetify2-spigot-*.jar |
plugins |
| Velocity proxy | raknetify2-velocity-*.jar |
plugins |
| BungeeCord proxy | raknetify2-bungee-*.jar |
plugins |
Zavřete klienta nebo zastavte server před nahrazením jeho JAR souboru. Odstraňte původní Raknetify JAR a jakýkoli starší Raknetify2 JAR soubor z téže instalace před přidáním nového souboru.
Klientovy složky patří k instance Minecraft nebo modpacku, který spouštíte. Serverové a proxy složky patří k instalaci serveru nebo proxy. Vytvořte odpovídající složku, pokud vám její vytvoření ještě nebylo zajištěno.
- Nainstalujte klientský mod pro svůj loader.
- Nainstalujte odpovídající serverový mod nebo plugin Spigot/Paper na kompatibilním serveru.
- Postupujte podle konfigurace firewalla a routeru, abyste povolili UDP spojení se serverem.
- Znovu spusťte klienta i server.
- Přidejte adresu serveru, například
raknet;play.example.comneboraknet;play.example.com:25565.
Adresy bez předpony raknet; používají TCP.
Samotné instalování klientového modu nepřidává podporu RakNetu na vzdálený server. Provozovatel serveru musí poskytnout RakNet endpoint. Hráči, kteří se připojují k serveru někoho jiného, obvykle nepotřebují pravidla pro přeposílání dat na vstupní straně.
Nainstalujte odpovídající proxy plugin a klientní mod. Pro nastavení posluchačů, přesměrování backendu, omezení přístupu a adresy, kterou hráči by měli používat, postupujte podle pokynů Velocity a BungeeCord.
Pro přímý Minecraft server nastavte níže odpovídající Java argument. Operátoři proxy by měli použít nastavení Velocity a BungeeCord listener.
| Platforma | Java argument | Přijaté porty |
|---|---|---|
| Server Fabric, Forge nebo NeoForge | -Draknetify.fabric.portOverride=25570 |
1 až 65534
|
| Spigot nebo Paper server | -Draknetify.spigot.portOverride=25570 |
1 až 65535
|
Forge a NeoForge používají sdílený kód naslouchání, takže jejich název vlastnosti také obsahuje fabric. Nahraďte 25570 požadovaným UDP portem.
Spigot / Paper ≥ 0.1.0-beta.1.431
Přidejte argument před -jar do Javského příkazu, nebo do pole argumentů JVM vašeho hostitele. Znovu spusťte server a povolte UDP na vybrané portu poslechu. Pokud je veřejný port také 25570, připojte se pomocí raknet;play.example.com:25570. Pokud router port překládá, použijte jeho veřejný port v adrese klienta. TCP port zůstane na svém stávajícím hodnotě.
Na serverech Spigot/Paper používá RakNet pro UDP stejnou místní adresu jako Minecraft pro TCP. Neplatná hodnota nebo obsazený port UDP zabrání spuštění RakNetu. V protokolu při spuštění zkontrolujte skutečnou adresu a port UDP. Pokud chcete znovu použít číslo portu TCP, odeberte argument a server restartujte.
Router nebo UDP proxy může také použít jiný veřejný UDP port a přenášet daty na existující posluchač bez změny Java argumentů serveru.
Otevřete úspěšný spust main v GitHub Actions a stáhněte jeho Artifacts archiv. GitHub vyžaduje účet pro stahování pracovních artefaktů. Použijte výše uvedenou tabulku s instalačními informacemi k výběru JAR souboru z archivu.
Velocity a BungeeCord stojí mezi hráči a backendovými Minecraft servery. Instalujte Raknetify2 na proxy a na každém klientovi, který se připojí přes RakNet.
Raknetify2 klient --UDP--> Velocity nebo BungeeCord --TCP--> backend server
Backend servery pro tuto síťovou cestu nepotřebují Raknetify2. Stále potřebují mody, pluginy a podporu pro přeposílání, které vaše síť vyžaduje. Raknetify2 nepřekládá verze Minecraftu ani nezměňuje autentizaci účtu proxy serveru.
- Potvrďte, že běžné TCP spojení přes váš proxy fungují, včetně autentizace a přepínání mezi backendovými servery.
- Zastavte proxy a stáhněte odpovídající plugin z GitHub Releases.
- Položte
raknetify2-velocity-*-all.jarneboraknetify2-bungee-*-all.jardo složkypluginsproxyho. Odstraňte z této složky jakékoli starší pluginy Raknetify nebo Raknetify2. - Nainstalujte odpovídající mod Raknetify2 klienta podle návodu k instalaci.
- Zkontrolujte níže uvedená nastavení posluchače, restartujte proxy a prohlédněte si jeho log pro chyby posluchače RakNet.
- Povolení veřejného UDP provozu na proxy a omezení portů pro zpracování hraní hry, jak je popsáno v Konfiguraci firewalla a routeru.
Používejte kompatibilní verze Raknetify2 na klientovi a proxy. Před kombinací verzí zkontrolujte kompatibilitu.
Nastavení bind v velocity.toml určuje adresu a TCP port pro naslouchání Minecraftu Velocity. Raknetify2 obvykle používá stejné číslo portu pro UDP. Položky [servers] identifikují backendové servery. Udržujte tyto položky směřující na backendové TCP adresy. Podívejte se na konfigurační reference Velocity.
Chcete-li použít samostatný UDP port, přidejte tento argument JVM před -jar v startovacím příkazu Velocity:
-Draknetify.velocity.portOverride=25570
Vyměňte 25570 za váš zvolený port. Tím se změní RakNet UDP port, přičemž zůstávají zachovány Velocity TCP port a adresy backendu. Po změně argumentu restartujte Velocity.
Nastavte přesměrování hráčů jak na Velocity, tak na jeho základní servery. Používejte moderní přesměrování, pokud základní software to podporuje, a udržujte toto přesměrování tajně. Dodržujte pokyny specifické pro základní servery v průvodci přesměrováním informací o hráčích Velocity. Zároveň udržujte na místě omezení základního firewally.
V konfiguračním souboru BungeeCord config.yml hodnota host pod každým polím listeners určuje adresu a TCP port pro naslouchání v Minecraftu. Raknetify2 obvykle na této portové číslo přidá UDP. Polí servers se nacházejí základní TCP adresy. Tato nastavení jsou popsána v guárdě konfigurace BungeeCord.
Pro samostatný UDP port přidejte tento JVM argument před -jar v startovacím příkazu BungeeCord:
-Draknetify.bungee.portOverride=25570
Přesun může ovlivnit celý proces delegování. U konfigurace s více posluchači pro Minecraft se ujistěte, že skutečné RakNet koncové body jsou uvedeny v startupové logování, než přidáte pravidla firewalla. Po změně argumentů restartujte BungeeCord.
Ověřování účtů na proxy serveru ponechte zapnuté. Pro backendové servery Spigot doporučuje návod BungeeCord k předávání IP adres zapnout ip_forward: true na proxy a settings.bungeecord: true na backendu. Samotné předávání nezabrání přímému připojení k backendu. Přístup omezte podle návodu k firewallu.
Oba způsoby přepínání přijímají porty od 1 do 65534. Neplatné hodnoty jsou ignorovány, proto se ujistěte, že je určen správný UDP port v startupové logování. Odstráňte daný argument a restartujte počítač, abyste se vrátili na pořadové číslo portu posluchače pro Minecraft.
Hráči se připojují k veřejnému hostovému názvu proxy a k UDP portu, například raknet;play.example.com:25570. Když router překládá porty, použijte jeho veřejný UDP port v adrese klienta. Adresy bez prefixu raknet; nadále používají TCP posluchač proxy.
Nechte Query, Geyser a další služby UDP na samostatných UDP portech. Jiný TCP port nevyřeší konflikt s UDP sockety.
Simple Voice Chat používá svůj vlastní proxy plugin a UDP port na platformách Velocity a BungeeCord. Pro nastavení tohoto prostředí sledujte pokyny pro použití proxy pro hlasovou komunikaci zde.
Pokud se před vaším Minecraft proxy nachází samostatný UDP relay, který odesílá hlavičky protokolu PROXY v2, nakonfigurujte Raknetify2 pomocí přesměrování UDP a protokolu PROXY. Instalace Velocity nebo BungeeCord samostatně nevyžaduje takovou konfiguraci.
Testujte z vnější lokální sítě pomocí klienta Raknetify2. Připojte se prostřednictvím proxyho, přepněte mezi používanými backend servery a ujistěte se, že identita hráče a oprávnění zůstávají správné.
- Pokud funguje TCP přes proxy, ale RakNet dojde k timeoutu, zkontrolujte UDP posluchače proxy, veřejný port, trasy IPv4 a IPv6 a pravidla firewalla.
- Pokud se oba transporty selžou při připojení proxy k backendu, zkontrolujte TCP adresu backendu, pravidla přístupu a konfiguraci přesměrování hráčů.
- Pokud proxy hlásí obsazený UDP port, zkontrolujte, zda není obsazený procesem Query, Geyser, hlasovým proxym nebo jiným procesem, který k němu je připojen.
Pro hlášení zahrněte jak logy proxy, tak i logy backendu z téže pokusy o připojení. Informace o verzi zahrnout naleznete v Řešení problémů.
Tento průvodce je určen pro provozovatele serverů. Raknetify2 potřebuje funkční UDP směrování k serveru nebo proxyu, který přijímá RakNet spojení. Výchozí nastavení používá stejný port jako TCP posluchač Minecraftu.
Pro hráče ve stejné lokální síti použijte lokální adresu serveru a povolente UDP přes jeho firewall. Potřebujete přepisování portů routeru, pokud musí internetový provoz procházet IPv4 NAT vašeho routeru.
Odesílejte veřejný UDP provoz na stroj, který provozuje Minecraft server s Raknetify2. Cílová port je RakNet UDP posluchač tohoto serveru. Tento port musí být povolen ve firewallech hostitelského počítače. Zachovejte také stávající TCP směrování pro běžné Minecraft připojení.
Například, pokud Raknetify2 naslouchá na UDP portu 25570, přenášejte veřejný UDP port na lokální adresu serveru na portu 25570. TCP port serveru může zůstat na 25565. Viz nastavení posluchače na serveru, abyste si vybrali jiný UDP port.
Odesílejte veřejný UDP provoz na stroj spuštěný s Velocity nebo BungeeCordem pomocí pluginu Raknetify2. Použijte posluchač UDP RakNet od proxy serveru jako cíl přenášení. Zachovejte stávající veřejnou TCP trasu proxy serveru pro běžné Minecraft připojení.
Proxy se připojuje k backendovým Minecraft serverem přes TCP. Přidání Raknetify2 do proxy nevyžaduje otevření UDP portů pro hraní hry pro hráče.
| Připojení | Přístup povolený |
|---|---|
| Hráči na proxy | Veřejný UDP připojení k posluchači RakNet, spolu s existujícím veřejným TCP posluchačem. |
| Proxy k backendovým serverem | Porty TCP backendových serverů Minecraftu dostupné pouze z určených proxy serverů |
| Hráči přesměrujte přímo na backendové porty pro hraní. | Zůstaňte uzavření, včetně prostřednictvím IPv6. |
Když proxy a backendové servery běží přímo na vyhrazeném počítači, který řídíte, mohou backendoví posluchači používat loopback adresy s proxy konfigurovaným tak, aby k nim mohli dosáhnout. Mezi počítači omezujte TCP přístup k proxy hostům pomocí firewalla nebo izolované privátní sítě. Kontejnery a spravované hosty potřebují odpovídající omezení pro své síťové uspořádání. Viz Velocityův průvodce bezpečností backendů a BungeeCordův průvodce firewallem.
Převod hráčů a omezení firewallu fungují společně. Přímo přístup k backendu může obejít kontroly přihlášení proxy serveru. Pro instalaci pluginů, nastavení převodu a přepínání UDP portů se podívejte na Velocity a BungeeCord.
Veřejná portová adresa a port posluchače se mohou lišit, když router mezi nimi překládá.
| Nastavení | Port k použití |
|---|---|
| Adresa klienta a serveru | Veřejný UDP port |
| Přepravní pravidlo routeru pro externí port | Veřejný UDP port |
| Vnitřní port pravidel přenášení routeru | UDP port posluchače RakNet |
| Lokální port firewallem hostitele | UDP port posluchače RakNet |
Pro hostování za IPv4 routeru:
- Najděte lokální IPv4 adresu stroje, který přijímá RakNet spojení. Použijte rezervaci DHCP nebo vhodnou statickou adresu, aby pravidlo přesměrování nadále cílilo na tento stroj.
- Přidejte pravidlo přesměrování UDP pro veřejnou portovou adresu, kterou budou používat hráči.
- Nastavte cíl pravidla na lokální adresu této mašiny a na UDP port posluchače RakNet.
- Povolení vstupního UDP na portu posluchače ve firewalle hostitele.
Například server naslouchající na UDP portu 25565 může použít pravidlo s veřejným portem 25565, cílovou adresou 192.168.1.100 a cílovým portem 25565. Přepojujte příkladnou adresu na skutečnou lokální adresu vašeho serveru.
Zachovejte stávající pravidlo TCP pro běžné Minecraftové spojení. Pravidlo přesměrování TCP sám o sobě nepřenáší UDP.
Zkontrolujte, zda jiný router nebo váš poskytovatel internetových služeb provádí NAT předtím, než se provoz dostane k vašemu routeru. S dvěma routery musíte ovládat přenosem pro oba. Pokud váš poskytovatel internetových služeb používá NAT na úrovni operátora, zeptejte se, zda může poskytnout veřejnou IPv4 adresu nebo použít hostovací službu nebo tunel, který podporuje vstupní UDP. Pravidla přenosu vašeho routeru nemohou konfigurovat NAT poskytovatele internetových služeb. Viz pokyny TP-Linku pro portový přenos ohledně požadavků na veřejnou WAN adresu.
Povolení vybranému UDP portu prostřednictvím firewallu routeru pro IPv6 a firewallu hostitele. Cílová adresa IPv6 počítače, který přijímá RakNet spojení.
Zkontrolujte, zda IPv6 adresa hostového názvu směřuje k této mašině. Pokud se její IPv6 adresa změní, aktualizujte záznam DNS a všechna pravidla firewalla specifická pro danou adresu.
Název hostitele, který publikuje jak adresy IPv4, tak IPv6, potřebuje funkční směrování pro každou publikovanou adresu. Zkontrolujte oba soubory pravidel, pokud jeden hráč může připojit, zatímco druhý ne.
Pokud změna směrování IPv4 změní číslo portu, ujistěte se, že port, který používají hráči, dosáhne také IPv6 posluchače. Překlad portu pro IPv4 nekonfiguruje trasu pro IPv6.
Provedovatel nebo tunel musí podporovat protokol UDP na veřejném koncovém bodu, který poskytnete hráčům. Zkontrolujte jeho alokace portů, pravidla síťového firewalla a také vlastní firewall serveru.
Pokud dodatečný UDP proxy přenáší adresy klientů pomocí protokolu PROXY v2, postupujte podle UDP přesměrování a protokolu PROXY a omezte přístup k přijímajícímu UDP posluchači pouze na důvěryhodný proxy.
Připojte se z vnější lokální sítě serveru s aktualizovaným klientem Raknetify2, pomocí adresy např. raknet;play.example.com:25565. Použijte ve této adrese veřejný UDP port.
Použijte skutečné RakNet připojení k ověření směru. Scán UDP, který neobdrží žádnou odpověď, může uvést nezávazný výsledek, protože funkční služba může odmítnout neznámý průzkum. Dokumentace Nmapu k UDP scánu toto chování vysvětluje.
Úspěšné TCP spojení potvrzuje pouze TCP trasu. Pokud RakNet dojde k časovému limitu, zkontrolujte posluchač, směrovací cíl, UDP port a pravidla firewalla pomocí návodu pro řešení problémů.
Zkontrolujte kompatibilitu s konkrétní verzí, kterou stáhnete. Vývojová větev může obsahovat podporu, která ještě nebyla zavedena v žádné verzi.
Verze Minecraft a Java · English
Požadavek na Java, který stanovilo Raknetify2, je minimální. Minecraft nebo loader mohou vyžadovat novější runtime. Vyberte verzi Java, která splňuje všechny tři požadavky.
Používejte stejnou verzi Raknetify2 na klientovi i na serveru nebo proxy, který přijímá jeho spojení, pokud je to možné. Před kombinací verzí se podívejte na poznámky k verzi. Zakódovaná RakNet spojení vyžadují podporu autentizovaného šifrovacího protokolu na obou stranách. Původní verze Raknetify a Raknetify2 z doby před zavedením tohoto protokolu nemohou vytvořit tyto zakódované spojení s aktualizovanými protějšky.
Raknetify2 přenáší stávající herní protokol Minecraftu. Pro spojení různých verzí Minecraftu je potřeba kompatibilní nastavení překladu protokolu.
V případě selhání v rozsáhlejším modpacku sledujte návod k řešení problémů. Do své zprávy zahrněte kompletní verze modů.
Raknetify2 obvykle umožňuje, aby ostatní kanály přenášely pakety i v době, kdy jeden kanál čeká na chybějící data. V režimu se zachováním pořadí procházejí všechny pakety Minecraftu jedním kanálem. Ztracený paket pak zdrží všechny další pakety v daném směru až do opětovného doručení. Některé nástroje proti podvádění toto pořadí vyžadují. Během čekání se v tomto režimu pozastaví i nesouvisející herní provoz.
-
Nainstalujte na serveru nebo proxy, který přijímá RakNet spojení, verzi Raknetify2 podporující zpočátku režim, a také na každém RakNet klientovi.
-
Vytvořte soubor
config/raknetify2-compatibility.jsonv adresáři toho serveru nebo proxy serveru. Pokud adresářconfigneexistuje, vytvořte ho. -
Přidejte následující:
{"mode": "ordered"} -
Znovu spusťte server nebo proxy.
Klienti automaticky následují nastavení serveru. Hráči nemusí vytvářet konfigurační soubor ani měnit adresu svého serveru RakNet.
Všechna Minecraftová pakety používají jeden spolehlivý, uspořádaný kanál v každém směru, včetně rozlišovačů balíčků a přechodů mezi světy.
Když hráči připojí prostřednictvím Velocity nebo BungeeCord, musíte na tom proxy nastavit režim pořadového připojení, i když anti-cheat funguje na backendovém serveru.
Tato politika platí pro všechny backend přepínače. V režimu pořadového přenosu proxy přenáší požadavky na udržování spojení na skutečného klienta místo toho, aby je zodpovídal lokálně.
Při prvním spojení přes RakNet konzole hlásí:
Raknetify2 compatibility: ordered (updated clients required, genuine acknowledgements)
Úspěšný výměna kompatibility také zaznamenává ordered compatibility negotiated, po kterém následuje adresa protějšku.
Udržujte kontroly proti cheatování aktivované a ověřujte své konkrétní nastavení.
RakNet klienty, které nepodporují řazený režim, se nemohou připojit k serveru, který ho vyžaduje. Aktualizujte Raknetify2 na těchto klientech nebo se připojte pomocí normální TCP adresy a portu serveru nebo proxy bez prefixu raknet;.
Změněte soubor na:
{"mode": "multichannel"}Poté restartujte server nebo proxy. Odstranění souboru také obnoví režim více kanálů po restartu.
Soubor musí obsahovat přesně jednu nastavení s názvem mode, jejíž hodnota musí být buď "ordered", nebo "multichannel". Hodnoty záleží na velikosti písmen.
Neplatná nebo nečitelná konfigurace odmítá RakNet spojení. Opravte soubor a znovu spusťte proces.
Pokud konzole stále hlásí multichannel, ověřte, zda je soubor v pracovním adresáři serveru nebo proxyu, který přijímá RakNet spojení, a poté restartujte tento proces.
Seriály Fabric, Forge a NeoForge mohou při přenosu schopného klienta na konfigurovaný cíl použít RakNet. To využívá nativní podporu přenosu v Minecraftu, která byla zavedena v Java Edition 1.20.5. Ujistěte se, že vaše verze Raknetify2 podporuje danou verzi a loader v Minecraftu na obou stranách.
Nainstalujte Raknetify2 na serveru odesílání a na klientovi. Cílový server musí mít kompatibilní službu pro přijímání dat typu RakNet a musí přijímat příchozí přenosy dat typu Minecraft.
Tato konfigurace se vztahuje na přenosy odesílané třemi výše uvedenými modovými načítateli. Pluginy Spigot/Paper, Velocity a BungeeCord tento soubor přenosů nečtou.
Vytvořte soubor config/raknetify2-transfers.json v adresáři serveru, který odesílá data.
{
"destinations": [
{
"host": "play.example.com",
"tcpPort": 25565,
"udpPort": 25570
}
]
}Vyměňte příkladný hostovací název a porty za hodnoty vašeho cílového zařízení, poté restartujte server. Další cílová zařízení se přidají do stejného pole.
| Pole | Význam |
|---|---|
host |
Cílová hostové jméno nebo IP adresa, bez předpony pro přenos nebo portu. |
tcpPort |
Cílová port v původní transakční žádosti |
udpPort |
Veřejný port RakNet, se kterým se přenáší klient, by měl kontaktovat |
Čísla portů TCP a UDP mohou být stejná. Pokud router překládá porty UDP, použijte veřejný port uvedený v tomto souboru. Čísla portů zapište jako čísla v formátu JSON.
Odesíláte přenosy na běžné hostové jméno a TCP port cílového počítače. Raknetify2 zkontroluje, zda klient propaguje podporu automatického přenosu. U schopného klienta a odpovídajícího cíle vybere konfigurovaný UDP port. Ostatní klienti a neodpovídající cíle zachovají původní adresu přenosu.
Vyhledávání používá název hostitele a TCP port z požadavku na přenos. Název hostitele je zvýrazněn velkými písmeny, koncový bod DNS je odstraněn a pravopis IPv6 je normalizován. Vyhledávání v DNS neúčinkuje při vyhledávání, takže dvě různé názvy hostitelů, které odpovídají stejné adrese, vyžadují samostatné záznamy. Záznamy s wildkardovými značkami nejsou podporovány.
Pro cílový server s konfigurací v server.properties Minecraftu nastavte accepts-transfers=true a restartujte ho. Cílový proxy může mít svá vlastní nastavení přenosů. Standardně Minecraft odmítá příchozí přenosy, i když normální připojení funguje.
Cílový RakNet posluchač, veřejné přeposílání UDP a firewaj hostitele musí být již nakonfiguroveny. Soubor přenosů odesílajícího serveru vybírá adresu, která je odeslána klientovi.
Zkontrolujte jak IPv4, tak IPv6 směrovky cílového počítače, když je jeho název hostitele publikován pro oba typy adres. Před zkoumáním chování automatického přenosu proveďte běžné přímé spojení přes RakNet s cílovým počítačem.
Zachovejte všechna kontroly přihlášení nebo přístupu k cílovým místem. Tato konfigurace neumožňuje hráčům přístup ani nezastupuje autentizaci serveru.
Chybějící pole, neznámá pole, neplatná porty a duplicitní cíle způsobují konfigurační chybu během inicializace. Použijte serverový log k identifikaci chyby, opravte JSON a restartujte server.
Chcete-li deaktivovat automatické výběr, odstraňte konfigurační soubor nebo použijte {"destinations": []}, poté restartujte server pro odesílání. Jeho přenosové požadavky si zachovají své původní adresy.
UDP proxy může přenášet RakNet provoz a zachovat původní adresu klienta pomocí protokolu PROXY v2. Tuto funkci povolte, když upstream UDP proxy odesílá tyto hlavičky vašemu posluchači. Běžné přeposílání portu routeru to nevyžaduje.
Na serveru nebo v Minecraft proxy, který přijímá přenesený UDP provoz, vytvořte soubor config/raknetify2-proxy-protocol.json:
{
"trustedProxies": ["192.0.2.10"]
}Místo příkladu použijte skutečnou zdrojovou IP adresu UDP proxy nebo rozsah CIDR, který kontrolujete. Adresa musí odpovídat tomu, co přijímající server vidí po jakémkoli NAT přerušení. Přijímané jsou literály IPv4 a IPv6. Názevům DNS jsou odmítnuty. Znovu spusťte přijímající server nebo proxy.
Konfigurujte převodový proxy tak, aby odesílal hlavičky protokolu PROXY v2 pro UDP. Raknetify2 přijímá převzaté adresy klientů pouze z uvedených zdrojů. Přímé RakNet spojení bez těchto hlaviček jsou odmítnuty, když je tato konfigurace aktivována. TCP posluchač si zachovává svou stávající konfiguraci.
Každý proxy server v seznamu může předávat adresy klientů. Na firewallu cílového serveru povolte přístup k jeho portu UDP pouze z určeného proxy serveru. Mezi důvěryhodné adresy zahrňte jen nejnutnější rozsahy.
Soubor musí obsahovat pouze trustedProxies, minimálně jednu položku. Prázdný pole je chybou. Neplatný soubor zabrání spuštění RakNet posluchače.
Aby se znovu vrátilo k přímým UDP spojením, odstraňte soubor a restartujte posluchač. Zároveň aktualizujte chování převodu dat z upstreamu a pravidla firewalla pro novou trasu.
Pokud se připojení po aktivování této funkce nezdaří, zkontrolujte skutečnou zdrojovou adresu proxy na backendu, konfigurovaný důvěryhodný rozsah a zda proxy vysílá hlavičky protokolu UDP PROXY verze 2.
Pro instalaci proxy pro Minecraft a konfiguraci backendu sledujte Velocity a BungeeCord.
Raknetify2 může sdílet svého serverového posluchače pro UDP s prostředím Simple Voice Chat v prostředcích Fabric, Forge, NeoForge, Spigot a Paper.
Nainstalujte Simple Voice Chat na serveru a na každém klientovi, který chce hlasový chat. Pro ostatní konfiguraci postupujte podle průvodce serverovou instalací.
Použijte nadřazenou složku config serveru pro soubory Raknetify2, včetně souborů v prostředí Spigot/Paper. Soubory Simple Voice Chat zůstávají na ploše specifické pro danou platformu.
-
V adresáři serveru vytvořte soubor
config/raknetify2-voicechat.jsons následujícím obsahem:{"enabled": true} -
Nastavte
port=-1v konfiguraci serveru Simple Voice Chat. Na modifikovaných serverech se nachází vconfig/voicechat/voicechat-server.properties. Na Spigot/Paper se nachází vplugins/voicechat/voicechat-server.properties. -
Vypusťte
bind_addressprázdné, pokud existuje jeden odpovídající posluchač RakNet. Pokud server má na tomto UDP portu více posluchačů, nastavte ho na lokální adresu posluchače, kterou chcete sdílet. -
Znovu spusťte server a spusťte
/voicechat test <PLAYERNAME>pro připojeného hráče.
Pokud RakNet posluchač používá jiný port než Minecraft, nastavte hodnotu port explicitně na tento lokální UDP port místo použití -1. Například RakNet posluchač na lokálním UDP portu 25570 potřebuje port=25570.
Nastavte voice_host, pokud klienti potřebují jinou veřejnou adresu nebo port. Pro router, který přenáší veřejný UDP port 25580 na lokální UDP port 25570, použijte port=25570 a voice_host=play.example.com:25580. Veřejná adresa se uvede v voice_host. Nastavení bind_address vybírá lokální posluchač.
Raknetify2 poskytuje sdílený UDP socket prostřednictvím API Simple Voice Chat. Simple Voice Chat zajišťuje autentizaci a šifrování hlasového komunikátu. Hráči mohou používat hlasové chatování s připojením k hernímu prostředí přes TCP nebo RakNet.
Query a Geyser musí být na oddělených UDP portech. Integrace sdíleného soka podporuje pouze Simple Voice Chat.
Integrace nesdílí soket pro hlasový proxy na Velocity nebo BungeeCord. Postupujte podle návodu k nastavení proxy pro Simple Voice Chat a přiřaďte hlasovému proxy samostatný UDP port. Pomocí oficiálního pluginu pro hlasový proxy nastavte jakékoli veřejné voice_host v konfiguraci proxy pro hlasové služby. Tento plugin ignoruje nastavení voice_host z backend serverů.
Pro obecný UDP tunel nastavte voice_host na veřejné hostové jméno a UDP port, který směruje na tento server.
Pokud log uvádí No RakNet listener matches the voice bind address and port, potvrďte, že RakNet byl úspěšně spuštěn a že hlasový port a adresa pro připojení odpovídají lokálnímu posluchači.
Pokud uvádí Multiple RakNet listeners match the voice bind address, vyberte konkrétní lokální adresu v bind_address a znovu spusťte zařízení.
Pouze jeden plugin Simple Voice Chat může poskytnout své UDP socket. Pokud startup zjistí, že již jiný plugin poskytuje socket, vyberte, jakou integraci socketu použít.
Abychom zablokovali integraci Raknetify2, nastavte {"enabled": false} v jeho hlasové konfiguraci nebo odstraňte tento soubor. Dejte Simple Voice Chatu samostatný UDP port, aktualizujte jeho firewall nebo přepisovací pravidla a restartujte server.
Zkontrolujte je v pořadí:
- Klient má správný mod Raknetify2 pro svůj loader a verzi Minecraftu.
- Server nebo proxy, který přijímá spojení, má nainstalovaný Raknetify2 a byl spuštěn bez chyb s posluchačem.
- Adresa začíná
raknet;a používá veřejný UDP port. - Hosting provider, router a firewallem hostu povoleny jsou služby UDP na tomto portu.
- Název hostitele, jeho adresy IPv4 a IPv6, vedou k zamýšlenému hostiteli a mají funkční pravidla firewallu.
Úspěšné TCP spojení potvrzuje pouze TCP trasu. Pro ověření UDP přenášení a přístupu k IPv6 sledujte konfiguraci firewalla a routeru. Pokud je povolen protokol PROXY, musí klienti dosáhnout posluchače prostřednictvím konfigurovaného důvěryhodného proxy.
Zkontrolujte, zda nepoužívá jiný proces UDP port. Služby Geyser a další UDP služby potřebují své vlastní porty. Simple Voice Chat může použít integraci s sdíleným portem.
Můžete si zvolit jiný lokální UDP port pomocí nastavení direct-server listener nebo nastavení Velocity a BungeeCord. Zkontrolujte požadavky na verzi pro nastavení Spigot/Paper. Změna pouze veřejného portu routeru zanechává lokální socketový konflikt.
Připojte se přímo k cílovému zařízení pomocí jeho adresy raknet;. Pokud to nevyjde, nejprve opravte posluchač cílového zařízení nebo síťovou trasu.
Pokud fungují přímé spojení, zkontrolujte, zda destinátus přijímá příchozí přenosy. Server Minecraftu používající server.properties musí mít nastavení accepts-transfers=true. Přímé připojení toto nastavení nezkouší.
Poté porovnejte název hostitele přenosu a TCP port s config/raknetify2-transfers.json na serveru odesílatele. Ujistěte se, že soubor byl načten po restartu a že klient podporuje automatické RakNet přenosy. Viz Automatické přenosy.
Zkontrolujte verze Raknetify2 na obou stranách spojení. Při změně šifovaného protokolu aktualizujte jak klient, tak server nebo proxy. Při vyšetřování zachovejte autentizační nastavení serveru.
Zaznamenejte, která akce způsobí selhání, jako je otevření inventáře, přijetí zdrojového balíčku, změna světů nebo vytvoření entity. Porovnejte stejnou akci přes TCP a RakNet pomocí samostatné testovací instalace, pokud je to možné.
Některé speciální payloady závisí na pořadí standardních paketů. Autori modů mohou tyto závislosti deklarovat prostřednictvím rozhraní pro pořadí paketů.
Otevřete problém v trackeru problémů Raknetify2 a zahrněte:
- Minecraft, verze Java, loader a Raknetify2 na obou stranách.
- Verze serverového a proxy softwaru, včetně jakéhokoli proxy pro přesměrování UDP.
- Další nainstalované mody a jejich verze.
- Kroky pro způsobení problému a to, co jste očekávali.
- Zda stejné kroky fungují i přes TCP.
- Výstupy z logů relevantních klientů, serverů a proxyů z téže pokusy.
Před nahráním logů odstraňte přístupové tokeny, hesla a další soukromé informace. Zachovejte zprávy o výjimkách a stavové stopy potřebné k diagnostice problému.
Raknetify2 umožňuje modům deklarovat, který Minecraft provoz musí zůstat uspořádaný pomocí jejich vlastních payloadů. Používejte to, když zpracování payloadu vyžaduje entitu, částici, inventář nebo jiný stav stanovený dřívějšími pakety.
| Skupina | Přidělený provoz |
|---|---|
ui |
Světově nezávislé menu a interakce |
entity |
Vznik entit, jejich odstranění a pohyb |
world_interaction |
Zásoby a další interakce závislé na světě |
effects |
Zvuky a částice |
chunk |
Aktualizace terénu, bloků a osvětlení |
Všechny skupiny zajišťují spolehlivý a uspořádaný doručování v rámci svého kanálu. Pakety v různých skupinách mohou dorazit v odlišném relativním pořadí. Vyberte skupinu, která odpovídá závislosti payloadu.
Přidejte poskytovatele pod položku raknetify:packet_channels v souboru fabric.mod.json vašeho modu. Tento poskytovatel implementuje třídu Consumer<BiConsumer<String, String>> s využitím typů JDK. Přijímá registrátora, který přijímá určitý identifikátor payloadu a skupinu pořadí.
Přidejte tuto položku do svých stávajících metadat a nahraďte název třídy plným kvalifikovaným názvem vašeho poskytovatele:
{
"entrypoints": {
"raknetify:packet_channels": [
"com.example.mod.OrderingProvider"
]
}
}Zachovejte zbytek vašeho fabric.mod.json, včetně jeho stávajících položek. Toto je úryvek z metadatové souboru.
Například rozšíření pohybu entit může zaregistrovat example:entity_path do skupiny entity. Dokumentace API pro řazení paketů obsahuje implementaci tohoto poskytovatele.
Fabric nezapne tento vstupní bod, když Raknetify2 chybí. Prodejci by měli během inicializace deklarovat identifikátory a skupiny, aniž by se spoléhali na to, že jiný mod dokončí svou inicializaci.
Mody Forge a NeoForge, stejně jako servery nebo proxy pluginy, mohou během inicializace, kdy je Raknetify2 k dispozici, zavolat PacketOrdering.register(identifier, group). Tato třída je com.ishland.raknetify.api.PacketOrdering. Registrované informace je potřeba zahrnout před přijetím spojení hráčů a zamezit tím nahrání tříd Raknetify2, pokud je závislost chybí.
Prohlášení platí pro nová spojení. Stávající spojení zachovávají pravidla, která přijala při nastavení. Je dovoleno opakovat identické prohlášení. Konfliktující skupiny pro stejný identifikátor jsou odmítnuty.
Identifikátory payloadu musí používat platný vlastní jmenný prostor. Jmenný prostor minecraft je vyhrazen. Limit pro celý endpoint je 128 deklarací, včetně vestavěných pravidel a registrací z jiných modů. Identifikátory mohou obsahovat až 255 ASCII znaků s použitím syntaxe jmenného prostoru API.
Aktualizovaní RakNet peerové hodnoty vyměňují deklarace během nastavení spojení. Server nebo proxy může použít deklaraci peeru, pokud nemá pro daný payload lokální pravidla. Lokální pravidla mají přednost a deklarace peeru zůstávají omezeny na toto spojení.
Viz Převod UDP a PROXY protokol pro informace o UDP relacích a převzatých klientových adresách.
Pro nastavení proxy v Minecraftu viz Velocity and BungeeCord.