NightCoop
Инструкции

Инструкции

От первой установки до своего сервера. Каждая инструкция короткая, команды копируются одним нажатием.

Установка мода

Нужна лицензионная Cyberpunk 2077 на Windows (Steam, GOG или Epic). На какой версии игры работает сборка, написано у неё на странице «Скачать».

  1. Архив. Скачайте архив сборки на странице «Скачать». RED4ext 1.30 уже в нём, отдельно его ставить не нужно; его лицензия — в red4ext\LICENSE.txt.
  2. Распаковка. Распакуйте архив целиком в папку игры и согласитесь заменить файлы: папки bin и red4ext из архива лягут поверх папок игры.
  3. Проверка. Должен появиться файл Cyberpunk 2077\red4ext\plugins\NightCoop\NightCoop.dll. Запустите игру: в главном меню появится пункт «Совместная игра».

Где папка игры

В Steam: правой кнопкой по игре → «Управление» → «Просмотреть локальные файлы». Обычно это …\steamapps\common\Cyberpunk 2077. В GOG Galaxy и Epic — «Управление» / «Показать папку».

Перед первой сессией сделайте копию папки сейвов: %USERPROFILE%\Saved Games\CD Projekt Red\Cyberpunk 2077. Мод бережёт сейвы гостя, но копия ничего не стоит.

Пункта «Совместная игра» нет

  • Проверьте путь к NightCoop.dll — лишняя вложенная папка из архива частая причина.
  • Откройте журнал RED4ext в red4ext\logs: там написано, загрузил ли он плагин и почему нет.
  • Версия игры должна быть из списка у сборки: на другой RED4ext плагин не загрузит.

Installing the mod

You need a licensed Cyberpunk 2077 on Windows (Steam, GOG or Epic). Which game versions a build runs on is written next to it on the Download page.

  1. Archive. Download the build’s archive on the Download page. RED4ext 1.30 is already inside, no separate install; its license is in red4ext\LICENSE.txt.
  2. Unpack. Unpack the whole archive into the game folder and agree to replace files: its bin and red4ext folders go over the game’s.
  3. Check. The file Cyberpunk 2077\red4ext\plugins\NightCoop\NightCoop.dll should be there. Start the game: the main menu gets a Co-op item.

Where the game folder is

In Steam: right-click the game → Manage → Browse local files. Usually it is …\steamapps\common\Cyberpunk 2077. In GOG Galaxy and Epic — Manage / Show folder.

Before the first session, copy your saves folder: %USERPROFILE%\Saved Games\CD Projekt Red\Cyberpunk 2077. The mod keeps a guest’s saves safe, but a copy costs nothing.

No Co-op item in the menu

  • Check the path to NightCoop.dll: an extra nested folder from the archive is the usual cause.
  • Open RED4ext’s log in red4ext\logs: it says whether it loaded the plugin, and why not.
  • The game version must be one the build lists: on another one RED4ext does not load the plugin.

Первая сессия

У всех игроков — одна и та же сборка NightCoop. Пункт «Совместная игра» есть в главном меню и в меню паузы.

Хост

  1. «Совместная игра» → «Создать сессию».
  2. В главном меню открывается лобби: выберите сейв мира или «Новая игра»; каждый игрок отмечает «Готов».
  3. Код сессии показан крупно справа. «Копировать приглашение» кладёт в буфер строку с кодом и сервером — отправьте её напарникам.

Гость

  1. «Совместная игра» → «Войти по коду».
  2. Наберите код или вставьте приглашение (Ctrl+V). Вы загрузитесь в мир хоста своим V.

Сервер

Справа сверху в меню мода — окно «Сервер: …». По умолчанию стоит «Авто: ближний»: мод сам выбирает официальный сервер с наименьшим пингом. Свой сервер добавляется там же — как.

Совет. Играйте в режиме окна «Без рамки»: в «Полном экране» Alt+Tab подвешивает кадр на 1–2 секунды. Если игра время от времени замирает примерно на секунду, выключите оверлей Discord и генерацию кадров NVIDIA.

The first session

Everyone runs the same NightCoop build. The Co-op item is in the main menu and in the pause menu.

Host

  1. Co-op → Host a session.
  2. In the main menu this opens a lobby: pick a world save or New game; every player marks Ready.
  3. The session code is shown large on the right. Copy the invite puts a line with the code and the server on the clipboard — send it to your partners.

Guest

  1. Co-op → Join by code.
  2. Type the code or paste the invite (Ctrl+V). You load into the host’s world as your own V.

Server

The top right of the mod menu shows “Server: …”. It starts on “Auto: the nearest”: the mod picks the official server with the lowest ping. Your own server is added in the same place — how.

Tip. Play in Borderless window mode: in exclusive fullscreen Alt+Tab freezes a frame for 1–2 seconds. If the game stalls for about a second now and then, turn off the Discord overlay and NVIDIA frame generation.

Свой сервер у игроков

Поднять свой сервер: исходники хаба и инструкция — github.com/Twenfys/nightcoop-hub (через Docker или сборкой без него). Ниже — как подключиться к такому серверу.

Владелец сервера даёт адрес и отпечаток ключа, например hub.example.org#K3QF-9X2M-TV7A-0D4R. Подойдёт и адрес числом (203.0.113.7#K3QF-…), другой порт пишется через двоеточие (hub.example.org:47900#K3QF-…).

  1. Хост: меню мода «Совместная игра» → «Сервер: …» → «Добавить свой сервер» → введите или вставьте адрес с отпечатком → «Сохранить». Сервер сразу выбран: справа сверху видно «СЕРВЕР: … · пинг · проверен».
  2. В сессии — «Копировать приглашение»: строка вида ABC234@hub.example.org#K3QF-9X2M-TV7A-0D4R (код сессии и сервер).
  3. Гость вставляет её в «Войти по коду» — и попадает на тот же сервер; сервер запоминается у него в своих.

