LilBackPacks

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

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