Backpack Plus

Changelog: 09.04.2026 [Hotfix 3.1.1]

Fixed

- Fixed a bug in the /backpack remove owner command that caused an error when the backpack was not loaded in memory

For the full changelog, see [3.1.0](https://modrinth.com/plugin/backpack-plus/version/3.1.0)

Changelog: 09.04.2026 [Release 3.1.0]

⚠️ Note: If you are upgrading from an older version, please update your message configurations to the MiniMessage format, as Legacy Colors are no longer supported. Failure to do so will result in your messages appearing without colors.

If something doesn't work as expected, please report the error on [Discord](https://discord.com/invite/Ty7JUbz8Cv) or [GitHub Issues](https://github.com/ItQerk/BackpackPlus-Issues/issues).

⚠️ Warning: Before proceeding with this update:

1. Backup the BackpackPlus folder to avoid losing custom configurations or data.

2. If you are using a MySQL database, ensure it is backed up to prevent any potential data loss.

Key Changes

- Main: - Updated NBT-API to the latest version - The plugin now runs on version 26.1.1 - Player names are now updated in the database upon joining the server - Fixed: - Fixed an SQLite error related to a duplicate tier column, which could prevent the plugin from starting if the database didn't exist - Fixed incorrect timestamps caused by a rare bug - Added: - Added an admin command to change backpack ownership: /backpack force transfer owner <backpack uuid> <player> | Permission: backpackplus.admin.force.transfer.owner - Added a feature to save the last viewed backpack page - when a player reopens their backpack, it will now open on the same page they previously closed (if this option is enabled: keep-player-last-backpack-page) - Added an option to block backpack opening when interacting with specific blocks:

  # While holding the backpack, clicking on a block will trigger the block's native interaction instead of opening the backpack
  blocked-backpack-interaction-blocks:
    - CRAFTING_TABLE
    - ENDER_CHEST
    - ENCHANTING_TABLE
    - ANVIL
    - GRINDSTONE
    - LOOM
    - SMITHING_TABLE
    - STONECUTTER
    - CARTOGRAPHY_TABLE
    - OAK_BUTTON
  

- Added a command to delete backpacks from the database: /backpack delete <backpack uuid>. Permission: backpackplus.admin.backpack.delete - Added command: /backpack remove owner. Permission: backpackplus.remove.owner - used for transferring backpack ownership. After executing this command, the next person to open the backpack will become its new owner. - If a backpack has a pending ownership change NBT, the owner's name will no longer be displayed; instead, the default placeholder from the config will be shown. - Changed: - Expanded the inventory backpack limit system:

  # Block the possibility of having more than the set number of backpacks in the inventory
  limit-backpack-per-inventory:
    # If true, the plugin will check and enforce the backpack limit for players
    enable: false
    # The default limit for players who do not have any specific permission from the list below
    default-limit: 1
    # Custom limits based on permissions.
    # If a player has multiple permissions, the highest value will be granted.
    # Format: "permission.node": limit_amount
    permissions:
      "backpack-limit-1": 1
      "backpack-limit-2": 2
      "backpack-limit-3": 3
  

- Updated language files - Changed the update check provider from SpigotMC to Modrinth ---

Upgrade Steps

1. Backup the necessary files and database as described above. 2. Replace the existing plugin files with the new version. 3. Update config.yml according to the latest format. 4. Update your language file to the MiniMessage format. 5. Restart the server and verify that everything is functioning correctly. ---

Changelog: 25.02.2026 [Release 3.0.0]

⚠️ Note: If you are upgrading from an older version, please update your message configurations to the MiniMessage format, as Legacy Colors are no longer supported. Failure to do so will result in your messages appearing without colors.

If something doesn't work as expected, please report the error on [Discord](https://discord.com/invite/Ty7JUbz8Cv) or [GitHub Issues](https://github.com/ItQerk/BackpackPlus-Issues/issues).

⚠️ Warning: Before proceeding with this update:

1. Backup the BackpackPlus folder to avoid losing custom configurations or data.

2. If you are using a MySQL database, ensure it is backed up to prevent any potential data loss.

Key Changes

- Main: - Spigot servers are no longer supported. - Paper API has been implemented instead of Spigot API. - Legacy Colors are no longer supported; please update them to the MiniMessage format. You can use the default files as a template. - All messages now support the MiniMessage format. - The plugin now supports versions 1.20 and newer. - Added: - Added a check to verify if the server software is supported (Folia / Paper / Paper forks). - Added pagination for the GUI showing all players' backpacks. - Added the ability to set a default placeholder for <backpack_owner>: -

      backpack-placeholders-defaults: 
        backpack-owner-name: "<#1cc2f6><player>"
  - Added new NBT tags for backpacks:
    - Backpack Owner UUID
    - Backpack Owner Name
  - Added a template for backpack lore content (colors and formatting can now be customized):
    - 

yml # Default values for backpack placeholders backpack-placeholders-defaults: #... other # <amount> = amount of specific item # <name> = material or custom item name content-lore-template: "<#f9c100><amount>x <#dadada><name>" - You can now customize virtually all messages. - Added a custom logging system for testing purposes. - Added the /backpack recipes command (backpackplus.view.recipes), which displays all craftable backpacks. - Added a new config option to prevent opening a backpack when right-clicking a chest or similar block; the block will be opened instead. This also applies to doors and trapdoors: block-interaction-blocks-prevent-backpack-open. - Added support for Folia. - Added an option to hide tooltips for GUI elements. - Added the remove-inactive-backpacks option, which removes inactive backpacks after a specified number of days. - Added support for these plugins: - DeluxeCombat - PvPManager - Added an option to enable or disable the ability to use backpacks during combat (if you have one of the supported plugins installed). Option: allow-open-backpacks-in-combat: false - Added cannot-use-in-combat message to language files - Removed: - Removed saving the backpack tier and size within the content. - GUI buttons will no longer be saved in the content. - Fixed: - All players' backpacks are no longer loaded when the plugin starts. - Fixed saving backpacks during plugin shutdown (the plugin will now wait for the save to finish). - Saving all backpacks is now performed with a single query instead of separate queries. - Fixed the function for checking if a String is valid Base64; it no longer incorrectly detects materials as Base64. - Database - Improved the database code. - Overhauled the entire database system for significantly faster performance. - Added a tier column for backpacks in the database (backpacks will automatically update in the database). ---

Upgrade Steps

1. Backup the necessary files and database as described above. 2. Replace the existing plugin files with the new version. 3. Update config.yml according to the latest format. 4. Update your language file to the MiniMessage format. 5. Restart the server and verify that everything is functioning correctly. ---

Changelog: 12.09.2025 [Release 2.0.1]

⚠️ Note: This version is not compatible with the old config (older than 2.0.0). Rename or delete it and restart the server to generate the default config, then update it.

If something doesn't work as it should report the error on [discord](https://discord.com/invite/Ty7JUbz8Cv)

⚠️ Warning: Before proceeding with this update:

1. Backup the BackpackPlus folder to avoid losing custom configurations or data.

2. If you are using a MySQL database, ensure it is backed up to prevent any potential data loss.

Key Changes

- Fixed: - Fixed a bug where last_player_uuid was null, which caused the backpack to not load correctly ---

Upgrade Steps

1. Backup the necessary files and database as described above. 2. Replace the existing plugin files with the new version. 3. Update config.yml according to the latest format (refer to the provided [config template for 2.0.0](https://www.dropbox.com/scl/fi/9r62ixg0wx2causz1vpd2/conf… 4. Restart the server and verify that everything is functioning correctly. ---

Changelog: 07.09.2025 [Release 2.0.0]

⚠️ Note: This version is not compatible with the old config. Rename or delete it and restart the server to generate the default config, then update it.

If something doesn't work as it should report the error on [discord](https://discord.com/invite/Ty7JUbz8Cv)

⚠️ Warning: Before proceeding with this update:

1. Backup the BackpackPlus folder to avoid losing custom configurations or data.

2. If you are using a MySQL database, ensure it is backed up to prevent any potential data loss.

Key Changes

- Added: - Added limit for lore - maximum can be 256 lines (minecraft limit) - Added configuration option: allow-bundles-in-backpacks: "Should it be possible to place bundles in backpacks?" - Added more database configuration options - Added command for console: /backpackplus mysql pool stats - Added option for limit-backpack-per-inventory - limit-backpack-per-inventory-amount determines how many backpacks a player can have in inventory at one time - Added all gui names to language files now you can translate them, etc. - Added all BackpackPlus items to language files so you can translate them any way you like - Added display of last player's name in backpack preview - Added check for newer database backpack if you use backpack on several servers - Added a column to the database: is_open (It should create itself) - Fixed: - Blocking backpacks from being placed into bundles now works for all bundle types - Fixed the show-content option, which, when set to false and the description was empty, would still add the backpack's contents to the lore - Fixed bug with non-existent setMaxStackSize method on version 1.20.1 if it does not exist it will not be set - Fixed loading of backpacks in admin panel if settings for that backpack are not found - Updated: - Updated the class responsible for MySQL to be compatible with the updated dependencies. - Replaced the fields use-ssl and check-server-certificate with ssl-mode (Modern TLS switch: when set, overrides the legacy flags below: DISABLED | PREFERRED | REQUIRED | VERIFY_CA | VERIFY_IDENTITY) - Language files updated - Updated libraries - Improved: - Rewritten the class responsible for backpack gui interactions - Improved several functions ---

Upgrade Steps

1. Backup the necessary files and database as described above. 2. Replace the existing plugin files with the new version. 3. Update config.yml according to the latest format (refer to the provided [config template for 2.0.0](https://www.dropbox.com/scl/fi/9r62ixg0wx2causz1vpd2/conf… 4. Restart the server and verify that everything is functioning correctly. ---

Changelog: 13.05.2025 [Beta 1.5.6]

⚠️ Note: Review the changes from version [1.5.0](https://modrinth.com/plugin/backpack-plus/version/1.5.0-b… before you upgrade.

If something doesn't work as it should report the error on [discord](https://discord.com/invite/Ty7JUbz8Cv)

⚠️ Warning: Before proceeding with this update:

1. Backup the BackpackPlus folder to avoid losing custom configurations or data.

2. If you are using a MySQL database, ensure it is backed up to prevent any potential data loss.

Key Changes

- Added: - Prevent crafting with filled containers and bundles in backpack recipes - Added saving the last player who used the backpack to the database - Fixed: - Fixed backpack being locked by an inspector currently viewing it - Updated: - Language files updated - Improved: - Improved several functions ---

Upgrade Steps

1. Backup the necessary files and database as described above. 2. Replace the existing plugin files with the new version. 3. Update config.yml according to the latest format (refer to the provided [config template for 1.5.5](https://www.dropbox.com/scl/fi/usp53vprxbfz8pbwfyx9v/conf… 4. Restart the server and verify that everything is functioning correctly. ---

Changelog: 30.04.2025 [Beta 1.5.5]

⚠️ Note: Review the changes from version [1.5.0](https://modrinth.com/plugin/backpack-plus/version/1.5.0-b… before you upgrade.

If something doesn't work as it should report the error on [discord](https://discord.com/invite/Ty7JUbz8Cv)

⚠️ Warning: Before proceeding with this update:

1. Backup the BackpackPlus folder to avoid losing custom configurations or data.

2. If you are using a MySQL database, ensure it is backed up to prevent any potential data loss.

Key Changes

- Fixed: - Fixed a bug when decoding an object from base64 - Added: - Added support for MMOItems plugin when handling allowed items in the filtered backpack. - Added NBT (nbt:plugin:namespace:value Value must be of type String) support for allowed items in filtered backpack. - Added GUI display for allowed items with custom NBT data (e.g., items from MMOItems). - A small API for the plugin has been added: [link](https://www.dropbox.com/scl/fo/764j4m5dxo503p6zacr63/APQ1… - Added option in config.yml owner-only only the owner of the backpack can open it - Changed: - Set max_stack_size for backpacks to 1 - Updated: - Language files updated (Added not-owner) ---

Upgrade Steps

1. Backup the necessary files and database as described above. 2. Replace the existing plugin files with the new version. 3. Update config.yml according to the latest format (refer to the provided [config template for 1.5.5](https://www.dropbox.com/scl/fi/usp53vprxbfz8pbwfyx9v/conf… 4. Restart the server and verify that everything is functioning correctly. ---

Changelog: 15.04.2025 [Beta 1.5.4]

⚠️ Note: Review the changes from version [1.5.0](https://modrinth.com/plugin/backpack-plus/version/1.5.0-b… before you upgrade.

If something doesn't work as it should report the error on [discord](https://discord.com/invite/Ty7JUbz8Cv)

⚠️ Warning: Before proceeding with this update:

1. Backup the BackpackPlus folder to avoid losing custom configurations or data.

2. If you are using a MySQL database, ensure it is backed up to prevent any potential data loss.

Key Changes

- Fixed: - Fixed use of gui-title for backpack inventory title ---

Upgrade Steps

1. Backup the necessary files and database as described above. 2. Replace the existing plugin files with the new version. 3. Update config.yml according to the latest format (refer to the provided [config template](https://www.dropbox.com/scl/fi/3kppnra5vjercjfv5x7qv/conf… 4. Restart the server and verify that everything is functioning correctly. ---

Changelog: 14.04.2025 [Beta 1.5.3]

⚠️ Note: Review the changes from version [1.5.0](https://modrinth.com/plugin/backpack-plus/version/1.5.0-b… before you upgrade.

If something doesn't work as it should report the error on [discord](https://discord.com/invite/Ty7JUbz8Cv)

⚠️ Warning: Before proceeding with this update:

1. Backup the BackpackPlus folder to avoid losing custom configurations or data.

2. If you are using a MySQL database, ensure it is backed up to prevent any potential data loss.

Key Changes

- Added: - Added support for PostgreSQL database - Added if a player leaves the server the backpacks they last used will be deleted from the server memory (not the database) - Other: - Improved code readability not yet for entire project ---

Upgrade Steps

1. Backup the necessary files and database as described above. 2. Replace the existing plugin files with the new version. 3. Update config.yml according to the latest format (refer to the provided [config template](https://www.dropbox.com/scl/fi/3kppnra5vjercjfv5x7qv/conf… 4. Restart the server and verify that everything is functioning correctly. ---

Changelog: 23.02.2025 [Beta 1.5.2]

⚠️ Note: Review the changes from version [1.5.0](https://modrinth.com/plugin/backpack-plus/version/1.5.0-b… before you upgrade.

If something doesn't work as it should report the error on [discord](https://discord.com/invite/Ty7JUbz8Cv)

⚠️ Warning: Before proceeding with this update:

1. Backup the BackpackPlus folder to avoid losing custom configurations or data.

2. If you are using a MySQL database, ensure it is backed up to prevent any potential data loss.

Key Changes

- Fixed: - Fixed bug with InventoryView not found on versions 1.20/4 - Update: - Updated in resourcepack settings and file(resourcepack.zip) to the latest, from now it works from version 1.19 to the latest thanks to user: iijj22gg - Added: - Added 3 missing options to config.yml (This did not affect the operation of the plugin because they were automatically completed) ---

Upgrade Steps

1. Backup the necessary files and database as described above. 2. Replace the existing plugin files with the new version. 3. Update config.yml according to the latest format (refer to the provided [config template](https://www.dropbox.com/scl/fi/3kppnra5vjercjfv5x7qv/conf… 4. Restart the server and verify that everything is functioning correctly. ---

Changelog: 23.01.2025 [Beta 1.5.1]

⚠️ Note: Review the changes from version [1.5.0](https://modrinth.com/plugin/backpack-plus/version/1.5.0-b… before you upgrade.

If something doesn't work as it should report the error on [discord](https://discord.com/invite/Ty7JUbz8Cv)

⚠️ Warning: Before proceeding with this update:

1. Backup the BackpackPlus folder to avoid losing custom configurations or data.

2. If you are using a MySQL database, ensure it is backed up to prevent any potential data loss.

Key Changes

- Fixed: - Fixed the option to save backpacks in the player's inventory (caused a database disconnection error for SQLite) ---

Upgrade Steps

1. Backup the necessary files and database as described above. 2. Replace the existing plugin files with the new version. 3. Update config.yml according to the latest format (refer to the provided [config template](https://www.dropbox.com/scl/fi/3kppnra5vjercjfv5x7qv/conf… 4. Restart the server and verify that everything is functioning correctly. ---

Changelog: 21.01.2025 [Beta 1.5.0]

Important Notes

⚠️ Note: This version introduces significant changes that may not be compatible with previous versions unless config.yml is updated.

If something doesn't work as it should report the error on [discord](https://discord.com/invite/Ty7JUbz8Cv)

⚠️ Warning: Before proceeding with this update:

1. Backup the BackpackPlus folder to avoid losing custom configurations or data.

2. If you are using a MySQL database, ensure it is backed up to prevent any potential data loss.

Key Changes

- Configuration Overhaul: - Major updates to config.yml. Refer to the updated documentation for details on the required changes. - Added new configuration options to enhance flexibility and control. - Database Enhancements: - Optimized database queries for better performance. - Introduced support for additional database configurations. - Improved compatibility with MySQL and SQLite. - Added: - Message displayed if a backpack fails to load from the database (or does not exist). - Saving of backpacks in inventory after player's death: - To enable, set keep-backpacks-after-death to true - You can also configure permissions for this feature. The default is: backpackplus.keep.backpacks - Per-backpack material customization. - Cache system for improved performance. - Ability to set the backpack type to "filtered," allowing only specified items to be stored. - Command to change basic backpack settings: /backpackplus settings <tier> - Sounds when moving items in a backpack. - To enable, set play-song-when-item-moved-in-backpack to true - Additional MySQL database options related to HikariCP settings. - Ability to set backpack descriptions in the configuration. - Option to disable displaying the contents of backpacks. ---

Upgrade Steps

1. Backup the necessary files and database as described above. 2. Replace the existing plugin files with the new version. 3. Update config.yml according to the latest format (refer to the provided [config template](https://www.dropbox.com/scl/fi/3kppnra5vjercjfv5x7qv/conf… 4. Restart the server and verify that everything is functioning correctly. ---

I recommend making a copy of the BackpackPlus folder before updating the plugin Remember to change only the .jar file and do not delete the BackpackPlus folder.

Fixed:

- Loading options for custom items (filling and overfill) If something doesn't work as it should report the error on [discord](https://discord.com/invite/Ty7JUbz8Cv)

I recommend making a copy of the BackpackPlus folder before updating the plugin Remember to change only the .jar file and do not delete the BackpackPlus folder.

Changelog 20.09.2024 [1.4.4]

Fixed:

- The code responsible for players' heads has been improved - Error with “Cannot have empty/air choice” has been fixed

Changed:

- Needed libraries will now be loaded by “SpigotLibraryLoader” If something doesn't work as it should report the error on [discord](https://discord.com/invite/Ty7JUbz8Cv)

I recommend making a copy of the BackpackPlus folder before updating the plugin

Remember to change only the .jar file and do not delete the BackpackPlus folder.

Changelog 14.09.2024 [1.4.3]

Improved

- Updated the code responsible for the commands - Command messages will depend on the language set (not all) - Empty messages will not be sent for players - Fixed sending messages when the player clicks on the backpack menu

Added:

- Added command: /backpack resourcepack reload (permission: backpackplus.admin.resourcepack.reload) to reload resourcepack from config.yml - Added new values to language files

Changelog 23.08.2024

Added:

- New events for handling backpacks, opening/closing - Added ability to set custom items to gui as buttons, etc. [Preview](https://www.youtube.com/watch?v=0YHGMNJyUCM) - Spanish language Translated by: Sopherine(isofix19) - Added support for the ResourcePackManager plugin - Default resourcepack will be in folder: BackpackPlus/pack (of course, changes to it will not be taken into account by the plugin, you must have a ResourcePackManager for the changes to take effect) - Added ability to turn off showing backpack contents in lore: show-backpack-content-lore - Added ability to block putting backpacks into containers (config.yml: block-backpack-insert-containers) - Added checking if the plugin is connected to the database. If it is not connected the plugin will be disabled

Changes:

- Improved the code so that it works with events - Changes in config and [resourcepack](https://mc-packs.net/download/e1a5ae322cdaf23fa993487f8ca… from now on it will also be in the BackpackPlus/pack folder

Added options to config.yml:

- Custom fill object between buttons: - Gui.filling-use-custom-model - Whether it should use a custom item - Gui.filling-custom-model-id - Custom Model Id - Gui.filling-custom-model-material - Custom Model Material - Custom item to fill excess spaces in backpacks: - Gui.overfill-use-custom-model - Whether it should use a custom item - Gui.overfill-custom-model-id - Custom Model Id - Gui.overfill-custom-model-material - Custom Model Material - Custom Next page item: - Gui.page-next-button-use-custom-model - Should the next page button be as a custom model if it is on false will be used head player - Gui.page-next-button-custom-model-id - Custom Model Id - Gui.page-next-button-custom-model-material - Custom Model Material - Custom Previous page item - Gui.page-previous-button-use-custom-model - Should the previous page button be as a custom model if it is on false will be used head player - Gui.page-previous-button-custom-model-id - Custom Model Id - Gui.page-previous-button-custom-model-material - Custom Model Material - show-backpack-content-lore - If the option is enabled it will show the contents of the backpack in lore - block-backpack-insert-containers- If this option is enabled putting backpacks into specific containers will be blocked - blocked-containers - List of containers to be blocked, that is, it will not be possible to put backpacks in them

Fixed:

- From now on, backpacks should not be opened several times what happened in the case after RMB spamming - When a player loses connection or anything else the backpack should not leave locked - Fixed closing all backpacks when reloading the server - From now on, there should be no more problems with disappearing items from backpacks - Fixed the command to block items/materials - from now on, the command will save blocked items

Changelog 21.06.2024

Fixed:

- From now on, the names of players who are in the database will be displayed normally not as Unknown - The code responsible for the database has been corrected - Fixed a bug whereby if an admin reviewed players' backpacks then players had a duplicate backpack when creating backpacks

Improved:

- Code of several classes has been improved - Backpack opening time improved - Database code completely rewritten - From now on, you don't have to click 2 times to open the backpack

Added:

- Added saving of player names to database Please let me know of any errors Discord: [link](https://discord.gg/Ty7JUbz8Cv)

NOTE

this version causes errors with SQLite, if you are using version 1.3.2 or older do not upgrade to this one wait for the next one

Before updating, make a copy of the BackpackPlus folder

Changelog 16.06.2024

Added:

- Support to 1.21

Fixed:

- Fixed a bug whereby backpacks were not working on version 1.19 - Fixed a bug whereby the config was not complete

Improved:

- Corrected database code Please let me know of any errors Discord: [link](https://discord.gg/Ty7JUbz8Cv)

Changelog 09.06.2024

Added:

- Added ability to lock an item to prevent it from being placed in a backpack - Command to block items: /backpack block <hand | name> [<Material Name>] Permission: backpackplus.admin.block - Adds item/material to blocked list. If it gets bugged let me know

Fixed:

- Fixed a bug related to fireworks that made it impossible to load a backpack. Please let me know of any errors Discord: [link](https://discord.gg/Ty7JUbz8Cv)

Remember to make a copy of your BackpackPlus folder

Changelog 06.06.2024

Fixed:

- Fixed an issue where a player could not create a new backpack due to a message indicating they already had one. This pertains to the limit-backpack-per-inventory option. - Fixed the Event responsible for item pickup. This pertains to the limit-backpack-per-inventory option. - Fixed the change of backpack material in the config. - Players who have never been on the server should now be displayed correctly.

Please let me know of any errors

Changelog 14.05.2024

Added:

- Ability to change plugin language (custom languages can be added) - Ability to set permissions for using a specific backpack - Ability to set permissions for crafting a specific backpack - Ability to block having more than one backpack at a time

Fixed:

- Fixed the /backpack players command. It should now work correctly. Previously, it was bugging out and showing a message that no player had created a backpack yet.

Added options to config.yml:

- language: All languages are in the folder localization. To add a language, simply duplicate an existing one and rename it. - limit-backpack-per-inventory: Block the possibility of having more than one backpack in the inventory. - permissions-to-use-backpack: Whether to require permissions for a player to use backpacks (different for each tier). - crafting-backpack-requires-permission: Whether crafting the backpack requires the appropriate permission. - backpack-tiers.<tier>.permission-craft: Permission required to craft the backpack. - backpack-tiers.<tier>.permission-use: Permission required to use the backpack. - backpack-tiers.<tier>.can-be-crafted: Whether the backpack can be crafted.

Default Languages (you can add your own):

- chi.yml - 中文 - eng.yml - English - fre.yml - Français - ger.yml - Deutsch - jpn.yml - 日本語 - pol.yml - Polski - ukr.yml - Українська

If you find a bug, report it on my [Discord](https://discord.com/invite/Ty7JUbz8Cv)