Плагин AdminGui 1.0

Назначение​

AdminGui — серверный плагин, который объединяет повседневные административные действия в графическом интерфейсе. Он предназначен для управления игроками, наказаниями, телепортацией, инвентарями, режимом невидимости и частью серверных параметров без постоянного ввода команд в чат. Клиентская сторона не поддерживается, серверная обязательна. Лицензия — MIT, участник публичной команды проекта — Mamtak.

Плагин относится к управлению, утилитам и игровым механикам. GUI упрощает навигацию, но не отменяет разграничение полномочий.

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

Кому подходит​

AdminGui рассчитан на серверы Minecraft 1.21, где модераторы регулярно выполняют однотипные операции. Типичные сценарии:

• работа младшего персонала через понятные меню;
• наказания с подтверждением;
• проверка состояния игрока;
• просмотр и редактирование инвентаря;
• телепортация между игроками и точками;
• скрытое наблюдение в vanish;
• управление чатом и базовыми параметрами мира.

Интерфейс не заменяет регламент модерации и обучение персонала.

Интерфейс и выбор цели​

Главная панель открывается подтверждённой командой /admingui. Из неё можно выбрать целевого игрока через скрытый ввод, который не отправляется в чат, перейти к инструментам по категориям и вернуться назад кнопками в каждом меню.

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

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

Панель наказаний включает ban, временный ban с выбором срока, unban, kick с собственной причиной, mute, временный mute, unmute и предупреждения с произвольным сообщением. Для разрушительных действий предусмотрены экраны подтверждения.

Vanish действует только для самого администратора: заявлены скрытие от игроков и списка, индикатор action bar, запрет обычного чата при доступных командах и блокировка перечисленных личных сообщений.

Инвентарь редактируется в реальном времени, включая броню и вторую руку; предусмотрены просмотр и редактирование Ender Chest. Телепортация охватывает переход к игроку, перенос цели, spawn, координаты и возврат после телепортации или смерти.

Также заявлены freeze и unfreeze, блокировка движения и разрушения блоков, защита от падения при заморозке и просмотр состояния игрока. Есть управление чатом, объявлениями, временем, погодой и сложностью, удаление категорий мобов и базовые сведения о задержках и сущностях.

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

Метаданные перечисляют Bukkit, Paper и Spigot, а подтверждённые версии Minecraft — от 1.21 до 1.21.11. В официальном тексте указано тестирование на этом диапазоне, поддержка Paper и Spigot и рекомендация Paper.

Перед установкой сопоставляют:

• точную версию Minecraft;
• сборку серверного ядра;
• версию AdminGui;
• систему прав;
• плагины наказаний, телепортации, чата и vanish;
• уже назначенные персоналу команды и полномочия.

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

Файл и проверка целостности​

Зафиксирован один артефакт: admingui-1.1.jar, размер 45950 байт. В метаданных его версия обозначена как 1.0, хотя имя файла содержит 1.1. Это расхождение следует сохранять как факт и не пытаться исправлять предположением.

SHA-512 файла: 4b15247f66a5aa340a4952ad7684229ca0d660352d5f2e1af53eb564111b4f1997bb23ee4577f9f69ee979328b3a47b8191d7eaf27e5292e76720dfedfb6048f. SHA-1: c207b656e5edeecf0afa5b599f3bc5c0e8be12f9.

Артефакт получен по официальному HTTPS, локально сверён по опубликованным хешам и статически проверен по структуре и путям. Динамический запуск не выполнялся. Совпадение хеша подтверждает идентичность файла, но не корректность действий на конкретном сервере.

Установка​

JAR помещают в папку plugins совместимого сервера. Контролируемая процедура:

• остановить сервер;
• сохранить прежний JAR, конфигурацию и данные связанных плагинов;
• проверить имя, размер и хеш файла;
• исключить наличие второго экземпляра AdminGui;
• скопировать JAR в plugins;
• запустить сервер и проверить журнал;
• выдать доступ только тестовой роли;
• выполнить проверки на отдельном тестовом игроке.

Сначала доступ дают тестовой роли и проверяют пересечение с действующими системами наказаний и телепортации.

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

Проверку проводят от безопасных функций к разрушительным:

• открытие главной панели;
• скрытый выбор тестовой цели;
• переходы между категориями и возврат;
• просмотр сведений об игроке;
• телепортация и работа возврата;
• включение и снятие freeze;
• вход и выход из vanish;
• просмотр инвентаря и Ender Chest;
• редактирование одного неценного предмета;
• временное наказание с подтверждением;
• управление тестовым чатом и миром;
• повторный запуск сервера.

Проверяют фактическое состояние цели: отменённое наказание не применяется, после vanish видимость восстанавливается, а изменение инвентаря совпадает у обеих сторон.

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

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

Нужно учитывать:

• поддержка заявлена только для ветки 1.21;
• обязательные зависимости не перечислены;
• Paper рекомендован, но это не гарантия отсутствия ошибок;
• vanish описан как self-only;
• Ender Chest имеет отдельные режимы просмотра и редактирования;
• удаление мобов по категории требует особой осторожности;
• базовые сведения о лаге не заменяют полноценную диагностику производительности;
• статическая проверка JAR не подтверждает права и действия GUI.

Полномочия выдают по принципу минимальной достаточности, разделяя просмотр и изменяющие действия.

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

Перед обновлением сохраняют JAR, конфигурацию, права и данные связанных плагинов. На копии повторяют выбор цели, наказания, инвентарь, vanish, freeze и телепортацию.

Из-за расхождения между именем admingui-1.1.jar и версией 1.0 в метаданных нельзя полагаться только на подпись файла. Для идентификации полезнее одновременно фиксировать хеш, размер и источник артефакта.

Откат​

Для отката возвращают согласованные прежний JAR, конфигурацию и правила доступа.

После отката проверяют:

• загрузку одного экземпляра плагина;
• доступ тестовой роли;
• выбор игрока;
• подтверждения наказаний;
• vanish и freeze;
• просмотр и редактирование инвентаря;
• телепортацию и возврат.

Уже выполненные наказания, перемещения предметов и удаления сущностей проверяют отдельно.

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

Начинают с первой ошибки и точных версий, затем определяют этап: открытие панели, выбор цели или выполнение действия.

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

Лицензия​

AdminGui распространяется по MIT. При локализации сохраняют название проекта, участие Mamtak и лицензионные сведения. Рекомендации по ролям, резервным копиям и тестированию являются редакционными и не приписываются разработчику.

FAQ​

Нужна ли установка игрокам?​

Нет. Клиентская сторона помечена как неподдерживаемая, серверная — как обязательная.

Какая команда открывает панель?​

В официальном описании подтверждена команда /admingui.

Поддерживается ли Minecraft 1.20?​

Нет подтверждения. Указан диапазон 1.21–1.21.11.

Почему имя файла и версия различаются?​

Файл называется admingui-1.1.jar, а версия в метаданных указана как 1.0. Причина расхождения в источнике не объяснена.

Заменяет ли GUI систему прав?​

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

Что тестировать первым?​

Открытие панели, выбор тестового игрока и навигацию. Затем — просмотр, телепортацию и только после этого наказания, инвентарь и управление миром.