Инструкция по Votifier

Игрок голосует за ваш сервер — и получает за это награду прямо в игре. Для этого сайт должен уметь связаться с вашим сервером, а на сервере должен стоять плагин, который примет сигнал и выдаст бонус. Ниже — весь путь целиком, от скачивания до проверки.

Зачем это нужно

Голос без награды почти ничего не значит. Игрок нажал кнопку, счётчик на сайте вырос, а в игре ничего не изменилось — и в следующий раз он голосовать не станет. С настроенным Votifier голос превращается в понятную выгоду: алмазы, деньги, опыт, что угодно на ваш выбор.

Это работает и в обратную сторону. Сервер, который выдаёт награду, поднимается в голосовании, а голосование поднимает его в списке. Одно без другого не живёт.

Что понадобится

Плагин Votifier — принимает сигнал от сайта. Есть несколько версий, подойдёт любая с поддержкой первого протокола.
Плагин наград (по желанию) — выдаёт игроку бонус. Без него сигнал придёт, но награду придётся выдавать самому.
Доступ к панели хостинга — чтобы открыть отдельный порт. Это обычно самая хлопотная часть.
Права владельца сервера на нашем сайте — чтобы заполнить поля в кабинете.

Шаг 1. Скачайте плагин

Готовые плагины пишут другие люди, и у них свои правила распространения, поэтому в кнопках ниже — ссылки на страницы авторов, а не наши файлы. Там же всегда лежит свежая версия.

VotifierPlus на SpigotMC Принимает голоса. Живая версия, обновляется автором.

VotingPlugin на SpigotMC Выдаёт награды за голос. Ставить не обязательно, но с ним удобнее.

Проверьте версию игры. На каждой странице автора указано, с какими версиями работает плагин. Ставить сборку для другой версии бессмысленно: сервер её просто не загрузит.

Шаг 2. Положите файл на сервер

Скачанный .jar скопируйте в папку plugins/ в корне сервера и перезапустите сервер целиком. Именно перезапустите, а не перезагрузите плагины на ходу: при первом запуске плагин создаёт ключи, и делать это на работающем сервере не стоит.

После запуска в папке plugins/ появится папка плагина. Внутри неё — настройки и папка с ключами шифрования.

Шаг 3. Откройте порт

Votifier слушает отдельный порт, обычно 8192. Это не игровой порт, и сам по себе он закрыт.

Открывается он в панели хостинга. На большинстве хостингов это отдельный раздел вроде «Сетевые порты» или «Дополнительные порты», где нужный номер добавляют в список разрешённых.

Если не открыть порт, ничего не заработает. Со стороны сайта это выглядит как «сервер не отвечает», хотя сервер работает и игроки на нём есть. Проверить просто: если после сохранения настроек в кабинете написано, что связь не установлена, — дело почти всегда в закрытом порте.

Шаг 4. Возьмите открытый ключ

Плагин создаёт пару ключей: закрытый и открытый. Сайту нужен открытый — им он подписывает голос, а плагин проверяет подпись. Закрытый ключ не покидает сервер и никому не показывается.

Открытый ключ лежит в файле:

plugins/VotifierPlus/rsa/public.key

Откройте его любым текстовым редактором и скопируйте всё содержимое целиком, включая строки с решёткой сверху и снизу.

У разных плагинов путь отличается. У классического Votifier файл лежит в plugins/Votifier/rsa/public.key, у других версий — иначе. Ищите файл с именем public.key в папке плагина: имя одинаковое почти всегда.

Шаг 5. Заполните кабинет

Откройте в кабинете раздел «Награда за голос». Там три поля, и все три обязательны.

Сервер: Какой из ваших серверов принимает голоса. Если сервер один, он уже выбран.
Порт Votifier: Тот самый отдельный порт. По умолчанию 8192 — менять его стоит только если он у вас занят.
Открытый ключ: Содержимое файла public.key. Вставляйте как есть: строки с решёткой и рамки можно не убирать, мы разберём и так.

Нажмите «Сохранить и проверить». Мы не просто запомним настройки, а сразу попробуем достучаться до сервера и скажем результат.

Адрес берётся из карточки сервера. Отдельного поля для него нет: мы используем тот адрес, по которому сервер проверяется в рейтинге. Если в карточке указан домен, а игровой порт спрятан за прокси — связь может не установиться, и тогда в карточке стоит указать прямой адрес.

Шаг 6. Настройте награду

Если вы поставили плагин наград, откройте его настройки и опишите, что получает игрок. Команды зависят от плагина, но обычно это список вида «выдать столько-то того-то тому-то».

И проверьте, что в списке сервисов, от которых принимаются голоса, есть kubra.ru. Без этого плагин получит сигнал, но не признает его своим и награду не выдаст.

Шаг 7. Проверьте, что всё работает

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

Голос принят — счётчик на странице сервера вырос.
В кабинете, в разделе «Награда за голос», появились счётчики отправленных голосов.
В консоли сервера появилась запись о принятом голосе.
Игрок с этим ником получил награду.

Если первые два пункта выполняются, а третий и четвёртый нет — проблема на стороне сервера: закрытый порт, неверный ключ или плагин наград не признал голос.

Если не работает

«Связь не установлена» сразу после сохранения: Порт закрыт или указан неверно. Проверьте в панели хостинга, что номер открыт наружу, и что он совпадает с настройками плагина.
Связь есть, но награда не выдаётся: Голос дошёл, значит ключ и порт верны. Смотрите плагин наград: в списке сервисов должен быть kubra.ru, а в описании награды — подстановка ника игрока.
Раньше работало, теперь перестало: Чаще всего сменился адрес сервера или порт после переезда на другой хостинг. Откройте карточку сервера и проверьте адрес, затем сохраните настройки заново.
Ключ не принимается: Скорее всего, скопирована только часть файла. Откройте public.key и скопируйте его целиком, от первой строки до последней.

Коротко

Скачайте плагин по ссылке выше и положите в plugins/.
Перезапустите сервер и откройте порт 8192 в панели хостинга.
Скопируйте содержимое public.key.
В кабинете, в разделе «Награда за голос», выберите сервер, укажите порт и вставьте ключ.
Нажмите «Сохранить и проверить» и проголосуйте за себя.

Не получилось с первого раза — напишите нам, контакты на странице «Контакты». Опишите, на каком шаге застряли, и мы подскажем.