Добавить сервер
← Все записи
8 мин чтения

Как настроить NuVotifier для наград за голоса в Minecraft (гайд 2026)

Обложка гайда по NuVotifier: игрок Minecraft нажимает «Голосовать» на мониторинге серверов, голос уходит на сервер с NuVotifier и в плагин наград VotingPlugin и превращается в сундук с алмазами, монетами и ключами — четыре шага: игрок голосует, мониторинг отправляет подписанный голос, плагин выполняет ваши команды, игрок получает награду.

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

В этом гайде — вся настройка NuVotifier, поддерживаемой версии Votifier: от установки плагина до проверки первого голоса, и что делать, если голос не доходит.


Как работают награды за голоса

Связаться между собой должны три части:

  1. Игрок голосует за ваш сервер на мониторинге — например, на вашей странице в McRank.
  2. Мониторинг подключается к NuVotifier на вашем сервере и отправляет подписанный голос: ник игрока, название мониторинга и время.
  3. Плагин наград (VotingPlugin, SuperbVote и другие) получает этот голос и выполняет ваши команды-награды.

Сам NuVotifier награды не выдаёт. Он только принимает голоса и передаёт их другим плагинам. Нужны оба.


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

  • Сервер на Paper, Spigot или Purpur либо сеть на BungeeCord / Velocity. Есть и сборка NuVotifier для Sponge.
  • Доступ к файлам и консоли сервера.
  • Один свободный TCP-порт, доступный из интернета. По умолчанию NuVotifier использует 8192. На хостинге обычно нужно запросить или добавить дополнительный порт (часто это называется «allocation» или «аллокация») в панели управления.

Шаг 1: Установите NuVotifier

  1. Скачайте nuvotifier.jar из последнего релиза NuVotifier на GitHub. Один и тот же jar работает на Paper/Spigot, BungeeCord и Velocity.
  2. Положите jar в папку plugins.
  3. Перезапустите сервер (не через /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

Что означает каждая настройка:

НастройкаЧто указать
host0.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

  1. Откройте Мои серверы и выберите сервер. Его ещё нет в каталоге? Сначала добавьте.
  2. Найдите карточку Уведомления Votifier.
  3. Отметьте Отправлять уведомление Votifier при каждом голосе.
  4. Заполните поля:
    • Хост Votifier — публичный IP или домен сервера (машины, где работает NuVotifier, а не домен за прокси Cloudflare).
    • Порт Votifier — значение port из config.yml.
    • Токен — токен mcrank или default, если отдельный не добавляли.
  5. Нажмите Сохранить настройки 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.