Repository navigation
Wiki nn no
- Framside
- Installasjon
- Velocity og BungeeCord
- Brannmur- og ruterkonfigurasjon
- Kompatibilitet
- Ordnet modus
- Automatisk overføring
- UDP -vidaresending og PROXY -protokoll
- Simple Voice Chat
- Feilsøking
- Mod-integrasjon
- UDP -proxier
Nettverkssamband med RakNet for Minecraft-klientar og -tenarar.
| Minecraft | Raknetify2 | Klient / Tenar |
|---|---|---|
| Fabric | mods/raknetify2-fabric-*.jar |
Klient / Tenar |
| Forge | mods/raknetify2-forge-*.jar |
Klient / Tenar |
| NeoForge | mods/raknetify2-neoforge-*.jar |
Klient / Tenar |
| Spigot / Paper | plugins/raknetify2-spigot-*.jar |
Tenar |
| Velocity | plugins/raknetify2-velocity-*.jar |
Velocity |
| BungeeCord | plugins/raknetify2-bungee-*.jar |
BungeeCord |
-
Fleirspelar
-
Legg til tenar
-
Tenaradresse
Tenaradresse RakNet · UDP raknet;play.example.com:25565TCP play.example.com:25565 -
Ferdig
-
Logg på tenar
| F3 | |
|---|---|
| RakNet · UDP | Aktiv · MTU 1400 |
| TCP | Inaktiv |
- Klient · Raknetify2 → UDP → Velocity / BungeeCord · Raknetify2
- Velocity / BungeeCord → TCP → Tenar
| Portnummer · 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 |
| Tenaradresse | UDP |
|---|---|
raknet;play.example.com:25580 |
play.example.com:25580 → NAT → 192.0.2.10:25570
|
Tenar · 192.0.2.10
|
25570/udp |
Tenar / Velocity / BungeeCord
| JSON | |
|---|---|
| ① ② ③ | {"mode":"ordered"} |
| ① ∥ ② ∥ ③ | {"mode":"multichannel"} |
| Tenar | 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
| Tenaradresse | 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"]}-
Tenar A · Fabric / Forge / NeoForge ·
config/raknetify2-transfers.json{"destinations":[{"host":"play.example.com","tcpPort":25565,"udpPort":25570}]} -
Tenar B ·
play.example.com·server.properties→accepts-transfers=true -
Tenar A ·
/transfer play.example.com 25565 Alex→ Klient (Alex) → RakNet ·play.example.com:25570
| Minecraft | |
|---|---|
ui |
Innstillingar |
entity |
beinrangel |
world_interaction |
Opplag |
effects |
Partiklar |
chunk |
Blokker |
- Fabric ·
compatibility.json·gameVersions/runtimes/depends - Forge / NeoForge / Spigot / Paper · GitHub Releases
Raknetify2 bruker RakNet over UDP når fleire spelar Minecraft saman. Trafikken blir delt mellom kanalar som kvar held orden på sine eigne pakkar. Om ein pakke blir borte på éin kanal, kan data framleis kome fram på dei andre. Slik kan spelet svare på det du gjer medan tapte data blir sende på nytt eller delar av verda blir overførte.
Raknetify2 er ei sjølvstendig vidareføring av Raknetify, som ishland utvikla. Prosjektet støttar nyare Minecraft-versjonar og held ved like nettverkskoden, integrasjonane med ulike plattformer og testane av kva som fungerer saman.
- Sjekk kompatibilitet mellom Minecraft og mod.
- Vel ei nedlasting og installer den-en.
- Kopla til med ei adresse som
raknet;play.example.com.
- Velocity og BungeeCord
- Brannmur- og ruterkonfigurasjon
- Automatisk overføring
- UDP -vidaresending og PROXY -protokoll
- Deling av ein UDP -port med Simple Voice Chat
- Feilsøking og feilrapportering
Modutviklere kan bruka pakkeordningsgrensesnittet til å deklarera avhengnader mellom eigendefinerte nyttelast og Minecraft -trafikk.
Raknetify2 bruker MIT-lisensen og beheld dei opphavlege opphavsrettserklæringane. Nettverksimplementeringa byggjer på Raknetify og netty-raknet.
Last ned ei utgiving frå GitHub Releases. Sjekk Minecraft -versjon og loader-krav for den utgivinga før du installerer.
| Kvar du installerer | Fil | Mappe |
|---|---|---|
| Fabric klient eller servar | raknetify2-fabric-*.jar |
mods |
| Forge klient eller servar | raknetify2-forge-*.jar |
mods |
| NeoForge klient eller servar | raknetify2-neoforge-*.jar |
mods |
| Spigot - eller Paper -servar | raknetify2-spigot-*.jar |
plugins |
| Velocity -proxy | raknetify2-velocity-*.jar |
plugins |
| BungeeCord -proxy | raknetify2-bungee-*.jar |
plugins |
Lukk klienten eller stopp serveren før du erstattar JAR -fila. Fjern den originale Raknetify-en JAR -fila og alle eldre Raknetify2 JAR -filer frå same installasjon før du legg til den nye fila.
Klientmapper tilhøyrer Minecraft -instansen eller modpakken du køyrer. Servar- og proxymapper tilhøyrer den server- eller proxyinstallasjonen. Opprett den aktuelle mappa viss lasteren din enno ikkje har oppretta henne.
- Installer klientmodden for din loader.
- Installer den matchande servermodden, eller Spigot / Paper -plug-inen på ein kompatibel server.
- Følg Brannmur- og ruterkonfigurasjon for å tillata UDP -tilkoplingar til serveren.
- Start på nytt klienten og serveren.
- Legg til ei serveradresse som
raknet;play.example.comellerraknet;play.example.com:25565.
Adresser utan raknet; -prefiks bruker TCP.
Å installera berre klientmodden legg ikkje til RakNet -støtte til ein ekstern server. Serveroperatøren må tilby eit RakNet -endepunkt. Spelarar som koplar til nokon annan sin server treng vanlegvis ingen innkommande rutervidaresendingsreglar.
Installer han tilsvarande proxy-pluginen og klientmodden. Følg Velocity og BungeeCord for innstillingar for lyttarar, bakoverretting, tilgangsavgrensingar og adressa spelarane bør bruka.
For ein direkte Minecraft -servar, sett det aktuelle Java -argumentet nedanfor. Proxy-administratorar bør bruka Velocity - og BungeeCord -lyttarinnstillingane.
| Plattform | Java -argument | Aksepterte portar |
|---|---|---|
| Fabric -, Forge - eller NeoForge -servar | -Draknetify.fabric.portOverride=25570 |
1 til 65534
|
| Spigot - eller Paper -servar | -Draknetify.spigot.portOverride=25570 |
1 til 65535
|
Forge og NeoForge bruker delt lyttarkode, så eigenskapenamnet deira inneheld også fabric. Erstatt 25570 med ønskt UDP -port.
Spigot / Paper ≥ 0.1.0-beta.1.431
Legg til argumentet før -jar i Java -kommandoen, eller i JVM-en til verten -argumentsfelt. Start serveren på nytt og tillat UDP på den valde lytteporten. Dersom den offentlege porten også er 25570, kopla til med raknet;play.example.com:25570. Viss ein ruter omset porten, bruk dens offentlege port i klientadressa. TCP -porten held fram på sin eksisterande verdi.
På Spigot / Paper beheld UDP -lyttaren den lokale bindeadressa til Minecraft TCP -lyttaren. Ei ugyldig overstyring eller ein okkupert UDP -port forhindrar RakNet i å starta. Sjekk oppstartsloggen for den bundne UDP-en -adressa og porten. Fjern argumentet og start på nytt for å gå tilbake til TCP -portnummeret til lyttaren.
Ein ruter eller UDP -proxy kan også eksponera ein annan offentleg UDP -port og vidaresenda han til den eksisterande lyttaren utan å endra Java-en til serveren -argument.
Åpne ein vellykka main -køyring i GitHub Actions og last ned arkivet med dens Artifacts. GitHub krev ein konto for å lasta ned arbeidsflyt-artefaktar. Bruk installasjonstabellen ovanfor til å velja ein JAR frå arkivet.
Velocity og BungeeCord sit mellom spelarar og backend Minecraft -serverar. Installer Raknetify2 på proxyen og på kvar klient som skal kopla seg til via RakNet.
Raknetify2-klient --UDP--> Velocity eller BungeeCord --TCP--> bakanforliggjande tenar
Backend-serverane treng ikkje Raknetify2 for denne tilkoplingsvegen. Dei treng framleis moddene, plug-inane og vidaresendingsstøtta som krevst av nettverket ditt. Raknetify2 omset ikkje Minecraft -versjonar eller endrar proxyens kontoutentisering.
- Stadfest at vanlege TCP -tilkoplingar gjennom proxyen din fungerer, inkludert autentisering og byting mellom backend-servere.
- Stopp proxien og last ned den matchande plug-inen frå GitHub Releases.
- Plasser
raknetify2-velocity-*-all.jarellerraknetify2-bungee-*-all.jari proxyensplugins-mappe. Fjern alle eldre Raknetify - eller Raknetify2 -plug-ins frå den mappa. - Installer den aktuelle Raknetify2-en -klientmodden ved hjelp av installasjonsguiden.
- Sjekk lyttarinnstillingane nedanfor, start proxyen på nytt, og inspiser loggen for RakNet -lyttarfeil.
- Tillat offentleg UDP -trafikk til proxien og avgrens bakendespelportane som beskrive i Brannmur- og ruterkonfigurasjon.
Bruk kompatible Raknetify2 -utgivingar på klienten og proxyen. Sjekk Kompatibilitet før du blandar utgivingar.
The bind set inn velocity.toml vel Velocity ’s Minecraft lytteadresse og TCP port. Raknetify2 Bruker normalt det same portnummeret for UDP - Den. [servers] Disse oppføringane identifiserer backend-serverne. Hald desse oppføringane peikande mot backend-serveren. TCP Sjå alle adresser. Velocity ’s oppsettreferanse.
Slik bruker du ein separat UDP port, legg til dette JVM argument før -jar i Velocity ’s oppstartskommando:
-Draknetify.velocity.portOverride=25570
Erstatt 25570 med vald port. Dette endrar RakNet UDP -porten samtidig som det beheld Velocitys TCP -port og bakendadresser. Start Velocity på nytt etter å ha endra argumentet.
Konfigurer spelarvidaresending på både Velocity og dens bakendar. Bruk moderne vidaresending når bakend-programvaren støtter det, og hald vidaresendingsløyndommen privat. Følg bakend-spesifikke instruksjonar i Velocitys guide for vidaresending av spelarinformasjon. Behald bakend-brannmurrestriksjonene saman med vidaresendinga.
I BungeeCords config.yml identifiserer verdien host under kvar listeners -oppføring ein Minecraft -lytteadresse og TCP -port. Raknetify2 legg vanlegvis til UDP på det portnummeret. servers -oppføringane inneheld bakend- TCP -adresser. Desse innstillingane er beskrivne i BungeeCord konfigurasjonsguide.
For ein separat UDP port, legg til dette JVM argument før -jar i BungeeCord ’s oppstartskommando:
-Draknetify.bungee.portOverride=25570
Overstyringen tilhøyrer heile proxy-prosessen. For ein konfigurasjon med fleire Minecraft -lyttarar, sjekk dei faktiske RakNet -endepunkta i oppstartsloggen før du legg til brannmurreglar. Start BungeeCord på nytt etter å ha endra argumentet.
Behald kontogodkjenning på proxyen. For Spigot motorar, BungeeCord ’s Veiledning for Ip-vidaresending par ip_forward: true på mellomtenaren med settings.bungeecord: true Videresending åleine hindrar ikkje nokon frå å kopla seg direkte til ein backend. Avgrens backend-tilgang ved hjelp av brannmur-instruksjonar.
Begge proxyoverstyringene aksepterer portar frå 1 til 65534. Ugyldige verdiar blir ignorerte, så stadfest den bundne UDP-en -porten i oppstartsloggen. Fjern argumentet og start på nytt for å returnera til Minecraft -portnummeret til lyttaren.
Spillere koplar til proxyens offentlege vertsnamn og UDP -port, til dømes raknet;play.example.com:25570. Når ein ruter omset portar, bruk dens offentlege UDP -port i klientadressa. Adresser utan raknet; -prefiks held fram med å bruka proxyens TCP -lyttar.
La Query, Geyser og andre UDP -tenester køyra på separate UDP -portar. Ein annan TCP -port løyser ikkje ein UDP -sokkelkonflikt.
Simple Voice Chat bruker sin eigen proxy-plugin og UDP -port på Velocity og BungeeCord. Følg rettleiinga for stemmechat proxy for det oppsettet.
Viss ein separat UDP -relé sit framfor Minecraft -proxyen din og sender PROXY -protokoll v2-hoder, konfigurer Raknetify2 ved hjelp av UDP -vidaresending og PROXY -protokoll. Å installera Velocity eller BungeeCord åleine krev ikkje den konfigurasjonen.
Test frå utanfor det lokale nettverket ditt med ein Raknetify2 -klient. Kopl til via proxyen, byt mellom backend-serverne du bruker, og stadfest at spelaridentitet og løyve held fram med å vera korrekte.
- Viss TCP gjennom proxyen fungerer, men RakNet blir tidsavbroten, sjekk proxyens UDP -lyttar, offentleg port, IPv4 - og IPv6 -rutar, og brannmurreglar.
- Viss begge transportane feilar når proxyen koplar seg til ein backend, sjekk den backendens TCP -adresse, tilgangsreglar og spelarvidaresendingskonfigurasjon.
- Viss proxyen rapporterer ein okkupert UDP -port, sjekk etter Query, Geyser, ein stemmeprotokoll eller ein annan prosess som er bunden til den.
For rapportar, inkluder både proxy- og backend-logger frå same tilkoplingsforsøk. Sjå Feilsøking for versjonsinformasjonen du skal inkludera.
Denne guiden er for serveradministratorar. Raknetify2 treng ein fungerande UDP -rute til serveren eller ein proxy som aksepterer RakNet -tilkoplingar. Standardoppsettet bruker same portnummer som Minecrafters TCP -lyttar.
For spelarar på same lokale nettverk, bruk den lokale adressa til serveren og tillat UDP gjennom brannmuren til verten. Ruterportvidaresending er nødvendig når internettrafikk må kryssa IPv4-en til ruteren NAT.
Send offentleg UDP -trafikk til maskina som køyrer Minecraft -serveren med Raknetify2. Destinasjonsporten er RakNet-en til den serveren UDP -lyttar. Tillat den porten i vertmaskinens brannmur. Behald dens eksisterande TCP -rula for vanlege Minecraft -tilkoplingar.
Til dømes, viss Raknetify2 lyttar på UDP 25570, vidaresend den offentlege UDP-en -porten til den lokale adressa til serveren på port 25570. TCP-en til serveren -port kan halda fram på 25565. Sjå innstillingar for direkte serverlyttar for å velja ein annan UDP -port.
Send offentleg UDP -trafikk til maskina som køyrer Velocity eller BungeeCord med Raknetify2 -proxy-pluginen. Bruk proxyens RakNet UDP -lyttar som vidaresendingsdestinasjon. Behald proxyens eksisterande offentlege TCP -rula for vanlege Minecraft -tilkoplingar.
Proxyen koplar seg til bakend Minecraft -serverar over TCP. Å leggja til Raknetify2 i proxyen krev ikkje at bakend Spel-UDP -portar blir opna for spelarar.
| Tilkopling | Tilgang for å tillata |
|---|---|
| Spillere til proxien | Offentlig UDP til RakNet -lyttaren, pluss den eksisterande offentlege TCP-en -lyttaren |
| Proxy til bakend-servere | TCP-portane til dei bakanforliggjande Minecraft-tenarane. Berre dei utpeika mellomtenarane skal ha tilgang. |
| Spillere direkte til bakendspillportene | Hald denne tilgangen stengd, også via IPv6. |
Når proxyen og bakendane køyrer direkte på ei dedikert maskin du kontrollerer, kan bakendlytterne bruka loopback-adresser med proxyen konfigurerte til å nå dei der. Mellom maskiner, avgrens bakend- TCP -tilgang til proxy-vertene ved hjelp av ein brannmur eller eit isolert privat nettverk. Konteinarar og administrerte vertskap treng tilsvarande avgrensingar for nettverkslayouten sin. Sjå Velocity ’s backend security guida og BungeeCord ’s firewall guida.
Spillervideresending og brannmurrestriksjonar fungerer saman. Direkte bakendtilgang kan omgå proxyens påloggingskontrollar. For plug-in-installasjon, vidaresendingsinnstillingar og UDP -portoverstyringar, følg Velocity and BungeeCord.
Den offentlege porten og lyttarens port kan vera ulike når ein ruter omset mellom dei:
| Innstillingar | Port å bruka |
|---|---|
| Klientserveradresse | Offentlig UDP -port |
| Ekstern port for rutervideringregel | Offentlig UDP -port |
| Intern port for rutervideringregel | RakNet - UDP-en til lyttaren -port |
| Vertsbrannmurens lokal port | RakNet - UDP-en til lyttaren -port |
For hosting bak ein IPv4 -ruter:
- Finn den lokale IPv4-en -adressa til maskina som aksepterer RakNet -tilkoplingar. Bruk ein DHCP-reservasjon eller ei eigna statisk adresse slik at videregelen held fram med å peika mot den maskina.
- Legg til ein UDP -videregel for den offentlege porten spelarane vil bruka.
- Set destinasjonen til regelen til den lokale adressa og RakNet-en til den maskina - UDP-en til lyttaren -port.
- Tillat innkommande UDP på porten til lyttaren i brannmuren til verten.
Til dømes kan ein server som lyttar på UDP -porten 25565 bruka ein regel med offentleg port 25565, destinasjonsadresse 192.168.1.100 og destinasjonsport 25565. Erstatt dømeadressa med din servers faktiske lokale adresse.
Behold den eksisterande TCP-en -regelen for vanlege Minecraft -tilkoplingar. Ein TCP -vidaresendingsregel åleine ber ikkje UDP.
Undersøk om ein annan rutar eller nettleverandøren bruker NAT før trafikken når rutaren din. Har du to rutarar, må du setje opp vidaresending på begge. Bruker leverandøren operatør-NAT, kan du be om ei offentleg IPv4-adresse eller bruke ei teneste eller ein tunnel som tek imot UDP utanfrå. Regelen i din eigen rutar kan ikkje endre NAT hjå leverandøren. Rettleiinga frå TP-Link om vidaresending av portar forklarer kvifor du treng ei offentleg WAN-adresse.
Tillat han valde UDP -porten gjennom både rutereinest IPv6 -brannmur og brannmuren til verten. Målrett mot IPv6-en til maskina -adresse som aksepterer RakNet -tilkoplingar.
Sjekk at vertnavnets IPv6 -adresse peikar til den maskina. Viss IPv6 -adressa blir endra, oppdater DNS -oppføringa og eventuelle adresse-spesifikke brannmurreglar.
Eit vertnavn som publiserer både IPv4 - og IPv6 -adresser treng ei fungerande rute for kvar annonsert adresse. Sjekk begge sett med reglar når éin spelar kan kopla til og ein annan ikkje kan.
Viss IPv4 -vidaresending endrar portnummeret, sørg for at porten spelarane tastar inn også når IPv6 -lyttaren. Ein IPv4 -portomsetjing konfigurerer ikkje IPv6 -ruta.
Leverandøren eller tunnelen må støtta UDP på det offentlege endepunktet du gir til spelarane. Sjekk porttildelingane og nettverksbrannmurreglane og dessutan serverens eigen brannmur.
Viss eit tilleggs UDP -proxy vidaresender klientadresser ved hjelp av PROXY -protokoll v2, følg UDP -vidaresending og PROXY -protokoll og avgrens tilgangen til den mottakande UDP-en -lyttaren til den fortrudde proxyen.
Kopla til frå utanfor lokalet til serveren nettverk med ein oppdatert Raknetify2 -klient, ved å bruka ei adresse som raknet;play.example.com:25565. Bruk den offentlege UDP-en -porten i denne adressa.
Bruk ein ekte RakNet -tilkopling for å stadfesta ruta. Ein UDP -skanning som ikkje får svar kan rapportera eit uavgjort resultat fordi ei fungerande teneste kan forkasta ein ukjend sonde. Nmap’s UDP scan documentation forklarer denne oppførselen.
Ein vellykka TCP -tilkopling stadfestar berre TCP -ruta. Viss RakNet blir tidsavbroten, sjekk lyttaren, vidaresendingsdestinasjonen, UDP -porten og brannmurreglane ved hjelp av feilsøkingsguiden.
Sjekk kompatibiliteten for den spesifikke utgivinga du lastar ned. Utviklingsgreina kan innehalda støtte som enno ikkje er dukka opp i ei utgiving.
For Fabric, last ned compatibility.json frå same utgiving som JAR -fila. Sjekk Minecraft -versjonen din i gameVersions, og sjekk deretter den relevante oppføringa under runtimes for dens depends -krav. Denne JSON-fila er eit referansedokument og treng ikkje å bli lagt i mods -mappa.
For Forge, NeoForge og Spigot / Paper, sjekk versjonskrava som er deklarerte av artefaktet og dets nedlastingsliste. Støtte på éin loader etablerar ikkje støtte på ein annan.
Java -kravet erklært av Raknetify2 er minimumskravet. Minecraft eller loaderen kan krevja ei nyare køyretid. Vel ein Java -versjon som oppfyller alle tre.
Bruk same Raknetify2 -utgiving på klienten og serveren eller proxyen som aksepterer tilkoplinga. Sjekk utgivingsnotata før du blandar utgivingar. Krypterte RakNet -tilkoplingar krev støtte for autentisert krypteringsprotokoll på begge sider. Opphavlege Raknetify - og Raknetify2 -bygg frå før denne protokollen vart introdusert, kan ikkje etablera desse krypterte tilkoplingane til oppdaterte partar.
Raknetify2 ber Minecrafters eksisterande spelprotokoll. Å kopla saman ulike Minecraft -versjonar krev eit kompatibelt protokollomsetjingssett.
Byggearbeidsflyten build workflow inkluderer kompatibilitetskontrollar som involverer Polymer, Krypton, PacketFixer og Fast IP Ping. Desse kontrollane dekkjer versjonane og kombinasjonane som er valde av arbeidsflyten. Sjekk byggjeresultata til ei utgiving når du undersøkjer ein bestemd kombinasjon.
Ved feil i ein større modpakke, følg feilsøkingsguiden. Inkluder dei komplette modversjonane i rapporten din.
Vanlegvis kan dei andre kanalane i Raknetify2 halde fram sjølv om éin kanal ventar på ein pakke som er borte. I ordna modus går alle Minecraft-pakkane i same retning gjennom éin kanal. Dersom ein pakke går tapt, må alle som kjem etter, vente på at han blir send på nytt. Dette gir den rekkjefølgja enkelte program mot juks krev. Medan det blir venta, må også annan speltrafikk stoppe.
-
Installer ein Raknetify2 -byggja som støttar ordna modus på serveren eller proxien som aksepterer RakNet -tilkoplingar og på kvar RakNet -klient.
-
Opprett
config/raknetify2-compatibility.jsonrelativt til den serverens eller proxyens arbeidsmappe. Opprettconfig-mappa om ho ikkje eksisterer. -
Legg til følgjande:
{"mode": "ordered"} -
Start på nytt serveren eller proxien.
Klientar følgjer innstillinga frå serveren automatisk. Spelarar treng ikkje å oppretta ei konfigurasjonsfil eller endra RakNet-en sin -serveradresse.
Alle Minecraft -pakkar bruker éin påliteleg ordna kanal i kvar retning, inkludert pakkeavgrensere og verdsovergangar.
Når spelarar koplar til via Velocity eller BungeeCord, konfigurer ordna modus på den proxyen, sjølv om anti-cheaten køyrer på ein backend-server.
Retningslinja gjeld på tvers av backend-svitsjer. I ordna modus vidaresender proxyen backend keepalive-forespørsler til den verkelege klienten i staden for å svara lokalt.
Ved den første RakNet-en -tilkoplinga rapporterer konsollen:
Raknetify2 compatibility: ordered (updated clients required, genuine acknowledgements)
Eit vellykka kompatibilitetsutveksling loggar også ordered compatibility negotiated, etterfølgd av peerens adresse.
La kontrollane mot juks stå på, og test oppsettet ditt.
RakNet -klientar som ikkje støttar ordna modus kan ikkje kopla til ein server som krev det. Oppdater Raknetify2 på desse klientane, eller kopl til ved hjelp av serverens eller proxyens normale TCP -adresse og port utan raknet; -prefiks.
Endre fila til:
{"mode": "multichannel"}Start deretter serveren eller proxien på nytt. Å fjerna fila gjenopprettar også fleirmodus etter ein omstart.
Filen må innehalda nøyaktig éi innstilling kalla mode, med anten "ordered" eller "multichannel" som verdi. Verdiane er kasuskjenslevare.
Ugyldig eller ulesenbar konfigurasjon avviser RakNet -tilkoplingar. Korriger fila og start prosessen på nytt.
Viss konsollen framleis rapporterer multichannel, sjekk at fila er i arbeidsmappa til serveren eller proxyen som aksepterer RakNet -tilkoplinga, og start deretter den prosessen på nytt.
Fabric -, Forge - og NeoForge -serverar kan velja RakNet ved overføring av ein kapabel klient til eit konfigurert mål. Dette bruker Minecrafterens innebygde overføringsstøtte, introdusert i Java Edition 1.20.5. Sjekk at Raknetify2-en din -utgiving støttar Minecraft -versjonen og loaderen på kvar ende.
Installer Raknetify2 på sendeserveren og klienten. Målet må tilby ein kompatibel RakNet -lyttar og akseptera innkommande Minecraft -overføringar.
Denne konfigurasjonen gjeld for overføringar send av dei tre mod-loaderne ovanfor. Spigot / Paper -, Velocity - og BungeeCord -plug-inane les ikkje denne overføringsfila.
Opprett config/raknetify2-transfers.json i katalogen til sendarserveren:
{
"destinations": [
{
"host": "play.example.com",
"tcpPort": 25565,
"udpPort": 25570
}
]
}Erstatt dømenamnet og portane med verdiane til destinasjonen din, og start deretter sendarserveren på nytt. Fleire destinasjonar blir lagde til i same array.
| Felt | Betydning |
|---|---|
host |
Destinasjonsvertnavn eller Ip-adresse, utan transportprefiks eller port |
tcpPort |
Destinasjonsport i den opphavlege overføringsførespurnaden |
udpPort |
Offentlig RakNet -port som den overførte klienten skal kontakta |
TCP - og UDP -portnummera kan vera like. Viss ein ruter omset UDP -porten, bruk den offentlege porten i denne fila. Skriv portane som JSON-tal.
Send overføringar til den vanlege vertsnamnet og TCP-en til destinasjonen -port. Raknetify2 sjekkar om klienten annonserer støtte for automatisk overføring. For ein kapabel klient og ein matchande destinasjon vel han den konfigurerte UDP-en -porten. Andre klientar og ikkje-matchande destinasjonar beheld den opphavlege overføringsadressa.
Matchande bruker vertsnamnet og TCP -porten frå overføringsførespurnaden. Kasus på vertsnamn, eit avsluttande DNS -punkt og tilsvarande IPv6 -skriving blir normalisert. DNS -oppslag deltek ikkje i matchande, så to ulike vertsnamn som løyser til same adresse krev separate oppføringar. Stjerneoppføringar blir ikkje støtta.
For ein destinasjon som bruker Minecraft ’s server.properties, sett accepts-transfers=true Ein destinasjonsproxy kan ha sine eigne overføringsinnstillingar, og det kan hende at du må konfigurera dei. Minecraft ’s standard avviser innkommande overføringar, sjølv når ei normal direkte samanføying fungerer.
Destinasjonens RakNet -lyttar, offentleg UDP -vidaresending og brannmuren til verten må allereie vera konfigurert. Overføringsfila til avsendarserveren vel adressa som blir send til ein klient.
Sjekk både IPv4-en til destinasjonen - og IPv6 -ruter når vertnavnet publiserer begge adressetypane. Test ein vanleg direkte RakNet -tilkopling til destinasjonen før du undersøkjer automatisk overførselsåtferd.
Behold eventuelle destinasjonsinnloggings- eller tilgangssjekkar på plass. Denne konfigurasjonen gir ikkje spelarar tilgang eller erstattar serverautentisering.
Manglende felt, ukjende felt, ugyldige portar og dupliserte destinasjonar forårsakar ein konfigurasjonsfeil under initialisering. Bruk serverloggen for å identifisera feilen, korriger JSON-en og start på nytt.
For å deaktivera automatisk val, fjern konfigurasjonsfila eller bruk {"destinations": []}, deretter start sendingsserveren på nytt. Dens overføringsførespurnader vil behalda dei opphavlege adressene sine.
Ein UDP -proxy kan vidaresenda RakNet -trafikk og bevara den opphavlege klientadressa ved hjelp av PROXY -protokoll v2. Aktivar denne funksjonen når ein oppstraums UDP -proxy sender desse hovuda til lyttaren din. Vanleg ruterportvidaresending krev det ikkje.
På serveren eller Minecraft -proxyen som får den vidaresende UDP-en -trafikken, opprett config/raknetify2-proxy-protocol.json:
{
"trustedProxies": ["192.0.2.10"]
}Erstatt dømet med UDP -proxyens faktiske kjelde-Ip-adresse eller eit CIDR -område du kontrollerer. Adressa må samsvara med det mottakande lyttaren ser etter eventuell mellomliggjande NAT. IPv4 - og IPv6 -literaler blir akseptert. DNS -domene blir avviste. Start på nytt den mottakande serveren eller proxyen.
Still inn mellomtenaren til å sende PROXY v2-hovud for UDP. Raknetify2 tek berre imot vidaresende klientadresser frå kjeldene på lista. Når dette er slått på, blir direkte RakNet-tilkoplingar utan slike hovud avviste. TCP-lyttaren held på innstillingane sine.
Kvar mellomtenar på lista får lov til å opplyse om adressa til klienten. Still inn brannmuren til den bakanforliggjande tenaren slik at berre den utpeika mellomtenaren kjem inn på UDP-porten. Ta berre med dei adresseområda som faktisk trengst.
Fila må berre innehalda trustedProxies, med minst éi oppføring. Ein tom array er ein feil. Ei ugyldig fil forhindrar RakNet -lyttaren i å starta.
For å gå tilbake til direkte UDP -tilkoplingar, fjern fila og start lyttaren på nytt. Oppdater oppstraumsvidaresendingsåtferda og brannmurreglane for den nye ruta samtidig.
Viss tilkoplingar feilar etter at denne funksjonen er aktivert, sjekk proxyens faktiske kjeldeadresse på backend, det konfigurerte fortrudde området, og om proxyen sender UDP PROXY -protokoll v2-hoder.
Sjå Velocity og BungeeCord for å installere Minecraft-mellomtenaren og setje opp dei bakanforliggjande tenarane.
Raknetify2 kan dela serveren sin UDP -lyttar med Simple Voice Chat på Fabric, Forge, NeoForge, Spigot og Paper.
Installer Simple Voice Chat på serveren og på kvar klient som ønskjer stemmechat. Følg dens serveroppsettguide for resten av konfigurasjonen.
Bruk toppnivået til serveren config -mappe for Raknetify2s fil, inkludert på Spigot / Paper. Simple Voice Chats eiga fil blir verande i plattformspesifikk plassering nedanfor.
-
Opprett
config/raknetify2-voicechat.jsoni servermappa med dette innhaldet:{"enabled": true} -
Sett
port=-1i Simple Voice Chat serverkonfigurasjonen sin. På moddede serverar er detteconfig/voicechat/voicechat-server.properties. På Spigot / Paper er detplugins/voicechat/voicechat-server.properties. -
La
bind_addressvera tom når det er éin som samsvarer med RakNet -lyttaren. Viss serveren har fleire lyttarar på den UDP-en -porten, sett han til den lokale adressa til lyttaren du vil dela. -
Start serveren på nytt og køyr
/voicechat test <PLAYERNAME>for ein tilkopla spelar.
Viss RakNet -lyttaren bruker ein annan port enn Minecraft, sett stemme port til den lokale UDP-en -porten eksplisitt i staden for å bruka -1. Til dømes, ein RakNet -lyttar på lokal UDP -port 25570 treng port=25570.
Sett voice_host når klientar treng ein annan offentleg adresse eller port. For ein ruter som vidaresender offentleg UDP 25580 til lokal UDP 25570, bruk port=25570 og voice_host=play.example.com:25580. Den offentlege adressa høyrer heime i voice_host. bind_address -innstillinga vel ein lokal lyttar.
Raknetify2 leverer den delte UDP-en -sokkelen gjennom Simple Voice Chats API. Simple Voice Chat handterer stemmeautentisering og kryptering. Spelarar kan bruka stemmechat med anten TCP eller RakNet spelsamband.
Hold Keep Query og Geyser på separate UDP -portar. Den delte sokkelintegrasjonen støttar berre Simple Voice Chat.
Integrasjonen deler ikkje ein stemmeprotokoll-sokkel på Velocity eller BungeeCord. Følg Simple Voice Chat sin proxy-oppsettguide og gi stemmeprotokollen sin eigen UDP -port. Med den offisielle stemmeprotokoll-plug-inen, sett alle offentlege voice_host-ar -overstyring i proxyens stemmekonfigurasjon. Den plug-inen ignorerer backend-serverenes voice_host -innstillingar.
For ein generell UDP -tunnel, set voice_host til det offentlege vertsnamnet og UDP -porten som vidaresender til denne serveren.
Viss loggen rapporterer No RakNet listener matches the voice bind address and port, stadfest at RakNet starta vellykka og at stemmeporten og bindeadressa samsvarer med dens lokale lyttar.
Om han rapporterer Multiple RakNet listeners match the voice bind address, vel ei spesifikk matchande lokal adresse i bind_address og start på nytt.
Berre éin Simple Voice Chat -plug-in kan levera UDP-en sin -sokkel. Viss oppstarten rapporterer at ein annan plug-in allereie leverer ein sokkel, vel kva sokkelintegrasjon du vil bruka.
Å deaktivera Raknetify2 ’s integrasjon, set {"enabled": false} i stemmekonfigurasjonen, eller fjern den fila. Gi Simple Voice Chat ein separat UDP port, oppdater brannmuren eller vidaresendingsreglane, og start serveren på nytt.
Sjekk desse i rekkjefølgje:
- Klienten har rett Raknetify2 -mod for sin loader og Minecraft -versjon.
- Serveren eller proxyen som aksepterer tilkoplinga har Raknetify2 installert og starta utan lyttarfeil.
- Adressen startar med
raknet;og bruker den offentlege UDP-en -porten. - Vertsprovideren, ruteren og vertens brannmur tillèt alle UDP på den porten.
- Hostnameets IPv4 - og IPv6 -adresser leier til den tiltenkte verten og har fungerande brannmurreglar.
Ein vellykka TCP -tilkopling stadfestar berre TCP -ruta. Følg Brannmur- og ruterkonfigurasjon for å sjekka UDP -vidaresending og IPv6 -tilgang. Viss PROXY -protokollen er aktivert, må klientar no lyttaren via ein konfigurert fortrudd proxy.
Sjekk for andre prosessar som bruker UDP -porten. Query, Geyser og andre UDP -tenester treng sine eigne portar. Simple Voice Chat kan bruka delt-port-integrasjonen.
Du kan velja ein annan lokal UDP -port ved hjelp av direkte-server-lyttarinnstillingane eller Velocity - og BungeeCord -innstillingane. Sjekk versjonskravet for Spigot / Paper -innstillinga. Å endra berre ein ruterars offentlege port lèt den lokale sokkeittkonflikten bli verande.
Koble direkte til destinasjonen ved hjelp av dens raknet; -adresse. Dersom det mislykkast, fiksar først destinasjonslyttaren eller nettverksruta.
Om direkte tilkoplingar fungerer, sjekk om destinasjonen aksepterer innkommande overføringar. Ein Minecraft -servar som bruker server.properties treng accepts-transfers=true. Direkte tilkoplingar testar ikkje denne innstillinga.
Samanlikn deretter overføringsnamnet og TCP -porten med config/raknetify2-transfers.json på sendarserveren. Stadfest at fila vart lasta etter ein omstart og at klienten støttar automatisk RakNet -overføring. Sjå Automatisk overføring.
Sjekk Raknetify2 -versjonane på begge endar av tilkoplinga. Oppdater klienten og serveren eller proxyen samtidig når ei utgiving endrar den krypterte protokollen. Bevar autentiseringsinnstillingane frå serveren medan du undersøkjer.
Registrer kva handling som utløyser feilen, til dømes å opna eit inventar, få ein ressurspakke, byta verder eller sponsa ei eining. Samanlikn same handling over TCP og RakNet ved hjelp av ein separat testinstallasjon når det er praktisk.
Noen tilpassa nyttelaster avheng av rekkjefølgja av vanillettpakker. Modutviklarar kan deklarera desse avhengnadene gjennom pakkeordningsgrensesnittet.
Åpne ei oppgåve i Raknetify2 -oppfølgingssystemet og inkluder:
- Minecraft -, Java -, loader- og Raknetify2 -versjonar på begge sider.
- Server- og proxyprogramvareversjoner, inkludert eventuelle UDP -videresendingsproxyer.
- Andre installerte modifikasjonar og deira versjonar.
- Trinn for å reprodusera problemet og kva du forventa skulle skje.
- Om dei same trinna fungerer over TCP.
- Relevante utdrag frå klient-, servar- og proxy-logger frå same forsøk.
Fjern tilgangsteikn, passord og andre private opplysningar før du lastar opp loggane. Ta vare på feilmeldingane og kallstakkane som trengst for å finne årsaka.
Raknetify2 lèt mods deklarera kva Minecraft -trafikk som må halda fram med å vera ordna med dei eigendefinerte nyttelastene sine. Bruk dette når handtering av ei nyttelast krev ei eining, chunk, inventar eller annan tilstand etablert av tidlegare pakkar.
| Gruppe | Relatert trafikk |
|---|---|
ui |
Verdsuavhengige menyar og interaksjonar |
entity |
Entitetsskaping, fjerning og rørsle |
world_interaction |
Lager og andre verdsavhengige interaksjonar |
effects |
Lyder og partiklar |
chunk |
Terreng-, blokk- og lysoppdateringar |
Alle grupper beheld påliteleg ordna levering innanfor kanalen sin. Pakkar i ulike grupper kan komma i ei anna relativ rekkjefølgje. Vel gruppa som samsvarer med avhengnaden til nyttelasta.
Legg til ein leverandør under raknetify:packet_channels entrypoint i din mods fabric.mod.json. Leverandøren implementerer Consumer<BiConsumer<String, String>> ved hjelp av JDK-typar. Den får ein registrar som aksepterer ein tilpassa nyttelastidentifikator og ei ordningsgruppe.
Slå saman denne oppføringa i det eksisterande metadataet ditt, og erstatt klassenamn med din leverandørs fullt kvalifiserte namn:
{
"entrypoints": {
"raknetify:packet_channels": [
"com.example.mod.OrderingProvider"
]
}
}Behold resten av fabric.mod.json-en din, inkludert dens eksisterande inngangspunkt. Dette er eit fragment av metadatafila.
Til dømes kan ei utviding for einingsrørsle registrera example:entity_path med entity -gruppa. PacketOrdering API-dokumentasjonen inkluderer leverandørimplementeringa.
Fabric lèt dette inngangspunktet vera uanropet når Raknetify2 manglar. Leverandørar bør deklarera identifikatorar og grupper under initialisering utan å stola på at ein annan mod har fullført sin eigen initialisering.
Forge - og NeoForge -mods, og dessutan servar- eller proxy-plugins, kan kalla PacketOrdering.register(identifier, group) under initialisering når Raknetify2 er tilgjengeleg. Klassen er com.ishland.raknetify.api.PacketOrdering. Registrer før du aksepterer spelarsamband, og hald valfri integrasjonskode frå å lasta Raknetify2 -klassar når avhengnaden manglar.
Deklarasjoner gjeld for nye tilkoplingar. Eksisterande tilkoplingar beheld reglane dei fekk ved oppsett. Å gjenta ein identisk deklarasjon er tillaten. Konflikterende grupper for same identifikator blir avviste.
Payload-identifikatorar må bruka eit gyldig tilpassa namespace. minecraft -namespace er reservert. Grensesnittomfattande grense er 128 deklarasjonar, inkludert innebygde reglar og registreringar frå andre mods. Identifikatorar kan innehalda opptil 255 ASCII-teikn ved å bruka APIens namespaced identifier-syntaks.
Oppdaterte RakNet -peers utvekslar deklarasjonar under tilkoplingsoppsett. Ein server eller proxy kan bruka ein peers deklarasjon når han ikkje har ein lokal regel for den payloaden. Lokale reglar har forrang, og ein peers deklarasjonar held fram med å vera avgrensa til den tilkoplinga.
Sjå UDP -vidaresending og PROXY -protokoll for UDP -reléer og vidaresende klientadresser.
For Minecraft -proxyoppsett, sjå Velocity og BungeeCord.