# EliteVaults

EliteVaults is a vault plugin for Spigot and Paper servers. It gives players personal, numbered storage spaces they can open from anywhere, share with others, and customise however they like. Admins get full audit logging, suspicious activity alerts, and tools to inspect or manage any player's data. It replaces outdated vault systems with a clean, predictable setup that works for both small servers and large networks.

### Soft Dependencies

These are optional. EliteVaults works fine without any of them.\
\
[WorldGuard](https://modrinth.com/plugin/worldguard/versions) - Adds support for restricting vault access within regions using the `elitevaults-access` flag. The integration is enabled automatically when WorldGuard is detected.\
[PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/) - Exposes vault data as placeholders for scoreboards, holograms, and other plugins. Install PlaceholderAPI and the expansion registers automatically on startup. Available placeholders:

| Placeholder                     | Value                                     |
| ------------------------------- | ----------------------------------------- |
| `%elitevaults_vault_count%`     | Number of vaults the player has           |
| `%elitevaults_max_vaults%`      | Player's vault limit                      |
| `%elitevaults_total_items%`     | Total item stacks across all vaults       |
| `%elitevaults_vault_name_<#>%`  | Display name of vault N                   |
| `%elitevaults_vault_items_<#>%` | Item count in vault N                     |
| `%elitevaults_shared_count%`    | Number of  vaults shared with this player |

### Permissions

| Permission                      | Default  | Description                        |
| ------------------------------- | -------- | ---------------------------------- |
| `elitevaults.use`               | everyone | Open `/vault` and use the selector |
| `elitevaults.share`             | everyone | Invite others to your vault        |
| `elitevaults.vault.N`           | false    | Unlock N vaults                    |
| `elitevaults.vaults.unlimited`  | op       | Unlock unlimited vaults            |
| `elitevaults.bypass.cooldown`   | op       | Skip vault opening cooldown        |
| `elitevaults.bypass.worldguard` | op       | Open vaults in restricted regions  |
| `elitevaults.admin`             | op       | All admin commands                 |
| `elitevaults.admin.alerts`      | op       | Receive suspicious activity alerts |
| `elitevaults.expiry.bypass`     | false    | Skip vault expiry duration         |

### Commands&#x20;

#### Player Commands `(/vault)`  or `/v`

| Command                             | Description                                   |
| ----------------------------------- | --------------------------------------------- |
| `/vault`                            | Open your vault selector                      |
| `/vault open <#>`                   | Open a specific vault directly                |
| `/vault pin <#>`                    | Pin/unpin a vault to the top of your selector |
| `/vault search <query>`             | Search all your vaults for items              |
| `/vault share <#> [member\|viewer]` | Invite a player                               |
| `/vault accept`                     | Accept a vault invite                         |
| `/vault decline`                    | Decline a vault invite                        |
| `/vault members <#>`                | Manage vault members                          |
| `/vault info <#>`                   | View vault information                        |
| `/vault rename <#>`                 | Rename a vault                                |
| `/vault icon <#> <material>`        | Set a custom vault icon                       |
| `/vault notify <#>`                 | Toggle member action notifications            |
| `/vault delete <#>`                 | Delete a vault                                |

#### Admin Commands `(/evadmin)`  or `/eva`

| Command                          | Description                     |
| -------------------------------- | ------------------------------- |
| `/evadmin reload`                | Reload config and messages      |
| `/evadmin logs <player>`         | Open audit log GUI for a player |
| `/evadmin inspect <player> <#>`  | Open any player's vault         |
| `/evadmin reset <player>`        | Delete all vaults for a player  |
| `/evadmin give <player> <count>` | Grant extra vault slots         |
| `/evadmin backup`                | Create a manual data backup     |
| `/evadmin debug`                 | Toggle debug logging            |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://myelitewiki.gitbook.io/resources/plugins/elitevaults.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.