Backpacks1653

📖 Description

Backpacks1653 is a server plugin that gives players extra storage in the form of backpacks. Players can open a virtual backpack with a simple command, or craft a backpack item and open it with a right click. Backpacks can have multiple pages, custom crafting recipes, privacy settings and configurable behavior on death. Server owners get an ingame settings menu, automatic backups, a migration tool for other backpack plugins and support for SQLite, MySQL and Redis.

💡 Why Backpacks1653?

Backpacks1653 combines virtual backpacks and item backpacks in one plugin, so you do not need two separate plugins. It runs on Paper, Spigot and Folia with a single jar, works across multiple servers through MySQL or Redis, and can import existing data from Minepacks and BackpackPlus. This makes it easy to switch without your players losing their items.

📋 Requirements

Please make sure your server meets these requirements before downloading.

• 🖥️ Server: Paper, Spigot or Folia 1.21.x or higher
• ☕ Java: 21 or higher
• 🔌 Optional: PlaceholderAPI (for placeholders)

✨ Features

The plugin includes the following features out of the box.

• ✅ Platform Support. Works on Paper, Spigot and Folia (single jar)
• ✅ Folia Ready. Entity and global scheduler fallback system for safer task execution
• ✅ Virtual Backpacks. Open your backpack with /backpack, no item needed
• ✅ Item Backpacks. Craftable backpack items with custom textures (player heads)
• ✅ Multi Page Support. Up to 10 pages per backpack, permission based
• ✅ Permission Based Sizes. 9 to 54 slots, controlled via permissions
• ✅ Custom Crafting Recipes. Shaped and shapeless recipes, fully configurable
• ✅ Backpack Linking. Link multiple backpack items to share storage
• ✅ Anvil Combination. Combine backpacks with chestplates
• ✅ Shortcut Item. Minepacks style shortcut item to open virtual backpacks
• ✅ Privacy System. Private backpacks with toggle and bypass permissions
• ✅ View Only Mode. Non owners can view but not take items from public backpacks
• ✅ Death Behaviors. Drop item, drop contents, keep, or destroy on death
• ✅ Item Filter. Blacklist or whitelist items, block shulker boxes and nesting
• ✅ Free on Join. Automatically give backpacks on first or every join
• ✅ Slot Lock. Lock backpack to a specific inventory slot
• ✅ Sounds. Configurable open and close sounds
• ✅ Ingame Settings GUI. Change settings without editing files
• ✅ Preset Mode. Minepacks preset to easily migrate and match behavior
• ✅ Migration System. Migrate data and config from Minepacks and BackpackPlus
• ✅ Multiple Databases. SQLite, MySQL (HikariCP), Redis with cross server sync
• ✅ Automatic Backups. Scheduled backups with auto cleanup
• ✅ Auto Config Updates. New config values are added automatically without overwriting
• ✅ 21 Languages. Fully translated, custom languages supported
• ✅ MiniMessage & Legacy. Choose between modern MiniMessage or classic color codes
• ✅ PlaceholderAPI Support. Fully integrated
• ✅ bStats Metrics. Anonymous usage statistics

📥 Installation

Setting up the plugin only takes a few steps.

1. Download Backpacks1653.jar
2. Place it in your server's plugins/ folder
3. Restart the server
4. Edit plugins/Backpacks1653/config.yml to your liking
5. Customize messages in plugins/Backpacks1653/lang/
6. Use /bpadmin reload to apply changes

🎮 Player Commands

These commands are available to all players with the default permissions. You can also use /bp as a short alias for /backpack.

Command	Description	Permission
/backpack	Open your virtual backpack	backpacks1653.use
/backpack [page]	Open a specific page	backpacks1653.use
/backpack shortcut	Receive a shortcut item	backpacks1653.use
/backpack shortcut remove	Remove your shortcut item	backpacks1653.use

🛠️ Admin Commands

These commands are meant for server staff and require the listed permissions.

Command	Description	Permission
/bpadmin view <player>	View a player's backpack	backpacks1653.admin.view
/bpadmin edit <player>	Edit a player's backpack	backpacks1653.admin.edit
/bpadmin give <player>	Give a backpack item to a player	backpacks1653.admin.give
/bpadmin link	Link two held backpack items	backpacks1653.link
/bpadmin unlink	Unlink held backpack item	backpacks1653.link
/bpadmin settings	Open ingame settings GUI	backpacks1653.admin.settings
/bpadmin migrate <plugin> <data|config|all>	Migrate from another plugin	backpacks1653.admin.migrate
/bpadmin backup	Create a manual backup	backpacks1653.admin.backup
/bpadmin reload	Reload config and messages	backpacks1653.admin.reload

🔑 Permissions

