▶️ ЗАБЕРИ СВОИ 8 ПОДАРКОВ 🎁 ПРИ СОЗДАНИИ СВОЕГО МАЙНКРАФТ СЕРВЕРА
Плагины/EssentialsX GUI
EssentialsX GUI

EssentialsX GUI

EGUI - мощный графический интерфейс для домов и варпов EssentialsX на серверах Paper. Полная настройка, админ-панель, один JAR для всех версий 1.21.1+.

Оцените первым
4.1K
5

EGUI (EssentialsGui) v2.1.1

EGUI - это мощный и настраиваемый графический интерфейс для EssentialsX, который заменяет текстовые команды для домов и варпов на удобные меню. Один JAR работает на всех версиях Paper - от 1.21.1 до 26.x.

На серверах Minecraft с EssentialsX управление домами и варпами обычно сводится к набору команд в чате. EGUI делает этот процесс визуальным и интуитивно понятным: игроки видят свои дома в виде иконок, могут телепортироваться, удалять или создавать новые одним кликом. Администратор получает админ-панель для управления чужими домами и гибкие настройки через конфиг.

Плагин требует EssentialsX для полной функциональности, но запускается и без него (в чат выводится предупреждение для администраторов). Поддерживаются только серверы на Paper (Spigot и CraftBukkit не поддерживаются). Требуется Java 21+.

Совместимость по версиям

Версия MinecraftВерсия JavaПоддержка EGUI
1.21.1 - 1.21.6Java 21AnvilGUI (ввод текста)
1.21.7 - 1.21.11Java 21Paper Dialog API
26 и новееJava 25Paper Dialog API

Один JAR на все серверы - EGUI автоматически определяет версию Paper и загружает нужный модуль ввода.

Возможности

  • Интеграция с EssentialsX - плагин читает данные домов и варпов напрямую из EssentialsX.
  • Адаптивное меню домов - автоматически показывает только доступные слоты в зависимости от разрешений игрока.
  • Настраиваемая раскладка - выберите полную (THREE_ROWS с рамкой) или компактную (ONE_ROW) версию.
  • Центрирование элементов - опционально центрируйте иконки домов и варпов при малом количестве.
  • Полная кастомизация - каждый предмет, сообщение и макет настраиваются в config.yml.
  • Свои иконки для домов - игроки могут установить собственный материал для иконки дома.
  • Умный ввод текста - на новых серверах используется Paper Dialog API, на старых - AnvilGUI. Без дополнительных настроек.
  • Админ-панель - команда /adminhomes для поиска и управления домами офлайн-игроков.
  • Гибкие переключатели - можно включить или выключить команды /homes и /warps, GUI создания дома, подтверждение удаления и предложение создать дом при пустом списке.
  • Свои иконки для варпов - назначайте уникальные предметы, названия и описания отдельным варпам в warps.yml.
  • Безопасное удаление - подтверждение удаления дома через GUI (отключаемо).
  • GUI при отсутствии домов - если у игрока нет домов, при /homes открывается меню с предложением создать дом.
  • Горячая перезагрузка - /egui reload обновляет конфиги, иконки и данные без перезапуска сервера.
  • Панель статуса - /egui status показывает статус подключения к EssentialsX и версию плагина.
  • Автообновление - уведомления о новых версиях для администраторов.
  • Лёгкий - около 400 КБ с двумя встроенными провайдерами.

Команды и разрешения

КомандаОписаниеПравоДоступ
/homesОткрыть меню домовegui.homesВсе
/sethomeicon <дом> <материал>Установить иконку домаegui.sethomeiconВсе
/adminhomesАдмин-панель для домов игроковegui.adminOP
/warpsОткрыть меню варповegui.warpsВсе
/egui reloadПерезагрузить конфигурациюegui.reloadOP
/egui statusСтатус плагина и версияegui.statusOP

Конфигурация (config.yml)

Пример config.yml
# ==============================================================================
#  EGUI Configuration
# ==============================================================================

