FirstLogin: плагин приветствия и правил для Minecraft

Плагин FirstLogin: Идеальное первое впечатление на вашем Minecraft сервере

Каждый администратор Minecraft сервера знает: первые секунды после входа игрока формируют отношение к проекту. Скучное стандартное сообщение или отсутствие какой-либо реакции часто приводят к тому, что новичок просто покидает сервер. Плагин FirstLogin создан, чтобы превратить рутинный первый вход в запоминающееся событие, а заодно взять на себя важную функцию — принятие правил через интерактивное меню.

Что такое FirstLogin?

FirstLogin — это легковесный плагин для серверов на базе Spigot или Paper версии 1.20 и выше, работающий на Java 17. Он не перегружает ядро, но при этом предлагает гибкую систему приветствий, визуальных эффектов и настраиваемого GUI. Плагин умеет отличать новичков от вернувшихся игроков, отслеживать принятие текущей версии правил и даже собирать телеметрию для анализа активности.

Основные возможности

FirstLogin объединяет десятки функций, которые обычно ищут в нескольких отдельных плагинах. Вот ключевые направления:

Приветственные сообщения и визуальные эффекты

Плагин поддерживает глобальные и приватные сообщения с полноценной поддержкой Adventure MiniMessage и плавным переходом от legacy-форматирования через символ &. При желании можно добавить Title, Action Bar и звуковое сопровождение. Для вернувшихся игроков работает «возвращающийся гейт»: повторное приветствие показывается только если игрок отсутствовал заданное количество дней.

Welcome GUI и принятие правил

Главная изюминка FirstLogin — настраиваемое меню, которое может открываться при каждом входе до тех пор, пока игрок не примет актуальные правила. Каждый предмет в GUI поддерживает отдельные права доступа, режимы срабатывания (однократно, с кулдауном, закрытие по клику) и звуки. Предусмотрен опциональный диалог подтверждения перед финальным акцептом. Асинхронное сохранение данных в players.yml гарантирует, что сервер не зависнет даже при массовом онлайне.

Кстати, если вы хотите дополнить серверный плагин клиентскими модами для улучшения визуального опыта, лаунчер foxygame.net позволяет легко установить нужные моды прямо из меню, делая процесс входа на сервер еще более захватывающим и персонализированным.

Счетчики и телеметрия

FirstLogin автоматически подсчитывает открытия GUI, принятия правил и клики по конкретным предметам за сегодняшний день. Эти данные доступны через PlaceholderAPI и могут использоваться для отображения статистики на информационных табло или в других плагинах. Сброс телеметрии настраивается по расписанию.

Установка и настройка

Процесс установки максимально прост и не требует редактирования файлов вручную на начальном этапе:

• Поместите файл firstlogin-1.8.0.jar в папку plugins/ вашего сервера.
• Запустите сервер один раз, чтобы сгенерировались конфигурационные файлы: config.yml, messages.yml и players.yml внутри папки plugins/FirstLogIn.
• Настройте сообщения и визуальные эффекты под стиль вашего проекта.
• Перезапустите сервер (рекомендуется вместо использования /reload).

Для работы PlaceholderAPI необходимо включить соответствующую опцию в конфигурации и выполнить /firstlogin reload для динамической регистрации расширения.

Команды и права доступа

Плагин добавляет несколько удобных команд для игроков и администраторов. Все административные утилиты сгруппированы под /firstlogin с автодополнением.

Основные команды

• /listp — количество игроков, заходивших на сервер за всё время.
• /pnames — список имён всех посетителей.
• /owner — выводит имя владельца сервера из конфигурации.
• /onlinep — сводка онлайн/всего.
• /firsthelp — краткая справка.
• /firstlogin reload — перезагрузка конфигурации и сообщений.
• /firstlogin gui open [игрок] — открыть GUI указанному игроку.
• /firstlogin clearcooldown [игрок] [ключ|all] — сброс кулдаунов.
• /firstlogin seen [игрок] / reset [игрок|all] / status [игрок] — управление данными игроков.
• /firstlogin set [ключ] [значение] — изменение настроек на лету.
• /firstlogin metrics [reset|when|now] — просмотр и сброс телеметрии.

