PlayerVaultZ

На любом сервере Майнкрафт рано или поздно встает вопрос нехватки места в сундуках. Игроки копят ресурсы, а количество доступных блоков хранения ограничено. Плагин PlayerVaultZ решает эту проблему, предоставляя каждому игроку личное виртуальное хранилище с неограниченным количеством страниц (при наличии прав). Это не просто замена сундука, а полноценная система с сортировкой, поиском, защитой от черного списка и возможностью миграции с популярного PlayerVaultsX.

PlayerVaultZ - это современный, быстрый и гибкий плагин для серверов Minecraft, который работает на асинхронном вводе-выводе и использует SQLite в качестве базы данных. Он идеально подходит как для небольших проектов, так и для крупных серверов с сотнями игроков.

Основные возможности

• Пагинация - многостраничный интерфейс с интуитивно понятной навигацией. Игрок может открывать разные страницы своего хранилища, а администратор может настраивать количество доступных страниц через права.
• Сортировка - продвинутые режимы организации предметов: по типу, названию, количеству и т.д. Хранилище всегда будет в порядке.
• Умный поиск - мгновенный поиск по названию предмета в интерфейсе, похожем на наковальню. Результаты кликабельны - можно сразу перейти на нужную страницу и слот с предметом.
• Импорт из PlayerVaultsX - бесшовная миграция данных. Просто поместите .yml файлы в папку импорта и выполните команду. Все предметы будут перенесены с сохранением структуры.
• Права доступа - гибкая система пермишенов: можно ограничить количество страниц для каждого игрока, разрешить просмотр чужих хранилищ, сортировку, импорт и администрирование.
• Производительность - асинхронные операции, легковесный бэкенд, никаких лагов даже при большом количестве одновременных запросов.

Защита и безопасность

Система черного списка

Плагин позволяет заблокировать определенные предметы, которые нельзя хранить в виртуальных сундуках. Можно фильтровать по материалу, кастомному названию, описанию (lore) или NBT-тегам. Администраторы могут обходить ограничения.

Вот пример настройки черного списка:

# Настройки черного списка
blacklist:
  # Включить черный список
  enabled: true
  
  # Список материалов, которые нельзя хранить
  # Используйте названия материалов из документации Spigot
  materials:
    - BEDROCK
    - COMMAND_BLOCK
    - COMMAND_BLOCK_MINECART
    - CHAIN_COMMAND_BLOCK
    - REPEATING_COMMAND_BLOCK
    - STRUCTURE_BLOCK
    - STRUCTURE_VOID
    - BARRIER
    - DEBUG_STICK
    - KNOWLEDGE_BOOK
    - SPAWNER
    - SHULKER_BOX
    - WHITE_SHULKER_BOX
    - ORANGE_SHULKER_BOX
    - MAGENTA_SHULKER_BOX
    - LIGHT_BLUE_SHULKER_BOX
    - YELLOW_SHULKER_BOX
    - LIME_SHULKER_BOX
    - PINK_SHULKER_BOX
    - GRAY_SHULKER_BOX
    - LIGHT_GRAY_SHULKER_BOX
    - CYAN_SHULKER_BOX
    - PURPLE_SHULKER_BOX
    - BLUE_SHULKER_BOX
    - BROWN_SHULKER_BOX
    - GREEN_SHULKER_BOX
    - RED_SHULKER_BOX
    - BLACK_SHULKER_BOX
  
  # Список предметов по кастомному названию (поддерживаются цветовые коды)
  custom-names:
    - "&cAdmin Item"
    - "&4Banned Item"
  
  # Список предметов, в описании которых содержится текст
  lore-contains:
    - "SOULBOUND"
    - "Quest Item"
    - "Cannot be stored"
  
  # Список NBT-тегов: предметы с такими тегами будут заблокированы
  nbt-tags:
    - "AdminItem"
    - "NoVault"
  
  # Сообщение, которое увидит игрок при попытке положить запрещенный предмет
  message: "&cЭтот предмет нельзя хранить в хранилище!"
  
  # Разрешить администраторам обходить черный список
  admin-bypass: true

Автоматическое резервное копирование

PlayerVaultZ автоматически создает сжатые бекапы (.yml.gz) при закрытии хранилища или входе игрока. Можно настроить количество хранимых копий и период их хранения. В случае потери данных есть интерфейс восстановления: можно просмотреть историю бекапов для каждого хранилища, увидеть содержимое и выборочно восстановить страницы и предметы.

Экстренное восстановление

Если система обнаруживает потерю данных (например, повреждение файла), она автоматически делает предварительный бекап перед восстановлением, чтобы ничего не потерять.

Настройка внешнего вида

• GUI дизайнер - полностью настраиваемая панель навигации: можно менять фоновые иконки, заголовки, плейсхолдеры и звуки.
• Стили навигации - выбирайте между стрелками, книгами, головами игроков или собственными иконками.
• Кастомные предметы - нативная поддержка Nexo, ItemsAdder и Oraxen с автоматическим переходом на ванильные текстуры, если кастомный предмет недоступен.
• Звуковая система - настраиваемые звуковые эффекты на все действия: открытие, закрытие, сортировка, поиск, перемещение предметов.

Команды

• /pv - открыть первое хранилище
• /pv <номер> - открыть конкретное хранилище
• /pv <игрок> <номер> - открыть хранилище другого игрока (требуется право)
• /pv search [термин] - запустить интерфейс поиска или сразу найти по слову
• /pvadmin - административная панель управления
• /pvimport playervaultsx - запустить миграцию из PlayerVaultsX

Миграция из PlayerVaultsX

1. Поместите .yml файлы PlayerVaultsX в папку plugins/PlayerVaultZ/import/playervaultsx
2. Выполните команду /pvimport playervaultsx
3. Ход выполнения отобразится в чате с итоговой статистикой

Рекомендуется сначала протестировать миграцию на данных одного игрока, чтобы убедиться, что все предметы переносятся корректно.

Права доступа (Permissions)

• playervaultz.use - доступ к хранилищу (по умолчанию true)
• playervaultz.vaults.N - количество доступных хранилищ (например, playervaultz.vaults.5)
• playervaultz.other - просмотр чужих хранилищ (админ)
• playervaultz.sort - разрешить сортировку (по умолчанию true)
• playervaultz.sort.others - сортировка чужих хранилищ (админ)
• playervaultz.import - выполнение импорта (админ)
• playervaultz.admin - полный административный доступ
• playervaultz.blacklist.bypass - обход черного списка (админ)
• playervaultz.unlimited.vaults - неограниченное количество хранилищ

Быстрый старт

1. Скачайте плагин PlayerVaultZ и поместите JAR-файл в папку plugins/ вашего сервера Minecraft.
2. Настройте права доступа через вашу систему управления пермишенами (например, LuckPerms).
3. Отредактируйте GUI-элементы в config.yml под свой стиль.
4. При необходимости импортируйте данные из PlayerVaultsX.

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