Что такое FirstJoinPlus и зачем он нужен
FirstJoinPlus — это мощный плагин для Bukkit и Spigot серверов Minecraft, который позволяет полностью контролировать процесс первого входа игрока. Если вы хотите, чтобы новички получали стартовый набор, появлялись в особой точке спавна, видели приветственное сообщение или даже запускали фейерверк — этот инструмент закроет все потребности. В отличие от многих аналогов, он не трогает уже зарегистрированных пользователей, так что постоянные игроки не увидят повторных уведомлений о «первом входе».
Плагин написан с расчётом на гибкость: можно включать и отключать отдельные функции, задавать задержки, использовать переменные для персонализации сообщений. Он подойдёт как для небольших приватных серверов, так и для крупных хабов, где требуется особая обработка каждого входа.
Ключевые возможности плагина
Разработчик предусмотрел десятки сценариев, и всё настраивается через один конфигурационный файл. Вот что вы можете сделать с FirstJoinPlus:
- Приветственное сообщение — в чат выводится настраиваемый текст с переменными %player_name, %total_players и другими. Можно анонсировать, сколько уникальных игроков уже заходило на сервер.
- Стартовый набор — новичок получает предметы, указанные в списке. Например, деревянный меч, кирку, хлеб. Количество задаётся через двоеточие: bread:5.
- Спавн для новых игроков — команда /firstjoinplus setspawn фиксирует точку, куда телепортируется игрок при первом заходе. Координаты также можно прописать вручную.
- Эффекты и зрелищность — запуск фейерверка, дымовой эффект, звук получения уровня. Всё это создаёт атмосферу праздника.
- Временная неуязвимость — god-mode защищает новичка от любых повреждений, включая PvP, на заданное время. Отдельно отключается только PvP-урон.
- Выдача книг с правилами — можно положить в инвентарь написанную книгу, содержимое которой хранится в текстовом файле.
- Выполнение команд — от имени игрока или консоли выполняются любые команды. Удобно для выдачи прав, групп, приветственных реплик.
- Наложение зелий — эффекты вроде скорости или регенерации с настраиваемой длительностью.
- Сброс состояния — очищает инвентарь, здоровье и голод, если нужно начать с чистого листа.
- Настройка сообщений входа/выхода — можно полностью скрыть стандартные уведомления или заменить их своими.
Для серверов-хабов есть режим every-join-is-first-join, при котором каждая сессия считается первой. Игрок будет телепортироваться на спавн, получать фейерверк, а сообщения о входе и выходе можно отключить, выставив %none.
Установка и первый запуск
Плагин ставится как любой другой: скачайте JAR-файл и поместите в папку plugins вашего сервера. После перезагрузки или выполнения /reload появится конфигурационный файл config.yml. Именно в нём кроется вся магия FirstJoinPlus. При тестировании конфигурации удобно использовать лаунчер foxygame.net — он позволяет быстро собрать серверную сборку с нужными плагинами и модами, а также запускать тестовые миры прямо из лаунчера, что экономит время при отладке параметров FirstJoinPlus.
Конфиг разбит на логические секции: on-first-join содержит всё, что касается первого входа, а other-messages отвечает за общие сообщения сервера. Внутри секции можно включать или выключать каждый модуль отдельно.
Основные параметры конфигурации
Разберём самые востребованные опции:
- delay-everything-below-by — задержка в тиках перед выполнением всех действий. Полезна, если другой плагин конфликтует и переопределяет, например, точку спавна. Значение 5–10 тиков часто решает проблему.
- first-join-kit: items — список предметов. Поддерживаются только названия материалов из игры и количество через двоеточие. Для сложных наборов с описаниями и чарами рекомендуется использовать отдельный плагин на наборы, а FirstJoinPlus пусть просто дёргает его команду.
- give-written-books: book-files — имена файлов из папки plugins/FirstJoinPlus/books. Текст книги можно сверстать заранее.
- modify-damage: god-mode / disable-pvp — expire-after указывает длительность в секундах.
- run-console-commands — идеально для автоматической выдачи группы через тот же LuckPerms: setgroup %player_name newbies.
- teleport — если не хотите использовать команду setspawn, координаты можно прописать прямо здесь, включая pitch и yaw.
- every-join-is-first-join — переключатель для хабов.
Команды и права
Все команды плагина начинаются с /firstjoinplus или сокращённо /fjp. По умолчанию они доступны операторам сервера без дополнительных пермишенов.
- /firstjoinplus — показывает общую информацию о плагине.
- /firstjoinplus help — список всех доступных команд.
- /firstjoinplus reload — перезагружает конфиг. Требуется право firstjoinplus.reload.
- /firstjoinplus setspawn — устанавливает точку спавна для новичков по вашему текущему местоположению. Право: firstjoinplus.setspawn.
- /firstjoinplus debug — эмулирует первое присоединение, чтобы проверить настройки без привлечения реальных игроков. Право: firstjoinplus.debug.
Для уведомлений о первом входе можно выдать право firstjoinplus.notify, чтобы определённые игроки или администраторы видели сообщение в чате.
Переменные и персонализация
FirstJoinPlus поддерживает множество переменных, которые делают сообщения живыми:
- %player_name% — ник игрока.
- %player_display_name% — отображаемое имя (если не переопределено другим плагином).
- %total_players% — количество уникальных игроков, когда-либо заходивших на сервер.
- %random_player% — ник случайного игрока онлайн.
- %none% — полностью убирает сообщение. Применяется в join-message, quit-message и kick-message.
- %player_country% и %player_city% — требуют установленного GeoIPTools.
Решение типичных проблем
Иногда новички не появляются в заданной точке спавна. Это почти всегда конфликт с другим плагином, который тоже управляет респавном. Решение — увеличить delay-everything-below-by до 5 или 10 тиков. Аналогично, если отображаемое имя не подхватывается, задержка даст время другим плагинам установить display name.
Если вы хотите, чтобы стартовый набор содержал предметы с особыми свойствами, проще использовать внешний плагин для китов. FirstJoinPlus оставлен максимально простым: только название и количество. Связка получается элегантной: в run-console-commands пропишите вызов нужного кита, а FirstJoinPlus отработает всё остальное — спавн, сообщения, эффекты.
Заключение
FirstJoinPlus — это легковесный, но невероятно гибкий инструмент для администрирования первых шагов игрока на сервере Minecraft. Он избавляет от необходимости писать скрипты и собирать несколько плагинов ради простого приветствия. Чёткая структура конфига, поддержка переменных и продуманные отладочные команды делают его мастхэвом для любого администратора, который заботится о впечатлении новичков. Настройте стартовый набор, красивый фейерверк и информативную книгу правил — и первые минуты игры запомнятся каждому.