Minecraft Plugin · Available

BotchedVaults

Backpacks with unlockable pages, stack upgrades up to 640 items a slot, and shared clan vaults where you decide who can deposit and who can take.

Discuss on the forum
Website downloads
0
BotchedVaults artwork
Platform
Paper 1.21.8 – 26.3
Storage
Backpacks · clan vaults
Version
1.3.0
Requires
Nothing else
Overview

What is BotchedVaults?

BotchedVaults gives every player a backpack with pages of 36 slots. You choose how many pages are free and the most a backpack can have, up to 50. Players buy more pages, get them from their rank, or win them from crates. Stack upgrades let one slot hold more of the same item: 128 diamonds at 2x, all the way to 640 at 10x. Swords, armor and tools still hold one per slot.

With BotchedMobs installed, every clan also gets a shared clan vault. Set what each rank can do (no access, view only, deposit only, or deposit and take), add daily take limits, and lock pages to higher ranks. The vault log shows who put in or took out what. Clicks that could duplicate items or skip limits are blocked, and every save is crash-safe.

Highlights

What you can do

  • Backpacks with pages

    /backpack opens pages of 36 slots. Free pages, a max of up to 50, and pages players can buy or earn.

  • Stack upgrades

    2x, 4x, 6x, 8x and 10x for every page, so one slot holds up to 640 diamonds.

  • Clan vaults

    One shared vault for every BotchedMobs clan, with its own pages, stack upgrades and log.

  • Rank access

    Deposit and take rights per rank, daily take limits and page locks. Anti-dupe on every click.

Everything included

Features

  • The Gilded Reserve Bank map: six Bankers, a round-door Vault, six clickable vaults and a coin fountain plaza (/zone bank)
  • Backpack pages of 36 slots, with free pages and a max you set (1–50)
  • Pages bought per page number, given by rank permission, or handed out with /bvaults givepage
  • Stack upgrades from 2x to 10x for backpacks and clan vaults, with prices you set
  • Left-click takes a stack, right-click takes half, shift-click fills your inventory
  • Clan vault access per rank: none, view, deposit, or deposit and take
  • Daily take limits per rank, reset at midnight, and page locks by rank
  • Vault log of every deposit, withdrawal and purchase
  • Blocked items (like shulker boxes) and blocked worlds
  • Drag, number keys, Q, offhand swap, middle click and double click are blocked so items can’t be duplicated
  • Crash-safe saves: each file is written to a temp file, then renamed
  • Pays with BotchedEconomy or any Vault economy
Upgrades

Stack sizes

Stack sizeDiamonds a slotBackpack priceClan vault price
1x (start)64––
2x1285,00010,000
4x25615,00030,000
6x38435,00070,000
8x51275,000150,000
10x640150,000300,000

These are the default prices. Change any size or price in config.yml, or remove a line to skip that size.

Reference

Commands

Player commands
CommandWhat it does
/backpack [page]Open your backpack (also /bp, /backpacks)
/clan vault [page]Open your clan’s vault (also /clanvault, /cvault, /cv)
/clan vault settingsWho can deposit, take, daily limits and page locks
/clan vault log [page]Who put in or took out what
Admin commands
CommandWhat it does
/bvaults backpack <player> [page]Open someone’s backpack
/bvaults vault <clan tag> [page]Open a clan’s vault (logged as staff)
/bvaults givepage <player> [amount]Unlock backpack pages (crates, rewards)
/bvaults setpages <player> <pages>Set unlocked backpack pages
/bvaults pages <player>See someone’s backpack pages and stack size
/bvaults vaultpages <clan tag> <pages>Set a clan vault’s pages
/bvaults givestack <player> [size]Next (or set) backpack stack size
/bvaults vaultstack <clan tag> [size]Next (or set) clan vault stack size
/bvaults reloadReload the config
Setup

Get started

  1. Place BotchedVaults-1.3.0.jar in your server’s plugins folder and restart.
  2. Players can open /backpack right away.
  3. Set free pages, page prices and stack upgrade prices in plugins/BotchedVaults/config.yml.
  4. Give ranks extra pages or stack sizes with botchedvaults.backpack.pages.<n> and botchedvaults.backpack.stack.<size>.
  5. Run /bvaults reload to apply your changes.

Updating from an older version: your config.yml gets the new settings on first start, and saved backpacks and vaults load as they are.

Compatibility

Requirements

AreaSupport
Server softwarePaper 1.21.8 through 26.3, one jar
Java21 or newer
OptionalBotchedMobs (needed for clan vaults)
OptionalBotchedEconomy or any Vault economy (needed for buying pages and stack upgrades)
Updates

Latest version

Buying the plugin gets you every version below, plus future updates. Sign in with Discord and they are always in My purchases.

v1.3.0Latest

Shared menu style

Works with Paper 1.21.8 – 26.3

  • Backpacks, clan vaults and vault settings use the shared Botched panel style, with Previous, Next and Close in the bottom right
  • BotchedVaults-1.3.0.jarUniversal build · Java 21 · 135.2 KBIncluded with purchase
Earlier versions (3)
v1.2.0

Guide books

Works with Paper 1.21.8 – 26.3

  • Player and staff guide books: read them with /guide or /backpack guide, add give for a physical copy. Books are never handed out automatically
  • The staff book needs staff permission, and guide.yml updates live when edited
  • BotchedVaults-1.2.0.jarUniversal build · Java 21 · 125.8 KBIncluded with purchase
v1.1.0

Stack upgrades

Works with Paper 1.21.8 – 26.3

  • Stack upgrades for backpacks and clan vaults: 2x, 4x, 6x, 8x and 10x (up to 640 diamonds in one slot)
  • Buy them from the hopper button on any page, or give them with /bvaults givestack and /bvaults vaultstack
  • Rank permission botchedvaults.backpack.stack.<size>
  • Tools, armor and other single items still hold one per slot
  • Your config.yml gets the new settings on first start, and saved backpacks and vaults load as they are
  • BotchedVaults-1.1.0.jar102.1 KBIncluded with purchase
v1.0.0

First release

Works with Paper 1.21.8 – 26.3

  • Backpacks with pages of 36 slots, bought, given by rank or won from crates
  • Clan vaults for BotchedMobs clans with per-rank access, daily take limits and page locks
  • A vault log of who put in or took out what