LilBackpacks 🎒

A lightweight yet powerful backpack plugin for Spigot and Paper servers that puts customization at your fingertips!

🌟 Highlights

• Multiple Backpack Types - Create unlimited backpack variants with custom sizes and appearances
• Enterprise Data Protection - Atomic writes & automatic backups prevent data loss
• Resource Pack Ready - Full support for custom model data
• Flexible Storage - Choose between YML, JSON, SQLite, or MySQL
• Full Localization - Supports MiniMessage, legacy colors, and PlaceholderAPI
• Custom Crafting - Design unique recipes for each backpack type
• Nexo Compatible - Seamlessly integrate with Nexo items

📦 Features in Detail

🔐 Data Safety

• Atomic File Operations - Server crashes won't corrupt your data
• 3-Layer Backup System:
  • Per-file .backup for instant recovery
  • Timestamped full backups on server start
  • Automatic rotation (keeps last 3 by default)
• Auto-Recovery - Automatically restores from backup if corruption detected
• Works Everywhere - YAML, JSON, MySQL, AND SQLite all protected!

Storage Options

• 📄 YML - Simple & human-readable with atomic writes
• 🔄 JSON - Compact & efficient with atomic writes
• 📱 SQLite - Single-file database with transactions
• 🌐 MySQL - Perfect for networks with transaction support

Customization

• 🎨 Custom names & lore
• 📐 Adjustable inventory sizes (up to 54 slots)
• 🛠️ Custom crafting recipes with backpack upgrades
• 💬 Fully customizable messages
• 🎵 Configurable sounds & particle effects
• 🚫 Advanced restrictions (world blacklist, combat lock, max per player)

Protection Rules

• 🚫 Prevent backpacks as fuel
• ⚔️ Control crafting usage
• 🌍 Block in specific worlds
• ⚔️ Disable during combat
• 📊 Set max backpacks per player

Performance

• ⚡ Config caching for instant access
• 💾 Auto-save system for open backpacks
• 🔄 Smart retry logic for failed saves
• 🐛 Debug mode for troubleshooting

🎮 Basic Commands

| Command | Description | Permission |
| --------------------------- | -------------- | --------------------- |
| /lbp | Open admin GUI | lilbackpacks.admin |
| /lbp give <player> <type> | Give backpack | lilbackpacks.give |
| /lbp reload | Reload config | lilbackpacks.reload |

Note: Right-click any backpack to open it!

⚡ Quick Start

1. Download LilBackpacks
2. Drop into plugins folder
3. Start your server
4. Configure in /plugins/LilBackpacks/
5. /lbp reload to apply changes

🔧 Sample Configuration

backpacks:
  explorer_pack:
    item:
      material: CHEST
      custom-model-data: 1001
      display-name: "&6Explorer's Backpack"
      lore:
        - "&7Perfect for your adventures!"
        - "&7Size: &645 slots"
    gui:
      title: "&6Explorer's Pack"
      rows: 5
    rules:
      prevent-furnace-burn: true
    recipe:
      enabled: true
      shape:
        - "LWL"
        - "WCW"
        - "LWL"
      ingredients:
        L: LEATHER
        W: WHITE_WOOL
        C: CHEST

Advanced Settings

# Auto-Save Configuration
storage:
  auto-save:
    enabled: true
    interval: 300  # Seconds
    async: true
  backup:
    enabled: true
    rotation-count: 3

# Backpack Restrictions
backpack:
  restrictions:
    max-backpacks-per-player: 3
    blocked-worlds:
      - "world_pvp"
    disabled-in-combat: true
    combat-timer: 5

# Sounds & Effects
backpack:
  sounds:
    enabled: true
    open: "BLOCK_CHEST_OPEN"
    volume: 1.0
  effects:
    particles:
      enabled: true
      type: "PORTAL"

🔗 Links

• 💬 Discord Support