Expendable Backpacks

Комплексная система рюкзаков, включающая восемь прогрессивных уровней, улучшаемое хранилище, устанавливаемые рюкзаки-блоки и уникальный Enderpack с общим инвентарем.

Expendable Backpacks - это плагин для серверов Minecraft, который решает извечную проблему нехватки места в инвентаре. Вместо того чтобы таскать с собой сундуки или ставить их в мире, игроки могут использовать рюкзаки, которые можно носить с собой, ставить на землю и даже объединять в общее хранилище с помощью Enderpack. Плагин идеально подходит для выживания, мини-игр и RPG-серверов, где организация хранения - ключ к комфортной игре.

Особенности

• Восемь уровней - от базового Dirt Backpack (9 слотов) до премиального Netherite Backpack (54 слота)
• Устанавливаемые рюкзаки - ставьте рюкзаки как блоки в мире с помощью Shift + ПКМ
• Система Enderpack - уникальное общее хранилище для нескольких Enderpack с идентификацией по UUID
• Стартовый рюкзак - выдавайте Leather Backpack новым игрокам при первом входе
• Улучшения с сохранением содержимого - окружите рюкзак материалом, и он улучшится, не потеряв вещи
• Защита от вложенности - умная система не позволяет складывать рюкзаки внутрь других рюкзаков
• Интерактивный GUI-гид - встроенная визуальная подсказка со всеми рецептами и путями улучшения
• Кастомные текстуры - красивые текстуры голов игроков для каждого уровня с цветными названиями
• Постоянное хранение - всё содержимое автоматически сохраняется с привязкой к UUID
• Клонирование Enderpack - создавайте несколько точек доступа к одному общему инвентарю
• Полная защита - установленные рюкзаки защищены от взрывов, поршней, огня и лавы
• Оптимизация производительности - эффективное кэширование инвентаря и асинхронное сохранение
• Tab-дополнение - полная поддержка автодополнения для всех команд и UUID

Уровни рюкзаков

Уровень	Хранилище	Материал для улучшения
Dirt Backpack	9 слотов (1 ряд)	Окружение землёй
Leather Backpack	9 слотов (1 ряд)	Начальный уровень
Copper Backpack	18 слотов (2 ряда)	8x медный слиток
Iron Backpack	27 слотов (3 ряда)	8x железный слиток
Gold Backpack	36 слотов (4 ряда)	8x золотой слиток
Diamond Backpack	45 слотов (5 рядов)	8x алмаз
Netherite Backpack	54 слота (6 рядов)	Кузнечный стол
Enderpack	27 слотов (3 ряда)	Общее хранилище

Устанавливаемые рюкзаки

Рюкзаки можно ставить в мире как декоративные блоки, при этом они сохраняют всю функциональность!

Как это работает

• Установка: держите рюкзак и нажмите Shift + ПКМ по любой поверхности
• Открытие: ПКМ по установленному рюкзаку, чтобы открыть его инвентарь
• Разрушение: сломайте блок, чтобы забрать рюкзак со всем содержимым
• Защита: установленные рюкзаки полностью защищены от:
  • Взрывов (крипер, TNT и т.д.)
  • Поршней (толкание/тяга)
  • Огня и лавы
  • Взрывов блоков (кровати, якоря возрождения)

Варианты использования

• Складские комнаты - создайте организованные зоны хранения с видимыми уровнями рюкзаков
• Декор базы - выставляйте напоказ коллекцию высокоуровневых рюкзаков
• Точки быстрого доступа - размещайте рюкзаки в стратегических местах вокруг базы
• Командное хранилище - ставьте общие Enderpack в общих зонах
• Магазины и торговля - создавайте витрины с рюкзаками на рыночных площадях

Важно знать

• Установленные рюкзаки сохраняют UUID - предметы остаются на своих местах
• Разрушение и повторная установка не влияют на содержимое
• Enderpack работают так же и при установке - все копии имеют общий инвентарь
• Вы по-прежнему можете открывать рюкзаки в руке обычным ПКМ

Enderpack - особенный уровень

Enderpack предоставляет уникальную функциональность, недоступную другим уровням:

• Общее хранилище - все Enderpack с одинаковым UUID имеют доступ к одному и тому же инвентарю
• Клонирование - скрафтите 1 Enderpack + 1 жемчуг Края = 2 Enderpack с одинаковым UUID
• Несколько точек доступа - держите один в инвентаре, один на базе, делитесь с товарищами
• Работает при установке - установленные как блоки Enderpack всё ещё имеют общий инвентарь
• Идеально для команды - координируйте общее хранилище между несколькими игроками
• Доступ из любой точки - получайте доступ к одному и тому же инвентарю откуда угодно

