SmartBackpackX

📦 SmartBackpackX Ultra

SmartBackpackX is the most comprehensive, secure, and highly customizable inventory extension plugin for modern Minecraft servers. Crafted specifically to eliminate item duplication, minimize server overhead, and deliver a premium player experience.

---

✨ Key Features

• 🔄 Hybrid Storage System — Choose between virtual menu-based storage collections and physical portable backpack items.
• 👥 Group Defaults (Rank-Based) — Automatically assign specific configurations (number of slots, sizes, templates, removable states) to players based on their permission groups. Supports inheritance/priority and additive modes!
• 🎨 Custom Templates — Define custom backpack tiers with unique icons (including custom Base64 heads, player heads, and HeadDatabase integration), capacities, descriptions, and custom item filters.
• 📥 Auto-Pickup — Ground items are collected directly into designated backpacks on pickup.
• 🗃️ Auto-Sorting — Sort your backpack contents instantly by Name, Type, or Amount using an audited, duplicate-safe sorting algorithm.
• 🚫 Item Filters & Blacklists/Whitelists — Set global item restrictions, per-template whitelists/blacklists, and let players customize their own whitelisted item filters in-game.
• 💾 Automatic & Manual Backups — Complete data recovery with automated interval backups, join/quit snapshots, compression, and manual backup triggers.
• 🛡️ Anti-Abuse Protection — Integrated combat lock, open cooldowns, nesting prevention (no backpacks in backpacks), and strict inventory storage category blockings.
• 🔌 Soft Dependencies — Supports PlaceholderAPI (for stats) and HeadDatabase (for hundreds of custom icons).
• 💾 Multiple Databases — Choose from YAML, SQLite, or high-performance MySQL (with connection pooling) backends.

---

🎮 Player Commands

Base Permission: backpack.use

Command	Description	Permission
/bp	Open your primary/selected backpack	backpack.use
/bp open [name]	Open a specific backpack by name or slot ranking	backpack.cmd.open
/bp select <name>	Select your default backpack for quick opening	backpack.use
/bp rename <old> <new>	Rename a backpack in your collection	backpack.use
/bp list	Open the virtual collection selector GUI	backpack.access.collection
/bp togglepickup [name]	Toggle the Auto-Pickup feature for a backpack	backpack.feature.autocollect
/bp help	View the command help menu	backpack.cmd.help

---

🔧 Admin Commands

Base Permission: backpack.admin

💡 Offline Player Support: All targeting commands below fully support offline players by UUID and name resolution!

Command	Syntax	Description	Permission
/bpa give	<player> <size> <name> [state] [template]	Give a backpack to a player (virtual or portable)	backpack.admin.give
/bpa clone	<player> <name> [target] [state]	Clone a backpack with all items inside it	backpack.admin.clone
/bpa inspect	<player> <list\|virtual\|portable> [name]	Open player selector GUI or inspect specific backpack	backpack.admin.inspect
/bpa list	<player>	Open a player’s backpack collection selector GUI	backpack.admin.inspect
/bpa info	<player>	View detailed data of a player’s backpacks	backpack.admin.inspect
/bpa delete	<player> <name> [confirm]	Delete a backpack from a player	backpack.admin.delete
/bpa reset	<player> [confirm]	Reset all data and recreate defaults for a player	backpack.admin.delete
/bpa backup create	<player>	Manually create a backup for a player	backpack.admin.restore
/bpa backup list	<player>	List all available backups of a player	backpack.admin.restore
/bpa restore	<player> <backup> [target]	Restore a backup, optionally to another player	backpack.admin.restore
/bpa defaults apply	<player> [force]	Force-apply group default configurations	backpack.admin
/bpa defaults info	<player>	View active defaults and group permissions	backpack.admin.inspect
/bpa reload	—	Reload all configurations, templates, and messages	backpack.admin.reload

---

🔌 PlaceholderAPI Integration

Show your players’ stats in scoreboards, tab lists, and chat formatters:

• %smartbackpackx_count% — Number of virtual backpacks in collection.
• %smartbackpackx_portable_count% — Number of portable backpacks in inventory.
• %smartbackpackx_total% — Total backpacks (virtual + portable).
• %smartbackpackx_selected% — Name of the active/selected backpack.
• %smartbackpackx_selected_size% — Slots capacity of the active backpack.
• %smartbackpackx_slots_used% — Number of slots currently containing a backpack.
• %smartbackpackx_slots_max% — Max slots available to the player.
• %smartbackpackx_has_backpack% — Returns "true" if the player owns any backpack, "false" otherwise.

---

🔐 Core Permissions

• backpack.admin — Master admin access (grants all sub-permissions, bypasses combat lock/sorting limits).
• backpack.access.virtual — Permission to open and use virtual menu backpacks.
• backpack.access.portable — Permission to open and carry physical portable backpacks.
• backpack.access.portable.takeout — Allows players to take a backpack out of their virtual collection as an item.
• backpack.access.slot.<1-56> — Grant access to specific virtual collection slots.
• backpack.feature.settings — Access to settings and filter menus.
• backpack.feature.filter — Permission to set up personal filter lists in-game.
• backpack.feature.autocollect — Permission to use Auto-Pickup.
• backpack.feature.autosorting — Permission to toggle Auto-Sorting.
• backpack.group.<name> — Received default group backpacks automatically (e.g. backpack.group.vip).

---

📥 Installation

1. Download SmartBackpackX Ultra and put the .jar file into your server’s plugins/ directory.
2. Start or restart your server to generate config.yml, messages.yml, and templates.yml.
3. Configure your settings (database type, anti-abuse, defaults, and custom templates).
4. Run /bpa reload to apply your changes!

🤝 Support

Found a bug or have a suggestion? Join our support community Discord Server.