Votifier и награды за голоса
Как подключить Votifier, чтобы игроки получали награды за голоса на MC Monitor: настройка NuVotifier, порт, прокси, хостинг и разбор ошибок по тому, что видно в кабинете и в консоли сервера.
Редакция от
Содержание 11 разделов
Голос за сервер на MC Monitor можно превратить в награду в игре. Игрок голосует на сайте, мы отправляем голос на ваш сервер через Votifier, а плагин голосования выдаёт награду. Настройки лежат в кабинете, раздел «Votifier».
Как это работает
Голос проходит три звена:
- MC Monitor подключается к вашему серверу по TCP на порт Votifier и передаёт ник игрока и название сервиса:
mc-mon.ru. - Votifier (мы рекомендуем NuVotifier) принимает голос и передаёт его другим плагинам. Сам он ничего не выдаёт.
- Плагин голосования, например VotingPlugin или SuperbVote, получает голос и выдаёт награду: предметы, валюту или привилегии по вашим настройкам.
Название сервиса mc-mon.ru плагин голосования сверяет со своим списком площадок, поэтому оно должно совпасть с настройкой до символа.
Если Votifier не настроен, голос всё равно идёт в рейтинг сервера и в раздел «По голосам», но выдать награду некому.
Как настроить
-
Установите на сервер NuVotifier и плагин голосования. Перезапустите сервер: плагин создаёт свои файлы при первом запуске.
-
Откройте
plugins/Votifier/config.yml. Нужны три значения:host: 0.0.0.0 port: 8192 tokens: default: ваш-токенТокен плагин создаёт сам при первом запуске, его не придумывают: скопируйте готовый из файла.
host: 0.0.0.0значит «слушать на всех адресах сервера». Это адрес для плагина, а не для нас: в кабинет его не вписывают. Порт не должен совпадать с игровым портом и с портами других плагинов. -
Откройте TCP‑порт Votifier в файрволе и в панели хостинга. Как проверить, что он виден снаружи, — ниже.
-
В кабинете, в разделе «Votifier», заполните «Адрес Votifier» (публичный адрес сервера), «Порт» и «Токен или открытый ключ». Протокол выбирать не нужно: мы узнаём его по ответу сервера.
-
Впишите «Ник для проверки» — ник, которым вы будете в игре, — и нажмите «Проверить и сохранить». Мы отправим тестовый голос и сохраним настройки, только если он дошёл.
-
Добавьте площадку
mc-mon.ruв плагин награды и задайте награду (ниже).
После сохранения токен и ключ в кабинете целиком не показываются, видно только последние символы токена. Чтобы заменить значение, вставьте новое. Если правите config.yml на работающем сервере, выполните в консоли сервера /nvreload, а не /reload: перезагрузка плагинов ломает NuVotifier, помогает только полный перезапуск сервера.
Где лежат токен и ключ
Папка зависит от платформы. На Paper и Spigot плагин создаёт plugins/Votifier/, хотя называется NuVotifier.
- Paper, Spigot. Токен — в
plugins/Votifier/config.yml, разделtokens, значениеdefault. Ключ —plugins/Votifier/rsa/public.key. - BungeeCord. Токен — в
plugins/NuVotifier/config.yml, разделtokens. Ключ —plugins/NuVotifier/rsa/public.key. - Velocity. Токен — в
plugins/nuvotifier/config.toml, разделtokens. Ключ —plugins/nuvotifier/rsa/public.key. - VotifierPlus. Токен — в
plugins/VotifierPlus/config.yml, разделtokens, но по умолчанию плагин принимает только v1: для v2 включите в этом файлеTokenSupport: true. Ключ —plugins/VotifierPlus/rsa/public.key. При первом запуске VotifierPlus выбирает свободный порт сам, поэтому сверьтеport:в егоconfig.yml.
Что вставлять:
- Токен — короткая строка из
config.yml, без кавычек и пробелов по краям. Он секретный: показывайте его только площадкам, которым доверяете. - Открытый ключ — содержимое
public.keyцеликом, около 400 символов в одной строке. Рядом лежитprivate.key: его нельзя показывать никому. Если закрытый ключ попал на сторону, остановите сервер, удалите папкуrsa, запустите заново и обновите открытый ключ везде, где он указан. - Если в
tokensесть отдельная строка с названием сервисаmc-mon.ru, плагин проверяет подпись по ней, иначе поdefault. Вставляйте то значение, которое действует для нашего названия.
v1 или v2
- NuVotifier v2. Голос подписывается токеном, а сервер отвечает: принял или назвал причину отказа. Поэтому ошибки видны сразу, в том числе в кабинете. Мы предлагаем этот протокол по умолчанию.
- Votifier v1. Голос шифруется открытым ключом, ответа нет. Нужен, если на сервере стоит классический Votifier.
NuVotifier принимает оба протокола: вставьте токен — голос пойдёт по v2, вставьте открытый ключ — по v1. Токен удобнее: по v2 сервер отвечает, дошёл ли голос. Если в config.yml NuVotifier стоит disable-v1-protocol: true, ключ он не примет, вставьте токен.
У v1 есть оговорка. После голоса сервер ничего не отвечает, поэтому вместо «Доставлен» кабинет пишет «Отправлен»: мы отправили голос, и соединение не оборвалось. Расшифровал ли его сервер, видно только в консоли: при неверном ключе там строка Could not decrypt data from … Make sure the public key on the list is correct. Если вставили ключ, после проверки загляните в консоль.
Протоколы не смешиваются: токен работает только с v2, ключ только с v1.
Порт и проверка снаружи
Порт Votifier — отдельный, не игровой (по умолчанию игровой 25565, Votifier 8192). Мы подключаемся к тому адресу и порту, которые вы указали, поэтому с ними должно работать любое подключение из интернета.
Проверьте порт с другого компьютера или с телефона через мобильную сеть, не из сети сервера:
- Linux и macOS:
nc -v адрес 8192 - Windows (PowerShell):
Test-NetConnection адрес -Port 8192
Порт открыт, если подключение прошло. Живой Votifier сразу присылает строку вида VOTIFIER 2 … (NuVotifier) или VOTIFIER 1.9 (классический): nc её покажет. Если подключение прошло, а строки нет, это не порт Votifier. Если не прошло, ищите причину в файрволе, панели хостинга или пробросе порта на роутере.
Из домашней сети проверка по публичному адресу может не работать: некоторые роутеры не пускают такое подключение изнутри, и порт кажется закрытым, хотя снаружи он открыт.
Адрес можно указать именем или IP. Имя мы разрешаем в адрес при каждой отправке, поэтому динамический DNS подходит. Нужна A‑запись (или AAAA) прямо на сервер: SRV‑записи, по которым игроки находят игровой порт, Votifier не читает.
Плагин награды и название сервиса
Votifier только принимает голос. Награду выдаёт плагин голосования, и он должен знать площадку mc-mon.ru. В VotingPlugin название сервиса лежит в VoteSites.yml:
VoteSites:
MCMonitor:
ServiceSite: mc-mon.ru
Значение ServiceSite должно совпадать с названием сервиса, которое мы присылаем. Если после тестового голоса награды нет, выполните в консоли /av servicesites: команда покажет названия, под которыми приходили голоса. Награду и остальные поля площадки задайте по документации плагина.
Поле «Награда за голос» в кабинете этого не заменяет. Это текст, который игроки увидят рядом с кнопкой «Голосовать» на странице сервера. Сама награда в игре выдаётся только плагином голосования.
Две проверки, которые легко перепутать:
- строка в консоли о том, что Votifier получил голос, значит «порт, токен и ключ в порядке»;
- команда
/av vote ник площадкапроверяет только плагин награды и не доказывает, что порт открыт и токен верный.
Один голос должен попадать в плагин голосования один раз. Если на сервере два плагина, принимающих голоса (например, NuVotifier и VotifierPlus), игрок получит награду дважды.
Тестовый голос и повторы
Тестовый голос уходит по кнопке «Проверить и сохранить» на то, что вписано в форму, так же, как настоящий, но в рейтинг не попадает; настройки сохраняются, только если он дошёл. Ник должен зайти на сервер, чтобы получить награду. Если сервер сейчас выключен или порт закрыт, появится кнопка «Сохранить без проверки». Когда меняете только награду, а поле «Ник для проверки» пустое, голос не отправляется. За 10 минут можно проверить не больше шести раз, а за час — не больше двадцати по всем вашим серверам, поэтому после правки настроек сначала проверьте то, что можно проверить без нас: порт, токен, консоль.
Настоящий голос уходит на сервер сразу после голосования. Если сервер не ответил, мы повторим отправку ещё четыре раза: через 30 секунд, 2, 10 и 30 минут. На подключение и на ответ в каждой попытке даётся по пять секунд. Каждая попытка берёт текущие настройки: если вы исправили адрес, порт или токен, пока голос ещё в повторах, он дойдёт сам. Если голос так и не дошёл, это видно в кабинете, в блоке «Доставка голосов», вместе с причиной, а сам голос остаётся засчитанным в рейтинге. Голоса со статусом «Не доставлен» заново автоматически не отправляются, после исправления настроек пойдут только новые.
Сервер за BungeeCord или Velocity
Если игроки заходят через прокси, публичным Votifier становится плагин на прокси: сайт подключается к нему, а не к игровым серверам.
- Установите NuVotifier и на прокси, и на каждом игровом сервере.
- На прокси задайте свободный порт (по умолчанию 8192) и режим пересылки
pluginMessaging. - На игровых серверах поставьте режим
pluginMessagingиport: -1: они получают голоса от прокси, а не по сети. - В кабинет впишите адрес и порт прокси и токен с прокси. Токен игрового сервера и ключ из его папки
rsaздесь не подходят. - Плагин награды ставится на тех серверах, где выдаётся награда; настройки пересылки в VotingPlugin описаны в его документации.
Тестовый голос проверяет прокси. Если голос дошёл до прокси, но не до игрового сервера, ищите причину в пересылке: в канале плагин-сообщений должно быть одинаковое имя (строчными буквами, с двоеточием) на прокси и на серверах, а если никого из игроков на сервере нет, голос ждёт, пока кто‑то зайдёт.
Хостинг без своего порта и домашний сервер
Пока порт Votifier недоступен снаружи, голоса не дойдут. Так бывает чаще всего у хостингов, которые открывают только игровой порт.
- Хостинг с панелью. Найдите в панели раздел с дополнительными портами или сетью (название у каждого хостинга своё; в Pterodactyl порты называются allocations, их добавляет хостер или администратор панели) и добавьте второй порт. В
config.ymlVotifier впишите тот же номер, в кабинет тоже. Порт должен быть из выданных: на невыданном порту плагин запустится, но снаружи его не будет видно, и мы получим таймаут. Если нужного раздела нет, напишите в поддержку: «Нужен второй TCP‑порт для плагина Votifier». - Адрес хостинга. Игровой адрес на таких хостингах часто работает через SRV‑запись. Votifier нужен адрес, на который указывает A‑запись, и свой порт: спросите их у поддержки или посмотрите в панели.
- Хостинг не выдаёт дополнительные порты. Тогда Votifier не подключить: голоса идут в рейтинг, а награды игроки не получат. Выбор — другой тариф или другой хостинг.
- Домашний сервер. Пробросьте TCP‑порт Votifier на роутере на компьютер с сервером, разрешите его в файрволе системы и задайте компьютеру постоянный адрес в локальной сети. Если провайдер выдаёт один общий адрес на многих абонентов, пробросить порт не выйдет: спросите у провайдера отдельный белый IP.
- Домен за CDN. Адрес, который идёт через прокси CDN (например, оранжевое облако Cloudflare), до сервера Votifier не донесёт: нужна запись, которая указывает прямо на сервер.
Ошибки в кабинете
Кабинет показывает причину простыми словами и в журнале попыток, и после тестового голоса. Ниже заголовки повторяют слова кабинета, а под ними — что за каждой причиной стоит и что делать.
Не удалось найти адрес сервера
В DNS нет A- или AAAA-записи для этого имени: опечатка, запись ещё не появилась или адрес работает только через SRV. Укажите имя с A‑записью или IP‑адрес.
Этот адрес нам недоступен
Кабинет пишет, что адрес ведёт во внутреннюю сеть. Это адрес из частных диапазонов (10.…, 172.16.…, 192.168.…), 127.0.0.1, 100.64.… или 0.0.0.0: во внутреннюю сеть мы не подключаемся. Укажите публичный адрес сервера.
Соединение отклонено
Адрес отвечает, но на этом порту никто не слушает. Проверьте:
- в журнале запуска есть строка о том, что Votifier включён; если там ошибка о занятом порте, выберите другой;
- порт в
config.ymlсовпадает с тем, что в кабинете; host: 0.0.0.0вconfig.yml;- сервер перезапущен после правки.
Сервер не ответил вовремя
Причин две.
- Пакеты молча отбрасываются: порт закрыт в файрволе, не выделен в панели хостинга или не проброшен на роутере. Другой вариант — адрес ведёт не на игровой сервер (на сайт, панель или CDN). Пройдите проверку порта.
- Порт открыт, подключение проходит, но отвечает не Votifier: он молчит и ждёт данных. Так ведёт себя игровой порт. Сверьте номер в кабинете с
port:вconfig.ymlи убедитесь, что порт Votifier и игровой порт разные.
Не удалось подключиться
Соединение не установилось по другой причине, например нет маршрута до адреса. Проверьте адрес и порт, потом пройдите те же шаги, что при «Сервер не ответил вовремя».
Сервер принял соединение, но не прислал приветствие Votifier
Порт принял соединение и сразу его закрыл, ничего не сказав. Чаще всего это защита от DDoS или файрвол хостинга, который пропускает соединение и обрывает его, либо перед портом стоит прокси, который не пропускает соединение дальше. Проверьте, что в журнале запуска есть строка о том, что Votifier включён, и повторите проверку через минуту. Если защита вмешивается, спросите у хостинга, как её обойти для порта Votifier.
На этом порту не Votifier
На порту стоит другая служба, которая присылает свою строку (SSH, почтовый сервер), или Votifier сменил протокол после сохранения. Сверьте номер с port: в config.yml и нажмите «Проверить и сохранить» ещё раз: протокол определится заново. Если это VotifierPlus и вы вставили токен, включите в его config.yml TokenSupport: true.
Открытый ключ не подходит
Мы не смогли прочитать вставленный ключ. Возможные причины: вместо ключа вставлен токен, закрытый ключ (private.key), текст обрезан или с лишними символами. Вставьте содержимое public.key целиком. Если вы вставили закрытый ключ, замените пару ключей, как описано выше.
Сервер отклонил подпись: токен неверный
В консоли сервера при этом пишется Signature is not valid (invalid token?). Скопируйте токен из config.yml заново без кавычек и пробелов, выполните /nvreload. Токен меняется, если файл настроек пересоздали: после переустановки плагина или удаления config.yml значение новое. На сервере за прокси нужен токен прокси.
Сервер принял подпись, но отклонил голос
Соединение и подпись в порядке, но NuVotifier ответил отказом по другой причине. Точную причину пишет консоль сервера в момент голоса. Самые частые две:
Unknown service 'mc-mon.ru': вtokensнет ниdefault, ни строки с названием сервисаmc-mon.ru. Добавьтеdefaultили строку с этим названием и выполните/nvreload.Username too long: ник длиннее 16 символов, плагин такие голоса не принимает.
Соединение оборвалось до отправки голоса
Соединение закрылось, пока мы отправляли голос. Обычно виноват файрвол или защита от DDoS на стороне сервера, иногда перезапуск плагина в этот момент. Повторите проверку. Если ошибка не уходит, посмотрите консоль на строку Connection reset и временно отключите файрвол для проверки.
Голос отправлен, но сервер закрыл соединение, не ответив
Выбран v2: голос ушёл, но NuVotifier закрыл соединение, не прислав ответ. Принят ли голос, по ответу неизвестно, посмотрите консоль сервера в момент проверки. Чаще всего соединение обрывает файрвол или защита от DDoS уже после отправки, либо плагин перезапускался. Настоящий голос мы отправим снова по обычному расписанию, поэтому в консоли он может появиться дважды.
Тест прошёл, а награды нет
Тестовый голос прошёл (у v1 — отправлен), а игрок ничего не получил. Это почти всегда настройки плагина награды, а не Votifier.
В консоли есть голос, но плагина награды нет
Votifier только принимает голос. Установите VotingPlugin или SuperbVote и настройте награду.
Плагин получил голос, но «не знает площадку»
Название сервиса в плагине не совпало с mc-mon.ru. Выполните /av servicesites, найдите присланное название и впишите его в ServiceSite, как показано выше.
Ник не тот
Награду получает игрок с тем ником, который указан в голосе. Проверьте регистр и что этот игрок заходил на сервер. Если игрока нет в сети, награда выдаётся по настройкам плагина: сразу или при следующем входе.
Награда пришла дважды
Голос принимают два плагина или две пересылки. Оставьте один.
Отправлен по v1, а в консоли Could not decrypt data from
Открытый ключ в кабинете не от этого сервера: например, после переустановки плагина создана новая пара ключей. Вставьте актуальный public.key.
В консоли тихо, а кабинет пишет «Отправлен»
Так бывает при v1: сервер ничего не отвечает, и мы знаем только, что голос отправлен. Возможно, порт Votifier ведёт на другую машину или на прокси, а не на игровой сервер. Посмотрите консоль той машины, на которую указывает адрес. Если хотите видеть ответ сервера, перейдите на NuVotifier v2.
Раньше работало, теперь голоса не идут
Изменился порт или адрес (хостинг выдал новый), плагин после обновления не включился, порт занял другой плагин, сменился токен. Откройте блок «Доставка голосов» в кабинете: там видна причина последних попыток.
Если ошибка не исчезает, напишите нам: контакты — на странице Контакты.