Пример использования

1. Скрафтите Enderpack
2. Клонируйте его, объединив с жемчугом Края (получится 2 Enderpack с одинаковым UUID)
3. Держите один в инвентаре для доступа на ходу
4. Установите один как блок на базе для быстрого доступа
5. Дайте один товарищу
6. Все три получают доступ к одному и тому же хранилищу на 27 слотов - даже установленный!

Настройка

Плагин использует конфигурационный файл plugins/ExpendableBackpacks/config.yml для настройки сервера.

Стартовый рюкзак

Выдавайте Leather Backpack новым игрокам при первом входе на сервер:

# Выдавать Leather Backpack игрокам при первом входе на сервер
# По умолчанию: false
give-backpack-on-first-join: false

# Сообщение, которое получают игроки при получении стартового рюкзака
# Используйте & для цветовых кодов (например, &a для зелёного, &6 для золотого)
# Установите пустую строку (""), чтобы отключить сообщение
starter-backpack-message: "&7Добро пожаловать! Вы получили &7Leather Backpack &7для начала. Нажмите ПКМ, чтобы открыть!"

Особенности:

• Срабатывает только для игроков, заходящих впервые
• Автоматически добавляет рюкзак в инвентарь
• Выпадает на землю, если инвентарь заполнен
• Настраиваемое приветственное сообщение с поддержкой цветовых кодов
• По умолчанию отключено - включите в конфиге

Установка и совместимость

1. Скачайте последнюю версию JAR-файла плагина
2. Поместите его в папку /plugins/ вашего сервера
3. Перезапустите сервер или используйте плагин-лоадер
4. Используйте /backpack для доступа к внутриигровому гиду
5. Настройте стартовый рюкзак в plugins/ExpendableBackpacks/config.yml (опционально)

Требования

• Серверное ПО: Paper, Spigot, Purpur или Folia
• Версия Minecraft: 1.21 или выше
• Java: 21 или выше

Команды и разрешения

Команды

Все команды поддерживают алиас /bp для быстрого доступа.

Команда	Описание	Разрешение
/backpack	Открыть интерактивный GUI-гид	backpack.use
/backpack help	Показать справку	backpack.use
/backpack give <игрок> <уровень>	Выдать рюкзак игроку	backpack.give
/backpack open <uuid>	Открыть рюкзак по UUID	backpack.openOthers
/backpack clear <uuid>	Очистить содержимое рюкзака	backpack.clear
/backpack clone <uuid>	Создать клон Enderpack	backpack.clone

Разрешения

Разрешение	Описание	По умолчанию
backpack.use	Использовать команду /backpack и открывать свои рюкзаки	Все
backpack.give	Выдавать рюкзаки игрокам	OP
backpack.openOthers	Открывать любой рюкзак по UUID	OP
backpack.clear	Очищать содержимое рюкзаков	OP
backpack.clone	Клонировать Enderpack	OP
backpack.admin	Все административные разрешения	OP

Рецепты крафта

Leather Backpack (начальный)

L S L
L C L
L L L

• L = кожа, S = нить, C = сундук

Enderpack (особый рецепт)

E P E
P C P
E I E

• E = око Края, P = жемчуг Края, C = сундук, I = железный блок

Улучшения

Окружите свой рюкзак 8 единицами материала улучшения:

• Leather -> Copper: 8x медный слиток
• Copper -> Iron: 8x железный слиток
• Iron -> Gold: 8x золотой слиток
• Gold -> Diamond: 8x алмаз
• Diamond -> Netherite: кузнечный стол (шаблон незеритового улучшения + алмазный рюкзак + незеритовый слиток)

Важно: все улучшения сохраняют ваши предметы и UUID!

Технические детали

Хранение данных

• Рюкзаки хранятся в plugins/ExpendableBackpacks/backpacks.yml
• Идентификация на основе UUID для каждого экземпляра рюкзака
• Установленные рюкзаки хранят UUID в PersistentDataContainer блока
• Автоматическая сериализация инвентаря
• Данные сохраняются между перезапусками сервера

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

• Эффективная система кэширования инвентаря
• Асинхронное сохранение данных
• Оптимизированная обработка взаимодействий с блоками
• Оптимизировано для крупных серверов
• Минимальное использование ресурсов

Технические детали установленных рюкзаков

• Устанавливаются как блоки голов игроков с кастомными текстурами
• UUID и уровень хранятся в NBT блока (PersistentDataContainer)
• Используются те же NamespacedKeys, что и для предметов, для согласованности
• Полная обработка событий для всесторонней защиты