Backpack plugin

🎒 Backpack

Supported Loaders: Bukkit, Spigot, Paper, Purpur, Folia Supported Versions: 1.21.x, 26.1.x, 26.2.x (Java 21+)

🔌 Compatibility & Core Support

✨ Features

• 6 backpack sizes — from 1 row (9 slots) up to 6 rows (54 slots)
• Permission-based sizing — the plugin automatically gives players the largest backpack they have permission for
• Death clearing — backpack items are lost on death by default (configurable with backpack.keep permission)
• Admin tools — view and edit any player's backpack in real-time, even when they're offline
• Per-player storage — each player's backpack is stored separately for maximum performance
• Async saving — all file I/O runs off the main thread to prevent lag
• Auto-save — periodic saves to prevent item loss (configurable interval)
• MiniMessage support — full hex color, gradient, and rich text formatting in all messages
• PlaceholderAPI support — use any PAPI placeholder in the backpack title (optional)
• Sound effects — configurable open/close sounds
• Fully configurable — every message, title, sound, and interval can be changed in config.yml
• Lightweight — no dependencies required, optimized for large servers

📋 Commands

🔐 Permissions

Player Permissions

How it works: The plugin automatically detects the highest row permission a player has.

For example, if a player has backpack.row.1, backpack.row.2, and backpack.row.3, their backpack will be 27 slots (3 rows).

If a player has no backpack.row.* permission, the /backpack command will not open and they will see a "no permission" message.

Death Behavior

By default, when a player dies, their backpack contents are cleared. To let certain players (e.g. donors, VIPs) keep their backpack items on death, grant them the backpack.keep permission.

Admin Permissions

⚙️ Configuration

The plugin generates a fully commented config.yml on first run. Here are the key options:

All messages support MiniMessage formatting including hex colors like <color:#FF5555> and gradients like <gradient:#FF6B6B:#4ECDC4>.

📦 Installation

1. Choose the matching JAR file for your server loader and version from the versions folder:
   • For Paper / Purpur / Folia / Spigot / Bukkit
   • For 1.21.x / 26.1.x / 26.2
2. Place it in your server's plugins/ folder (or equivalent mods/plugins directory)
3. Restart your server
4. Edit plugins/Backpack/config.yml to customize messages and settings
5. Use your permissions plugin (e.g., LuckPerms) to grant backpack.row.* permissions to players

Example LuckPerms setup:

/lp group default permission set backpack.row.3 true    # All players get 3 rows
/lp group vip permission set backpack.row.6 true        # VIPs get 6 rows
/lp group vip permission set backpack.keep true          # VIPs keep items on death

💾 Storage

Each player's backpack is stored as an individual YAML file:

plugins/Backpack/data/<uuid>.yml

This means:

• ✅ No database setup needed
• ✅ Easy to backup and migrate
• ✅ No performance issues with large player counts
• ✅ All saves happen asynchronously (no lag)

❓ FAQ

Q: What happens if the server crashes? A: The plugin auto-saves all backpacks periodically (default: every 5 minutes). On clean shutdown, everything is saved immediately.

Q: Can admins edit offline player backpacks? A: Yes! Use /backpack <playername> with the backpack.view permission to open and edit any player's backpack, even if they're offline.

Q: Does the plugin cause lag? A: No. All file operations run asynchronously. The plugin is designed for servers with hundreds of players.

Q: Is PlaceholderAPI required? A: No. PlaceholderAPI is optional. If installed, you can use any PAPI placeholder in the backpack title. The plugin works perfectly without it.

Q: Do players lose backpack items on death? A: Yes, by default. Grant the backpack.keep permission to let players keep their backpack items on death.

🔧 Support

If you encounter any issues, please report them with:

• Server version (/version)
• Plugin version
• Error logs from logs/latest.log
• Steps to reproduce the issue