
EssentialsX GUI
EGUI - мощный графический интерфейс для домов и варпов EssentialsX на серверах Paper. Полная настройка, админ-панель, один JAR для всех версий 1.21.1+.
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.6 | Java 21 | AnvilGUI (ввод текста) |
| 1.21.7 - 1.21.11 | Java 21 | Paper Dialog API |
| 26 и новее | Java 25 | Paper 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.admin | OP |
| /warps | Открыть меню варпов | egui.warps | Все |
| /egui reload | Перезагрузить конфигурацию | egui.reload | OP |
| /egui status | Статус плагина и версия | egui.status | OP |
Конфигурация (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."
Установка
- Скачайте файл EGUI-2.1.1.jar.
- Убедитесь, что EssentialsX уже установлен и работает на вашем сервере.
- Поместите JAR в папку plugins сервера.
- Перезапустите сервер (или используйте плагин-загрузчик) для генерации конфигурационных файлов.
- Настройте plugins/EGUI/config.yml под свой сервер.
- По желанию добавьте иконки для варпов в plugins/EGUI/warps.yml.
- Введите /egui reload в игре, чтобы применить изменения.
Как работает модульная система
EGUI 2.1.1 содержит два встроенных модуля в одном JAR:
| Модуль | Версии Paper | Метод ввода |
|---|---|---|
| Legacy | 1.21.1 - 1.21.6 | AnvilGUI (WesJD) |
| Dialog | 1.21.7+ и 26.x | Paper Dialog API |
При запуске EGUI определяет версию Minecraft и загружает подходящий провайдер. Вы можете принудительно выбрать модуль в config.yml:
module-selection: auto # auto, legacy или dialog
Изменение применяется через /egui reload. Если новый модуль не загружается, остаётся активным текущий.
bStats
EGUI использует bStats для анонимного сбора статистики: количество игроков, версия Minecraft, Java, софт сервера и т.д. Никакие IP-адреса или данные игроков не передаются.
