Project Zomboid Discord Интеграция

Аренда сервера Project Zomboid: XLGAMES.GG

Как настроить интеграцию Discord на сервере Project Zomboid

В этом гайде показано, как настроить интеграцию Discord на сервере Project Zomboid на хостинге XLGAMES.GG.

Discord-интеграция позволяет связать игровой сервер Project Zomboid с вашим Discord-сервером через Discord-бота.

Что делает Discord-интеграция

После настройки интеграции Discord-бот сможет:

• отправлять уведомление о запуске сервера
• сообщать, когда сервер готов к подключению
• показывать, когда игрок зашёл на сервер
• показывать, когда игрок отключился от сервера
• указывать ник игрока при входе и выходе
• транслировать игровой чат Project Zomboid в Discord
• отправлять сообщения из Discord-канала обратно в игровой чат
• работать как с английскими, так и с русскими сообщениями

Например, игрок пишет сообщение в игровом чате Project Zomboid — это сообщение появляется в Discord-канале.

И наоборот: если написать сообщение в указанном Discord-канале, оно будет отправлено в игровой чат сервера.

Что потребуется

Для настройки понадобится:

• Discord-аккаунт
• свой Discord-сервер
• права на добавление бота на Discord-сервер
• доступ к панели управления сервером Project Zomboid
• Discord Bot Token

Шаг 1. Авторизуйтесь в Discord в браузере

Для начала авторизуйтесь в своём Discord-аккаунте через браузер.

После этого откройте страницу Discord Developer Portal:

Discord Developer Portal

Шаг 2. Создайте новое приложение

На странице Discord Developer Portal нажмите кнопку New Application.

Кнопка New Application в Discord Developer Portal

Шаг 3. Укажите название приложения

В открывшемся окне укажите название приложения.

Название можно выбрать любое. Например:

PZChat

В качестве типа можно выбрать Personal.

Создание приложения Discord для Project Zomboid

После этого создайте приложение.

Шаг 4. Откройте вкладку Bot

После создания приложения откройте вкладку Bot.

Вкладка Bot в настройках Discord-приложения

Шаг 5. Настройте имя бота и получите токен

На странице Bot можно изменить имя бота.

В поле Username вместо стандартного имени, например servertest, можно указать любое удобное имя.

Например:

servertest

На этой же странице нажмите кнопку Reset Token, чтобы получить токен бота.

Кнопка Reset Token для получения токена Discord-бота

Скопируйте полученный токен и обязательно сохраните его в надёжном месте.

Важно: после ухода со страницы токен больше не будет отображаться. Если вы его потеряете, придётся снова нажимать Reset Token и получать новый токен.

Никому не передавайте токен Discord-бота. Тот, кто получит токен, сможет управлять вашим ботом.

Шаг 6. Включите необходимые Intent-права

После получения токена прокрутите страницу Bot ниже и включите следующие параметры:

• Presence Intent
• Server Members Intent
• Message Content Intent

Включение Presence Intent, Server Members Intent и Message Content Intent

Особенно важно включить Message Content Intent, чтобы бот мог читать сообщения в Discord-канале и передавать их в игровой чат.

Шаг 7. Откройте вкладку OAuth2

После настройки бота откройте вкладку OAuth2.

Вкладка OAuth2 в настройках Discord-приложения

Шаг 8. Создайте ссылку для приглашения бота

На странице OAuth2 найдите раздел OAuth2 URL Generator.

В списке Scopes поставьте галочку:

bot

Выбор галочки bot в OAuth2 URL Generator

Шаг 9. Выберите права для бота

Прокрутите страницу ниже и выберите необходимые права для бота.

Для работы интеграции обычно нужны права на:

• просмотр каналов
• отправку сообщений
• чтение истории сообщений
• использование внешних эмодзи, если требуется
• управление сообщениями, если это нужно для вашего Discord-сервера

Выбор прав для Discord-бота

Если не уверены, какие права выбрать, минимум боту нужно разрешить видеть нужные текстовые каналы и отправлять туда сообщения.

Шаг 10. Скопируйте ссылку приглашения

После выбора прав внизу страницы появится ссылка для приглашения бота.

Скопируйте её.

Ссылка для приглашения Discord-бота на сервер

Откройте эту ссылку в новой вкладке браузера и пригласите бота на свой Discord-сервер.

Приглашение Discord-бота на Discord-сервер

Шаг 11. Создайте каналы на Discord-сервере

На своём Discord-сервере создайте три текстовых канала.

В нашем примере используются:

pzchat

pzlog

pzcommand

Создание каналов pzchat, pzlog и pzcommand на Discord-сервере

Что означает каждый канал:

• pzchat — канал для чата между игрой и Discord
• pzlog — канал для логов, входов, выходов и статуса сервера
• pzcommand — канал для команд

Шаг 12. Откройте настройки сервера Project Zomboid

Теперь перейдите в панель управления игровым сервером Project Zomboid и откройте вкладку «Настройки».

Вкладка Настройки в панели управления сервером Project Zomboid

