HavenBags
Create shulker-like bags of varying sizes bound to a player, or accessible by anyone.
About
Create shulker-like bags of varying sizes bound to a player, or accessible by anyone.
▶ Custom Bag Crafting
In collaboration with Mehboss, CustomRecipes support crafting of HavenBags! You can create custom crafting recipes to allow players to craft bags. You can read more on the CustomRecipes Wiki.
Recipe Examples
You can also use HavenBags' legacy crafting feature. This is a very simple crafting system, and won't be updated further.
▶ Pre-defined Bags
Pre-create and give out bags with specific content through commands.
▶ Ethereal Bags
Ethereal bags are bags accessed and given only through commands in their own environment. Ethereal bags are stored in a single file on the server and ignores the regular database. This means that Ethereal bags are server-only, and cannot be used cross-server with MySQL. These bags also do not benefit from the features of regular bags.
▶ Auto-Pickup
You can set to bags to automatically pick up items for you. Specify the loot filters yourself, or let players specify specific items for pickup. This continues even when the player's inventory is full.
Images
▶ Magnet
Bags can be magnified, sucking in nearby items.
GIF
▶ Auto-Sorting
You can set to bags to automatically sort the contents of the bag in alphabetical order. Takes into account Display- and Itemname.
Displayname > Itemname > Material
▶ Refilling
When the player places down the last block in their hand, the same item is taken from the bag if any, and given to the player.
▶ Weight Limits
Bags can be given a specific weight they can carry. You can specify the weight of items any time. As well as specify encumbering.
Image
▶ Placement Blocker
To avoid bags being placed down and the data destroyed, bags are unable to be placed down.
▶ Dupe Prevention
If multiple of the same bags are detected, a warning will be sent in the console, and one of the players will have their bag forcefully closed. Additional hidden methods are also active.
▶ Bag Protection
Bags cannot be destroyed by things such as fire, lava and cactus. Among other things. You can disable this option any time in the config file.
GIFs
Even the mighty Spicy Water stands no chance again the power of the bag!
▶ Admin GUI
The Admin GUI allows you to easily create, restore and preview bags.
Images
▶ Texture Per Size
Set the textures of bags per size, and if the bag is bound or not.
Image
▶ Skin Tokens
Set the textures of bags using Skin Tokens. Create as many different skin tokens as your heart desires, and share them with your players.
Image
▶ Bag Upgrades
Define regular or custom items (through ModelData), which players can use to upgrade their bags.
Image
▶ Bag Upgrade Table
Right-clicking a fletching table opens a customizable gui, where players can skin and upgrade their bags.
▶ Quivers
Store and draw arrows directly from bags, no more need to carry a ton of arrows!
▶ Soulbound
Keep bags through death. *Likely not compatible with plugins like GravesX and AngelChest
▶ Cross-Server Bags
Choosing the database type "MySQLPlus" allows bags to be used across servers. Loading and saving the bag data when needed, rather than auto-saving every so often. (Will require both servers to use the same database type and database.)
▶ Seamless Database Conversion
Seamlessly convert how the plugin stores data between:
| Type | Description | Pros | Cons |
|---|---|---|---|
| Files | Each bag is stored in its own data file. | Easy to edit | Slower loading/saving |
| SQLite | Store all bags in a single local database file. (Recommended) | Fast loading/saving | Hard to edit |
| MySQL | Store all bags on an external database. | Saves space locally | Very slow loading/saving |
| MySQLPlus | Store all bags on an external database, loading/saving directly to the database. Can be used across servers. | Cross-server bags | Constantly saves and loads bag data |
▶ PAPI Placeholders
Here's a list of placeholders from HavenBags you can use with PlaceholderAPI:
View Placeholders
| Placeholder | Description |
|---|---|
%havenbags_bags_current% | How many bags the player owns. |
%havenbags_bags_max% | How many bags the player can own. |
%havenbags_bags_items_MATERIAL% | How many items of a specific material are in all the player's bags. (Does not count ownerless bags) |
%havenbags_bags_inv_items_MATERIAL% | How many items of a specific material are in all the player's bags in their inventory. (Counts all bags) |
%havenbags_player_has_bag% | Returns true or false, depending if a player owns a bag or not. |
%havenbags_carry% | How many bags the player is carrying. |
%havenbags_carry_max% | How many bags the player can carry at once. |
%havenbags_bags_slots_total% | Total amount of slots of all bags in the player's inventory. |
%havenbags_bags_slots_used% | How many slots are used in all bags in the player's inventory. |
%havenbags_bags_slots_free% | How many slots are free in all bags in the player's inventory. |
%havenbags_bags_others% | Returns true or false, if the player has a bag they can't use. |
Player
| Command | Permission | Description |
|---|---|---|
| N/A | havenbags.player | Gives all HavenBags player permissions. |
| N/A | havenbags.use | Allows you to use bags. |
| N/A | havenbags.open.9/18/27/36/45/54 | Allows you to use the open bags of the defined size. |
| N/A | havenbags.upgrade.9/18/27/36/45/54 | Allows you to use the upgrade bags of the defined size. |
| N/A | havenbags.carry.X | Sets how many bags the specific player can carry. (if enabled) |
| N/A | havenbags.max.X | Sets how many bags the specific player can create. (if enabled) |
/havenbags gui | N/A | If enabled, open a gui to restore or delete own bags. |
/havenbags rename [name] | havenbags.rename | Rename the bag in your hand. Without havenbags.bypass, you can only rename your own bags. |
/havenbags empty/explode | havenbags.empty | Dump the content of the bag in your hand, onto the ground. |
/havenbags autopickup <filter> | havenbags.autopickup | Set your bag to automatically pick up items for you. |
/havenbags trust <player> | havenbags.trust | Trust players to open your bound bag. |
/havenbags untrust <player> | havenbags.trust | Remove a player's trust from your bag. |
/havenbags autosort <on/off> | havenbags.autosort | Automatically sort the contents of a bag. |
/havenbags magnet <on/off> | havenbags.magnet | Sucks in nearby items. |
/havenbags refill <on/off> | havenbags.refill | When the player places down the last block in their hand, the same item is taken from the bag if any, and given to the player. |
/havenbags open <id> | havenbags.ethereal | Opens an ethereal bag. |
/havenbags ethereal <id> autosort <on/off> | havenbags.autosort | Automatically sort the contents of a bag. |
/havenbags ethereal <id> autopickup <on/off> | havenbags.autopickup | Set your bag to automatically pick up items for you. |
/havenbags ethereal <id> magnet <on/off> | havenbags.magnet | Sucks in nearby items. |
/havenbags help | N/A | View help about the commands you have access to. |
Admin
| Command | Permission | Description |
|---|---|---|
| N/A | havenbags.admin | Gives all HavenBags' admin permissions. |
| N/A | havenbags.bypass | Allows you to bypass ownership locks. |
/havenbags gui | havenbags.gui | Opens HavenBags' Admin GUI. |
/havenbags open <player> <id> | havenbags.ethereal.admin | Opens a player's ethereal bag. |
/havenbags create [ownerless] <size> | havenbags.create | Create a new bag. |
/havenbags give <player> [ownerless] <size> | havenbags.give | Give player a new bag. |
/havenbags give <player> <bag> | havenbags.give | Give player a pre-defined bag. |
/havenbags give <player> ethereal <rows> <id> | havenbags.ethereal.admin | Give player an ethereal bag. |
/havenbags restore <player> [bag-uuid] | havenbags.restore | Gives a copy of the bag stored on the server. |
/havenbags preview <player> [bag-uuid] | havenbags.preview | Preview a copy of the bag stored on the server. |
/havenbags texture <texture or base64> | havenbags.texture | Set the texture of the bag you're holding. You can only change textures of bags you own. |
/havenbags modeldata <value> [material] | havenbags.modeldata | Set the CustomModelData of the bag you're holding. You can only change modeldata of bags you own. |
/havenbags itemmodel <value> [material] | havenbags.modeldata | Set the ItemModel of the bag you're holding. You can only change itemmodel of bags you own. |
/havenbags weight <value> | havenbags.preview | Set the weight limit of the bag you're holding. |
/havenbags effect <value> | havenbags.effects | Apply an effect defined in effects.yml to the bag. |
/havenbags token texture <texture or base64> [player] | havenbags.token | Create a token you can combine with the bag, to change its appearance. |
/havenbags token custommodeldata <value> [player] | havenbags.token | Create a token you can combine with the bag, to change its appearance. |
/havenbags info | havenbags.info | Shows information about the bag you're currently holding. |
/havenbags rawinfo | havenbags.info | Shows raw metadata about the bag you're currently holding. |
/havenbags help | havenbags.help | Shows the entire help list, regardless of permissions. |
/havenbags convertdatabase <files/sqlite/mysql> | havenbags.database | Seamlessly change & convert how the plugin stores its data. |
/havenbags customcontent edit | OP | Edit a GUI inventory. |
/havenbags customcontent save <name> | OP | Save the GUI inventory. |
/havenbags customcontent load <name> | OP | Replace the GUI inventory with a saved one. |
/havenbags clearcontent <all/player/bag-uuid> | Console | Removes the content of all bags, chosen player's bags, or a specific bag. |
/havenbags reload | havenbags.reload | Reload all config files. |
/havenbags reload force | havenbags.reload | Reload all config files AND force load all bags from the server. (Any unsaved bags will be reset to last save) |
All commands can be shortened to /bags & /bag
My plugin requires the utility library plugin ValorlessUtils v1.17.0.313 or newer to function. It's 100% free, and works with all my plugins.
PvPManager / PvPManager Lite Disable players use of bags while in PvP.
HavenBagsPreview (Fabric Mod)
Credit: ArturoAtomplay
More Information
Features:
Instant Preview: See the contents of your HavenBags bags without opening them.
User-Friendly Interface: Simply hover over a HavenBags item in your inventory to reveal its contents in the tooltip.
Efficiency: Save time and streamline your inventory management process.
English - Credit: ServerMiner
Español (Spanish) - Credit: Ajneb97
Español (Spanish) - Credit: Trooki Gaming
Can you add my language to HavenBags?
NOTICE: lang.yml can be manually translated. Languages are only for item/block names.
Sure thing! Feel free to message me what language you'd like added, and I'll see what I can do.
Note that your language must be on this list of languages.
HavenBags has been updating a lot lately, how come?
I try to combine all new updates and additions into one big update. But when a bug or issue has been reported, I try to fix it as quickly as I can, and update the plugin to get rid of the problem. The problem can be niche and only affect a handful, or they can affect everyone. Nonetheless the plugin will be updated asap.
Please check the update note before updates, to see if it is worth for you to update.
What happens to open bags when restarting or reloading?
HavenBags keeps record of open bags, and will force any open bags to close, and return them to the player before shutting down.
What happens if you close an open bag with a full inventory?
The bag will drop below the player instead of returning to the inventory.
Will bags be removed from players, if the files on the server are deleted?
Bags in-game will remain, but will be removed once the player attempts to open it.
Can I upgrade or downgrade my server, without issues?
You should be able to upgrade within the supported versions, as newer versions are compatible with older data. You CANNOT however downgrade your server, as the functions don't support the newer data structure. (The same way you can't bring a 1.20 world into a 1.19 server)
Can I convert Minepacks backpacks to HavenBags?
Indeed you can! Update 1.26.0 introduced conversion from Minepacks to HavenBags ^^ Here's how to do it: https://www.spigotmc.org/resources/110420/update?update=565416
Can I convert EpicBackpacks to HavenBags?
Indeed you can! Update 1.27.0 introduced conversion from EpicBackpacks to HavenBags ^^ Here's how to do it: https://www.spigotmc.org/resources/110420/update?update=566001
How can I edit bag data on SQLite?
In order to load and edit the .db file, you need a program called "DB Browser (SQLite)". Here's how to get it: https://sqlitebrowser.org
Disclaimer: Shut down the plugin (or server) before editing the database. If you're not hosting the server locally, you'll have to download the database file.
How can I edit bag data on MySQL?
There are many ways to do it, but the way I do it is with a program called "MySQL Workbench" by ORACLE. Here's how to get it: https://dev.mysql.com/downloads/workbench/
Got questions or need help with something? Join my Discord server, and let's talk about it :D https://discord.gg/yyEPqSeXF9
Please if you discover any bugs, or the plugin isn't right for you. Please do not leave a bad review. Instead message me and I'll fix the bug.
