Как подключить NuVotifier и настроить награды за голосование
· Администрация MinecraftRating
NuVotifier: голос с мониторинга и награда игроку
NuVotifier принимает событие голосования, а отдельный обработчик, например VotingPlugin, выдаёт награду. Один установленный NuVotifier сам по себе не создаёт алмазы, валюту или права. Ниже — схема, которую мы проверили на собственном Paper: запрос с MinecraftRating → NuVotifier → VotingPlugin → выполнение команды награды.
Официальные ссылки
- NuVotifier: исходный код и официальные релизы.
- Инструкция установки NuVotifier.
- VotingPlugin: проект автора и описание наград.
- Paper: установка и Java.
Выбирайте совместимые стабильные версии из официальных источников. Наша проверка использовала Paper 1.21.11, NuVotifier 2.7.3 и закреплённую CI-сборку VotingPlugin; это описание теста, а не рекомендация ставить development-сборки на рабочий проект.
1. Установите плагины
Остановите Minecraft-сервер, положите JAR NuVotifier и VotingPlugin в папку plugins, затем запустите сервер. Убедитесь по журналу и команде plugins, что оба модуля включены. Требования к Java зависят от версии Paper; ориентируйтесь на его официальную документацию. Первоначальный запуск создаст конфигурацию и RSA-ключи NuVotifier.
2. Настройте приём голоса
В plugins/Votifier/config.yml задайте свободный TCP-порт, например:
host: 0.0.0.0
port: 8192
disable-v1-protocol: false
forwarding:
method: none
Этот пример — для одного самостоятельного сервера. Прокси-сеть требует отдельной настройки forwarding по документации NuVotifier. MinecraftRating сейчас отправляет протокол v1, поэтому его приём должен быть разрешён. Откройте именно выбранный TCP-порт в firewall и панели хостинга. По возможности ограничьте входящие подключения адресами мониторинга; не путайте этот порт с игровым портом Minecraft и не открывайте ради этого RCON.
3. Привяжите интеграцию в MinecraftRating
Войдите на сайт, откройте «Мои серверы» и подтвердите владение проектом через MOTD. Затем в интеграциях своего сервера откройте Votifier. Укажите публичный адрес, порт приёма и содержимое plugins/Votifier/rsa/public.key, включите интеграцию и сохраните.
Загружать нужно public.key. Файл private.key остаётся только на игровом сервере. Адрес 127.0.0.1, внутренние сети и порт, недоступный мониторингу, для внешней доставки не подходят. После изменения конфигурации перезапустите сервер; не используйте общий Bukkit /reload для обновления всех плагинов.
4. Назначьте награду
VotingPlugin сопоставляет событие с ServiceSite. Для нашего мониторинга оно должно быть MinecraftRating.com. Пример раздела VoteSites.yml:
VoteSites:
MinecraftRating:
Enabled: true
Name: 'MinecraftRating'
ServiceSite: 'MinecraftRating.com'
VoteURL: 'https://minecraftrating.com/ru/'
VoteDelay: 24h
WaitUntilVoteDelay: false
DisplayItem:
Material: DIAMOND
Amount: 1
Rewards:
Commands:
- 'give %player% minecraft:diamond 1'
Команда — пример для обычного онлайн-игрока. Замените её на проверенную команду вашего плагина экономики или прав, если нужна другая награда. Не вставляйте произвольные команды из сообщений игроков. Ограничение голосов применяет сайт: один голос за сервер в сутки по Москве; голос учитывается в рейтинге два календарных месяца. Не включайте конфликтующую дополнительную задержку плагина без проверки календарных правил.
Для офлайн-игрока обычный give не подходит: настройте очередь награды до входа по документации VotingPlugin. Опция ForceOffline разрешает выполнение команды без присутствия игрока, но сама команда тоже должна поддерживать такую работу. Для нашей технической проверки использовался scoreboard, а не инвентарь игрока:
scoreboard objectives add mcr_votes dummy
scoreboard players get TEST_NICK mcr_votes
В изолированном тесте наградой была команда scoreboard players add %player% mcr_votes 1 с разрешённым офлайн-выполнением. Не переносите настройки тестовых UUID на свой лицензированный сервер: режим UUID VotingPlugin должен соответствовать вашему проекту.
5. Проверьте полный путь
Сначала отправьте тест из интеграций своего сервера. Затем проверьте обычный голос с сайта: игрок вводит свой игровой ник, сайт принимает голос и ставит запрос награды в очередь. Сравните журнал NuVotifier, обработку VotingPlugin и фактический результат команды. Повторный запрос одного голоса не должен давать второй подарок.
Статус SENT в протоколе v1 подтверждает отправку пакета. Он не подтверждает расшифровку, выполнение команды или появление предмета в инвентаре. На собственном стенде мы отдельно проверили результат scoreboard и сохранение после перезапуска.
FAQ
Нужен работающий обработчик награды, совпадающий ServiceSite, правильный ник и исполнимая команда. Проверьте, может ли команда работать, когда игрок офлайн, и не отклоняет ли его VotingPlugin как ранее не заходившего. Локальная команда теста плагина проверяет обработчик, но не заменяет отправку с мониторинга через сеть.
В нашем отрицательном тесте корректный по формату, но чужой публичный ключ позволял отправить пакет; NuVotifier не мог правильно его обработать, и scoreboard не менялся. Сверьте ключ с текущим public.key именно этого экземпляра. Не считайте транспортный статус доказательством награды.
Мониторинг не смог установить соединение. Проверьте адрес, выбранный порт, проброс Docker/хостинга и firewall. На нашем тесте закрытый порт дал стадию TCP и повторную попытку; восстановление правильного адреса вернуло выдачу награды. Не запускайте неограниченные повторы: проверьте историю доставки.
Нет. На нашем контейнере SQLite не смог загрузить native-библиотеку из /tmp, смонтированного с noexec. Мы создали отдельный writable-каталог native-файлов внутри данных стенда и передали JVM -Djava.io.tmpdir=/data/cache/native; для JNA и Netty также использовались их параметры каталога загрузки. Путь зависит от вашей установки. Не отключайте защиту системного /tmp целиком ради плагина; убедитесь, что каталог доступен пользователю Java.
В текущей интеграции MinecraftRating нужен v1. Если v1 отключён, наш пакет принят не будет. Поддержка v2 — отдельная доработка, её нельзя включить одной галочкой на сайте.