Установка плагина

Плагин связывает магазин с вашим сервером и выдаёт купленные товары игрокам автоматически. Установка занимает около 5 минут. Никакие порты открывать не нужно — соединение всегда исходящее.

Поддерживаемые платформы

На Folia работает modern-сборка — плагин сам определит Folia и переключится на регионализованный планировщик. Внешние зависимости (LuckPerms / Vault / EssentialsX) не нужны — команды выполняются от лица консоли.

Для BungeeCord / Velocity и для модов Fabric / Forge / NeoForge есть отдельные сборки. Bukkit-сборка и прокси работают на всех версиях одним файлом; сборки модов — под конкретную версию Minecraft (например, 1.20.1, 1.21.1).

Установка по шагам

1. Скачайте сборку под свою платформу

Выберите файл под свой сервер. Если сомневаетесь и у вас обычный сервер — берите Paper / Spigot / Folia. Прокси, моды (Fabric / Forge / NeoForge) и старые версии — в списке «Другие платформы». Те же сборки доступны в дашборде: Trade → Серверы → «Установить плагин».

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 без перезапуска.

4. Возьмите токен в дашборде

Откройте Trade → Серверы → ваш сервер → «Скопировать токен». Токен выглядит как mt_XXXXXXXXXXXXXXXX и показывается один раз — копируйте сразу. Если сервера ещё нет, нажмите «+ Добавить сервер» — токен сгенерируется автоматически.

Важно: токен — это секрет доступа. Не публикуйте его. При утечке сгенерируйте новый кнопкой «Сгенерировать заново».

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 }   # автодонат
  rating: { enabled: true }   # награды за голоса

logging:
  show-errors: true
error-reporting:
  enabled: true

6. Перезагрузите конфиг и проверьте статус

В консоли сервера или из игры (с правами оператора) выполните:

/ms reload

В дашборде во вкладке «Серверы» статус сменится на ● Онлайн в течение 30 секунд. Готово — можно принимать покупки. Не загорелось зелёным? См. раздел «Что-то не работает» ниже.

Команды плагина

Основная команда — /ms. Алиасы: /millida, /mt, /millidatrade. Админ-команды требуют право millidaservices.admin (по умолчанию у операторов); /ms top доступна всем.

Прокси-сервер

Если у вас BungeeCord или Velocity и фронт-сервер раздаёт игроков по бэк-нодам — плагин ставится на каждый бэк-сервер, который принимает покупки. На самом прокси плагин не нужен.

BungeeCord / Waterfall. В spigot.yml бэк-сервера включите settings.bungeecord: true — плагин сам прочитает hostname из handshake.

Velocity (только modern). В paper-global.yml бэк-сервера включите секцию proxies.velocity (enabled: true, online-mode: true, secret). Secret должен совпадать с velocity.toml на прокси. На legacy (1.8 – 1.12) Velocity не поддерживается — только BungeeCord.

Награды за голоса

Игрок голосует за сервер на сайте Millida (там же защита от накрутки). Плагин узнаёт о засчитанном голосе и выдаёт награды локально — командами, которые вы настраиваете в config.yml. Плейсхолдеры: {player}, {streak}, {server}.

rating:
  vote-rewards:
    - "eco give {player} 100"
    - "crate give {player} vote 1"
  streak-milestones: [7, 30]
  streak-rewards:
    7:
      - "crate give {player} weekly 1"
    30:
      - "lp user {player} parent addtemp vip 30d"
  top:
    size: 10

Для голограмм с топом нужен PlaceholderAPI — доступны плейсхолдеры %millida_rating_top_1_name%, %millida_rating_top_1_votes%, %millida_rating_votes%, %millida_rating_streak%, %millida_rating_position%. Подробнее о настройке наград — в статье Голоса и награды.

Что-то не работает

Пройдитесь по чек-листу — в 90% случаев это одна из причин.

Сервер не появляется онлайн:

• Токен скопирован полностью, без пробелов, начинается с mt_. После правки — /ms reload.
• Файрвол — нужен исходящий доступ к api.millida.net по порту 443. Проверка: /ms test должна вернуть «API отвечает».
• Версия MC / Java — modern требует MC 1.13+ и Java 17+. Для 1.12 и ниже нужна Legacy-сборка.
• Плагин загрузился — в консоли при старте есть строка [MillidaServices] Millida Services v… запущен.

Где смотреть логи. Все сообщения пишутся в logs/latest.log с тегом [MillidaServices]. Частые ошибки:

• server-token не указан — поле в config пустое.
• Handshake failed: 401 — токен неверный или сервер удалён из дашборда.
• UnknownHostException: api.millida.net — нет DNS / интернета.
• SSLHandshakeException — устаревшая Java на legacy (обновите до 11+).

Игроки не получают покупки:

• Статус сервера в дашборде — ● Онлайн.
• Игрок реально в сети на нужном сервере (офлайн-выдача копится в очередь и придёт при входе).
• В консоли нет ошибок с тегом [MillidaServices].
• Команды товара корректны — частая ошибка: опечатка в плейсхолдере {player}.

FAQ

Как ротировать токен? Дашборд → Серверы → ваш сервер → «Сгенерировать заново». Старый токен сразу перестанет работать; вставьте новый в config.yml и выполните /ms reload.

Обновление плагина. Замените JAR в plugins/ на новый и перезапустите сервер — config.yml сохранится, новые поля дольются по умолчанию. При переезде с Legacy на Modern удалите старый JAR, положите новый и перенесите server-token — server ID останется тем же.

Несколько серверов на один магазин. Да: создайте несколько серверов (у каждого свой токен), поставьте плагин на каждый. По желанию объедините серверы в режим — тогда покупатель сначала выбирает режим, затем сервер.

Как работает «под капотом»? Плагин держит лёгкое long-poll соединение с api.millida.net и каждые несколько секунд проверяет новые покупки. Когда покупка приходит — выполняет команду товара от лица консоли. Порты открывать не нужно.

Не получилось? Напишите в поддержку в Telegram — поможем с настройкой.