# ------------------------------------------------------------------------------
#  Module Selection (Advanced)
# ------------------------------------------------------------------------------
# EGUI automatically detects your server version and loads the correct module:
#   - Paper 1.21.1 to 1.21.6  → loads AnvilGUI (legacy)
#   - Paper 1.21.7+ and 26.x   → loads Paper Dialog API (dialog)
#
# You can override this behavior:
#   auto    = Let EGUI decide (recommended)
#   legacy  = Force AnvilGUI on all versions
#   dialog  = Force Dialog API on all versions (will crash on old servers!)
module-selection: auto

# Print detailed module loading info to console on startup
module-log-verbose: true

# Path to the Essentials userdata and warps folders.
essentials-userdata-folder: "plugins/Essentials/userdata"
warps-folder: "plugins/Essentials/warps"

# ==============================================================================
#  GUI Appearance
# ==============================================================================
# Options: 
#   THREE_ROWS: A 9x3 GUI with top/bottom glass borders (as in screenshot).
#   ONE_ROW:    A compact 9x1 GUI containing only the functional row.
gui-style: ONE_ROW

# Centers home items in the functional row when fewer than 5 are shown.
center-homes: false

# Centers warp items in the functional row when fewer than 5 are shown.
center-warps: false

# Background filler item used for all GUIs
background-item:
  material: BLACK_STAINED_GLASS_PANE
  name: ""

# Navigation buttons
item-for-previous-page:
  material: ARROW
  name: "&ePrevious Page"
  lore:
    - "&aLeft-Click to go to the Previous Page"

item-for-next-page:
  material: ARROW
  name: "&eNext Page"
  lore:
    - "&aLeft-Click to go to the next page"

# ==============================================================================
#  Homes GUI Settings
# ==============================================================================
gui-titles:
  homes: "&8Your homes"
  warps: "&8Server Warps"
  sethome: "&fEnter Home Name"
  admin-search-online-player: "&fSearch Online Player"
  admin-search-offline-player: "&fSearch Offline Player"

# Item representing a set home
item-for-home:
  material: RED_BED
  name: "&e%home%"
  lore:
    - "&7World: &f%world%"
    - "&7X: &f%x% &7Y: &f%y% &7Z: &f%z%"
    - ""
    - "&aLeft-Click to Teleport"
    - "&cRight-Click to Delete"

# Item representing an available but unset home slot
item-for-empty-home:
  material: GRAY_BED
  name: "&8Empty Home Slot"
  lore:
    - "&7Click here to securely"
    - "&7type and set a new home!"

# ==============================================================================
#  Warps GUI Settings
# ==============================================================================

default-item-for-warp:
  material: ENDER_PEARL
  name: "&e%warp%"
  lore:
    - "&7Click to teleport to %warp%."

# ==============================================================================
#  Confirm Deletion GUI
# ==============================================================================
confirm-gui:
  fill-background: true
  background-material: BLACK_STAINED_GLASS_PANE
  background-name: " "
  confirm-item:
    material: LIME_WOOL
    name: "&aConfirm Deletion"
    lore:
      - "&7Click to permanently delete"
  cancel-item:
    material: RED_WOOL
    name: "&cCancel"
    lore:
      - "&7Go back to your homes list."

# ==============================================================================
#  Features
# ==============================================================================
features:
  allow-custom-home-icons: true
  enable-homes-command: true
  enable-warps-command: true
  enable-set-home-gui: true
  delete-home-confirmation: true
  admin-search-exact-match: false
  ask-create-home-if-empty: true

# ==============================================================================
#  No Homes GUI
# ==============================================================================
no-homes-gui:
  title: "&8No Homes Set"
  fill-background: true
  background-material: BLACK_STAINED_GLASS_PANE
  background-name: " "
  create-item:
    material: LIME_WOOL
    name: "&aCreate Home"
    lore:
      - "&7Click to create a home"
      - "&7at your current location."
  close-item:
    material: RED_WOOL
    name: "&cClose"
    lore:
      - "&7Close this menu."

