Content generated with AI — it may contain mistakes.

ExyliaPlayerVaults/GuidesUpdated in v1.12.0

Limit where and when vaults open

Block vaults in some worlds or game modes, in combat, between rapid clicks, and keep chosen items out of them, with the bypass permissions for trusted staff.

Page 5 of 202 min read

Restrictions decide where, when and with what a vault opens. They live in config.yml and are checked every time a player opens a vault.

Before you start#

None of these apply to staff opening somebody else's vault with /pvadmin. For your own trusted players, see the bypass permissions in Permissions.

Steps#

Pick what to restrict

Edit the restrictions section of config.yml:

plugins/ExyliaPlayerVaults/config.yml
yaml
restrictions:
  open-cooldown: 500ms
  block-in-combat: true
  disabled-worlds:
    - world_pvp
  disabled-game-modes:
    - SPECTATOR
    - CREATIVE

Keep items out (optional)

Under vaults, list materials in blocked-materials, for example [ELYTRA, TNT]. Names are compared ignoring case. Shulker boxes and bundles holding one are refused too.

Reload

/pvadmin reload.

What each one does#

SettingDefaultEffect
open-cooldown500msWait between opening two vaults. 0s turns it off.
block-in-combattrueRefuses to open a vault while combat-tagged, and closes an open one when the player hits or is hit by a player.
disabled-worldsnoneWorlds, by name, where vaults cannot be opened.
disabled-game-modesSPECTATORSURVIVAL, CREATIVE, ADVENTURE or SPECTATOR.
vaults.blocked-materialsnoneMaterials that cannot be put in a vault.

Let someone skip them#

PermissionSkips
exyliaplayervaults.bypass.cooldownThe open cooldown.
exyliaplayervaults.bypass.restrictionsWorlds, game modes and combat.
exyliaplayervaults.bypass.blockedThe blocked items list. Not granted to anyone by default: it lets players store what you chose to keep out.

Check that it works#

As a player without a bypass, stand in a disabled world and run /pv. You get the disabled-world message instead of the list. Try a blocked item: the click is refused with the blocked-item message. All messages are in messages.yml.

Technical details

Staff windows opened with /pvadmin edit are not held to blocked-materials and are not closed by combat. The same restrictions are in the in-game settings card, under the Access page.

Something missing on this page? Tell us on Discord