Это пошаговый гайд по установке плагина Millida Services — одного плагина сразу для донат-магазина (Trade) и рейтинга сервера (Rating). За 5 минут ты доведёшь сервер от «скачал .jar» до зелёного индикатора «онлайн» и начнёшь принимать покупки и награждать игроков за голоса.
Плагин работает на Paper / Spigot / Folia, прокси BungeeCord / Velocity и модах Fabric / Forge / NeoForge. Никаких прав root и открытых портов не нужно — соединение всегда исходящее.
Не делись токеном сервера ни с кем. Это пароль, который позволяет выдавать товары на твоём сервере. Если токен утёк — сгенерируй новый в админке (см. FAQ ниже).
Какую версию выбрать
Есть две основные сборки. Если сомневаешься и у тебя обычный сервер — бери Modern (Paper / Spigot / Folia).
- Modern: Minecraft 1.13 – 1.21+, Java 17+, софт Paper / Spigot / Folia, опционально PlaceholderAPI.
- Legacy: Minecraft 1.8.8 – 1.12.2, Java 8+, софт Spigot / Bukkit, SSL-сертификаты вшиты прямо в JAR.
На Folia работает modern-версия: плагин сам определит Folia и переключится на регионализованный планировщик. Внешние зависимости (LuckPerms / Vault / EssentialsX) не требуются — плагин выдаёт команды от лица консоли.
Прокси и моды. Для BungeeCord / Velocity и для Fabric / Forge / NeoForge есть отдельные сборки. Bukkit-сборка и прокси работают на всех версиях Minecraft одним файлом; сборки модов идут под конкретные версии Minecraft (1.20.1, 1.21.1).
Шаг 1. Скачай сборку под свою платформу
Выбери файл под свой сервер. Если сомневаешься и у тебя обычный сервер — бери Paper / Spigot / Folia. Моды собираются под конкретную версию Minecraft, так что бери файл со своей версией. Нужна другая версия MC — напиши в поддержку, добавим в сборку.
- MillidaServices-Paper.jar — Paper / Spigot / Folia (1.13+)
- MillidaServices-BungeeCord.jar — BungeeCord (прокси)
- MillidaServices-Velocity.jar — Velocity (прокси)
- MillidaServices-Fabric-1.21.1.jar — Fabric · 1.21.1
- MillidaServices-Fabric-1.20.1.jar — Fabric · 1.20.1
- MillidaServices-Forge-1.21.1.jar — Forge · 1.21.1
- MillidaServices-Forge-1.20.1.jar — Forge · 1.20.1
- MillidaServices-NeoForge-1.21.1.jar — NeoForge · 1.21.1
- MillidaTrade-legacy.jar — Legacy · Spigot 1.8 – 1.12
Шаг 2. Положи JAR в plugins/
Скопируй файл в папку plugins/ своего сервера — через FTP, SFTP или панель хостинга. На модах файл кладётся в папку mods/.
- Пример пути на хостинге: /home/minecraft/server/plugins/MillidaServices-Paper.jar
- На модах: /home/minecraft/server/mods/MillidaServices-Fabric-1.21.1.jar
Шаг 3. Перезапусти сервер
Полный рестарт нужен один раз, чтобы плагин создал файл plugins/MillidaServices/config.yml. Дальше изменения применяются командой /ms reload без перезапуска. В консоли сервера выполни stop, затем запусти заново (например, ./start.sh).
Шаг 4. Возьми токен в админке
Открой Админка → Магазин → раздел «Серверы» → твой сервер → кнопка «Скопировать токен». Токен выглядит как mt_XXXXXXXXXXXXXXXX. Если сервера ещё нет — нажми «+ Добавить сервер», укажи название (например, «Анархия #3»), и токен сгенерируется автоматически.
Токен сервера показывается один раз — копируй сразу.
Шаг 5. Вставь токен в config.yml
Открой plugins/MillidaServices/config.yml (на модах — config/millidaservices/config.json) и впиши токен в поле server-token. Это единственное обязательное поле — остальное опционально. Адрес API подставляется автоматически, указывать его не нужно.
- server-token: "mt_XXXXXXXXXXXXXXXXXXXXXXXX" — токен сервера (обязательно)
- server-name: "Анархия #3" — имя сервера
- mode-name: "Анархия" — режим
- services.trade.enabled: true — автодонат
- services.rating.enabled: true — награды за голоса
- logging.show-errors: true — выводить ошибки плагина в консоль
- error-reporting.enabled: true — обезличенные отчёты об ошибках в Millida
Шаг 6. Перезагрузи конфиг и проверь статус
В консоли сервера или из игры (с правами оператора) выполни команду /ms reload. В админке во вкладке «Серверы» статус сервера сменится на «● Онлайн» в течение 30 секунд. Готово — можно принимать покупки. Если не загорелось зелёным, загляни в раздел «Что-то не работает» ниже.
Команды плагина
Основная команда — /ms. Алиасы: /millida, /mt, /millidatrade. Админ-команды требуют права millidaservices.admin (по умолчанию оно у операторов); команда /ms top доступна всем игрокам.
- /ms top — топ голосующих сервера, доступна всем игрокам.
- /ms status — версия, server ID, очередь событий, последний flush, активные сервисы. Ничего не меняет.
- /ms reload — перечитать конфиг и заново сделать handshake. После смены токена или настроек.
- /ms test — ping на api.millida.trade, проверка сети/файрвола без перезагрузки.
- /ms update — проверить и скачать обновление плагина (если включено на бэкенде).
Рейтинг: награды за голоса
Игрок голосует за твой сервер на сайте Millida (там же защита от накрутки: Discord, Cloudflare, история игры). Плагин узнаёт о засчитанном голосе и выдаёт награды локально — командами, которые ты настраиваешь сам в config.yml. Можно давать бонус за каждый голос и отдельные бонусы за стрик (голоса несколько дней подряд).
- rating.vote-rewards — команды за КАЖДЫЙ голос, поддерживают плейсхолдеры {player}, {streak}, {server}. Пример: "eco give {player} 100" и "crate give {player} vote 1".
- rating.streak-milestones: [7, 30] — на каких днях стрика срабатывают бонусы.
- rating.streak-rewards — команды за стрик: на 7 дней, например, "crate give {player} weekly 1"; на 30 дней — "lp user {player} parent addtemp vip 30d".
- rating.top.size: 10 — сколько мест показывать в /ms top и плейсхолдерах.
- rating.messages.vote — сообщение при голосе, например: "&8[&dRating&8] &f{player} проголосовал — спасибо!"
Топ голосующих и голограммы
Команда /ms top показывает топ. Для голограмм используй плейсхолдеры (их рендерят DecentHolograms / HolographicDisplays) — нужен установленный PlaceholderAPI.
- %millida_rating_top_1_name% — ник игрока на 1-м месте (и _2_, _3_ … до top.size).
- %millida_rating_top_1_votes% — голоса игрока на 1-м месте.
- %millida_rating_votes% — голоса текущего игрока.
- %millida_rating_streak% — стрик игрока (дней подряд).
- %millida_rating_position% — позиция игрока в топе.
API для разработчиков
Другие плагины могут расширять Millida Services. На Bukkit/Paper — через ServicesManager и события. Стабильная точка интеграции — пакет ru.millida.services.core.api.
- Получить API: MillidaServicesApi api = getServer().getServicesManager().load(MillidaServicesApi.class);
- api.serverId() — ID сервера.
- api.ratingTop(10) — топ голосующих.
- api.ratingPlayer("Steve") — голоса, стрик и позиция игрока.
- Событие MillidaVoteRewardEvent (через @EventHandler) — реакция на награду за голос, у e.getInfo() доступны nickname() и streak().
- На любой платформе доступна подписка api.onVoteReward(listener).
Прокси-сервер
Если у тебя BungeeCord или Velocity и фронт-сервер раздаёт игроков по бэк-нодам — плагин ставится на каждый бэк-сервер, который принимает покупки. На самом прокси-сервере плагин не нужен.
BungeeCord / Waterfall
В spigot.yml бэк-сервера убедись, что включена опция settings.bungeecord: true. Плагин автоматически прочитает hostname из BungeeCord handshake — никаких дополнительных настроек.
Velocity (только modern)
В paper-global.yml на бэк-сервере должна быть включена секция proxies.velocity: enabled: true, online-mode: true и secret: 'твой-velocity-secret'. Secret должен совпадать со значением в velocity.toml на прокси. На legacy-версии (1.8 – 1.12) Velocity не поддерживается — только BungeeCord.
Что-то не работает
Пройдись по чек-листу сверху вниз. В 90% случаев это одна из четырёх причин.
1. Сервер не появляется онлайн в админке
Проверь по порядку токен, файрвол, версию Minecraft/Java и загрузку плагина.
- Токен — скопирован полностью, без пробелов, начинается с mt_. После правки выполни /mt reload.
- Файрвол — сервер должен иметь исходящий доступ к api.millida.trade по порту 443 (HTTPS). Проверка: /mt test — должно вернуть «API отвечает».
- Версия Minecraft / Java — modern требует MC 1.13+ и Java 17+. Если у тебя 1.12 или ниже — нужна Legacy-версия.
- Плагин загрузился — в консоли при старте должна быть строка [MillidaServices] Millida Services v… запущен.
2. Где смотреть логи
Все сообщения плагина пишутся в стандартный лог сервера: logs/latest.log (текущий) и logs/2026-06-01-1.log.gz (архивные). Ищи строки с тегом [MillidaServices] или [MillidaTradeLegacy].
- server-token не указан — поле в config.yml пустое.
- Handshake failed: 401 — токен неверный или сервер удалён из админки.
- UnknownHostException: api.millida.trade — нет DNS или интернета.
- SSLHandshakeException — устаревшая Java на legacy (см. FAQ ниже).
3. Версия Java несовместима
Проверь версию Java на сервере командой java -version.
- Modern — Java 17 или выше (как и сам Paper 1.18+).
- Legacy — Java 8 или выше.
4. Игроки не получают покупки
- В админке статус сервера «● Онлайн» (зелёный).
- Игрок реально в онлайне на нужном сервере. Плагин выдаёт только онлайн-игрокам, оффлайн — копит в очередь и выдаст при входе.
- В консоли нет ошибок с тегом [MillidaServices].
- Команды товара в админке корректные — частая ошибка: опечатка в плейсхолдере {player}.
FAQ
Как ротировать токен?
Зайди в Админка → Серверы, открой нужный сервер, нажми «Сгенерировать заново». Старый токен сразу перестанет работать. Скопируй новый, вставь в config.yml и выполни /mt reload.
Обновление со старой версии плагина
Просто замени JAR в plugins/ на новый и перезапусти сервер. config.yml сохранится — плагин дольёт новые поля со значениями по умолчанию. Если переезжаешь с Legacy на Modern (обновил MC до 1.13+ и Java до 17+) — удали MillidaTradeLegacy.jar, положи MillidaTrade.jar и перенеси server-token в новый config. Server ID в админке останется тем же.
SSL-ошибка на старой Java
Для legacy-плагина (1.8 – 1.12) мы кладём корневые сертификаты Let's Encrypt (ISRG Root X1) прямо в JAR — подключение к api.millida.trade работает из коробки даже на Java 8. Если всё равно ловишь SSL-handshake — обнови Java до 11+.
Как работает плагин «под капотом»?
Плагин держит лёгкое long-poll соединение с api.millida.trade (heartbeat) и каждые несколько секунд проверяет, есть ли новые покупки на выдачу. Когда покупка приходит — выполняет команду товара от лица консоли. Никакие порты на твоём сервере открывать не нужно — соединение всегда исходящее.
Несколько серверов на один магазин
Да. В админке создаёшь несколько серверов (у каждого свой токен), ставишь плагин на каждый и в config.yml вписываешь соответствующий токен. По желанию объединяешь сервера в режим (например, «Анархия») — тогда покупатель на витрине сначала выбирает режим, потом конкретный сервер.
Поддомен — как настроить DNS
В админке (раздел «Поддомены») добавь свой поддомен — например, blogger.shop.ru. Затем в DNS-провайдере (Cloudflare, рег.ру и т.д.) создай CNAME-запись. Через 5 – 60 минут (зависит от провайдера) поддомен начнёт работать, SSL-сертификат выпустим автоматически.
- Тип: CNAME
- Хост: blogger.shop.ru
- Цель: millida.trade
- TTL: 300 (или auto)
