VaultPity

VaultPity

Trial vaults should feel exciting, not endless.

VaultPity gives every successful normal or ominous trial-vault unlock a transparent bonus roll. Miss that bonus enough times and the configured guarantee takes over. Your players can see their exact progress, odds, and possible rewards at any time—without replacing or interfering with vanilla vault loot.

Downloads

• Paper: fully supported on Minecraft 1.21.4–1.21.11
• Purpur and other Paper-compatible forks: designed to work through the Paper API; verify on your chosen fork before production use
• Fabric, Quilt, Forge, NeoForge, Velocity, BungeeCord, Waterfall, Spigot, Bukkit, and Folia: not supported by this release

VaultPity is a server-side plugin. Players do not need to install a mod or resource pack.

Features

• Separate pity counters for normal and ominous vaults
• Independent bonus chances and guarantee thresholds
• Fully configurable, weighted reward pools for each vault type
• Configurable reward material, minimum and maximum amount, weight, custom name, lore, and enchantment glint
• Exact configured odds shown inside the reward preview
• A clean `/vaultpity` menu with live progress for both vault types
• Paginated normal and ominous reward previews
• Configurable GUI titles, sizes, slots, icons, filler items, and navigation
• World allowlists and denylists
• Configurable MiniMessage text, sounds, particles, timing, and storage behavior
• Admin status, set, reset, and safe reload commands
• Atomic YAML storage with optional per-opening and periodic saves
• Pending rewards survive disconnects and restarts
• Full-inventory rewards are safely dropped for the correct player
• Duplicate interaction and dual-hand protection
• No NMS, reflection, CraftBukkit internals, or vanilla-loot replacement

How the pity system works

Normal and ominous vaults are tracked independently.

With the default settings:

• Normal vaults: 18% bonus chance, guaranteed on the fifth opening in a miss streak
• Ominous vaults: 22% bonus chance, guaranteed on the fourth opening in a miss streak

At a threshold of `5`, four misses make the fifth eligible opening guaranteed. A successful bonus resets only that vault type's counter. Opening a normal vault never changes ominous progress, and vice versa.

The bonus is independent of the vault's vanilla reward. VaultPity does not decide whether vanilla loot was “good” or “bad,” and it never cancels, edits, or replaces the item the vault ejects.

Rewards

Both reward pools are configured separately. Add, remove, or rebalance entries without rebuilding the plugin.

Weights are relative, so every preview reflects the exact reward pool currently configured on your server.

The GUI

Run `/vaultpity` to open the main menu. Each vault card shows:

• Current misses and guarantee progress
• Configured base bonus chance
• How many eligible openings remain before the guarantee
• A direct link to that vault's reward pool

The reward menus display every configured reward, its amount range, and its real weighted chance. Pagination is included for larger custom pools.

Commands

• `/vaultpity` — open your progress and reward menu
• `/vaultpity status [player]` — inspect pity progress
• `/vaultpity set <player> <normal|ominous> <count>` — set a counter
• `/vaultpity reset <player> [normal|ominous|all]` — reset progress
• `/vaultpity reload` — validate and reload configuration

The player menu is available by default. Administrative subcommands require their matching `vaultpity.admin.*` permission or the parent `vaultpity.admin` permission.

Requirements

• Minecraft 1.21.4–1.21.11
• Paper server software
• Java 21

Paper 1.21.1–1.21.3 do not provide the public vault state needed to confirm a genuine unlock safely. VaultPity deliberately refuses to start on those versions instead of claiming unreliable compatibility.

Important notes

• VaultPity runs entirely on the server; no client installation is required.
• It does not need an extra port, database, dependency plugin, or resource pack.
• Existing player progress is written atomically and can be saved after every opening.
• Use `/vaultpity reload` after editing configuration. Invalid values are rejected with practical console errors instead of silently producing broken rewards.

Made by crown7367 on Discord.


In-game previews

VaultPity overview
Track normal and ominous vault pity progress from one clean in-game menu.


Normal vault progress
See current misses, bonus chance, and guaranteed reward countdown for normal vaults.


Normal reward pool
Preview every configured normal-vault pity reward directly in game.


Ominous vault progress
Track the separate ominous-vault pity counter, bonus chance, and guarantee.


Ominous reward pool
Preview every configured ominous-vault pity reward directly in game.