Права (пермишены)

• firstlogin.admin — доступ ко всем административным командам.
• firstlogin.command.listp — использование /listp.
• firstlogin.command.pnames — /pnames.
• firstlogin.command.owner — /owner.
• firstlogin.command.onlinep — /onlinep.
• firstlogin.command.firsthelp — /firsthelp.

PlaceholderAPI интеграция

FirstLogin предоставляет богатый набор плейсхолдеров, которые можно использовать в любых плагинах, поддерживающих PlaceholderAPI. Все временные метки форматируются согласно шаблону из конфигурации.

Временные метки и статус

• %firstlogin_first_join_date% — дата первого входа.
• %firstlogin_rules_accepted_date% — дата принятия правил.
• %firstlogin_days_since_first_join% — дней с первого входа.
• %firstlogin_first_join_ts% — временная метка первого входа в миллисекундах.
• %firstlogin_rules_accepted_ts% — метка принятия правил.
• %firstlogin_rules_version_accepted% — последняя принятая версия правил.
• %firstlogin_rules_pending% — true, если игрок не принял текущую версию.

Телеметрия и порядок входа

• %firstlogin_gui_opens_today% — открытий GUI сегодня.
• %firstlogin_rules_accepted_today% — принятий правил сегодня.
• %firstlogin_item_clicks_today_<ключ>% — кликов по предмету с указанным ключом.
• %firstlogin_join_order% — порядковый номер входа (начиная с 1).
• %firstlogin_metrics_reset_date% — дата последнего сброса телеметрии.
• %firstlogin_metrics_next_reset_pretty% — оставшееся время до следующего сброса в читаемом виде, например «3h 14m 5s».

Что нового в версии 1.8.0

Обновление 1.8.0 значительно расширяет функциональность GUI и добавляет долгожданные возможности отслеживания активности.

Расширенная система GUI

Теперь каждый предмет в меню может запускать до 29 типов действий: от простых сообщений и команд до телепортации, выдачи предметов, наложения эффектов, запуска фейерверков и даже случайных или условных цепочек. Для контроля видимости предметов появилось 13 типов требований: проверка флагов, прав, уровня здоровья, игрового режима, мира, погоды и других параметров. Оформление предметов тоже вышло на новый уровень — 10 опций отображения, включая свечение, кастомную модель, скрытие флагов, цвет кожаной брони и эффекты зелий. Встроенные плейсхолдеры вроде {health}, {world}, {playtime} и прогресс-бары делают меню живым и информативным.

Отслеживание входов и события

• Фиксируется серия последовательных дней входа (стрик) и максимальный стрик.
• Обнаружение годовщины первого входа и праздничные сообщения.
• Кастомные события FirstJoinEvent и ReturningPlayerEvent для взаимодействия с другими плагинами.
• Сообщения о важных рубежах стрика: 7, 14, 30, 60, 90, 100 и 365 дней.
• Реферальная система и заметки об игроках для администраторов.

Вебхуки Discord и Slack

FirstLogin теперь умеет отправлять уведомления о первом входе и возвращении игроков прямо в каналы Discord или Slack. Сообщения полностью настраиваются и поддерживают плейсхолдеры, включая информацию о годовщинах.

Заключение

FirstLogin — это не просто плагин для приветствия, а полноценный инструмент управления первым впечатлением и контроля принятия правил. Гибкие настройки, асинхронная работа, интеграция с PlaceholderAPI и вебхуками делают его незаменимым для серьёзных серверов, стремящихся к профессионализму. Благодаря регулярным обновлениям и вниманию к деталям, плагин остаётся актуальным и продолжает развиваться, предлагая администраторам всё больше творческих возможностей. Установите FirstLogin, настройте уникальное приветствие и наблюдайте, как новички превращаются в постоянных игроков.