Introduction
What ExyliaPlayerVaults is, what it solves, and how this documentation is organised.
ExyliaPlayerVaults gives every player personal vaults: real chests they open from anywhere with /pv,
kept in the database and open in exactly one window at a time across a whole network. It is free and open
source, published under the GNU General Public License v3.0 on
Modrinth.
It is built so a vault can never duplicate an item: not with two windows, not across a server switch, not after a crash. A rank decides how many vaults a player has and how big they are; players can buy more, name them, give them an icon and search them; staff can look inside anybody's, change them, empty them and put an earlier copy back.
It used to be the vaults module of ExyliaSurvivalCore. It is its own plugin now and keeps the vaults in
the same table, so a server whose vaults were in a shared database finds every one of them — see
Network for what carries over and what
does not.
What is included
How many and how big by rank, the /pv list, names and icons, /pv search, and where and when a vault
may be opened.
Extra vaults bought from the list with any currency ExyliaLib knows, each one pricier than the last.
Staff toolsAnybody's vaults, read only or to edit, online, offline or on another server; empty one, browse its history and put a copy back. Every change goes to the audit log.
NetworkOne lock per vault shared by every server, writes that never land over a newer row, and Redis to close a vault open somewhere else.
Requirements
| Requirement | Detail |
|---|---|
| Server | Paper 1.21.4 or newer. Folia supported. |
| Java | 21 |
| Required dependency | ExyliaLib — installed automatically when missing |
| Optional dependencies | PlaceholderAPI, and whatever economy plugin sells the vaults (ExyliaEconomy, Vault…) |
The configuration, the menus, the database and its locks, Redis, the placeholders, the text and icon prompts, the economy that charges a purchase and the audit log all come from ExyliaLib. ExyliaPlayerVaults is the part that decides what a vault is and who may open it.
How to read this documentation
Getting started
Installation, what the first start creates, and a first look as a player and as staff.
Vaults
What players get and do, what they can buy, what staff can do, and how it all stays safe across servers.
Reference
Commands, permissions, placeholders and every configuration key, message and menu value.
Conventions
- Values marked as default are what the plugin writes the first time it starts. If the file already exists, your value is kept.
- Identifiers between
<and>are variables./pv <number>means/pv 2. - A vault is named by its number, counted from 1. Its name and icon are only how it is drawn.
- Colours use ExyliaLib palette tokens (
{primary},{error},{highlight}), so recolouring the network never means editing these files.
Something missing on this page? Tell us on Discord