Start Here

  • Give players permission to use /container.
  • Open the container with /container and test depositing and withdrawing items.
  • Use storage blocks only after the basic container flow works.
  • Set up the database backend before running the plugin on a production server.

Core Purpose

VContainer stores player-owned item collections outside the normal inventory. Players can open a paginated menu, deposit items, withdraw items, sort the display, and use storage blocks as physical access points in the world.

The plugin is built for servers that want a configurable storage layer without forcing every interaction through text commands.

Player Flow

Virtual container

  • Players open /container.
  • Inventory clicks deposit items when deposit is enabled.
  • Container clicks withdraw all, one item, or one stack depending on click type.

Storage blocks

  • Admins can create global storage blocks with /vcontainer set.
  • Personal storage blocks can be given as items and placed by players.
  • Owners can manage members and pick up their personal block through the GUI.

Compatibility

  • Platform: Paper.
  • Java version: 21.
  • Supported Minecraft versions are the 1.21 API family listed in the README.
  • Optional integrations: Oraxen, MythicMobs, ItemsAdder, PlaceholderAPI text parsing, and supported shop providers for selling.
  • Storage backends: local JSON, MySQL, MariaDB, and H2.

File Layout

plugins/VContainer/
|- config.yml
|- database.yml
|- messages.yml
|- migration.yml
|- prices.yml
`- menus/
   |- container.yml
   |- members.yml
   `- confirm.yml