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

Один плагин для донат-магазина (Trade) и рейтинга сервера (Rating). За 5 минут твой сервер начнёт принимать покупки и награждать за голоса. Работает на Paper / Spigot / Folia, прокси BungeeCord / Velocity и модах Fabric / Forge / NeoForge. Никаких прав root и открытых портов — соединение исходящее.

Не делитесь токеном сервера ни с кем. Это пароль, который позволяет выдавать товары на твоём сервере. Если токен утёк — сгенерируй новый в админке (см. FAQ ниже).

Какую версию выбрать

Modern

Minecraft1.13 – 1.21+

JavaJava 17+

СофтPaper / Spigot / Folia

ПрочееPlaceholderAPI (опционально)

Legacy

Minecraft1.8.8 – 1.12.2

JavaJava 8+

СофтSpigot / Bukkit

ПрочееSSL-сертификаты вшиты в JAR

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

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

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

Выбери файл под свой сервер. Если сомневаешься и у тебя обычный сервер — берите Paper / Spigot / Folia.

Paper / Spigot / Folia (1.13+)

BungeeCord (прокси)Velocity (прокси)Fabric · 1.21.1 Fabric · 1.20.1 Forge · 1.21.1 Forge · 1.20.1 NeoForge · 1.21.1 Legacy · Spigot 1.8 – 1.12

Моды собираются под конкретную версию Minecraft — берите файл со своей версией. Нужна другая версия MC? Напиши в поддержку — добавим в сборку.

Положи JAR в plugins/

Скопируй файл в папку plugins/ своего сервера — через FTP, SFTP или панель хостинга.

# пример пути на хостинге
/home/minecraft/server/plugins/MillidaServices-Paper.jar

# на модах — в папку mods/
/home/minecraft/server/mods/MillidaServices-Fabric-1.21.1.jar

Перезапусти сервер

Полный рестарт нужен один раз, чтобы плагин создал файл plugins/MillidaServices/config.yml. Дальше изменения применяются командой /ms reload без перезапуска.

# в консоли сервера
stop

# и запускаем заново
./start.sh

Возьмите токен в админке

Открой Админка → Магазин → раздел «Серверы» → твой сервер → кнопка «Скопировать токен». Токен выглядит как mt_XXXXXXXXXXXXXXXX.

Если сервера ещё нет — нажми «+ Добавить сервер», укажи название (например, «Анархия #3») и токен сгенерируется автоматически.

Админка → Серверы: токен сервера показывается один раз — копируйте сразу

Вставь токен в config.yml

Открой plugins/MillidaServices/config.yml (на модах — config/millidaservices/config.json) и впишите токен в поле server-token. Это единственное обязательное поле — остальное опционально:

server-token: "mt_XXXXXXXXXXXXXXXXXXXXXXXX"
server-name: "Анархия #3"
mode-name: "Анархия"

services:
  trade:  { enabled: true }   # автодонат
  rating: { enabled: true }   # награды за голоса

logging:
  show-errors: true           # выводить ошибки плагина в консоль
error-reporting:
  enabled: true               # обезличенные отчёты об ошибках в Millida

Адрес API подставляется автоматически — указывать его не нужно.

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

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

/ms reload

В админке во вкладке «Серверы» статус сервера сменится на ● Онлайн в течение 30 секунд. Готово — можно принимать покупки.

Админка → Серверы: индикатор «● Плагин подключён» рядом с сервером

Не загорелось зелёным? Открой раздел «Что-то не работает» ниже.

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

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

/ms topТоп голосующих сервера. Доступна всем игрокам.

/ms statusВерсия, server ID, очередь событий, последний flush, активные сервисы. Ничего не меняет.

/ms reloadПеречитать конфиг и заново сделать handshake. После смены токена/настроек.

/ms testPing на api.millida.trade — проверка сети/файрвола без перезагрузки.

/ms updateПроверить и скачать обновление плагина (если включено на бэкенде).

Рейтинг: награды за голоса

Игрок голосует за твой сервер на сайте Millida (там же — защита от накрутки: Discord, Cloudflare, история игры). Плагин узнаёт о засчитанном голосе и выдаёт награды локально — командами, которые ты настраиваешь сам в config.yml. Можно давать бонус за каждый голос и отдельные бонусы за стрик (голоса несколько дней подряд).

rating:
  # Команды за КАЖДЫЙ голос. {player}, {streak}, {server}.
  vote-rewards:
    - "eco give {player} 100"
    - "crate give {player} vote 1"
  # Бонусы за стрик — срабатывают, когда стрик достигает N дней подряд.
  streak-milestones: [7, 30]
  streak-rewards:
    7:
      - "crate give {player} weekly 1"
    30:
      - "lp user {player} parent addtemp vip 30d"
  top:
    size: 10                  # сколько мест в /ms top и плейсхолдерах
  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);

String serverId = api.serverId();
var top = api.ratingTop(10);
var me = api.ratingPlayer("Steve");   // голоса/стрик/позиция

// Реакция на награду за голос (свои эффекты/статистика)
@EventHandler
public void onVote(MillidaVoteRewardEvent e) {
    var info = e.getInfo();
    Bukkit.broadcastMessage(info.nickname()
        + " проголосовал! стрик: " + info.streak());
}

На любой платформе доступна подписка api.onVoteReward(listener).

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

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

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

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

Проверь по порядку:

Токен — скопирован полностью, без пробелов, начинается с 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… запущен.

FAQ

Не получилось?

Напиши нам в Telegram-бот поддержки — отвечаем в течение часа.

Написать в поддержку →