Як створити сервер Cyberpunk 2077 з Open77

Open77 (OPEN//77) - це спільнотна багатокористувацька платформа для Cyberpunk 2077. Розміщення власного сервера Cyberpunk 2077 дозволяє вам:

• Грати разом у Night City: рольові ігри, freeroam, deathmatch або battle royale.
• Створювати власні ігрові режими за допомогою ресурсів Lua 5.4 та веб-інтерфейсів (WebUI).
• Налаштовувати світ: транспорт, карти, NPC, кіберимпланти, погоду та моди, що автоматично поширюються серед гравців.
• Згуртувати спільноту з самого початку розвитку ще молодої багатокористувацької сцени, де ще є місце, щоб заявити про себе.

Open77 працює за тим самим принципом, що й FiveM для GTA V: виділений сервер, безкоштовний ліцензійний ключ, веб-панель адміністрування та скриптові ресурси. Сервер постачається готовим до гри з режимом Freeroam: ви можете відкрити свій світ за кілька хвилин, а потім розвивати його.

Сервер Open77 свідомо зроблений легким: йому не потрібні ні Cyberpunk 2077, ні рушій REDengine, ні дані гри. Перевірте ці пункти перед початком:

• ✔ Система : Windows x64 або Linux x64 (Debian), runtime .NET включено в архів: більше нічого встановлювати не потрібно
• ✔ Обладнання : Офіційна документація не встановлює мінімальних вимог; як орієнтир, VPS із 2-4 ядрами та 4 ГБ RAM достатньо для старту, збільшуйте ресурси залежно від ваших ресурсів Lua та кількості гравців
• ✔ Гра : Встановлення Cyberpunk 2077 на серверній машині не потрібне
• ✔ Гравці : Кожен гравець повинен мати Cyberpunk 2077 версії 2.31 з доповненням Phantom Liberty на 64-бітній Windows 10 або 11, а також доступ Alpha
• ✔ Хостинг : Ваш ПК для тестування, потім VPS або виділений сервер для сервера, відкритого 24/7

Щоб завантажити сервер і зареєструвати його на мастер-сервері Open77, вам потрібен акаунт з доступом Alpha та ліцензійний ключ, згенерований у keymaster.

/alpha apply

Виділений сервер Open77 завантажується зі сторінки Host офіційного сайту. Архів містить сервер та його runtime .NET, готовий до гри режим Freeroam, Warden (майстер налаштування та веб-панель) та runtime Lua 5.4.

1. Перейдіть на open2077.net/host зі своїм акаунтом Alpha та оберіть канал Stable (рекомендовано), а не Unstable
2. Завантажте архів для вашої системи: .zip для Windows, .tar.gz для Linux, і перевірте його відбиток SHA-256, вказаний на сторінці
3. Розпакуйте архів у папку, виділену для вашого сервера
4. Запустіть Start.cmd у Windows або ./start.sh у Linux (або безпосередньо виконуваний файл Open77.Server)

Вказати ліцензійний ключ

Рекомендований спосіб - передавати ключ через змінну середовища OP77_LICENSE_KEY, щоб ніколи не записувати його відкритим текстом у файлі конфігурації:

Linux :

export OP77_LICENSE_KEY="op77_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
./start.sh

Windows :

$env:OP77_LICENSE_KEY = "op77_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
.\Start.cmd

Warden - це веб-панель адміністрування, що постачається із сервером Open77, аналог txAdmin для FiveM. Під час першого запуску, якщо файл server.jsonc відсутній, у браузері відкривається майстер налаштування.

http://localhost:11780

Файл server.jsonc (JSON із підтримкою коментарів) містить усю конфігурацію сервера. Майстер налаштування генерує такий файл; ось основні блоки, які варто знати:

{
  "identity": {
    "name": "Night City RP",
    "visibility": "public"
  },
  "network": {
    "port": 11778,
    "publicEndpoint": "play.example.com:11778"
  },
  "query": {
    "enabled": true,
    "map": "Night City",
    "gamemode": "Freeroam"
  },
  "masterServer": {
    "enabled": true,
    "url": "https://master.open2077.net/",
    "licenseKey": null,
    "licenseKeyEnvironmentVariable": "OP77_LICENSE_KEY"
  },
  "warden": {
    "enabled": true,
    "bind": "127.0.0.1:11780"
  }
}

• identity.name - Назва сервера, що відображається в браузері серверів launcher
• identity.visibility - Видимість у каталозі: public (у списку), unlisted або private (за запрошенням)
• network.port / network.publicEndpoint - Ігровий UDP-порт (11778 за замовчуванням) та публічна адреса, яку гравці використовують для підключення
• query - Вмикає запит інформації про сервер і задає карту та ігровий режим, що відображаються
• masterServer - Реєстрація на мастер-сервері Open77; залиште licenseKey як null, щоб ключ зчитувався зі змінної OP77_LICENSE_KEY
• warden.bind - Адреса прослуховування панелі Warden, залишайте локальною

Аргументи запуску

На VPS ви також можете передати все через аргументи запуску: --no-setup пропускає майстер налаштування, --public-ip оголошує ваш публічний IP, а --max-players задає максимальну кількість гравців. Додайте --check-config, щоб перевірити конфігурацію без запуску сервера.

./Open77.Server --no-setup --config server.jsonc \
  --public-ip 203.0.113.10 --port 11778 --max-players 32 \
  --log-level info

Весь контент вашого сервера (ігрові режими, HUD, скрипти, карти, транспорт) представлений у вигляді ресурсів: пакетів скриптів Lua 5.4, прав доступу та веб-файлів, які сервер завантажує і поширює серед гравців. Вони розкладені за категоріями в папці resources/:

resources/
  system/       official platform resources
  gamemodes/    playable modes and HUDs
  dev/          examples and harnesses
  assets/
    loaders/    archivexl, tweakxl
    maps/       world packages
    vehicles/   vehicle packages
    mods/       third-party packages

Маніфест open77.lua

Кожен ресурс має файл open77.lua, який оголошує його назву, версію, серверні, клієнтські та спільні скрипти, веб-інтерфейс і необхідні права доступу. Серверні скрипти ніколи не надсилаються гравцям.

resource "garage"
version "1.0.0"
auto_start true

shared_script "shared/config.lua"
server_script "server/main.lua"
client_script "client/main.lua"

web_ui_page "web/index.html"
web_files { "web/**" }
permissions { "network.events" }

Керування ресурсами з консолі

Після додавання папки пересканьте маніфести командою refresh, потім запустіть ресурс командою ensure. Також доступні команди start, stop, restart і resources (список), а також гаряче перезавантаження з Warden.

refresh
ensure garage
restart garage
stop garage

Прийшли з FiveM?

Open77 запозичує багато концепцій FiveM і пропонує аліаси сумісності: Citizen.CreateThread, Wait, RegisterCommand, події та exports працюють, а fxmanifest.lua перетворюється на open77.lua. Однак натива GTA (Citizen.InvokeNative, RequestModel, RequestAnimDict) не існує: скрипт FiveM потрібно адаптувати, а не просто скопіювати. Якщо ви новачок у FiveM, перегляньте також наш посібник зі створення сервера FiveM.

База даних MySQL / MariaDB

Для збереження даних (персонажі, інвентарі, транспорт) увімкніть блок database у server.jsonc. Підтримуються лише MySQL та MariaDB. Рядок підключення у форматі MySqlConnector бажано передавати через змінну OP77_DATABASE_CONNECTION, і кожен ресурс, що звертається до бази, повинен оголосити право доступу database.access.

Server=127.0.0.1;Port=3306;Database=open77;User ID=open77;Password=SECRET;

Open77 вміє автоматично встановлювати моди, необхідні вашому серверу (ArchiveXL, TweakXL, транспорт, карти), перед запуском гри: гравцям не потрібно робити нічого вручну і не потрібно перезапускати гру, щоб приєднатися.

Три статуси безпеки

• Verified - мод перевірений командою Open77, дозволений будь-який тип контенту (включно з виконуваними файлами), поширюється платформою
• Unverified - приймаються лише інертні дані (.archive, .tweak, .xl, INI-файли рушія), розміщені на вашому сервері
• Blocked - мод відхилений: гравці не можуть приєднатися до сервера, який його вимагає

Open77 використовує UDP-порт для гри та TCP-порт для завантаження ресурсів гравцями. Щоб ваш сервер був доступний з Інтернету, обидва ці порти повинні бути відкриті.

Порти для відкриття

• UDP 11778 (за замовчуванням): ігровий трафік, змінюється через network.port або --port
• TCP 11779 (за замовчуванням): завантаження ресурсів і модів гравцями
• TCP 11780 : панель Warden, залишайте локальною, не відкривайте її публічно

Приклади правил фаєрвола

Windows Defender :

New-NetFirewallRule -DisplayName "Open77 Game" -Direction Inbound -Protocol UDP -LocalPort 11778 -Action Allow
New-NetFirewallRule -DisplayName "Open77 Downloads" -Direction Inbound -Protocol TCP -LocalPort 11779 -Action Allow

Linux UFW :

sudo ufw allow 11778/udp
sudo ufw allow 11779/tcp

Linux iptables :

sudo iptables -A INPUT -p udp --dport 11778 -j ACCEPT
sudo iptables -A INPUT -p tcp --dport 11779 -j ACCEPT

Warden централізує адміністрування вашого сервера Cyberpunk 2077 через браузер:

• Консоль у реальному часі: читати логи та виконувати команди сервера
• Модерація гравців: попереджати, виганяти, банити та керувати списком заблокованих, надсилати оголошення
• Керування ресурсами Lua з гарячим перезавантаженням, без перезапуску сервера
• Акаунти адміністраторів з правами, обмеженими за ролями, а також значок і банер сервера

• ✔ Резервні копії: регулярно копіюйте ваш server.jsonc, папку resources/ та базу даних за межі машини. Автоматизуйте це: про ручну резервну копію зрештою завжди забувають.
• ✔ Оновлення: залишайтеся на каналі Stable і оновлюйте сервер щойно виходить нова версія, оскільки гравцям потрібна сумісна версія. Під час Alpha зберігайте резервну копію ваших ресурсів перед кожним оновленням.

Після реєстрації на мастер-сервері за допомогою ліцензійного ключа публічний сервер автоматично з'являється в браузері launcher Open77 та на open2077.net. Декілька налаштувань можуть відіграти важливу роль:

• ✔ Оберіть зрозумілу назву та опис, які повідомляють про ваш ігровий режим, мову та атмосферу.
• ✔ Додайте теги: перший тег, що відповідає відомому режиму, визначає категорію, до якої потрапляє ваш сервер, інакше він відображається як «Custom».
• ✔ Додайте значок і банер через Warden, вкажіть ваш сайт і Discord, і поділіться посиланням для прямого підключення (open77://connect?server=...).
• ✔ Додайте свій сервер до рейтингу серверів Cyberpunk 2077 Top-Games, щоб залучити нових гравців за допомогою голосів.