Плагин для серверов Майнкрафт с системой реферальных кодов и наград за приглашение друзей. Игрок создаёт код, передаёт его другу, а после активации оба получают настроенные награды.
Возможности
- Короткие уникальные коды с копированием по нажатию, история приглашений, личная статистика и общий рейтинг пригласивших игроков.
- Награды для пригласившего и приглашённого, а также бонусы за заданное число приглашений.
- Награды для лидеров рейтинга по расписанию; количество мест, интервал и команды задаются в конфиге.
- Награды для отсутствующих игроков сохраняются и выдаются при следующем входе.
- Можно включить звуки и титры при успешной активации кода.
- Защита от злоупотреблений: нельзя пригласить самого себя, код применяется только один раз; можно задать минимальное время игры, срок действия кода и проверку IP-адреса.
- Игрокам с правом можно разрешить собственные коды из букв, цифр и
_. - Данные рефералов доступны через PlaceholderAPI для чата и табло.
Команды
/invite— получить или посмотреть свой код./invite set <code>— установить собственный код./ref <code>— активировать код приглашения./referral stats— посмотреть личную статистику./referral top— открыть рейтинг./referral history— посмотреть историю приглашений./referral reload— перезагрузить конфиг./referral admin info <player>— посмотреть реферальные данные игрока./referral admin reset <player> [confirm]— сбросить данные игрока./referral admin setcode <player> <code>— назначить игроку код.
Права
mysticalref.invite— получение кода.mysticalref.customcode— собственный код.mysticalref.use— активация кода.mysticalref.referral— статистика, рейтинг и история.mysticalref.reload— перезагрузка настроек.mysticalref.admin— административные команды.
Настройка
Для хранения данных нужна заранее созданная база MySQL. Параметры подключения находятся в plugins/MysticalReferral/config.yml, в разделе database: host, port, name, username, password и настройки пула соединений.
В разделе settings настраиваются длина кода (code-length), минимальное игровое время (min-playtime-minutes), проверка IP (allow-ip-referrals), размер рейтинга (leaderboard-size) и срок действия кодов (code-expiration-days). Награды выполняются как консольные команды; имя игрока подставляется через %player%. Разделы milestones, effects, custom-codes и top-rewards отвечают соответственно за бонусные этапы, эффекты, правила собственных кодов и награды лидерам.
Требования
Работает на сервере Paper и его форках, включая Purpur, с Java 21 и MySQL 8.0 или выше. PlaceholderAPI подключается для вывода реферальных данных в чат и табло.
