CommunityVault

CommunityVault — это система глобального хранения ресурсов, предназначенная для совместного выживания на сервере. Игроки используют физические сундуки, организованные категории и систему поиска для управления общим складом.

CommunityVault обеспечивает игрокам единое пространство для совместного хранения предметов в рамках сервера. Система построена на использовании физических объектов — сундуков депозита и вывода, что позволяет сохранить погружение в игровой процесс, при этом данные хранятся в глобальной базе.

• Глобальное хранилище: просмотр содержимого в любом месте через команду /cvault (только для чтения).
• Сундуки депозита и вывода: возможность покупки через /buydc и /buywc с настраиваемой стоимостью.
• Автоматическая сортировка: предметы автоматически распределяются по категориям на основе их материала.
• Поиск по складу: команда /searchvault <термин> (алиас /sv) позволяет находить нужные ресурсы.
• Интерфейс с пагинацией: удобное меню с кнопками навигации по страницам и всплывающими подсказками.
• Ручная компактность: команда /cvaultcompact объединяет предметы в стаки (несортируемые объекты, такие как шалкеры, остаются нетронутыми).
• Команда статуса: /cvaultstatus отображает количество стаков, информацию о резервных копиях и текущую вместимость.
• Автоматизация: поддержка работы с воронками, раздатчиками и крафтерами для автоматического пополнения склада.
• Лимиты вместимости: возможность установить максимальный объем хранилища с уведомлениями при заполнении.
• Безопасность: система проверяет наличие свободного места в инвентаре перед выводом предметов, выполняя откат операции при нехватке места.

Процесс взаимодействия с хранилищем организован следующим образом:

1. Игрок покупает сундук депозита (/buydc) или сундук вывода (/buywc).
2. В сундук депозита выбрасываются предметы, которые автоматически сортируются в глобальное хранилище.
3. Из сундука вывода предметы можно забрать через интерфейс или найти с помощью поиска /sv <термин>, глядя на сундук.
4. Для автоматизации можно настроить выход воронки из сундука вывода (один выход на сундук).
5. Общий обзор склада доступен в любой точке мира через /cvault.

• Сундуки депозита могут связываться только с другими сундуками депозита.
• Сундуки вывода могут связываться только с другими сундуками вывода.
• Обычные сундуки не могут быть сопряжены со специальными сундуками (депозит/вывод).
• Воронки в сундуках вывода извлекают выбранный предмет вывода (буферизуется в центральном слоте).

Игроки могут управлять структурой категорий через иконку книги в меню хранилища:

• Переименование категорий и изменение их иконок.
• Редактирование состава предметов в категориях (доступно по умолчанию).
• Создание и удаление категорий (требует специальных прав доступа).
• Возможность принадлежности одного предмета к нескольким категориям одновременно.

Основные параметры в конфигурационном файле включают:

• diamondCostDepositChest / diamondCostWithdrawalChest — стоимость сундуков.
• maxVaultCapacityEnabled — включение лимита вместимости.
• maxVaultCapacity — значение лимита.
• allowHopperWithdrawal — разрешение на вывод через воронки.
• allowHopperDeposit — разрешение на депозит через воронки.
• allowDropperDeposit — разрешение на депозит через раздатчики.
• allowCrafterDeposit — разрешение на депозит через крафтеры.

Все данные хранилища и категории сохраняются в формате YAML в директории plugins/CommunityVault/. Плагин выполняет автоматическое резервное копирование при запуске и остановке сервера. Старые резервные копии удаляются автоматически через 14 дней.