📖 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.

🛠️ Admin Commands

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

🔑 Permissions

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

⚙️ Configuration Example

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

# ========================================
# 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.

🌍 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.