- Native Minecraft Version:
- Tested Minecraft Versions:
- Source Code:
- Languages Supported:
- Spanish, Chinesebettershulkerboxes.*: Grants all permissions (Recommended for admins)
Please read the whole post before downloading.
Warning: Better Shulker Boxes might be incompatible with certain plugins.
If you are using AuctionHouse and/or CMI, set "enable_rclick_chest_open" to false to prevent duping.
Code quality: A
About compatibility and support:
I do not support versions older than the latest one.
The latest version (2.12.0+) works with any Spigot / PapersSpigot version between 1.12.x and 1.15.x. It might work for older versions, but keep in mind they are not supported.
BSB or BetterShulkerBoxes allows players on your server to open a shulkerbox while holding it, so they can open a shulker box, for example, in a protected area.
You can customize open and close messages and sounds, inventory name, cooldown.
Right-click shulkerbox in inventory to open it:
You can open a shulkerbox by right-clicking it inside the your inventory.
Custom inventory names:
You can choose the inventory name for shulkerboxes, you can also use %itemname% to use the shulkerbox's name in the inventory name.
Ability to enable/disable and config the sound that is played when a player opens/closes a shulkerbox.
Items saved as metadata:
Better Shulker Boxes doesn't storage the container inventory in a file, as some plugins do (for example, playervaults). Instead, items are stored as MetaData of the shulker box, so if you uninstall the plugin no items will be lost.
Better Shulker Boxes is completly free.
bettershulkerboxes.use.*: Grants all permissions to just use the plugin (Recommended for users)
bettershulkerboxes.use: Allows players to open shulkerboxes in both ways UNLESS rightclick_requires_permission is set to true
bettershulkerboxes.use.rightclick: Allows players to open shulkerboxes by rightclicking them in the inventory (rightclick_requires_permission doesn't matter)
bettershulkerboxes.bypasscooldown: Allows players to bypass the cooldown (Recommended for exclusive ranks)
bettershulkerboxes.updatenotify: Allows players to receive notification about new versions and to use /bsb check. (Recommended for admins)
bettershulkerboxes.reload: Allows players to reload the config. (Recommended for admins)
/bsb - Shows the version of the plugin.
/bsb reload - Reloads the config.yml.
/bsb check - Check if you are running the latest version available.
# Better Shulker Boxes - By Rektb
# PLEASE SEE https://github.com/lMartin3/BetterShulkerBoxes/blob/master/src/main/resources/config.yml for an example config.yml
# bettershulkerboxes.*: Grants all permissions (Recommended for admins)
# bettershulkerboxes.use.*; Grants all permissions (Recommended for users)
# bettershulkerboxes.use: Allows players to open shulkerboxes in both ways UNLESS rightclick_requires_permission is set to true
# bettershulkerboxes.use.rightclick: Allows players to open shulkerboxes by rightclicking them in the inventory (rightclick_requires_permission doesn't matter)
# bettershulkerboxes.bypasscooldown: Allows players to bypass the cooldown (Recommended for exclusive ranks)
# bettershulkerboxes.updatenotify: Allows players to receive notification about new versions. (Recommended for admins)
# bettershulkerboxes.reload: Allows players to reload the config. (Recommended for admins)
version: 2.10.0 # Do not touch
prefix: '&8[&3BSB&8] ' # Prefix of the messages in chat
inventory_name: '&7Shulkerbox' # Name of the inventory (can use %itemname% to use item's name)
open_msg: '&eOpening shulkerbox...' # Put 'none' to disable (with the quotes)
close_msg: '&eClosing shulkerbox...' # Put 'none' to disable (with the quotes)
no_permission_msg: '&cPermission denied' # Message that players will get when they haven't got enough permissions
cooldown_msg: '&cYou have to wait until you can use this again' # This is sent to the player if he tries to open the shulkerbox but the cooldown hasn't finished
config_reload_msg: '&bConfiguration reloaded successfully' # Message sent to admin/console when the plugin configuration is reloaded successfully
config_reload_error_msg: '&cThere is an error in the configuration, see the console for details' # Like above but not good
cooldown: 5 # [Integer] In ms (milliseconds) the time players have to wait open another shulkerbox after opening one.
open_sound: 'BLOCK_SHULKER_BOX_OPEN' # [String (sound)] Like messages, put 'none' (with the quotes) to disable
close_sound: 'BLOCK_SHULKER_BOX_CLOSE' # [String (sound)] Like messages, put 'none' (with the quotes) to disable
cooldown_enabled: true # [Boolean] To enable or not the cooldown (Recommended)
requires_permission: true # [Boolean] Do players require permission to open shulkerboxes using the plugin? (Recommended)
enable_read_only: false # [Boolean] Enable 'read-only' mode, allowing players to see contents but not to modify them. They will have to place the shulkerbox. (Not recommended)
enable_rclick_air_open: true # [Boolean] Enable the original feature to open shulkerboxes by rightclicking into the air while holding them? (Recommended)
enable_rightclick_open: true # [Boolean] Enable the 2.0 feature to open shulkerboxes by rightclicking them inside the inventory? (Recommended)
rightclick_requires_permission: false #[Boolean] Right-click feature requires permissions? (Not recommended)
enable_rclick_chest_open: true #[Boolean] Enable right-click in chest to open shulkerbox? WARNING: Can cause conflicts with LWC Donation chests!
# Since 2.7.0 Better Shulker Boxes automatically recollects server information. This is with the only purpose of helping development.
# The data sent is completely anonymous, and it does not include compromising information.
# The data recollected is limited to:
# Server statistics: Player amount, online mode, Minecraft version, software (spigot, sponge, etc).
# Hosting statistics: Number of cores of the CPU, system architecture, operating system, server location (by country) and java version.
# Plugin (BSB only) statistics: Plugin version, some configuration parameters.
# For more information about statistics visit https://bstats.org/
# Although this data helps development I understand concerns about privacy.
# If you choose not to participate on statistics set the following parameter to false.
English - by me
Spanish - by me
Chinese - By Alpha5402
If you would like to contribute by translating the messages to any language not yet supported DM me on Discord or here.
Better Shulker Boxes uses bStats to recollect statistics, it does not send any critical/personal data and it is completely anoymous.
The data recollected is limited to:
I understand privacy concerns and if you don't want to send any data at all, set 'enable_statistics' to false in config.yml inside the plugin folder.
- Server statistics: Player amount, online mode, Minecraft version, software (spigot, sponge, etc).
- Hosting statistics: Number of cores of the CPU, system architecture, operating system, server location (by country) and java version.
- Plugin (BSB only) statistics: Plugin version, some configuration parameters.
For more information about data collection visit the bStats website or feel free to contact me.
Statistics can be seen here.
Do you like the plugin?
If you do, please consider donating and / or leaving a review below.
Servers using the plugin:
If you use the plugin on your server and want it to be displayed here DM me!
If you find a bug or want to request a feature, join my Discord server.
[BSB] Better Shulker Boxes [1.12-1.16] 2.14.5
More features for shulker boxes
- Better Shulker Boxes 2.14.5 - Fixed invalid plugin.yml Aug 29, 2020
- Better Shulker Boxes 2.14.4 - Small bugfix Aug 29, 2020
- Better Shulker Boxes 2.14.3 - Fixed a duplication bug Jul 31, 2020
I have updated the plugin but I get that error
[02:25:25 ERROR]: Error occurred while enabling BetterShulkerBoxes v2.14.0 (Is it up to date?)
at me.rektb.bettershulkerboxes.BetterShulkerBoxes.onEnable(BetterShulkerBoxes.java:69) ~[?:?]
at org.bukkit.plugin.java.JavaPlugin.setEnabled(JavaPlugin.java:263) ~[patched_1.15.2.jar:git-Paper-282]
at org.bukkit.plugin.java.JavaPluginLoader.enablePlugin(JavaPluginLoader.java:364) ~[patched_1.15.2.jar:git-Paper-282]
at org.bukkit.plugin.SimplePluginManager.enablePlugin(SimplePluginManager.java:483) ~[patched_1.15.2.jar:git-Paper-282]
at org.bukkit.craftbukkit.v1_15_R1.CraftServer.enablePlugin(CraftServer.java:472) ~[patched_1.15.2.jar:git-Paper-282]
at org.bukkit.craftbukkit.v1_15_R1.CraftServer.enablePlugins(CraftServer.java:386) ~[patched_1.15.2.jar:git-Paper-282]
at net.minecraft.server.v1_15_R1.MinecraftServer.a(MinecraftServer.java:488) ~[patched_1.15.2.jar:git-Paper-282]
at net.minecraft.server.v1_15_R1.DedicatedServer.init(DedicatedServer.java:298) ~[patched_1.15.2.jar:git-Paper-282]
at net.minecraft.server.v1_15_R1.MinecraftServer.run(MinecraftServer.java:897) ~[patched_1.15.2.jar:git-Paper-282]
at java.lang.Thread.run(Thread.java:748) [?:1.8.0_242]
[02:25:25 INFO]: [BetterShulkerBoxes] Disabling BetterShulkerBoxes v2.14.0
[02:25:25 INFO]: Better Shulkerboxes disabled
Hello, the author of the plugin! I am the Chinese server owner using this plugin. This is a great plugin! Help me a lot!
Can I advertise this great plugin to MCBBS? I translated the configuration files and introductions into Chinese and taught the Chinese people to use it. This will let more Chinese server owners understand and use this plugin. I will mark you as an author and will never claim that this plugin is mine.
Hope to receive your reply.