Чтобы быстрее найти нужные параметры, нажмите:

CTRL + F

и введите:

Discord

Шаг 13. Введите токен Discord-бота и укажите канал для игрового чата

Найдите поле:

Discord - Токен доступа Discord Bot (DiscordToken)

Вставьте сюда токен, который вы получили на странице Discord Developer Portal.

Найдите поле:

Discord - Название канала с чатом вашего дискорд сервера (DiscordChatChannel)

Впишите название канала для чата.

В нашем примере:

pzchat

Этот канал будет использоваться для обмена сообщениями между Discord и игровым чатом Project Zomboid.

Поле DiscordToken в настройках сервера Project Zomboid

Шаг 14. Укажите канал для логов и укажите канал для команд

Найдите поле:

Discord - Название канала для лога вашего дискорд сервера (DiscordLogChannel)

Впишите название канала для логов.

В нашем примере:

pzlog

В этот канал будут приходить сообщения о запуске сервера, готовности к подключению, входе и выходе игроков.

Найдите поле:

Discord - Название канала для команд вашего дискорд сервера (DiscordCommandChannel)

Впишите название канала для команд.

В нашем примере:

pzcommand

Поле DiscordCommandChannel в настройках Project Zomboid

Шаг 15. Включите Discord-интеграцию

Найдите параметр:

Discord - Интеграция с вашим дискорд сервером (DiscordEnable)

Переключите его с ВЫКЛ на ВКЛ.

Включение параметра DiscordEnable

Шаг 16. Сохраните настройки

После заполнения всех Discord-полей прокрутите страницу вниз и нажмите кнопку сохранения настроек.

Кнопка сохранения настроек сервера Project Zomboid

Шаг 17. Перезапустите сервер

После сохранения настроек перезапустите игровой сервер Project Zomboid.

Если всё настроено правильно, после запуска сервера:

• бот станет онлайн в Discord
• в канале pzlog появится сообщение о подключении
• сервер отправит уведомление, когда будет готов к подключению

Например, в канале логов может появиться сообщение:

Server connected

Сообщение Server connected в канале логов Discord

Проверка работы чата

После запуска сервера проверьте работу чата.

Сообщение из игрового чата Project Zomboid должно появиться в канале:

pzchat

И наоборот, сообщение из Discord-канала pzchat должно появиться в игровом чате.

Передача сообщений между игровым чатом Project Zomboid и Discord

Поддерживаются сообщения как на латинице, так и на русском языке.

Проверка логов входа и выхода игроков

Когда игрок подключается к серверу или отключается от него, информация об этом будет отображаться в канале логов.

В нашем примере это канал:

pzlog

Сообщения о входе и выходе игроков в Discord-канале логов

Возможные проблемы

Бот не появляется онлайн

Если бот не появляется онлайн:

• проверьте, что токен Discord-бота указан правильно
• убедитесь, что бот приглашён на ваш Discord-сервер
• проверьте, что включён параметр DiscordEnable
• убедитесь, что сервер Project Zomboid был перезапущен после сохранения настроек

Сообщения из Discord не появляются в игре

Если сообщения из Discord не появляются в игровом чате:

• проверьте, что включён Message Content Intent в Discord Developer Portal
• убедитесь, что канал указан правильно
• проверьте, что бот имеет права читать сообщения и отправлять сообщения в этом канале
• убедитесь, что пишете именно в канал, указанный в DiscordChatChannel

Сообщения из игры не появляются в Discord

Если сообщения из игрового чата не появляются в Discord:

• проверьте, что игрок пишет в общий чат
• проверьте правильность названия канала в DiscordChatChannel
• убедитесь, что бот имеет доступ к этому каналу
• перезапустите сервер после изменения настроек

В канале логов ничего не появляется

Если в канале логов нет сообщений:

• проверьте значение DiscordLogChannel
• убедитесь, что бот имеет доступ к каналу логов
• проверьте токен бота
• перезапустите сервер

Важно

• Токен Discord-бота нельзя передавать посторонним.
• Если токен был случайно опубликован, его нужно сбросить через Reset Token.
• После изменения Discord-настроек сервер Project Zomboid нужно перезапустить.
• Названия каналов нужно указывать без символа #.
• Каналы должны существовать на вашем Discord-сервере.
• Бот должен быть приглашён именно на тот Discord-сервер, где находятся указанные каналы.
• У бота должны быть права видеть каналы, читать сообщения и отправлять сообщения.
• Для передачи сообщений из Discord в игру должен быть включён Message Content Intent.

Полезные ссылки

Общие

Как подключиться к серверу по FTP
Управление сервером через бота ВКонтакте
Управление сервером через бота Telegram
Управление сервером через бота Discord

Подробные

Project Zomboid: Настройка сервера
Project Zomboid: Как подключиться к своему серверу
Project Zomboid: Консольные команды
Project Zomboid: Как стать админом на сервере
Project Zomboid: Как изменить версию сервера
Хостинг серверов Project Zomboid на XLGAMES.GG