Как настроить NuVotifier для наград за голоса в Minecraft (гайд 2026)
Голоса на мониторингах поднимают ваш сервер в рейтинге, но игроки голосуют регулярно, только если что-то за это получают. Votifier — то, что это связывает: когда кто-то голосует за ваш сервер на мониторинге, мониторинг отправляет серверу сообщение, а плагин наград превращает его в алмазы, ключи или игровую валюту.
В этом гайде — вся настройка NuVotifier, поддерживаемой версии Votifier: от установки плагина до проверки первого голоса, и что делать, если голос не доходит.
Как работают награды за голоса
Связаться между собой должны три части:
- Игрок голосует за ваш сервер на мониторинге — например, на вашей странице в McRank.
- Мониторинг подключается к NuVotifier на вашем сервере и отправляет подписанный голос: ник игрока, название мониторинга и время.
- Плагин наград (VotingPlugin, SuperbVote и другие) получает этот голос и выполняет ваши команды-награды.
Сам NuVotifier награды не выдаёт. Он только принимает голоса и передаёт их другим плагинам. Нужны оба.
Что понадобится
- Сервер на Paper, Spigot или Purpur либо сеть на BungeeCord / Velocity. Есть и сборка NuVotifier для Sponge.
- Доступ к файлам и консоли сервера.
- Один свободный TCP-порт, доступный из интернета. По умолчанию NuVotifier использует
8192. На хостинге обычно нужно запросить или добавить дополнительный порт (часто это называется «allocation» или «аллокация») в панели управления.
Шаг 1: Установите NuVotifier
- Скачайте
nuvotifier.jarиз последнего релиза NuVotifier на GitHub. Один и тот же jar работает на Paper/Spigot, BungeeCord и Velocity. - Положите jar в папку
plugins. - Перезапустите сервер (не через
/reload).
При первом запуске NuVotifier создаёт plugins/NuVotifier/config.yml. На Velocity вместо него создаётся config.toml с теми же настройками в синтаксисе TOML (port = 8192, секция [tokens] и так далее).
У вас сеть серверов? Установите NuVotifier на прокси и на каждый бэкенд-сервер, где нужны награды. Как их связать — в шаге 5.
Шаг 2: Настройте config.yml
Свежий конфиг выглядит так:
host: 0.0.0.0
port: 8192
disable-v1-protocol: false
tokens:
default: 3f9a1c7e2b...
forwarding:
method: none Что означает каждая настройка:
| Настройка | Что указать |
|---|---|
host | 0.0.0.0 — слушать на всех сетевых интерфейсах. Не меняйте, если хостинг не требует иного. |
port | Порт, на который приходят голоса. 8192 или свободный порт, который выдал хостинг. Только не игровой порт. |
disable-v1-protocol | Оставьте false, если не пользуетесь только мониторингами с v2 (см. v1 и v2). |
tokens | Секретные ключи, которые доказывают, что голос действительно пришёл от мониторинга. Никому их не показывайте. |
Токены
NuVotifier выбирает токен по названию мониторинга, который прислал голос (его serviceName). Если у мониторинга нет своего токена, используется default.
Можно просто указать в McRank токен default. Аккуратнее — отдельный токен для каждого мониторинга: тогда один можно сменить, не ломая остальные:
tokens:
default: 3f9a1c7e2b...
mcrank: любая-длинная-случайная-строка McRank отправляет голоса с названием сервиса mcrank, поэтому NuVotifier будет проверять их токеном mcrank.
После правки файла перезапустите сервер.
Шаг 3: Откройте порт
Мониторинг должен достучаться до NuVotifier из интернета. Если не сможет, голос просто потеряется.
- Панель хостинга (Pterodactyl и похожие): добавьте второй порт (аллокацию) и укажите его номер в
port. - VPS или выделенный сервер: разрешите порт в файрволе, например
sudo ufw allow 8192/tcp. - Домашний сервер: пробросьте порт на роутере на компьютер, где запущен Minecraft.
- Cloudflare: если домен проксируется через Cloudflare (оранжевое облако), трафик Votifier через него не пройдёт. Используйте DNS-запись без проксирования (серое облако) или IP-адрес сервера в качестве хоста Votifier.
Шаг 4: Подключите сервер в McRank
- Откройте Мои серверы и выберите сервер. Его ещё нет в каталоге? Сначала добавьте.
- Найдите карточку Уведомления Votifier.
- Отметьте Отправлять уведомление Votifier при каждом голосе.
- Заполните поля:
- Хост Votifier — публичный IP или домен сервера (машины, где работает NuVotifier, а не домен за прокси Cloudflare).
- Порт Votifier — значение
portизconfig.yml. - Токен — токен
mcrankилиdefault, если отдельный не добавляли.
- Нажмите Сохранить настройки Votifier.
Сразу проверьте: в разделе Проверка настройки под формой введите свой ник в Minecraft и нажмите Отправить тестовый голос. McRank отправит один настоящий голос на сохранённые настройки и точно скажет, что произошло. Тестовый голос не учитывается в рейтинге; можно отправить до 5 проверок за 10 минут.
Если всё работает, в консоли сервера появится строка о голосе от вашего ника. Если нет — переходите к разделу «Решение проблем».
Шаг 5: Сети на BungeeCord и Velocity
В сети мониторинг должен обращаться к прокси — только у него есть публичный адрес. Прокси затем передаёт каждый голос на бэкенд-серверы.
NuVotifier умеет делать это двумя способами. Для одного прокси используйте plugin messaging.
На прокси (config.yml или config.toml на Velocity):
port: 8192
tokens:
default: 3f9a1c7e2b...
forwarding:
method: pluginMessaging На каждом бэкенд-сервере:
port: -1
forwarding:
method: pluginMessaging port: -1 отключает публичный приём голосов на бэкенде: голоса приходят только через прокси.
В McRank указывайте адрес, порт и токен прокси.
Второй способ, proxy, заставляет прокси пересылать каждый голос по сети в NuVotifier каждого бэкенда. Он нужен для сложных сетей; подробности — в руководстве по настройке NuVotifier (на английском).
Какой бы способ вы ни выбрали, убедитесь, что бэкенд-серверы принимают подключения только от прокси. Иначе игроки смогут зайти на бэкенд напрямую в обход проверок прокси.
Шаг 6: Выдавайте награды через VotingPlugin
NuVotifier принимает голос, а плагин наград решает, что получит игрок. Самый популярный вариант — VotingPlugin. Установите его на сервер, где игроки должны получать награды (в сети — на бэкенды), и добавьте McRank в plugins/VotingPlugin/VoteSites.yml:
VoteSites:
McRank:
Enabled: true
Name: 'McRank'
ServiceSite: 'mcrank'
VoteURL: 'https://mcrank.net/ru/your-server-slug'
VoteDelay: 24h
Rewards:
Commands:
- 'eco give %player% 500'
- 'crate key give %player% vote 1'
Messages:
Player: '&aСпасибо за голос на McRank!' ServiceSiteдолжен быть ровноmcrank— это название McRank передаёт с каждым голосом. Если не совпадает, VotingPlugin проигнорирует голос.VoteURL— страница, которую игроки открывают для голосования. Укажите страницу вашего сервера на McRank; её адрес виден в браузере.VoteDelay: 24hсовпадает с McRank: каждый игрок может голосовать раз в 24 часа.Commands— любые консольные команды. Замените их командами вашего плагина экономики, кейсов или рангов.
После правки выполните /av reload.
Нужно что-то попроще? SuperbVote и похожие плагины тоже принимают голоса от NuVotifier и выполняют команды. С McRank работает любой плагин с поддержкой NuVotifier.
Сделайте голосование выгодным
Лучше всего работают полезные, но не ломающие баланс награды: немного денег, ключ от кейса, временный бонус. Напоминайте игрокам командой /vote и периодическими объявлениями. Больше голосов — выше место в рейтинге, а значит, новые игроки: читайте, как привлечь больше игроков (на английском).
Решение проблем
Начните с кнопки Отправить тестовый голос в McRank — её сообщение подскажет, какая часть сломана.
«Votifier не ответил»
McRank не получил ответа от NuVotifier по вашему хосту и порту.
- NuVotifier запущен? После старта в консоли должна быть строка о том, что он слушает ваш порт.
- Порт открыт у хостинга и в файрволе? См. шаг 3.
- Вы указали порт Votifier, а не игровой (
25565)? Игровой порт принимает подключение, но не отвечает как Votifier, поэтому проверка завершается по таймауту. - Хост — домен за прокси Cloudflare? Укажите IP или DNS-запись без проксирования.
«Что-то ответило, но это не NuVotifier v2»
На этом порту работает программа, но это не NuVotifier — или это старый классический Votifier, который понимает только протокол v1. McRank нужен протокол v2 от NuVotifier. Замените jar старого Votifier на NuVotifier — плагин наград продолжит работать.
«Votifier отклонил голос»
NuVotifier получил голос, но подпись не совпала. В McRank указан не тот токен, которым проверял NuVotifier:
- Скопируйте токен из
config.ymlзаново — без пробелов и кавычек. - Если вы добавили токен
mcrank, в McRank нужен именно он, а неdefault. - Перезапустите сервер после правки
config.yml.
Тестовый голос доходит, но награду никто не получает
NuVotifier работает, а плагин наград не подхватывает голос.
- Проверьте, что
ServiceSiteровноmcrank. - В сети убедитесь, что голос доходит до бэкенда:
forwarding.methodдолжен бытьpluginMessagingи на прокси, и на бэкенде. - Выполните команду награды вручную в консоли, подставив реальный ник вместо
%player%. - Запустите встроенную проверку NuVotifier в консоли, чтобы проверить награды без мониторинга:
/testvoteна сервере,/ptestvoteна прокси.
v1 и v2: почему важен протокол
У Votifier есть два способа передать голос:
- v1 — исходный протокол на паре RSA-ключей (файл
public.key). - v2 — более новый протокол NuVotifier: каждый голос подписан общим токеном и содержит одноразовый код (challenge) от вашего сервера, поэтому перехваченный голос нельзя отправить повторно.
McRank отправляет голоса только по v2. NuVotifier понимает оба протокола, так что достаточно установить его. Оставьте disable-v1-protocol: false, если другие ваши мониторинги ещё шлют голоса по v1.
Частые вопросы
Порт NuVotifier должен быть открыт всё время? Да. Мониторинг подключается в момент голосования. Если порт в этот момент закрыт, награда за этот голос потеряется.
Можно использовать один токен для всех мониторингов? Да, для этого и нужен default. Отдельные токены просто проще заменить, если один утечёт.
Тестовый голос влияет на рейтинг? Нет. Он нигде не сохраняется, не считается голосом и не отправляет уведомления в Discord. Он только проверяет настройку.
Игроки могут голосовать чаще раза в день? В McRank каждый игрок может голосовать за сервер раз в 24 часа. Поставьте VoteDelay: 24h, чтобы /vote показывал правильное время.
Это работает на Bedrock-серверах? Да, если сервер работает на платформе, которую поддерживает NuVotifier: например, Paper с Geyser или сеть за прокси BungeeCord или Velocity.
Настройка Votifier занимает минут десять и окупается долго: каждый голос поднимает сервер в рейтинге и даёт игрокам повод вернуться завтра. Если сервер ещё только собираетесь запускать, начните с гайда как создать сервер Minecraft, а потом добавьте его в McRank.