ModularPacks (МодуларПакс)

Плагин для серверов Майнкрафт на Paper, добавляющий настоящие переносные рюкзаки с улучшениями. Рюкзак является предметом: его можно носить, открывать, ставить в мире, передавать другим игрокам и использовать совместно, а ванильным клиентам не нужны моды.

Возможности

• Рюкзаки имеют собственный постоянный идентификатор, а их содержимое, установленные модули и данные общего доступа хранятся в SQLite.
• В стандартной конфигурации есть кожаный, медный, железный, золотой, алмазный и незеритовый рюкзаки. Для каждого задаются вместимость, число слотов улучшений, название, описание, цвет, модель и рецепт.
• Рюкзаки можно ставить в мире; внешний вид размещённого предмета, его положение, поворот и масштаб настраиваются.
• Общий рюкзак позволяет нескольким игрокам работать с одним содержимым; лимит участников задаётся в конфиге.
• Улучшения добавляют полезные функции: притягивание предметов, неразрушимость, резервуары для жидкостей и опыта, автопитание, пополнение инвентаря, удаление отфильтрованных предметов с возможностью восстановления, переноску вёдер и опыта.
• Рабочие улучшения дают переносной верстак, печь, плавильную печь, коптильню, камнерез, наковальню, кузнечный стол, проигрыватель, а также автоматический крафт.
• Администраторы могут выдавать, просматривать, открывать, менять тип и восстанавливать рюкзаки, в том числе у игроков не в сети.
• Другие плагины могут добавлять собственные улучшения через API.

Команды

Основная команда: /backpack.

• /backpack help [command] — справка по доступным командам.
• /backpack give type <typeId> [player] [amount] — выдать рюкзак указанного типа.
• /backpack give module <upgradeId> [player] [amount] — выдать улучшение.
• /backpack recipe backpack <typeId> [variantId] — показать рецепт рюкзака.
• /backpack recipe module <upgradeId> — показать рецепт улучшения.
• /backpack list [playerName [menu] | unowned] — список сохранённых рюкзаков; с menu открывается меню выбора.
• /backpack open <uuid> или /backpack open <player> <Type#N> — открыть рюкзак для проверки или помощи игроку.
• /backpack settype <typeId> [--force] — сменить тип рюкзака в основной руке. Параметр --force может обрезать предметы, не помещающиеся после уменьшения вместимости.
• /backpack reload [config|lang|recipes|all] — перезагрузить конфиг, язык, рецепты или всё сразу.
• /backpack recover backpack <player> <backpackUuid> — восстановить рюкзак.
• /backpack recover void <player|uuid> list [limit] [all] — посмотреть предметы, удалённые модулем Void.
• /backpack recover void <player|uuid> <id|latest> [receiver] — вернуть удалённый предмет.

Игрок открывает рюкзак правой кнопкой мыши. В меню модулей обычно используются левая кнопка для открытия или настройки, правая — для дополнительного действия или смены режима, Shift + ЛКМ — для включения модуля, Shift + ПКМ — для снятия. Поведение зависит от конкретного улучшения.

Права

• modularpacks.command — основная команда /backpack.
• modularpacks.recipe — просмотр рецептов.
• modularpacks.open — открытие рюкзаков.
• modularpacks.place — размещение рюкзаков в мире.
• modularpacks.pickup — поднятие размещённых рюкзаков.
• modularpacks.reload — перезагрузка настроек, языков и рецептов.
• modularpacks.admin — административные инструменты.
• modularpacks.update.notify — уведомления проверщика обновлений.

Настройка

Главный файл — plugins/ModularPacks/config.yml; текстовые сообщения находятся в plugins/ModularPacks/lang/en_us.yml.

В BackpackTypes: задаются типы рюкзаков: Rows, UpgradeSlots, CraftingRecipe, OutputMaterial, DisplayName, Lore, CustomModelData, DefaultColor и SkullData. Рецепт может быть обычным крафтом или улучшением на кузнечном столе, а его ингредиентами могут служить другие рюкзаки и улучшения: BACKPACK:<TypeId>, <TYPE>_BACKPACK, MODULE:<UpgradeId>, UPGRADE:<UpgradeId>.

В Upgrades: настраиваются улучшения, их рецепты, предметы, описание, включение, переключение и специальные параметры — например, радиус магнита, режим автопитания или работу насосов.

Полезные общие параметры:

• ResizeGUI — динамический размер страниц меню.
• AutoCloseOnTeleport — закрытие рюкзака при телепортации.
• AllowShulkerBoxes и AllowBundles — разрешение шалкеров и мешков внутри рюкзака.
• BackpackInsertBlacklist — список материалов, которые нельзя положить в рюкзак; его учитывает и Magnet.
• Placeable — возможность ставить рюкзаки в мире.
• DropPlacedBackpacksOnExplosion — выпадение поставленных рюкзаков после взрыва.
• SharedBackpacks.Enabled и SharedBackpacks.MaxSharedUsers — общий доступ и лимит пользователей.
• Debug.ClickLog — журнал действий с меню в plugins/ModularPacks/click-events.log для поиска проблем.

Для моделей рюкзаков и улучшений можно назначить CustomModelData и подключить свой ресурс-пак. Подойдёт и ресурс-пак ModularPacks Resources; без ресурс-пака плагин использует обычные предметы и головы игроков.

Требования

Плагин рассчитан на Paper и совместимые с его API серверы; требуется Java 21. Данные хранятся локально в plugins/ModularPacks/backpacks.db, поэтому отдельная база данных не нужна.