Перейти к содержимому
Mineforgian

VirtualStorages | Backpacks

Add virtual storages for your players

Загрузки
2K
Подписчики
8
Обновлён
1 ноября 2025 г.
Лицензия
LGPL-3.0-only

Опубликован 13 апреля 2024 г.

Title

VirtualStorages is a Bukkit/Spigot plugin that enhances player storage capabilities by introducing virtual backpacks — accessible from anywhere in the world, allowing players to store items beyond their regular inventory limits.


🧰 Features

  • Virtual Backpacks: Players can access extra inventory space inside a personal virtual backpack. Backpacks are available anywhere — no need for chests!

  • Customizable: Configure titles, messages, and permissions. Allow specific backpack counts using permission nodes.

  • Admin Tools:

    • Inspect and manage other players’ backpacks using /backpackview <player>
    • Reload messages dynamically with /vsreload
    • All data stored in editable YAML files for easy manual adjustments

⚙️ Installation

  1. Download the VirtualStorages plugin JAR.
  2. Place it into your server’s plugins folder.
  3. Restart (or start) your server to enable the plugin.

💬 Commands

Command Description Alias Permission
/backpack Opens your virtual backpack /bp virtualstorages.use.#
/backpackview <player> Allows admins to view another player’s backpack /bpview <player> virtualstorages.admin
/vsreload Reloads messages from the config virtualstorages.admin

Replace # with the backpack number (1–999). Example: virtualstorages.use.3 lets a player access up to 3 backpack pages.


🗃️ Data Storage

All player backpack data is stored inside the plugin’s data folder. Each file is named after a player’s UUID, and can be edited manually. Changes are applied instantly, without requiring a server restart.

(Database storage support planned for future updates.)


🖼️ Screenshots

Single page backpack:
photo1

Multiple page backpack:
photo2


🧩 Permissions Overview

  • virtualstorages.use.# → Access backpack number # (1–999)
  • virtualstorages.admin → Use /vsreload
  • virtualstorages.admin → Use /backpackview <player>

A permissions plugin (like LuckPerms) is required to manage these effectively.


🧱 Feedback & Support

Found a bug or have a feature request? Report it on the GitHub Issues page.


✅ TODO

  • Allow viewing other players’ backpacks
  • Make /vsreload unnecessary for updating player backpack pages
  • Add database storage option

Ченджлог

1.4.0.0Релиз1.21.8, 1.21.9, 1.21.10 · 1 ноября 2025 г.

v1.4.0.0 - Improved reliability and performance improvements

  • Implemented fixes for backpack system crashes, memory leaks, and permission issues:

    • Attempted to resolve thread safety issues to prevent server freezing during heavy use.
    • Workaround for possible memory leaks by ensuring backpacks properly clean up when players leave.
    • Implemented fix for permission changes to handle item preservation and restoration correctly.
    • Optimized file operations to make saving/loading more efficient.
    • Enhanced overflow system to prevent item loss and duplication on permission changes.
  • Attempts to improve overall plugin functionality:

    • Atomic saves to ensure data integrity even during server crashes.
    • Admin tools refinement to allow viewing player backpacks without conflicts.
    • Constants implementation for navigation arrows and slots to replace magic numbers.
    • Loop protection to prevent items from getting stuck in endless loops.
  • Performance optimization attempts

    • Reduced memory usage per player.
    • Accelerated file operations for faster backpack interactions.
    • Improved queue management to reduce "wait to open" occurrences.

Previous Version:

  • v1.3.2.0:
    • Fixed Messages not loading from file
    • Made so if the player has items present in the overflow file, it will be visible from the /bpview command so an admin can take and recover items
  • v1.3.1.0:
    • Added fallback option to prevent losing items on permission shrinks
    • Added lock mechanism to prevent two players accessing the same inventory at the same time (ex. /bp and /bpview), not ideal but safest approach to prevent item duping
    • Rewrote Messages, Titles, and Item Names to read from configuration files for player customization
    • Command /vsreload no longer needed to update inventory sizes - now done automatically
    • Command /vsreload now reloads the text cache used for titles and messages

Full Changelog: https://github.com/852DuartePls/Spigot-VirtualStorages/compare/1.3.1.0...1.4.0.0

1.3.0.2Релиз1.20.5, 1.20.6, 1.21 · 19 июля 2024 г.

Changes:

Small bugfixes
Full Changelog: 1.3.0.1 >> 1.3.0.2

It is still recommended to make a backup of all the backpacks just in case

Previous Changes:

  • Fixed error displaying the Backpack Title after updating the permissions.
  • Added a new command "/backpackview " to display the content of another player's backpack ingame.
  • The permission "virtualstorages.admin" is now necessary for both reload and bacpackview.
  • The data is now compressed into a .gz file to reduce storage space.
    • Old .yml files should still be recognizable by the plugin without losing any data from the backpacks, and they will be converted into the new format.
  • Many internal changes in the code.
1.3.0.1Релиз1.20.5, 1.20.6, 1.21 · 12 июля 2024 г.

Out of Experimental

It is still recommended to make a backup of all the backpacks just in case

Changes:

  • Fixed error displaying the Backpack Title after updating the permissions.
  • Added a new command "/backpackview " to display the content of another player's backpack ingame.
  • The permission "virtualstorages.admin" is now necessary for both reload and bacpackview.

Previous Changes:

  • The data is now compressed into a .gz file to reduce storage space.
    • Old .yml files should still be recognizeable by the plugin without losing any data from the backpacks and will get converted into the new format
  • Many internal changes in the code.
1.3.0.0-EXPERIMENTALБета1.20.5, 1.20.6, 1.21 · 6 июля 2024 г.

HIGHLY RECOMMENDED TO BACKUP ALL YOUR VIRTUALSTORAGE'S RELATED FILES BEFORE UPDATING TO THIS VERSION

Changes:

  • The data is now compressed into a .gz file to reduce storage space.
  • Added a new command "/backpackview " to display the content of another player's backpack ingame.
    • This command requires the new permission: "virtualstorage.admin"
  • Many internal changes in the code
  • Old .yml files should still be recognizeable by the plugin without losing any data from the backpacks, but it is still recommended to make a backup.
1.2.2Релиз1.20.5, 1.20.6, 1.21 · 14 июня 2024 г.
  • Optimized code and implemented asynchronous inventory loading for improved performance
  • Now backups are created every time the server is closed or the /vsreload command is used
  • New techniques were implemented to avoid deleting items or cases where the entire backpack was deleted when an item was in the slot where a “Navigation Item” should appear
1.1.1Релиз1.20.2, 1.20.3, 1.20.4 · 22 апреля 2024 г.
  • Modified YAML File Naming in saveAllBackpacks()
    • Adjusted method to include PlayerName in the YAML file names along with UUIDs during inventory saving, changing file name format from "UUID.yml" to "PlayerName - UUID.yml".
1.1Релиз1.20.2, 1.20.3, 1.20.4 · 15 апреля 2024 г.

Enhanced exception handling, refactored permission updates, improved logging, code cleanup, and documentation improvements for better code reliability and maintenance.

1.0Релиз1.20.2, 1.20.3, 1.20.4 · 13 апреля 2024 г.

First Release

Комментарии

Загружаем…