Выбор и свои серверы хранятся в servers.txt рядом с NightCoop.dll. Вернуться на официальные: «Сервер: …» → «Авто: ближний». Старый файл hub.txt с одной строкой адреса тоже работает: новая версия сама перенесёт его в свои серверы.

Если что-то не так

В игреПочемуЧто делать
«Сервер не прошёл проверку ключей»Отпечаток не сходится с ключом сервера: опечатка, новый ключ или это не тот сервер.Проверьте адрес («Сервер: …» → свой сервер → «Изменить адрес»). Ключ создан заново — возьмите новый отпечаток у владельца.
«Сервер … не найден»Имя не находится в DNS.Проверьте имя или впишите адрес числом.
«Сервер не отвечает»Закрыт UDP 47800 или хаб не запущен.Напишите владельцу сервера.
Сессия создаётся на 5–6 секунд дольшеНа сервере закрыты порты потоков 47810+.Играть можно; владельцу — открыть порты.

Без отпечатка (только hub.example.org) игра тоже соединится и зашифрует связь, но не отличит сервер от подставного — в окне сервера будет «шифруется, не проверен». Просите у владельца адрес с отпечатком.

Joining your own server

To run your own server: the hub’s sources and the guide are at github.com/Twenfys/nightcoop-hub (with Docker or a build without it). Below — how players join such a server.

The server’s owner gives you an address and a key fingerprint, for example hub.example.org#K3QF-9X2M-TV7A-0D4R. An IP address works too (203.0.113.7#K3QF-…); another port goes after a colon (hub.example.org:47900#K3QF-…).

  1. Host: the mod menu Co-op → Server: … → Add an own server → type or paste the address with the fingerprint → Save. The server is chosen at once; the top right reads “SERVER: … · ping · verified”.
  2. In the session, Copy the invite gives a line like ABC234@hub.example.org#K3QF-9X2M-TV7A-0D4R (the session code and the server).
  3. The guest pastes it into Join by code and lands on the same server; it is remembered among the guest’s own servers.

The choice and your own servers are kept in servers.txt next to NightCoop.dll. Back to the official ones: Server: … → Auto: the nearest. The older hub.txt file with one address line still works: a new version moves it into your own servers.

When something is wrong

In the gameWhyWhat to do
“The server failed the key check”The fingerprint does not match the server’s key: a typo, a new key, or not that server at all.Check the address (Server: … → the own server → Change the address). If the key was re-created, get the new fingerprint from the owner.
“The server is not found”The name does not resolve.Check the name or use the IP address.
“The server does not answer”UDP 47800 is closed, or the hub is down.Tell the server’s owner.
Creating a session takes 5–6 seconds longerThe thread ports 47810+ are closed on the server.You can play; the owner should open the ports.

Without a fingerprint (just hub.example.org) the game still connects and encrypts, but cannot tell the server from an impostor: the server window says “encrypted, not verified”. Ask the owner for the address with the fingerprint.

Свой хаб

Исходники хаба и инструкция — что нужно серверу, порты, ключ, обновление, сборка без Docker — на github.com/Twenfys/nightcoop-hub. Как игрокам подключиться к вашему серверу — выше.

Логи и отчёт об ошибке

Мод пишет подробный журнал. С ним ошибку находят по времени, без него — угадывают.

Папка в папке игрыЧто там
red4ext\logsПолные журналы запусков: nightcoop-…log и журнал самого RED4ext.
red4ext\plugins\NightCoop\logsПоследние минуты перед падением или зависанием (nightcoop-last-…-crash.log, …-hang.log) и прошлые сессии.
  1. Запишите время, что делали и кто вы в сессии — хост или гость.
  2. Сожмите обе папки в zip. Лучше всего — логи всех игроков сессии.
  3. Отправьте в наш Discord, в канал для отчётов.

Logs and bug reports

The mod keeps a detailed log. With it a bug is found by its time; without it, guessed.

Folder in the game folderWhat is there
red4ext\logsFull logs of each start: nightcoop-…log and RED4ext’s own log.
red4ext\plugins\NightCoop\logsThe last minutes before a crash or a freeze (nightcoop-last-…-crash.log, …-hang.log) and past sessions.
  1. Note the time, what you were doing and whether you were the host or a guest.
  2. Zip both folders. Logs from every player in the session help most.
  3. Post them on our Discord, in the bug reports channel.

Обновление и откат

  • Обновить. Скачайте новую сборку и замените папку red4ext\plugins\NightCoop целиком: старые файлы в ней не оставляйте. servers.txt можно сохранить — в нём ваши серверы.
  • Играть со старой версией. В сессии у всех должна быть одна сборка. Все вышедшие версии остаются на странице «Скачать»; вместе играют сборки с одинаковым номером протокола.
  • Удалить мод. Удалите папку red4ext\plugins\NightCoop. Сейвы остаются на месте.

Updating and going back

  • Update. Download the new build and replace the red4ext\plugins\NightCoop folder as a whole: leave no old files in it. You can keep servers.txt — it holds your servers.
  • Play an older version. Everyone in a session needs the same build. Every released version stays on the Download page; builds with the same protocol number play together.
  • Remove the mod. Delete the red4ext\plugins\NightCoop folder. Your saves stay where they are.