Плагин ServerPermissions 1.3.3 +1.3.2

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

Проект относится к управлению, перемещению и служебным инструментам. Клиентская часть не поддерживается: логика работает на стороне Velocity, а игрок подключается обычным клиентом Minecraft.

Роль в серверной сети​

Сеть за Velocity может объединять лобби, выживание, мини-игры, тестовые и закрытые режимы. ServerPermissions добавляет отдельную проверку доступа к каждому такому направлению.

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

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

Схема разрешений​

Используется узел вида:

serverpermissions.server.<сервер>

В документации приведены примеры:

• serverpermissions.server.survival;
• serverpermissions.server.skyblock.

Последняя часть обозначает конкретное направление. Право для survival само по себе не подтверждает доступ к skyblock: каждому серверу соответствует отдельный узел.

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

Отказ в доступе и стартовый сервер​

Если игрок пытается перейти без нужного разрешения, ServerPermissions отправляет сообщение об ошибке. Возможность изменять его точный текст не описана.

Автор отдельно предупреждает: всем пользователям необходимо выдать доступ к лобби или первому серверу. Иначе стартовое направление окажется закрыто, и игроки не смогут нормально войти в сеть.

Работа без собственного конфига​

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

Для выдачи прав нужен плагин разрешений, работающий в Velocity; в официальном тексте как пример указан LuckPerms. Базовый порядок настройки:

• определить контролируемые серверы;
• создать узлы по их именам;
• открыть всем доступ к лобби;
• распределить остальные права по группам;
• проверить разрешённые и запрещённые переходы.

MiniPlaceholders​

MiniPlaceholders указан как необязательная зависимость, а исходное описание подтверждает его поддержку. Базовая проверка доступа не представлена как зависящая от этой интеграции.

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

Velocity, Java и место установки​

Официально заявлены Velocity 3.2.0+ и Java 17+. Эти сведения относятся к среде запуска плагина. Перед установкой следует проверить обе версии, а также совместимость остальных компонентов прокси.

Платформа проекта — Velocity. Поддержка Paper, Folia, Bukkit, Spigot или BungeeCord как мест непосредственной установки не указана. JAR размещают в каталоге plugins экземпляра Velocity.

Подтверждённые версии Minecraft​

Метаданные перечисляют:

• 1.7.2–1.7.10;
• 1.8–1.8.9;
• 1.9–1.9.4;
• 1.10–1.10.2;
• 1.11–1.11.2;
• 1.12–1.12.2;
• 1.13–1.13.2;
• 1.14–1.14.4;
• 1.15–1.15.2;
• 1.16–1.16.5;
• 1.17–1.17.1;
• 1.18–1.18.2;
• 1.19–1.19.4;
• 1.20–1.20.6;
• 1.21–1.21.11;
• 26.1.

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

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

Практический порядок:

• остановить Velocity;
• сверить имя и хеш JAR;
• поместить файл в plugins;
• проверить наличие системы разрешений;
• запустить прокси и изучить журнал;
• выдать тестовой группе доступ к лобби и одному режиму;
• проверить разрешённый и запрещённый переход.

Команды ServerPermissions в исходной основе не перечислены. Управление описано через разрешения, поэтому добавлять отдельные команды настройки не следует.

Файлы и контроль целостности​

Доступны две сборки:

• ServerPermissions-1.3.3.jar — 10 425 байт; SHA-1 a98f6f1735ed2401d8308f7f6fb8a4f8b9a93374;
• ServerPermissions-1.3.2.jar — 10 305 байт; SHA-1 69538581b41c8cc21daba0745955907d0c96404f.

SHA-512 версии 1.3.3: 16c055aeedabb75e97414a85a5408366b0bff911a0d61485fe8d4b11b0dd74eee29842359b2fbc2f71c5b20ee2d8f6b44ff5253e2f3ef6afd0c27db8ad6c1c9c.

SHA-512 версии 1.3.2: 78458237de65a5252089c1fd0dc733308c7986b326da37e0573e9e47b79cab7eddccc1df9a6000d8f17dc137071b22af09fe24d5497f147b7cc7251513a667ca.

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

Производительность, проверка и лицензия​

Разработчик заявляет высокую производительность за счёт возможностей Velocity. Это характеристика проекта, а не результат измерения в конкретной сети.

Файлы получены по официальному HTTPS, сверены с опубликованными SHA-1 и SHA-512; структура и пути проверены статически. Динамический запуск не выполнялся, поэтому отсутствие эксплуатационных ошибок не подтверждено.

ServerPermissions распространяется по лицензии MIT. При использовании, изменении и распространении необходимо соблюдать её условия.

Практический аудит доступа​

После настройки полезно проверить:

• новый игрок входит в лобби;
• обычная группа не попадает в закрытый режим;
• разрешённая группа проходит на нужный сервер;
• отказ сопровождается сообщением;
• переименование сервера отражено в узлах;
• администраторы не теряют доступ;
• без MiniPlaceholders базовая проверка сохраняется;
• после обновления прокси правила работают ожидаемо.

Ошибка в базовой группе способна закрыть доступ сразу большой части аудитории, поэтому тестировать следует отдельной учётной записью, а не только аккаунтом администратора.

Ограничения подтверждённых данных​

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

Также не выполнялся живой тест с несколькими серверами. Статья описывает заявленную модель доступа и проверенные метаданные файлов, а не результаты эксплуатации конкретной сети.

Безопасная проверка​

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

FAQ​

Нужен ли плагин на клиенте?​

Нет. Он устанавливается в Velocity; клиентская часть не поддерживается.

Обязателен ли именно LuckPerms?​

Нужна система разрешений в Velocity, а LuckPerms приведён как пример, не как единственный вариант.

Почему важно право на лобби?​

Без него пользователь может остаться без доступного стартового сервера.

Обязателен ли MiniPlaceholders?​

Нет. Он указан как optional.

Есть ли собственный конфигурационный файл?​

Проект описан как не требующий конфигурации; доступ задаётся разрешениями.

Проверялся ли JAR в работе?​

Нет. Выполнялись сверка хешей и статическая проверка, но не динамический запуск.