CustomGuiReworked

Плагин CustomGuiReworked для Minecraft 26.3

CustomGuiReworked — это современный каркас для создания кастомных интерфейсов инвентаря на серверах Minecraft, работающих на платформе Paper (версии 26.2+) и Purpur. Плагин позволяет администраторам и разработчикам создавать полностью персистентные инвентари, привязывать их к блокам и использовать в качестве библиотеки для собственных плагинов. Основное преимущество — отсутствие мерцания интерфейса и гарантия сохранения данных благодаря использованию инвентаря игрока вместо стандартного окна инвентаря.

Визуальный редактор и управление

Плагин предоставляет интуитивно понятный визуальный редактор, доступный через в-игровые команды. Администратор может создать новый интерфейс, изменить его структуру или отредактировать существующий, используя команды /gui create, /gui edit и /gui open. Менеджер /gui открывает главное меню управления с возможностью поиска по чату и пагинации. В процессе создания можно настроить размер сетки (от 9 до 54 слотов), выбрать тип скелета слота, задать заголовок и привязать кастомные блоки. Все изменения сохраняются мгновенно без необходимости перезагрузки сервера.

Система слотов и защита от дублирования

Каждый слот в интерфейсе имеет определенный тип, который определяет его поведение: DESIGN (только для просмотра), CONTAINER (хранение), CRAFT (ингредиент), RESULT (результат крафта) и FUEL. Система использует скрытые метки и лимиты стека для защиты слотов типа DESIGN от кражи предметов. Слоты RESULT защищены от любых методов вставки, включая использование мыши или клавиатуры. Двойной клик работает как в ванильном Minecraft, но с исключением слотов DESIGN и RESULT.

Типы хранения данных

Плагин поддерживает пять типов хранения данных, каждый из которых предназначен для конкретных сценариев использования. Тип BLOCK привязывает данные к конкретному блоку в мире, что идеально подходит для сундуков и печей. Тип PERSONAL хранит данные для каждого игрока отдельно, как личный сейф. Тип GLOBAL создает общесерверное хранилище, например, для аукциона. Тип TEAM привязывает данные к команде игроков по scoreboard. Тип TEMPORARY используется для сессий, где данные исчезают после закрытия интерфейса.

Производительность и безопасность

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

Интеграция с кастомными блоками

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

API для разработчиков

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

Поддержка Skript и Denizen

Плагин предоставляет специальные условия и выражения для скриптовых языков Skript и Denizen. Это позволяет легко создавать логику открытия и закрытия интерфейсов, обработки кликов и перетаскивания предметов. В Skript доступны условия on cgui open, on cgui click и выражения для работы с данными. В Denizen реализованы аналогичные условия для автоматизации игровых процессов.

Настройка конфигурации

Плагин создает конфигурационный файл config.yml при первой установке. В нем можно настроить автоматическое сохранение, максимальное количество кэшированных просмотров, время слияния записей и интеграцию с Skript и Denizen. Также можно изменить поведение выполнения команд от имени оператора и другие параметры производительности.

Связанные материалы

• Multiverse-Inventories — похожий плагин
• UberEnchant — похожий плагин
• ExcellentEconomy — похожий плагин
• CraftEngine — похожий плагин

Автор: AMPEMETER · Лицензия: MIT