Paper · Minecraft Java

MonitorVoteReward v1.0.0

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

Как это работает
  1. Игрок голосует за ваш сервер на MonitorMC, используя свой игровой ник.

  2. На сервере он выполняет специальную команду (доступна всем игрокам по умолчанию).

  3. Плагин обращается к сайту и проверяет, есть ли неучтённый голос для этого ника.

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

Возможности

Безопасная связь
Запрос к API с заголовком Authorization: Bearer и вашим секретом; на сайте хранится только хеш.
Гибкие награды
Vault-экономика, выдача предметов (имя, лор, зачарования), временные группы LuckPerms, консольные и игрок-команды.
Удобство
Кулдаун между попытками, сообщения в конфиге, /mmc reload для администраторов.

Требования

Сервер на базе Paper

Рекомендуется актуальная ветка, сборка под вашу версию Minecraft.

Java 21

Для запуска сервера (как у toolchain сборки плагина).

Опционально

Vault и экономика, LuckPerms — если включите соответствующие награды в конфиге.

Пошаговый гайд для владельца

  1. 1

    Добавьте сервер на MonitorMC

    Карточка должна быть одобрена. ID сервера — это сегмент в адресе страницы: /server/<id>.

  2. 2

    Сгенерируйте секрет в кабинете

    Профиль → редактирование сервера → блок «Секрет для плагина награды за голос». Строка показывается один раз — сохраните её. Это значение для monitor.secret в config.yml.

  3. 3

    Установите JAR на сервер

    Положите файл в папку plugins/, перезапустите сервер (или используйте менеджер плагинов).

  4. 4

    Заполните monitor.server-id и monitor.secret

    В конфиге укажите ID карточки и секрет. Плагин обращается к API MonitorMC по HTTPS (POST /api/plugin/vote-rewards/claim).

  5. 5

    Настройте награды и объявите игрокам команду

    Отредактируйте блок rewards: (экономика Vault, предметы, LuckPerms, команды). Игрок после голосования на сайте заходит в игру и выполняет /mmc vote.

Команды

/mmc vote— проверить голос и получить награду (игрок)
/mmc reload— перезагрузить config.yml (mmc.admin)
/mmc status— Vault, LuckPerms, ключ (mmc.admin)
/mmc help— подсказка по подкомандам

Право по умолчанию: mmc.use — выдаётся всем (можно изменить в permissions.yml вашего Permission-плагина).

Фрагмент config.yml

monitor:
  server-id: "ВАШ_ID_ИЗ_URL"
  secret: "ВАШ_СЕКРЕТ_ИЗ_КАБИНЕТА"

settings:
  request-timeout-seconds: 15
  cooldown-seconds: 5

rewards:
  economy:
    enabled: true
    amount: 100.0
  items:
    - material: GOLD_INGOT
      amount: 3
      name: "&eБонус за голос"
  luckperms:
    enabled: false
    nodes: []
  console-commands: []
  player-commands: []

Секрет можно задать через переменную окружения MONITOR_VOTE_SECRET или плейсхолдер ${ENV:ИМЯ_ПЕРЕМЕННОЙ} в конфиге — см. исходники плагина.

Готовы подключить награды?

Скачайте плагин и настройте секрет в карточке сервера — это займёт несколько минут.