HavenBags - Shulker-like Player Bound Bags [1.18-1.21.4]

HavenBags - Shulker-like Player Bound Bags [1.18-1.21.4] -----

Create shulker-like bags of varying sizes bound to a player, or accessible by anyone.

Issues:██████████████ https://github.com/Valorless/HavenBags/issues
Dependency: █ █ █ ███ █ https://www.spigotmc.org/resources/valorlessutils.109586/

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.

You can also use HavenBags' legacy crafting feature.
This is a very simple crafting system, and won't be updated further.

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

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

▶ 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.
Additonal 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.

Even the mighty Spicy Water stands no chance again the power of the bag!
[IMG]

▶ Admin GUI
The Admin GUI allows you to easily create, restore and preview bags.

▶ Texture Per Size
Set the textures of bags per size, and if the bag is bound or not.

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

▶ Bag Upgrades
Define regular or custom items (through ModelData),
which players can use to 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:

Files
Each bag is stored in their own data file.
(Pro: Easy to edit. Con: Slower loading/saving.)

SQLite
Store all bags in a single local database file.
(Recommended. Pro: Fast loading/saving. Con: Hard to edit.)

MySQL
Store all bags on an external database.
(Pro: Saves space locally. Con: Very slow loading/saving)

MySQLPlus
Store all bags on an external database, loading/saving directly to the database.
Can be used to use bags across servers.
(Pro: Cross-server bags. Con: Constantly saves and loads bag data.)

▶ PAPI Placeholders
Here's a list of placeholders from HavenBags you can use with PlaceholderAPI:

%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 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 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 create [ownerless] <size>	havenbags.create	Create a new bag.
/havenbags give <player> [ownerless] <size>	havenbags.give	Give player a new 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>	havenbags.modeldata	Set the CustomModelData of the bag you're holding. You can only change modeldata of bags you own.
/havenbags weight <value>	havenbags.preview	Set the weight limit of the bag you're holding.
/havenbags token texture <texture or base64>	havenbags.token	Create a token you can combine with the bag, to change it's appearance.
/havenbags token custommodeldata <value>	havenbags.token	Create a token you can combine with the bag, to change it's 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 it's data.
/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 be reset to last save)

All commands can be shortened to /bags & /bag

[IMG]

My plugin requires the utility library plugin ValorlessUtils v 1.12.0.262 or newer to function.
It's 100% free, and works with all my plugins.

CustomRecipes

ChestSort, so you can easily sort the bag.

PlaceholderAPI.

PvPManager / PvPManager Lite
Disable players use of bags while in PvP.

HavenBagsPreview (Fabric Mod)
Credit: ArturoAtomplay

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.
[IMG]

English - Credit: ServerMiner

Español (Spanish) - Credit: Ajneb97

Español (Spanish) - Credit: Trooki Gaming

[IMG]

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.

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.

HavenBags keeps record of open bags, and will force any open bags to close, and return them to the player before shutting down.

The bag will drop below the player instead of returning to the inventory.

Bags in-game will remain, but will be removed once the player attempts to open it.

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)

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

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

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.

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

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.