BackPack Plugin

Overview

The Backpack plugin allows players to have personal portable storage in Minecraft that can be opened like a chest but is persistent across server restarts. Each backpack is unique and linked to its owner, with features to prevent nesting backpacks inside each other and control inventory access.

The plugin also provides commands for giving, viewing, and managing backpacks, as well as full configuration support for customization.

Features

1. Backpack Items

Players can receive backpacks via command (/backpack give) or (optionally) through crafting.

Each backpack is linked to a UUID and the player's name.

The item lore shows:

Owner name

Backpack number

Contents count (filled slots / total slots)

Instruction: "Right-click to open"

1. Commands /backpack give <player> [rows] [item]

Gives a backpack to a player.

Optional:

rows: Size of the backpack (e.g., 2x9, 3x9)

item: The type of item to represent the backpack (e.g., CHEST, SHULKER_BOX)

/backpack seeinside <player> <number>

Allows a player to view a specific backpack of another player by its number.

/backpack reload or /bp reload

Reloads the plugin configuration (items, crafting recipes, language settings, etc.) without restarting the server.

1. Crafting

A default backpack recipe exists (configurable).

Can be fully customized in the config: shape, ingredients, and result item.

Crafting can produce real functional backpacks or dummy items depending on the settings.

1. Inventory Behavior

When a backpack is open:

Players can move all items except the backpack itself.

Other backpacks can be moved but cannot be placed inside the open backpack.

Inventory contents update dynamically in the item's lore.

1. Persistence

All backpacks are saved to backpacks.yml:

Contents

Size

Owner

Display name

Data is loaded automatically on plugin enable.

1. Configuration Options

Backpack Item: Set which item represents a backpack.

Default Rows & Max Rows: Control size limits of backpacks.

Crafting Recipe: Fully configurable, including shape and ingredients.

Language Settings: Support for English and German messages.

Comments: All config settings include English comments for clarity.

1. Plugin Compatibility

Compatible with Paper/Spigot 1.21+

Java 17+ recommended

Works with UUID-based persistence for multi-server and offline player support

1. Development Notes

Uses PersistentDataContainer for linking items to inventories.

Uses a custom BackpackInventoryHolder to track which inventory belongs to which backpack item.

Designed to prevent server errors from nested backpacks or accidental item loss.

Commands and crafting are fully dynamic via the configuration.