TravelBag

TravelBag is a free and reliable backpack mod for Fabric with configurable sizes, optional LuckPerms support, smart file-based storage, and a built-in shortcut item for quick access.

It is designed to feel safe on real servers:

• Each player has their own stored TravelBag
• The storage format always keeps room for 6 rows internally
• Downgrading permissions or config size does not delete hidden items
• Backups are created safely without generating nested backup files
• The latest 2 backups are rotated automatically per player file
• Item data is serialized with registry-aware codecs so enchantments and other components stay intact
• Unsafe bag data is locked instead of being silently overwritten
• No client-side mod needed

---

✨ Features

• Configurable TravelBag size from 1 to 6 rows
• Optional LuckPerms integration for size and feature permissions
• Optional auto-pickup when a player's inventory is full
• Optional shortcut head item for fast TravelBag access
• Configurable TravelBag shortcut head item.
• Per-player TravelBag files stored by UUID
• Automatic backup support with rotation
• Item filter support
• Shulker box restriction toggle
• Config reload command
• Mod Menu integration
• Optional Cloth Config support for an in-game config screen

---

⚙️ Config Highlights

TravelBag uses a simple properties config file: config/travelbag/travelbag.properties

Important options include:

• titles for owner and non-owner views
• drop-on-death behavior
• keepInventory interaction
• default size
• LuckPerms toggle
• cooldown
• shortcut item toggle
• shortcut preferred slot
• open sound toggle
• open sound id
• auto-pickup settings
• shulker restriction
• item filter
• allowed game modes
• aliases

---

🔄 Commands

• /travelbag - Open your own TravelBag
• /travelbag help - Show the available TravelBag commands
• /travelbag clean - Remove all items from your own TravelBag
• /travelbag clean <player> - Remove all items from another player's TravelBag
• /travelbag sort - Compact and sort your own TravelBag
• /travelbag <player> - Open another player's TravelBag
• /travelbag backup - Create backups of all TravelBag data files
• /travelbag reload - Reload the config file

Aliases are configurable and default to:

• /bp
• /backpack

---

🤷🏻‍♂️ How Storage Works

TravelBag stores player data in the Fabric config directory: config/travelbag/players/

Each player gets a separate file based on their UUID. TravelBag always stores up to 6 rows internally, even if a player currently only has access to fewer rows.

This means:

• hidden rows stay preserved when a player is downgraded
• re-upgrading size or permissions reveals those items again
• compacting can move stackable items upward into visible rows when possible
• item serialization uses registry-aware codecs to preserve enchantments and other modern item components
• if TravelBag cannot safely decode a bag file, that bag is locked to prevent accidental overwrite or item loss

Backups are written as:

• <uuid>.dat
• <uuid>.backup.1.dat - newest backup
• <uuid>.backup.2.dat - previous backup

Backups are created:

• on server start
• on /travelbag reload
• on /travelbag backup
• automatically every 10 minutes, but only if TravelBag data changed since the previous backup

If a bag file cannot be decoded safely, TravelBag also creates a timestamped failure snapshot before refusing further saves for that bag.

---

🎒 Shortcut Item

TravelBag can give players a shortcut head item that opens their backpack quickly.

The shortcut item:

• can be enabled or disabled globally
• supports a configurable head texture
• can be moved freely inside the player's inventory and hotbar
• cannot be placed inside the TravelBag
• cannot be placed inside chests or ender chests
• cannot be dropped normally
• is normalized automatically if duplicates somehow appear

The displayed shortcut name uses the player's name, for example:

• Alex's TravelBag
• James' TravelBag

---

🚗 Auto Pickup

If enabled, TravelBag can collect nearby item entities when a player's inventory is full.

Safety rules:

• filtered items are never removed from the ground
• blocked shulker boxes are never removed from the ground
• items are only collected if they can be stored safely
• open TravelBag screens stay in sync with auto-pickup changes

---

📊 Permissions

When LuckPerms support is enabled, TravelBag uses the following nodes:

• travelbag.use
• travelbag.fullpickup
• travelbag.size.1
• travelbag.size.2
• travelbag.size.3
• travelbag.size.4
• travelbag.size.5
• travelbag.size.6
• travelbag.clean
• travelbag.clean.other
• travelbag.sort
• travelbag.others
• travelbag.others.edit
• travelbag.keepOnDeath
• travelbag.noCooldown
• travelbag.ignoreBlacklist
• travelbag.backup
• travelbag.reload
• travelbag.bypass.gamemode
• travelbag.admin

travelbag.admin acts as an umbrella admin permission for TravelBag management features.

When LuckPerms support is disabled, TravelBag follows the config fallback values. Admin-only actions fall back to vanilla OP / gamemaster level.

---

🏜️ Test Server

Feel free to join my Minecraft server to test my mods: play.swordfishbe.eu

---

💡 Credits/Idea

Fabric mod idea based on Minepacks by GeorgH93.