All permissions can be managed with any permission plugin such as LuckPerms.

Permission	Description	Default
backpacks1653.use	Use virtual backpacks	true
backpacks1653.item.use	Use item backpacks	true
backpacks1653.craft	Craft backpacks	true
backpacks1653.anvil.combine	Combine backpack with chestplate	true
backpacks1653.keepondeath	Keep backpack on death	false
backpacks1653.link	Link backpacks	op
backpacks1653.private.bypass	Bypass private backpack restrictions	op
backpacks1653.viewonly.bypass	Bypass view only restrictions	op
backpacks1653.size.<size>	Set backpack size (18, 27, 36, 45, 54)	false
backpacks1653.pages.<number>	Set number of pages (1, 2, 3, 5, 10)	varies
backpacks1653.admin	Access admin commands	op
backpacks1653.admin.view	View other player backpacks	op
backpacks1653.admin.edit	Edit other player backpacks	op
backpacks1653.admin.give	Give backpack items	op
backpacks1653.admin.reload	Reload the plugin config	op
backpacks1653.admin.settings	Open ingame settings GUI	op
backpacks1653.admin.migrate	Migrate data from other plugins	op
backpacks1653.admin.backup	Manually create backups	op

⚙️ Configuration Example

Below is a shortened version of the default configuration. Click on the box to expand it.

config.yml

# ========================================
# Backpacks1653 Configuration
# ========================================

# ---- Language ----
language: "en_US"

# ---- Message Format ----
# MINI_MESSAGE = Modern format (<red>, <green>, etc.)
# LEGACY       = Classic format (&a, &c, etc.)
message-format: "MINI_MESSAGE"

# ---- Preset Mode ----
# Options: NONE, MINEPACKS
preset-mode: "NONE"

# ---- Free Backpack on Join ----
free-on-join:
  enabled: true
  give-item: false
  first-join-only: false

# ---- Backpack Modes ----
modes:
  virtual:
    enabled: true
  item:
    enabled: true

# ---- Shortcut Item ----
shortcut:
  enabled: false
  material: "COMPASS"
  display-name: "<green><bold>Backpack Shortcut"
  slot: -1
  give-on-join: true
  lock-in-inventory: true

# ---- Backpack Size ----
size:
  default: 27
  permission-based-size: true

# ---- Pages ----
pages:
  enabled: true
  default-pages: 1
  max-pages: 10
  permission-based-pages: true

# ---- Backpack Item Settings ----
item:
  material: "PLAYER_HEAD"
  texture: "eyJ0ZXh0dXJlcy..."
  display-name: "<gold><bold>Backpack"
  custom-model-data: -1

# ---- Crafting ----
crafting:
  enabled: true
  recipes:
    default:
      type: "shaped"
      shape:
        - "LLL"
        - "LCL"
        - "LLL"
      ingredients:
        L: "LEATHER"
        C: "CHEST"

# ---- Death Behavior ----
# Options: DROP_ITEM, DROP_CONTENTS, KEEP, DESTROY
death:
  behavior: "DROP_ITEM"
  permission-keep-on-death: true

# ---- Privacy ----
privacy:
  default-private: true
  allow-private-toggle: true

# ---- Item Filter ----
filter:
  mode: "NONE"
  block-shulker-boxes: true
  block-nesting: true

# ---- Database ----
# Type: SQLITE, MYSQL, REDIS
database:
  type: "SQLITE"

🔄 Migration

Switching from another backpack plugin? Backpacks1653 can migrate your data and configuration automatically. Currently supported are Minepacks and BackpackPlus, both with data and config migration.

To start a migration, use one of these commands:

• /bpadmin migrate minepacks data migrates backpack data
• /bpadmin migrate minepacks config migrates the configuration
• /bpadmin migrate minepacks all migrates everything

The migration automatically detects the source plugin's database type (SQLite or MySQL) and reads the credentials from its config. You can also use the built in Minepacks preset mode by setting preset-mode: "MINEPACKS" in your config.yml.

🗄️ Database Support

Choose the storage type that fits your setup.

Database	Description
SQLite	Default, no setup required. Perfect for single servers.
MySQL	HikariCP connection pool. Ideal for networks.
Redis	In memory storage with optional cross server sync via pub/sub.

🌍 Supported Languages

The plugin is fully translated into 21 languages: English, German, Dutch, Spanish, French, Portuguese, Arabic, Czech, Turkish, Polish, Russian, Italian, Korean, Hungarian, Japanese, Chinese, Vietnamese, Swedish, Slovak, Hindi and Indonesian.

You can also create your own language file and set language: "custom" in config.yml.

💬 Support

Support is only available via Discord. Please do not request support in the reviews.