Платно Плагин hClansStorageAddon [1.21.X-26.X] | Дополнение для плагина hClans v1.0

---

hClansStorageAddon добавляет в hClans общее предметное хранилище через команду /clan storage. Соклановцы могут пользоваться им одновременно, складывать общие ресурсы и забирать нужные предметы в пределах своих клановых прав.

Вместимость задаётся для каждого уровня клана, а страницы, кнопки и оформление полностью настраиваются.

---

• одно общее хранилище для каждого клана;
• одновременный доступ нескольких участников;
• отдельная вместимость для каждого уровня клана;
• страницы с кнопками переключения и информацией о хранилище;
• отображение заблокированных ячеек до открытия нужного уровня;
• раздельные проверки открытия, помещения и извлечения предметов;
• чёрный или белый список миров;
• настраиваемые алиасы подкоманды и показ в автодополнении;
• автоматическое сохранение предметов вместе с их метаданными;
• SQLite, MySQL, H2 и MariaDB через хранилище ядра hClans;
• настраиваемая очистка содержимого при удалении клана.

---

Количество доступных ячеек настраивается в settings.storage.slots.levels. В стандартной конфигурации:

• 1-й уровень — 9 предметных слотов;
• 5-й уровень — 45 предметных слотов;
• 10-й уровень — 84 предметных слота.

Стандартный интерфейс состоит из трёх страниц по 54 визуальные ячейки, из которых по 28 используются для хранения. Общая вместимость изменяется через количество страниц и список предметных слотов в gui.yml.

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

---

• hclansstorage.open — открытие хранилища;
• hclansstorage.put — помещение предметов;
• hclansstorage.take — извлечение предметов.

Это клановые права, назначаемые ролям hClans. Каждая проверка включается отдельно в permissions.yml; названия прав также изменяются в этом файле.

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

---

В gui.yml настраиваются заголовок, размер страницы, количество страниц, ячейки хранения, фон, заблокированные слоты и кнопки навигации.

Для предметов доступны материал, количество, расположение, приоритет, имя, lore, customModelData, свечение, скрытие подсказки, item flags и действия на нажатие.

Поддерживаются MiniMessage и переменные:

---

• /clan storage — открыть хранилище своего клана;
• /hclans reload — применить настройки через перезагрузку ядра и аддонов.

• config.yml — вместимость по уровням, миры, алиасы и очистка при удалении клана;
• permissions.yml — проверки клановых прав;
• gui.yml — страницы, предметные ячейки и оформление;
• actions.yml — сообщения и реакции на действия игрока.

Аддон использует подключение к базе данных и префикс таблиц ядра hClans. Загрузка и сохранение выполняются в отдельном потоке.

---

• Сервер: Paper 1.21.x;
• Java: 21;

1. Установите и настройте hClans.
2. Поместите hClansStorageAddon-1.0.jar в plugins/hClans/addons.
3. Перезапустите сервер или выполните /hclans reload.
4. Настройте файлы в plugins/hClans/addons/hClansStorageAddon.
5. Примените изменения через /hclans reload и откройте /clan storage.