# ==============================================================================
#  Messages
# ==============================================================================
messages:
  no-homes: "&cYou do not have any homes set."
  no-warps: "&cThere are no warps set."
  deleted: "&cDeleted home &e%home%&c."
  confirm-delete-title: "&4Delete %home%?"
  no-permission: "&cYou do not have permission to use this command."
  only-players: "&cOnly players can use this command."
  reload-success: "&aEGUI configuration reloaded!"
  usage: "&eUsage: /egui reload"
  invalid-home: "&cThat home does not exist."
  invalid-material: "&cInvalid item name."
  icon-set-success: "&aSuccessfully set the icon for &e%home%&a to &e%material%&a."
  icons-disabled: "&cCustom home icons are disabled."
  feature-disabled: "&cThis feature is currently disabled."
  sethome-success: "&aYour new home &e%home%&a was added!"
  sethome-invalid-name: "Enter a valid name"
  sethome-no-spaces: "No spaces allowed"
  player-not-found: "&cPlayer not found."
  admin-teleport-home: "&aTeleported to &e%player%&a's home: &e%home%&a."
  admin-delete-home: "&cDeleted &e%player%&c's home: &e%home%&c."
  admin-confirm-delete-title: "&4Delete &e%player%'s &4%home%?"
  admin-player-head-lore: "&7Click to view homes"

# ==============================================================================
#  Admin Panel Items
# ==============================================================================
admin-panel-items:
  background-item:
    material: BLACK_STAINED_GLASS_PANE
    name: " "
    lore: []
  search-online-button:
    material: NAME_TAG
    name: "&aSearch Online Player"
    lore:
      - "&7Click here to filter"
      - "&7all online players."
  search-offline-button:
    material: COMPASS
    name: "&cSearch Offline Player"
    lore:
      - "&7Click here to find"
      - "&7a specific offline player."
  back-button:
    material: BARRIER
    name: "&cBack to Admin Panel"
    lore: []

Пример настройки варпа

Чтобы дать варпу "spawn" уникальную иконку, добавьте в warps.yml:

warps:
  spawn:
    material: NETHER_STAR
    name: "&b&lSpawn"
    lore:
      - "&7Return to the main spawn."

Установка

  1. Скачайте файл EGUI-2.1.1.jar.
  2. Убедитесь, что EssentialsX уже установлен и работает на вашем сервере.
  3. Поместите JAR в папку plugins сервера.
  4. Перезапустите сервер (или используйте плагин-загрузчик) для генерации конфигурационных файлов.
  5. Настройте plugins/EGUI/config.yml под свой сервер.
  6. По желанию добавьте иконки для варпов в plugins/EGUI/warps.yml.
  7. Введите /egui reload в игре, чтобы применить изменения.

Как работает модульная система

EGUI 2.1.1 содержит два встроенных модуля в одном JAR:

МодульВерсии PaperМетод ввода
Legacy1.21.1 - 1.21.6AnvilGUI (WesJD)
Dialog1.21.7+ и 26.xPaper Dialog API

При запуске EGUI определяет версию Minecraft и загружает подходящий провайдер. Вы можете принудительно выбрать модуль в config.yml:

module-selection: auto   # auto, legacy или dialog

Изменение применяется через /egui reload. Если новый модуль не загружается, остаётся активным текущий.

bStats

EGUI использует bStats для анонимного сбора статистики: количество игроков, версия Minecraft, Java, софт сервера и т.д. Никакие IP-адреса или данные игроков не передаются.

Часто задаваемые вопросы

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

Minecraft: Java Edition

26.1.x1.21.x

Платформы

Поддерживаемые окружения

Сервер

Ссылки


Создатели

Детали

Лицензия:
Опубликован:5 месяцев назад
Обновлён:3 месяца назад
Главная