Что такое ExtendedCustomHelp и зачем он нужен
Каждый администратор сервера Minecraft рано или поздно сталкивается с ограничениями стандартной команды /help. Встроенная справка умеет показывать только плоский список команд, не различая прав доступа и не поддерживая детальные страницы. Плагин ExtendedCustomHelp создан именно для того, чтобы превратить скучную справочную систему в гибкий, многоуровневый инструмент с цветным текстом, переменными и пермишенами на каждый раздел.
Проблемы ванильного /help и как их решает плагин
Стандартный механизм Bukkit/Spigot не позволяет разграничить видимость страниц по правам. Если у вас десяток плагинов, все их команды сваливаются в одну кучу, а новичок видит то, что ему не нужно. Кроме того, нельзя создать подробные руководства внутри самой игры — только сухие описания команд. ExtendedCustomHelp исправляет эти недостатки, добавляя поддержку вложенных страниц, цветовых кодов и автоматической подстановки имени игрока.
Ключевые возможности
- Многостраничная справка с древовидной структурой: основные разделы и дочерние страницы.
- Пермишены на каждую страницу — можно скрыть админские команды от обычных игроков.
- Цветной текст через стандартные коды форматирования Minecraft (&a, &c, &e и другие).
- Переменные — на данный момент поддерживается %player%, которая заменяется на ник вызвавшего справку.
- Горячая перезагрузка конфигурации без рестарта сервера.
- Автоматическое обновление config.yml при выходе новой версии.
Установка и первые шаги
Плагин работает на серверах Spigot и CraftBukkit версий 1.8.x и 1.7.x. Совместимость с 1.6.x и 1.5.x не тестировалась, но по отзывам может функционировать. Файл плагина достаточно поместить в папку /plugins и перезапустить сервер. При первом запуске автоматически создадутся два файла: config.yml и Help.yml. Первый отвечает за системные сообщения, второй — за содержимое справочных страниц. Если вы только начинаете настраивать сервер и хотите, чтобы ваши игроки быстро подключались без лишних технических заморочек, обратите внимание на лаунчер foxygame.net — современный инструмент, где можно в пару кликов установить любые моды и сборки прямо из меню, а затем мгновенно зайти на подготовленный сервер.
Команды и права доступа
ExtendedCustomHelp добавляет несколько команд для игроков и администраторов:
- /help — основная команда, открывает главную страницу справки.
- /ehelp — дублирует функционал /help.
- /help <Метод> [Дочерняя] — переход к конкретному разделу и подстранице.
- /helpreload — перезагружает Help.yml без остановки сервера.
Система прав построена вокруг узла extendedcustomhelp и позволяет точечно управлять видимостью:
- extendedcustomhelp.* — доступ ко всем страницам.
- extendedcustomhelp.<Метод>.* — доступ к разделу и всем его дочерним страницам.
- extendedcustomhelp.<Метод>.<Дочерняя> — доступ к конкретной подстранице.
- extendedcustomhelp.reload — разрешение на перезагрузку конфигурации.
Структура Help.yml — сердце кастомной справки
Файл Help.yml описывает все страницы в формате YAML. В корне обязательно должен присутствовать раздел Main, иначе плагин не запустится. Каждая страница может содержать ключ Text со списком строк и опциональный флаг Need-Permission: true, который требует от игрока наличия соответствующего права. Дочерние страницы задаются через вложенный блок Children.
Пример простой конфигурации:
Main:
Text:
- '&aДобро пожаловать на сервер!'
- 'Твой ник: %player%'
Children:
Survival:
Need-Permission: true
Text:
- '&eПравила выживания'
- '&fЗдесь будет описание.'
Важно следить за корректностью синтаксиса YAML — любая ошибка в отступах или структуре приведёт к тому, что плагин не загрузится. Для цветового оформления используйте символ & перед кодом цвета, как показано в примере.
Настройка config.yml
Файл config.yml содержит сообщения, которые видит игрок при различных ситуациях. Доступны следующие параметры:
- Help-Not-Found — когда запрошенная страница не существует. Можно использовать переменную %page%.
- Not-Permission — при отсутствии прав на страницу. Поддерживает %page% и %permission%.
- Reload-Complete — сообщение об успешной перезагрузке Help.yml.
- Reload-Not-Permission — уведомление при попытке релоада без права extendedcustomhelp.reload.
Параметр Config-Version служебный, его не нужно трогать — он используется для автоматического обновления конфигурации при выходе новых версий плагина.
Заключение
ExtendedCustomHelp — это небольшой, но крайне полезный плагин для администраторов, которые хотят сделать справочную систему сервера по-настоящему удобной и безопасной. Он закрывает все основные пробелы стандартного /help, позволяя создавать многоуровневые руководства с цветами и персональными приветствиями. Благодаря гибкой системе прав вы можете скрыть чувствительную информацию от посторонних глаз, а горячая перезагрузка экономит время при частых правках. Если вы ищете способ упорядочить команды и правила на своём проекте, обязательно попробуйте этот инструмент — он заслуживает места в вашей сборке.