Repository navigation
Wiki uk ua
- Головна
- Встановлення
- Velocity та BungeeCord
- Налаштування файрволу та маршрутизатора
- Сумісність
- Ордерний режим
- Автоматичні передачі
- Пересилання UDP та протокол PROXY
- Simple Voice Chat
- Виправлення помилок
- Інтеграція модів
- UDP-проксі
Мережеві з’єднання через RakNet для клієнтів і серверів Minecraft.
| Minecraft | Raknetify2 | Клієнт / Сервер |
|---|---|---|
| Fabric | mods/raknetify2-fabric-*.jar |
Клієнт / Сервер |
| Forge | mods/raknetify2-forge-*.jar |
Клієнт / Сервер |
| NeoForge | mods/raknetify2-neoforge-*.jar |
Клієнт / Сервер |
| Spigot / Paper | plugins/raknetify2-spigot-*.jar |
Сервер |
| Velocity | plugins/raknetify2-velocity-*.jar |
Velocity |
| BungeeCord | plugins/raknetify2-bungee-*.jar |
BungeeCord |
-
Гра в мережі
-
Додати сервер
-
Адреса сервера
Адреса сервера RakNet · UDP raknet;play.example.com:25565TCP play.example.com:25565 -
Готово
-
Приєднатися
| F3 | |
|---|---|
| RakNet · UDP | Активно · MTU 1400 |
| TCP | Неактивно |
- Клієнт · Raknetify2 → UDP → Velocity / BungeeCord · Raknetify2
- Velocity / BungeeCord → TCP → Сервер
| Номер порту · 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 |
| Адреса сервера | UDP |
|---|---|
raknet;play.example.com:25580 |
play.example.com:25580 → NAT → 192.0.2.10:25570
|
Сервер · 192.0.2.10
|
25570/udp |
Сервер / Velocity / BungeeCord
| JSON | |
|---|---|
| ① ② ③ | {"mode":"ordered"} |
| ① ∥ ② ∥ ③ | {"mode":"multichannel"} |
| Сервер | 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
| Адреса сервера | trustedProxies |
RakNet |
|---|---|---|
192.0.2.10 · PROXY v2 / UDP |
["192.0.2.10"] |
✓ |
192.0.2.11 · PROXY v2 / UDP |
["192.0.2.10"] |
✗ |
| Клієнт → RakNet / UDP | ["192.0.2.10"] |
✗ |
config/raknetify2-proxy-protocol.json
{"trustedProxies":["192.0.2.10"]}-
Сервер A · Fabric / Forge / NeoForge ·
config/raknetify2-transfers.json{"destinations":[{"host":"play.example.com","tcpPort":25565,"udpPort":25570}]} -
Сервер B ·
play.example.com·server.properties→accepts-transfers=true -
Сервер A ·
/transfer play.example.com 25565 Alex→ Клієнт (Alex) → RakNet ·play.example.com:25570
| Minecraft | |
|---|---|
ui |
Налаштування |
entity |
Скелет |
world_interaction |
Інвентар |
effects |
Частинки |
chunk |
Блоки |
- Fabric · Minecraft / Java · English
- Forge / NeoForge / Spigot / Paper · GitHub Releases
Для мережевої гри в Minecraft Raknetify2 використовує RakNet поверх UDP. Дані передаються кількома каналами, у кожному з яких зберігається свій порядок доставки. Якщо в одному каналі загубився пакет, інші можуть і далі передавати дані. Тож гра може швидше реагувати на дії гравця, поки триває повторне надсилання втрачених даних або передавання чанків.
Raknetify2 – це окремо підтримуваний форк Raknetify, який спочатку розробив ishland. У форку додано підтримку новіших версій Minecraft. У ньому також підтримують транспортний код, інтеграції з платформами й тести сумісності.
- Перевірити сумісність з Minecraft та модами.
- Виберіть файл для завантаження та встановіть його.
- З’єднайтеся за адресою, наприклад
raknet;play.example.com.
- Velocity і BungeeCord
- Налаштування файрволу та маршрутизатора
- Автоматичні перекази
- Пересилання UDP та протокол PROXY
- Ширинка UDP-порту з Simple Voice Chat
- Виправлення помилок та повідомлення про баги
Автори модів можуть використовувати інтерфейс порядку пакетів для визначення залежностей між кастомними пакетами та трафіком в Minecraft.
Raknetify2 використовує ліцензію MIT та зберігає оригінальні повідомлення про авторські права. Його реалізація в мережевій сфері базується на Raknetify та netty-raknet.
Завантажте реліз з GitHub Releases. Перед встановленням перевірте версію Minecraft та вимоги до завантажувача для цього релізу.
| Де ви будете встановлювати | Файл | Фолдер |
|---|---|---|
| Клієнт чи сервер Fabric | raknetify2-fabric-*.jar |
mods |
| Forge клієнт або сервер | raknetify2-forge-*.jar |
mods |
| Клієнт або сервер NeoForge | raknetify2-neoforge-*.jar |
mods |
| Сервер Spigot або Paper | raknetify2-spigot-*.jar |
plugins |
| Velocity proxy | raknetify2-velocity-*.jar |
plugins |
| Проксі BungeeCord | raknetify2-bungee-*.jar |
plugins |
Закрийте клієнт або зупиніть сервер перед заміною його JAR-файлу. Видаліть оригінальний JAR-файл Raknetify та будь-який старіший JAR-файл Raknetify2 з тієї ж установки перед додаванням нового файлу.
Клієнтські папки належать до Minecraft-інстанції або модпаку, який ви запускаєте. Серверські та проксі-папки належать до встановлення сервера або проксі-сервера. Створіть відповідну папку, якщо ваш логгер ще не створив її.
- Встановіть клієнтський мод для свого завантажувача.
- Встановіть відповідний мод сервера або плагін Spigot/Paper на сумісному сервері.
- Дотримуйтесь конфігурації Firewall та роутера, щоб дозволити з’єднання через UDP з сервером.
- Перезапустіть клієнт і сервер.
- Додайте адресу сервера, наприклад
raknet;play.example.comабоraknet;play.example.com:25565.
Адреси без префікса raknet; використовують TCP.
Установлення мода лише на клієнті не додає підтримки RakNet на віддаленому сервері. Адміністратор сервера має налаштувати точку підключення RakNet. Гравцям, які приєднуються до чужого сервера, зазвичай не потрібно налаштовувати на своєму маршрутизаторі переадресацію вхідного трафіку.
Встановіть відповідний плагін-проксі та клієнтський мод. Дотримуйтесь інструкцій для налаштування слухачів, перенаправлення запитів на сервер, обмежень доступу та адрес, яку повинні використовувати гравці, за посиланням Velocity and BungeeCord.
Для безпосереднього сервера Minecraft, встановіть відповідний Java аргумент нижче. Оператори проксі повинні використовувати налаштування Velocity і BungeeCord listener.
| Платформа | Аргумент Java | Прийняті порти |
|---|---|---|
| Сервер Fabric, Forge або NeoForge | -Draknetify.fabric.portOverride=25570 |
1 до 65534
|
| Сервер Spigot або Paper | -Draknetify.spigot.portOverride=25570 |
1 до 65535
|
Forge та NeoForge використовують спільний код слухачів, тож назва їхніх властивостей також містить fabric. Замініть 25570 на потрібний UDP-порт.
Spigot / Paper ≥ 0.1.0-beta.1.431
Додайте аргумент перед -jar у команді Java, або у поле аргументів JVM вашого хоста. Перезапустіть сервер та дозвольте використання UDP на обраній порту слухачів. Якщо публічний порт також є 25570, підключайтесь за адресою raknet;play.example.com:25570. Якщо маршрутизатор перетворює порт, використовуйте його публічний порт у адресі клієнта. TCP-порт залишається на своєму існуючому значенні.
На мережі Spigot/Paper слухач UDP зберігає локальну адресу з’єднання TCP слухача Minecraft. Невірна зміна або зайнята UDP-порт може завадити RakNet запуститися. Перевірте журнал запуску на предмет адреси та порту UDP. Видаліть аргумент та перезапустіть, щоб повернутися до номера порту TCP-слухача.
Маршрутизатор або UDP-проксі також можуть використовувати інший публічний UDP-порт та перенаправляти повідомлення на існуючого слухача, не змінюючи параметрів сервера у Java.
Відкрийте успішну роботу main у GitHub Actions та завантажте її архів Artifacts. Для завантаження архівів робочого процесу GitHub потрібен акаунт. Використовуйте таблицю встановлення, щоб вибрати JAR-файл з архіву.
Velocity та BungeeCord розташовуються між гравцями та бекенд-сервами Minecraft. Встановіть Raknetify2 на проксі та на кожному клієнті, який буде підключатися через RakNet.
Raknetify2 клієнт --UDP--> Velocity або BungeeCord --TCP--> сервер-фронтенд
Бекенд-сервери не потребують Raknetify2 для цього шляху з’єднання. Вони все ще потребують модів, плагінів та підтримки перенаправлення, необхідних для вашої мережі. Raknetify2 не перекладає версії Minecraft та не змінює автентифікацію облікових записів проксі-сервера.
- Підтвердіть, що звичайні TCP-з’єднання через ваш проксі працюють, включаючи автентифікацію та перемикання між бекенд-серверами.
- Вимкніть проксі та завантажте відповідний плагін з GitHub Releases.
- Помістіть
raknetify2-velocity-*-all.jarабоraknetify2-bungee-*-all.jarу папкуpluginsпроксі-сервера. Видаліть будь-які старі плагіни Raknetify чи Raknetify2 з цієї папки. - Встановіть відповідний клієнтський мод Raknetify2 за допомогою інструкції з встановлення.
- Перевірте налаштування слухача нижче, перезапустіть проксі та перегляньте його журнал для виявлення помилок слухача RakNet.
- Дозволіть публічний UDP-трафік до проксі та обмежіть порти для гри на сервері, як описано в Конфігурації брандмауера та маршрутизатора.
Використовуйте сумісні версії Raknetify2 на клієнті та проксі. Перевіряйте Сумісність перед поєднанням версій.
Параметр bind у файлі velocity.toml визначає адресу слухання Minecraft та TCP-порт відповідного сервера. Raknetify2 зазвичай використовує той самий номер порту для UDP. Пункти [servers] ідентифікують бекенд-сервери. Ці пункти повинні вказувати адреси бекенд-серверів TCP. Детальніша інформація дивіться у руководстві конфігурації Velocity.
Щоб використовувати окремий UDP-порт, додайте цей аргумент JVM перед -jar у команді запуску Velocity:
-Draknetify.velocity.portOverride=25570
Переходимо 25570 на обраний вами порт. Це змінює UDP-порт RakNet, при цьому TCP-порт та адреси сервера Velocity залишаються незмінними. Після зміни параметра необхідно перезапустити Velocity.
Налаштуйте пересилання повідомлень для гравців як на Velocity, так і на його бекендах. Використовуйте сучасне пересилання, коли бекенд-програмне забезпечення це підтримує, і зберігайте це пересилання в таємниці. Дотримуйтесь інструкцій, специфічних для бекендів, у гіді пересилання інформації для гравців Velocity. Зберігайте обмеження бекенд-файрволу разом із пересиланням.
У файлі config.yml BungeeCord значення host під кожною записом listeners ідентифікує адресу слухання та TCP-порт Minecraft. Raknetify2 зазвичай додає UDP на цьому номері порту. Записи servers містять TCP-адреси серверів. Ці налаштування описані в гідері конфігурації BungeeCord.
Для окремого UDP-порту додайте цей аргумент JVM перед -jar у команді запуску BungeeCord:
-Draknetify.bungee.portOverride=25570
Переадміністрування стосується всього процесу проксі. Для налаштувань з кількома слухачами Minecraft перевірте реальні endpoints RakNet у логах запуску перед встановленням правил фільтрації. Перезапустіть BungeeCord після зміни аргументів.
Зберігати автентифікацію облікових записів через проксі. Для серверів типу Spigot BungeeCord інструкція щодо пересилки IP передбачає налаштування ip_forward: true на проксі разом із settings.bungeecord: true на сервері. Сама пересилка не заважає комусь підключитися безпосередньо до сервера. Обмежити доступ до сервера за допомогою інструкцій щодо брандмауера.
Обидва способи переопрацювання проксі приймають порти від 1 до 65534. Невіровані значення ігноруються, тож перевірте призначений UDP-порт у логах запуску. Видаліть аргумент та перезапустіть, щоб повернутися до номера порту слухача Minecraft.
Гравці підключаються до публічного хостингу проксі та UDP-порту, наприклад raknet;play.example.com:25570. Коли маршрутизатор перетворює порти, використовуйте його публічний UDP-порт у адресі клієнта. Адреси без префікса raknet; продовжують використовувати TCP-слухач проксі.
Залиште Query, Geyser та інші сервіси UDP на окремих UDP-портах. Різний TCP-порт не вирішує конфлікту з UDP-сокетами.
Simple Voice Chat використовує власний плагін-проксі та UDP-порт у серверах Velocity та BungeeCord. Для налаштувань дотримуйтесь інструкцій з використання проксі для голосового чату там.
Якщо окремий UDP-релегій розташований перед вашим Minecraft-проксі та надсилає заголовки протоколу PROXY версії 2, налаштуйте Raknetify2, використовуючи UDP-пересилання та протокол PROXY. Встановлення Velocity або BungeeCord самостійно не вимагає таких налаштувань.
Тестуйте ззовні вашої локальної мережі за допомогою клієнта Raknetify2. Приєднуйтеся через проксі-сервер, змінюйте сервери, які використовуєте, та переконайтеся, що ідентичність гравця та повноваження залишаються правильними.
- Якщо TCP через проксі працює, але RakNet вичерпує час, перевірте слухача UDP проксі, публічну порту, маршрути IPv4 та IPv6, а також правила брандмауера.
- Якщо обидва протоколи зазнають невдачі під час підключення проксі до бекенду, перевірте TCP-адресу бекенду, правила доступу та конфігурацію перенаправлення гравців.
- Якщо проксі повідомляє про зайняту UDP-порт, перевірте, чи є там процес Query, Geyser, голосовий проксі чи інший процес, який до нього підключений.
Для повідомлень включіть як логи проксі, так і логи backend з одного спроби з’єднання. Щодо інформації про версію, дивіться Виправлення проблем.
Цей посібник призначений для операторів серверів. Raknetify2 потребує функціонального UDP-шляху до сервера або проксі-сервера, який приймає підключення через RakNet. За замовчуванням використовується той самий порт, що і TCP-слухач Minecraft.
Для гравців, які знаходяться в одній локальній мережі, використовуйте локальний адресу сервера та дозвольте UDP проходити через його файрвол. Потрібне перенаправлення порту маршрутизатора, коли інтернет-трафік має проходити через IPv4 NAT маршрутизатора.
Надсилайте публічний UDP-трафік до комп’ютера, який використовує сервер Minecraft з Raknetify2. Центральний порт призначений для слухача UDP RakNet цього сервера. Дозвольте цьому порту через брандмауер комп’ютера-сервера. Зберігайте існуючу TCP-маршруту для звичайних підключень Minecraft.
Наприклад, якщо Raknetify2 слухає по UDP 25570, перенаправіть публічний UDP-порт на локальну адресу сервера на порт 25570. TCP-порт сервера може залишатися на 25565. Дивіться налаштування слухача прямого сервера, щоб обрати інший UDP-порт.
Надсилайте публічний UDP-трафік на комп’ютер, який використовує Velocity або BungeeCord, за допомогою плагіна Raknetify2. Використовуйте слухач UDP RakNet від проксі для перенаправлення трафіку. Зберігайте існуючу публічну TCP-маршруту проксі для звичайних Minecraft-з’єднань.
Проксі-сервер з’єднується з серверами Minecraft через TCP. Додавання Raknetify2 до проксі-сервера не вимагає відкриття UDP-портів для гри для гравців.
| З’єднання | Доступ, який дозволяється |
|---|---|
| Гравці через проксі-сервер | Публічний UDP-порт для слухача RakNet, разом із існуючим публічним TCP-слухачем. |
| Проксі-сервери для серверів backend | Задня частина Minecraft TCP-портів, доступних лише через визначені проксі-хости |
| Гравці безпосередньо переходять на сервери для гри. | Залишити заблоковані, включаючи через IPv6. |
Якщо проксі та внутрішні сервери працюють безпосередньо на одному виділеному комп’ютері під вашим контролем, внутрішні сервери можуть слухати на петльових адресах, а проксі – з’єднуватися з ними за цими адресами. Якщо сервери працюють на різних машинах, дозвольте з’єднання TCP з внутрішніми серверами лише з вузлів проксі, використовуючи брандмауер або ізольовану приватну мережу. Для контейнерів і керованого хостингу потрібні рівноцінні обмеження з урахуванням будови мережі. Див. посібник Velocity із захисту внутрішніх серверів і посібник BungeeCord із налаштування брандмауера.
Переведення пакетів від гравців та обмеження від файрволів працюють разом. Прямий доступ до бекенду може обійти перевірки облікових записів проксі-сервера. Для встановлення плагінів, налаштування переведення пакетів та зміни UDP-портів дотримуйтесь інструкцій з Velocity і BungeeCord.
Публічний порт та порт слухача можуть відрізнятися, коли маршрутизатор перетворює між ними:
| Налаштування | Порт, який слід використовувати |
|---|---|
| Адреса клієнта-серверу | Публічний UDP-порт |
| Зовнішній порт правил пересилання маршрутизатора | Публічний UDP-порт |
| Внутрішній порт правил пересилання маршрутизатора | Порт UDP слухача RakNet |
| Локальний порт файрволу хоста | Порт UDP слухача RakNet |
Для розгортання за допомогою IPv4-роутера:
- Знайдіть локальний IPv4-адресу машини, яка приймає з’єднання через RakNet. Використовуйте резервацію DHCP або відповідну статичну адресу, щоб правило перенаправлення продовжувало цілеспрямовуватися на цю машину.
- Додайте правило пересилання UDP для публічного порту, який будуть використовувати гравці.
- Встановіть призначення правила на локальний адресу цієї машини та UDP-порт слухача RakNet.
- Дозволіть вхідний UDP через порт слухача у брандмауері хоста.
Наприклад, сервер, який слухає через UDP-порт 25565, може використовувати правило з публічним портом 25565, адресою призначення 192.168.1.100 та портом призначення 25565. Замініть прикладну адресу на фактичну локальну адресу вашого сервера.
Зберігайте існуюче правило TCP для звичайних Minecraft-з’єднань. Правило пересилки TCP саме по собі не передає UDP.
Перевіріть, чи інший роутер чи ваш провайдер виконує NAT-переведення перед тим, як трафік досягне вашого роутера. Якщо у вас два роутери, переведення має охоплювати обидва. Якщо ваш провайдер використовує сервіс NAT на рівні провайдера, запитайте, чи може він надати публічну IPv4 адресу чи використовувати сервіс хостингу чи тунель, який підтримує вхідний UDP-трафік. Правила пересилання вашого роутера не можуть налаштувати NAT провайдера. Докладні відомості про вимоги до публічної WAN-адреси дивіться в інструкціях TP-Link щодо пересилання портів.
Дозволіть вибраному UDP-порту проходити як через IPv6-файрвол роутера, так і через файрвол хоста. Визначте IPv6-адресу машини, яка приймає підключення через RakNet.
Перевіріть, чи IPv6-адреса хостового імені вказує на потрібну машину. Якщо її IPv6-адреса змінилась, оновіть записи DNS та будь-які правила брандмауера, які стосуються цієї адреси.
Назва хоста, яка публікує як адреси IPv4, так і IPv6, потребує функціонального маршруту для кожної анонсованої адреси. Перевіряйте обидві серії правил, коли один гравець може з’єднатися, а інший – ні.
Якщо перенаправлення по IPv4 змінює номер порту, переконайтеся, що порт, який використовують гравці, також доступний для слухача по IPv6. Переклад порту по IPv4 не конфігурує маршрутизацію по IPv6.
Провайдер або тунель повинні підтримувати протокол UDP на публічному ендпоинті, який ви надсилаєте гравцям. Перевіріть розподіл портів, правила мережевого брандмауера, а також власний брандмауер сервера.
Якщо додатковий UDP-проксі пересилає адреси клієнтів за допомогою протоколу PROXY версії 2, дотримуйтесь процедур пересилання UDP та використання протоколу PROXY та обмежіть доступ до приймаючого UDP-слухача лише довіреному проксі.
Приєднуйтесь ззовні локальної мережі сервера за допомогою оновленого клієнта Raknetify2, використовуючи адресу типу raknet;play.example.com:25565. Використовуйте публічну UDP-порт у цій адресі.
Використовуйте справжнє з’єднання через RakNet для перевірки маршруту. Скан UDP, який не отримує відповіді, може показати неоднозначний результат, оскільки функціонуюча служба може відкинути незнайомий сканер. Документація Nmap щодо сканування UDP пояснює це поведінку.
Успішне TCP-з’єднання підтверджує лише TCP-шлях. Якщо RakNet вичерпав час, перевірте слухача, місце пересилання, UDP-порт та правила файерволу за посиланням на гід розв’язання проблем.
Перевірте сумісність з конкретним релізом, який ви завантажуєте. Розробчастий сегмент може містити функціонал, який ще не був включений до релізу.
Версії Minecraft та Java · English
Вимога до Java, визначена Raknetify2, є мінімальною. Minecraft або логгер можуть вимагати новішої версії робочого середовища. Оберіть версію Java, яка відповідає усім цим вимогам.
Використовуйте той самий реліз Raknetify2 на клієнті та сервері або проксі, який приймає його з’єднання, коли це можливо. Перевіряйте примітки до релізів перед їх поєднанням. Зашифровані з’єднання RakNet вимагають підтримки авторизованого шифрувального протоколу на обох кінцях. Оригінальні версії Raknetify та Raknetify2, створені до введення цього протоколу, не можуть встановити такі зашифровані з’єднання з оновленими партнерами.
Raknetify2 використовує існуючий геймплейний протокол Minecraft. Для підключення різних версій Minecraft необхідне налаштування перекладу протоколу, який буде сумісним.
У разі збійу у більшому мод-пакеті, дотримуйтесь гіду з виправленням проблем. Вкажіть у своєму звіті повні версії модів.
Зазвичай Raknetify2 дозволяє незалежним каналам пакетів продовжувати працювати, поки один канал чекає на відсутні дані. У режимі порядку всі пакети Minecraft розміщуються на одному каналі, тож відсутній пакет затримує всі наступні пакети в тому напрямку до моменту їх повторного передачі. Це зберігає порядок, який очікує деякі античит-програми, але втрачається можливість Raknetify2 продовжувати передачу несумісного геймплейного трафіку під час цього часу очікування.
-
Встановіть версію Raknetify2, яка підтримує порядковий режим на сервері чи проксі, що приймає з’єднання через RakNet, а також на кожному клієнті RakNet.
-
Створіть файл
config/raknetify2-compatibility.jsonу відповідному до каталогу сервера або проксі директорію. Якщо каталогconfigще не існує, створіть його. -
Додайте наступне:
{"mode": "ordered"} -
Перезапустіть сервер або проксі.
Клієнти автоматично слідують налаштуванням сервера. Гравцям не потрібно створювати конфігураційний файл чи змінювати адресу свого сервера RakNet.
Усі пакети в Minecraft використовують одну надійну послідовну канал у кожному напрямку, включаючи розділювачі пакетів та перехіди між світами.
Коли гравці підключаються через Velocity або BungeeCord, необхідно налаштувати режим порядку для цього проксі-сервера, навіть якщо античит працює на бекенд-сервері.
Ця політика діє для всіх бекенд-шлюзів. У режимі порядку проксі передає запити типу keepalive бекенду до справжнього клієнта, замість того, щоб відповідати на них локально.
Під час першого підключення до RakNet консоль повідомляє:
Raknetify2 compatibility: ordered (updated clients required, genuine acknowledgements)
Успішний обмін сумісністю також записує ordered compatibility negotiated, за яким следує адреса парного комп’ютера.
Залишайте перевірки проти шахрайства увімкненими та валідаціюйте своє конкретне налаштування.
Клієнти RakNet, які не підтримують порядковий режим, не зможуть підключитися до сервера, який вимагає цього. Оновіть Raknetify2 на цих клієнтах або підключайтеся за звичайною TCP-адресою та портом сервера чи проксі-сервера без префікса raknet;.
Змініть файл на:
{"mode": "multichannel"}Потім перезапустіть сервер або проксі-сервер. Видалення файлу також відновлює режим багатоканального зв’язку після перезапуску.
Файл повинен містити точно одну параметр, який має назву mode, а його значення може бути або "ordered", або "multichannel". Значення параметрів враховують розділові символи.
Негативна або нечитабельна конфігурація відкидає підключення до RakNet. Виправте файл та перезапустіть процес.
Якщо консоль все ще виводить multichannel, переконайтеся, що файл знаходиться у робочому каталозі сервера або проксі-сервера, який приймає підключення через RakNet, а потім перезапустіть цей процес.
Сервери Fabric, Forge та NeoForge можуть вибрати RakNet під час передачі спроможного клієнта до налаштованого пункту призначення. Це використовує вбудовану підтримку передачі в Minecraft, яка була введена в Java Edition 1.20.5. Переконайтеся, що ваша версія Raknetify2 підтримує версію та логер Minecraft з обох сторін.
Встановіть Raknetify2 на сервері-отримувачі та клієнті. Центр обміну повинен мати сумісний слухач RakNet та приймати вхідні транзакції Minecraft.
Ця конфігурація застосовується до транзакцій, які надсилаються за допомогою трьох вищезгаданих модів-загрузників. Плагифікації Spigot/Paper, Velocity та BungeeCord не читають цей файл транзакцій.
Створіть файл config/raknetify2-transfers.json у директорії сервера-отримувача:
{
"destinations": [
{
"host": "play.example.com",
"tcpPort": 25565,
"udpPort": 25570
}
]
}Замініть прикладний hostname та порти на власні значення вашого пункту призначення, а потім перезапустіть сервер-постачальник. Інші пункти призначення також вводяться в один масив.
| Поле | Значення |
|---|---|
host |
Назва хоста або IP-адреса, без префікса транспорту чи порту |
tcpPort |
Порт призначення у оригінальному запиті передачі |
udpPort |
Публічний порт RakNet, з яким встановлюється клієнт, повинен встановлювати контакт. |
Номери портів TCP та UDP можуть бути однаковими. Якщо маршрутизатор перетворює порт UDP, використовуйте відповідний публічний порт, зазначений у цьому файлі. Номери портів записуйте у форматі JSON-чисел.
Надсилайте транзакції на звичайне ім’я хоста та TCP-порт пункту призначення. Raknetify2 перевіряє, чи клієнт підтримує функцію автоматичного транзиту. Для клієнта, здатного до цього, та відповідного пункту призначення він обирає налаштований UDP-порт. Інші клієнти та невідповідні пункти призначення залишаються без змін.
Матеріал використовує ім’я хоста та TCP-порт з запиту на передачу даних. Ім’я хоста формується з великої літери, останній точка DNS та правильне написання IPv6 приведені до стандартного формату. Пошук по DNS не бере участі у процесі відповідності, тож дві різні назви хостів, які вказують на один і той самий адресний запис, потребують окремих записів. Волкодавські записи не підтримуються.
Для пункту призначення, який використовує server.properties Minecraft, встановіть accepts-transfers=true та перезапустіть його. Проксі-сервер пункту призначення може мати власні налаштування щодо передач. За замовчуванням Minecraft відхиляє вхідні передачі, навіть коли звичайне безпосереднє приєднання функціонує належним чином.
Місце призначення – слухач RakNet, публічний перенаправлення UDP та файрвол хоста – вже повинні бути налаштовані. Файл передач сервера-отримувача вибирає адресу, яка буде надіслана клієнту.
Перевіряйте IPv4 та IPv6 маршрутиці відправника, коли його хостна назва виводить обидва типи адрес. Спочатку протестуйте звичайне пряме з’єднання через RakNet з відправником, перед тим як досліджувати поведінку автоматичного перекладу.
Залишайте всі перевірки доступу та автентифікації. Ця конфігурація не надає гравцям доступу та не замінює серверну автентифікацію.
Відсутні поля, невідомі поля, недійсні порти та дублікатовані пункти призводять до конфігураційного помилки під час ініціалізації. Використовуйте журнал сервера для виявлення помилки, виправте JSON-файл та перезапустіть сервер.
Щоб відключити автоматичний вибір, видаліть конфігураційний файл або використайте {"destinations": []}, після чого перезапустіть сервер надсилання. Його запити на передачу збережуть свої початкові адреси.
UDP-проксі може пересилати трафік RakNet та зберігати оригінальний адресу клієнта за допомогою протоколу PROXY v2. Включіть цю функцію, коли upstream UDP-проксі надсилає ці заголовки вашому слухачу. Звичайне перенаправлення порту роутера це не вимагає.
На сервері або на Minecraft-проксі, який отримує пересилений UDP-трафік, створіть файл config/raknetify2-proxy-protocol.json:
{
"trustedProxies": ["192.0.2.10"]
}Замість прикладу використовується фактична вихідна IP-адреса UDP-проксі або діапазон CIDR, який ви контролюєте. Адреса повинна відповідати тій, яку бачить отримувач після будь-яких перешкод у форматі NAT. Приймаються літералі IPv4 та IPv6. Назви хостів через DNS відхиляються. Перевструйте отримуючий сервер або проксі.
Налаштуйте проксі-сервер для пересилання заголовків протоколу PROXY v2 для UDP. Raknetify2 приймає лише адреси клієнтів, пересилані з перелічених джерел. Прямі підключення через RakNet без цих заголовків будуть відхилені, коли це налаштування активне. Слухач TCP зберігає своє існуюче налаштування.
Кожен з перелічених проксі-серверів вважається надійним для надання адрес клієнтів. Обмежіть доступ до UDP-порту бекенду у своєму брандмауері, щоб лише призначений проксі-сервер міг до нього дістатися. Зберігайте діапазони довіри якомога вузькими, як це дозволяє ваша мережа.
Файл повинен містити лише trustedProxies, причому кожен запис має бути не менше одного. Порожній масив є помилкою. Негалійний файл заважає запуску слухача RakNet.
Щоб повернутися до прямих UDP-з’єднань, видаліть файл та перезапустіть слухача. Водночас оновіть поведінку перенаправлення upstream та правила файрволу для нового маршруту.
Якщо з’єднання не вдаються після активації цієї функції, перевірте фактичний вихідний адресу проксі на сервері, налаштований довірений діапазон, та чи проксі посилає заголовки протоколу UDP PROXY версії 2.
Для встановлення проксі в Minecraft та налаштування бекенду дотримуйтесь інструкцій Velocity and BungeeCord.
Raknetify2 може ділитися своїм серверним слухачем UDP з Simple Voice Chat на платформах Fabric, Forge, NeoForge, Spigot та Paper.
Встановіть Simple Voice Chat на сервері та на кожному клієнті, який бажає голосовий чат. Для решти налаштувань дотримуйтесь його гіду налаштування сервера.
Використовуйте директорію config верхнього рівня сервера для файлів Raknetify2, включаючи Spigot/Paper. Власні файли Simple Voice Chat залишаються у специфічному для платформи місці.
-
Створіть файл
config/raknetify2-voicechat.jsonу директорії сервера з таким вмістом:{"enabled": true} -
Налаштуйте
port=-1у конфігурації сервера Simple Voice Chat. На модізованих серверах цеconfig/voicechat/voicechat-server.properties. На Spigot/Paper –plugins/voicechat/voicechat-server.properties. -
Відкиньте
bind_addressпорожнім, якщо існує один слухач RakNet. Якщо сервер має кілька слухачів на цьому UDP-порту, встановіть його як локальний адресу слухача, яку ви хочете поділити. -
Перезапустіть сервер та запустіть програму
/voicechat test <PLAYERNAME>для гравця, який знаходиться в режимі підключення.
Якщо слухач RakNet використовує інший порт, ніж у Minecraft, встановіть параметр port на цей локальний UDP-порт, а не використовуйте -1. Наприклад, слухач RakNet на локальному UDP-порту 25570 потребує параметра port=25570.
Налаштуйте voice_host, якщо клієнтам потрібен інший публічний адресний запис або порт. Якщо маршрутизатор пересилає публічний UDP 25580 на локальний UDP 25570, використовуйте port=25570 та voice_host=play.example.com:25580. Публічний адресний запис слід вказати в voice_host. Налаштування bind_address вибирає локального слухача.
Raknetify2 надає спільний UDP-сокет через API Simple Voice Chat. Simple Voice Chat керує автентифікацією та шифруванням голосових повідомлень. Гравці можуть використовувати голосовий чат як з TCP, так і з RakNet-з’єднаннями.
Обов’язково розділіть Query та Geyser на окремі UDP-порти. Інтеграція спільного сокету підтримує лише Simple Voice Chat.
Інтеграція не використовує сокет голосового проксі на серверах Velocity чи BungeeCord. Дотримуйтесь інструкції з налаштування проксі Simple Voice Chat та призначіть окрему UDP-порт для голосового проксі. За допомогою офіційного плагіна для голосового проксі встановіть будь-яке публічне значення voice_host у конфігурації проксі. Цей плагін ігнорує налаштування voice_host від серверів бекенд.
Для загального UDP тунелю встановіть voice_host на публічне хостове ім’я та UDP-порт, який пересилає дані на цей сервер.
Якщо в логі повідомляється No RakNet listener matches the voice bind address and port, підтвердіть, що RakNet успішно запущений, і що голосова порта та адреса bind відповідають його локальному слухачу.
Якщо в результаті отримано значення Multiple RakNet listeners match the voice bind address, необхідно вибрати конкретний локальний адресу з таблиці bind_address та перезапустити процес.
Лише один плагін Simple Voice Chat може надавати свій UDP-сокет. Якщо під час запуску системи повідомляється, що інший плагін вже надає сокет, виберіть, який сокет використовувати.
Щоб вимкнути інтеграцію Raknetify2, задайте {"enabled": false} у файлі налаштувань голосового зв’язку Raknetify2 або видаліть цей файл. Виділіть для Simple Voice Chat окремий порт UDP, оновіть правила брандмауера чи переспрямування та перезапустіть сервер.
Перевіряйте їх у порядку:
- Клієнт має правильний мод Raknetify2 для свого завантажувача та версії Minecraft.
- Сервер або проксі, який приймає з’єднання, має встановлене Raknetify2 та запущене без помилок з боку слухача.
- Адреса починається з
raknet;і використовує публічну UDP-порт. - Хостинг-провайдер, маршрутизатор та файрвол хоста всі дозволяють використання протоколу UDP на цьому порту.
- Назва хоста з IPv4 та IPv6 адреса ведуть до потрібного хоста, і у нього діє правильне правило брандмауера.
Успішне TCP-з’єднання підтверджує лише TCP-шлях. Слід дотримуватися конфігурації брандмауера та роутера, щоб перевірити пересилання UDP та доступ до IPv6. Якщо активовано протокол PROXY, клієнти повинні досягати слухача через налаштований довірений проксі-сервер.
Перевіріть, чи немає іншого процесу, який використовує UDP-порт. Сервіс Geyser та інші UDP-сервіси потребують власних портів. Сервіс Simple Voice Chat може використовувати інтеграцію через спільний порт.
Ви можете вибрати інший локальний UDP-порт за допомогою налаштувань прослушувача прямого сервера або налаштувань Velocity та BungeeCord. Перевірте вимоги до версії для налаштувань Spigot/Paper. Зміна лише публічного порту маршрутизатора залишає локальний сокет у стані конфлікту.
Приєднайтеся безпосередньо до пункту призначення за його адресою raknet;. Якщо це не спрацює, спочатку виправте функціонування слухача пункту призначення чи мережевий маршрут.
Якщо прямі з’єднання працюють, перевірте, чи адресат приймає вхідні трансфери. Сервер Minecraft, який використовує файл server.properties, повинен мати параметр accepts-transfers=true. Прямі приєднання не перевіряють цей параметр.
Потім порівняйте ім’я хоста та TCP-порт передачі з файлом config/raknetify2-transfers.json на сервері відправника. Переконайтеся, що файл був завантажений після перезапуску та що клієнт підтримує автоматичні передачі через RakNet. Дивіться Автоматичні передачі.
Перевіряйте версії Raknetify2 на обох кінцях з’єднання. Оновлюйте клієнт та сервер або проксі разом, коли нове версії змінює зашифрований протокол. Зберігайте налаштування автентифікації сервера під час досліджень.
Запишіть, яка дія спричиняє збій: відкриття інвентару, отримання ресурсного пакета, зміна світів чи створення ентитю. Порівняйте одну і ту саму дію через TCP та RakNet, використовуючи окрему тестову установку, якщо це можливо.
Деякі користувацькі пакети залежать від порядку ванільних пакетів. Автори модів можуть визначати ці залежності через інтерфейс порядку пакетів packet ordering interface.
Відкрийте проблему в маркетинговому інструментарії Raknetify2 та включіть:
- Minecraft, версії Java, loader та Raknetify2 на обох кінцях мережі.
- Версії програмного забезпечення сервера та проксі, включаючи проксі-сервери для пересилання UDP-пакетів.
- Інші встановлені моди та їх версії.
- Кроки для виявлення проблеми та те, що ви очікували відбутися.
- Чи діють ті самі кроки через TCP.
- Відтворення важливих фрагментів логів клієнтів, серверів та проксі з того самого спроби.
Перед завантаженням логів видаляйте токени доступу, паролі та іншу приватну інформацію. Зберігайте повідомлення про винятки та стек спроб, необхідні для диагностики проблеми.
Raknetify2 дозволяє модам визначати, який трафік Minecraft повинен залишатися упорядкованим за допомогою їхніх власних пакетів даних. Використовуйте це, коли обробка пакета вимагає ентитета, куба, інвентару чи іншого стану, встановленого раніше пакетами.
| Група | Схожий трафік |
|---|---|
ui |
Меню та взаємодії, незалежні від світу |
entity |
Спавнення, видалення та переміщення ентітетів |
world_interaction |
Запаси та інші взаємодії, залежні від світу |
effects |
Звуки та частинки |
chunk |
Оновлення рельєфу, блоків та освітлення |
Усі групи забезпечують надійну та впорядковану доставку власних каналів. Пакети з різних груп можуть прибути в іншому порядку. Виберіть групу, яка відповідає залежності вантажу.
Додайте провайдер під елементом raknetify:packet_channels у файлі fabric.mod.json вашого моду. Провайдер реалізує тип Consumer<BiConsumer<String, String>> за допомогою типів JDK. Він отримує регістр, який приймає ідентифікатор користувальника та групу порядку.
Змішайте це запис у свої існуючі метадані, замінивши назву класу на повноцінне ім’я вашого провайдера:
{
"entrypoints": {
"raknetify:packet_channels": [
"com.example.mod.OrderingProvider"
]
}
}Збережіть решту вашого файлу fabric.mod.json, включаючи його існуючі записи. Це фрагмент метаданих файлу.
Наприклад, розширення для руху ентитю може реєструвати example:entity_path у групі entity. У документації API PacketOrdering наведена реалізація цього сервісу.
Fabric не викликає цей входний пункт, коли Raknetify2 відсутній. Провайдери повинні оголосити ідентифікатори та групи під час ініціалізації, не покладаючись на те, що інший мод завершив свою ініціалізацію.
Моди Forge та NeoForge, а також плагіни для серверів чи проксі-сервісів можуть викликати PacketOrdering.register(identifier, group) під час ініціалізації, коли Raknetify2 доступний. Клас, який використовується для цього, – com.ishland.raknetify.api.PacketOrdering. Реєструйте цей клас перед прийомом підключень гравців, щоб уникнути завантаження класів Raknetify2, якщо залежність від них відсутня.
Оголошення застосовуються до нових з’єднань. Існуючі з’єднання зберігають правила, які вони отримали під час налаштування. Допускається повторення однакового оголошення. Конфліктні групи для одного і того ж ідентифікатора відхиляються.
Ідентифікатори пейлоджету повинні використовувати дійсний користувацький простір імен. Простір імен minecraft зарезервований. Максимальна кількість ідентифікаторів для кожного кінцевого пункту становить 128, включаючи вбудовані правила та реєстрації з інших модів. Ідентифікатори можуть містити до 255 символів ASCII, використовуючи синтаксис іменованих ідентифікаторів API.
Оновлені ракети RakNet обмінюються деклараціями під час налаштування з’єднання. Сервер або проксі може використовувати декларацію ракети, якщо у нього немає власних правил для цього пакета даних. Власні правила мають пріоритет, і декларації ракети залишаються обмеженими для цього з’єднання.
Дивіться Пересилання UDP та протокол PROXY щодо реле UDP та пересилених адрес клієнтів.
Для налаштування проксі в Minecraft дивіться Velocity and BungeeCord.