PlayerVaultZ

!PlayerVaultZ Banner

⚡ Lightning-fast modern vault system with intelligent pagination, smart sorting, and instant search capabilities. Features seamless PlayerVaultsX migration in seconds.

✨ Core Features

• 📄 Pagination — Sleek multi-page interface with intuitive navigation controls
• 🔄 Sorting — Advanced organization modes for pristine vault management

!Sorting GIF

• 🔍 Smart Search — Instant anvil-based finder with clickable results that jump to exact vault/page/slot locations

!Searching GIF

• 📦 Import — Flawless PlayerVaultsX vault migration system
• 🔐 Permissions — Granular per-player limits and administrative oversight
• ⚡ Performance — Asynchronous I/O operations, SQLite backend, buttery-smooth experience

🛡️ Protection & Security

• 🚫 Blacklist System — Block items by material, custom name, lore, or NBT tags with configurable deny messages and admin bypass

# Blacklist settings
blacklist:
  # Enable item blacklist
  enabled: true
  
  # List of blacklisted materials that cannot be stored in vaults
  # Use Material names from https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html
  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
      
  # List of blacklisted items by custom name (supports color codes)
  # Items with these exact display names will be blocked
  custom-names:
    - "&cAdmin Item"
    - "&4Banned Item"
    
  # List of blacklisted items by lore (checks if lore contains this text)
  # Supports color codes
  lore-contains:
    - "SOULBOUND"
    - "Quest Item"
    - "Cannot be stored"
    
  # List of blacklisted NBT tags
  # Items with these NBT tags will be blocked
  nbt-tags:
    - "AdminItem"
    - "NoVault"
    
  # Message shown when a player tries to store a blacklisted item
  message: "&cThis item cannot be stored in vaults!"
  
  # Allow admins to bypass the blacklist
  admin-bypass: true

• 💾 Auto-Backup — Scheduled backups on vault close/player join with compressed .yml.gz storage and retention limits
• 🔄 Restore GUI — Browse backup history per vault, preview contents, selective item/page restoration with safety checks
• ⚠️ Emergency Recovery — Loss-detection triggers with pre-restore safety backups
• 🎨 Customization
• 🖼️ GUI Designer — Fully configurable navigation bars, filler items, custom titles/placeholders, and sound effects
• 🎯 Navigation Styles — Choose from arrows, books, player heads, or custom navigation icons
• ✨ Custom Items — Native support for Nexo, ItemsAdder, and Oraxen with automatic vanilla fallback
• 🔊 Sound System — Customizable audio feedback for all interactions

🎮 Commands

• /pv — Access primary vault
• /pv <#> — Open specific vault number
• /pv <#> — Browse another player's vault (permission required)
• /pv search [term] — Launch search interface or direct search
• /pvadmin — Administrative control panel
• /pvimport playervaultsx — Execute PlayerVaultsX migration

📥 Migration from PlayerVaultsX

1. Deploy .yml files to plugins/PlayerVaultZ/import/playervaultsx
2. Execute /pvimport playervaultsx to initialize migration
3. Progress tracking displays in chat with completion statistics

💡 Tip: Please make sure to test with one player vault data first, and then the rest to ensure all items are being captured and imported over properly. If you experience any issues during this process - report this to me!

🔑 Permissions

• playervaultz.use — Enable vault access (default: true)
• playervaultz.vaults.N — Grant N vault slots (e.g., playervaultz.vaults.5)
• playervaultz.other — Access other players' vaults (admin)
• playervaultz.sort — Enable vault sorting (default: true)
• playervaultz.sort.others — Sort other players' vaults (admin)
• playervaultz.import — Execute import commands (admin)
• playervaultz.admin — Full administrative suite
• playervaultz.blacklist.bypass — Bypass item restrictions (admin)
• playervaultz.unlimited.vaults — Unlimited vault access

🚀 Quick Start

1. Deploy JAR to plugins/ directory
2. Configure permissions via your management plugin
3. Customize GUI elements in config.yml
4. Optional: Import existing PlayerVaultsX data