Skip to content
Carlo Maria Cardí edited this page Dec 3, 2025 · 6 revisions

VirtualShulker Wiki

Welcome to the official documentation for the VirtualShulker plugin. Here you'll find setup instructions, usage guides, command references, and customization tips for VirtualShulker.


Table of Contents


Getting Started

VirtualShulker lets Minecraft players access shulker boxes virtually, without needing physical shulker boxes in-game. To begin, download and install the plugin as described in the README.

Installation

  1. Download the latest release or build from source.
  2. Place the VirtualShulker .jar file in your Minecraft server's plugins folder.
  3. Restart your server.

Commands

The plugin provides several commands to interact with virtual shulker boxes.

Command Description Permission
/vshulker open Opens your virtual shulker box virtualshulker.open
/vshulker give <player> Gives a virtual shulker to specified player virtualshulker.give
/vshulker reload Reloads the plugin configuration virtualshulker.reload

Use /vshulker help to display all available commands.


Permissions

Assign the following permissions to control access:

  • virtualshulker.open – Allows opening your virtual shulker box.
  • virtualshulker.give – Allows giving virtual shulker boxes to other players.
  • virtualshulker.reload – Allows reloading the plugin configuration.

Configuration

After the first launch, a configuration file (config.yml) is generated in the plugin's folder.

Available options may include:

max-slots: 27           # Maximum slots per virtual shulker box
allow-give: true        # Enable/disable giving virtual shulkers to others
messages:
  box-open: "Opened your virtual shulker!"
  no-permission: "You do not have permission."

Edit config.yml as desired and reload the plugin with /vshulker reload.


Advanced Features

  • Custom Storage Backend: Optionally configure storage (flatfile or database).
  • Multiple Boxes: Assign players multiple virtual shulkers.
  • GUI Customization: Change shulker box appearance through config.

FAQ

Q: Can I restrict virtual shulker usage to certain worlds?
A: Yes, via plugin config or permission plugins.

Q: Are items saved on server restart?
A: Yes, items in virtual shulker boxes are persistent.


Contributing

  1. Fork the repository on GitHub.
  2. Create a branch for your changes.
  3. Test your updates.
  4. Submit a pull request.

Suggestions and bug reports are welcome via GitHub Issues!


Support

  • For help, open an issue.
  • Documentation improvements and feedback are appreciated.

Enjoy VirtualShulker!

Clone this wiki locally