Плагин SetSpawn/SetLobby 1.2.0

Назначение плагина​

SetSpawn/SetLobby — серверный плагин для двух глобальных точек телепортации: Spawn и Lobby, которое также может использоваться как Hub. Администратор назначает координаты, а игроки переходят к ним через отдельные команды. Проект также умеет отправлять новых игроков в лобби при входе, ограничивать частоту телепортаций и выводить настраиваемые сообщения со звуками.

Плагин относится к категории transportation и решает узкую задачу. Он не описан как система порталов, пользовательских варпов или межсерверной маршрутизации, поэтому его следует оценивать именно как компактный компонент входной зоны.

Скриншоты и внешний вид​

Аудитория и сценарии выбора​

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

Практические основания для выбора:

• нужны отдельные переходы к Spawn и Lobby;
• /hub должен вести в лобби;
• новых игроков требуется направлять к одной точке;
• телепортационный спам нужно ограничить задержкой на игрока;
• сообщения и звуки должны редактироваться через конфигурацию;
• настройки желательно перечитывать без рестарта.

Множество варпов, случайный телепорт, прокси-сеть и синхронизация через базу данных в источнике не заявлены.

Команды и подтверждённые функции​

/setspawn назначает глобальный Spawn, а /spawn перемещает к нему. Для Lobby используется /setlobby; переход выполняется через /lobby либо псевдоним /hub. Команды установки точек требуют setspawn.set, обычные переходы — setspawn.use.

Автоматическая отправка новых игроков в лобби переключается через /toggleautojoin с правом setspawn.toggleautojoin. В описании функция включена по умолчанию, но фактическое состояние следует проверять в установленной конфигурации. Общая задержка действует на команды телепортации отдельно для каждого игрока; в примере приведено 30 секунд.

Тексты и звуковые эффекты задаются через config.yml. /spawnreload с правом setspawn.reload перечитывает настройки во время работы. Это не подтверждает безопасную горячую замену самого JAR.

Совместимость​

Подтверждены Minecraft 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10 и 1.21.11. Платформы — Bukkit, Paper и Spigot. Клиентская сторона обозначена как неподдерживаемая, серверная — как обязательная. В выбранных метаданных обязательные зависимости не перечислены.

Заявленный диапазон не гарантирует работу с каждым форком или набором плагинов. До установки нужно сопоставить точную версию ядра с перечнем и проверить возможный конфликт /spawn, /lobby и /hub.

Файл и подготовка​

Указан setspawn-1.0.jar размером 8004 байта, хотя версия релиза обозначена как 1.2.0. Это различие стоит сохранить в журнале обновлений. SHA-512: 1cd428511604a6368c2dd572562e0e77306ce418746c134dfe96c115a444d1519f6b1d074e40bb65158c0f4b2b0cfee2d8dc6f52a516e1247df451a395843896; SHA-1: 13c0976180f51b973dc7cb645f065a850a21e736.

Перед установкой сохраняют папку plugins, конфигурации и данные мира. Если уже действует другой плагин спавна, полезно записать его команды, права и координаты.

Проверочный список:

• версия входит в подтверждённый диапазон;
• ядро — Bukkit, Paper или Spigot;
• нет второй копии JAR;
• права подготовлены;
• точки безопасны для появления;
• старый файл доступен для отката.

Установка и первичная настройка​

JAR помещают в папку plugins остановленного совместимого сервера, затем выполняют штатный запуск и проверяют журнал. Горячая загрузка в источнике не подтверждена.

После запуска администратор назначает Spawn и Lobby в безопасных местах. Сначала переходы проверяют под административной учётной записью, затем — под игроком с setspawn.use. Автопереход новичков включают только после проверки Lobby.

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

Проверка результата​

Рабочий тест должен охватывать все заявленные сценарии:

• Назначить Spawn и Lobby в разных безопасных местах.
• Проверить /spawn, /lobby и /hub.
• Убедиться, что игрок без setspawn.set не меняет точки.
• Повторить телепортацию и проверить задержку.
• Сравнить двух игроков, подтверждая индивидуальный cooldown.
• Подключить новую тестовую учётную запись.
• Изменить одно сообщение или звук и перечитать конфигурацию.
• Перезапустить сервер и проверить сохранение параметров.

Отказ команды может означать отсутствие права, конфликт с другим плагином либо неуспешную загрузку JAR. Эти причины следует разделять по журналу и системе разрешений.

Ограничения и риски​

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

Результат зависит от выбранных координат. Точка внутри блока, над пустотой, в закрытой зоне или удалённом мире способна создать проблему. Источник не описывает дополнительную проверку безопасности, поэтому место тестируют вручную.

Автопереход относится к новым игрокам. Материалы не позволяют без проверки утверждать, как он ведёт себя при каждом повторном входе, смене мира или восстановлении после сбоя.

Безопасное обновление и откат​

Перед обновлением сервер останавливают и копируют JAR, конфигурацию и данные плагина. Новый файл сверяют с опубликованными хешами. После запуска проверяют журнал, команды, права, обе точки, задержку и автопереход. Старую сборку сохраняют до завершения теста.

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

Старый конфигурационный файл не стоит без сравнения накладывать на новый. При изменении структуры параметры переносят вручную.

Диагностика​

Если команды отсутствуют, проверяют журнал загрузки, версию ядра, дублирующий JAR и конфликт обработчиков. Если команда доступна оператору, но не игроку, проверяют соответствующее разрешение.

Когда автопереход не работает, нужно подтвердить, что функция включена, Lobby назначен, а тест проводится на новой учётной записи. Если задержка не совпадает с ожиданием, смотрят фактическое значение в конфигурации и тестируют игроков отдельно. Ошибка после /spawnreload требует возврата рабочей копии и изучения журнала.

Файл был локально сверен по опубликованным хешам, а структура и пути прошли статическую проверку. Динамический запуск не выполнялся, поэтому работу на конкретной сборке подтверждают тестовым сервером.

Лицензия и происхождение​

SetSpawn/SetLobby распространяется по MIT; идентификатор SPDX — MIT. Участник публичной команды проекта — Mamtak. При локализации следует сохранять название, авторство и лицензионные сведения. Рекомендации по резервным копиям и тестированию не нужно приписывать автору.

FAQ​

Нужна ли установка на клиент?​

Нет. Плагин предназначен для серверной стороны. Игрок подключается обычным клиентом, соответствующим правилам сервера.

Есть ли обязательные зависимости?​

В выбранных метаданных обязательные project dependencies не указаны. Дополнительный проект для описанных функций источник не называет.

Чем Lobby отличается от Spawn?​

Это две независимо назначаемые глобальные точки. Spawn вызывается через /spawn, Lobby — через /lobby или /hub. Их роль определяет администрация.

Можно ли менять настройки без рестарта?​

Для перечитывания config.yml подтверждена /spawnreload. Установку и замену JAR безопаснее проводить при остановленном сервере.

Доказывает ли совпадение хеша безопасность?​

Нет. Хеш подтверждает соответствие файла опубликованной сборке, но не заменяет динамический анализ и тест совместимости.