🛡️ XPVault Plugin – Comprehensive Technical Guide
What is XPVault?
XPVault is an advanced plugin for Minecraft that allows players to securely manage their experience points (XP). It introduces a personal XP vault system where players can save, retrieve, and transfer XP, while also giving server administrators full control over XP distribution through administrative commands. XPVault enhances multiplayer gameplay by offering reliability and customization.
✅ Key Features
Secure XP vault system to store XP.
Recover saved XP anytime — especially after death.
Send and receive XP between players.
Full administrative control over XP balances.
Full message customization via messages.yml.
Built-in support for PlaceholderAPI integration.
🧭 Available Commands
/savexp
Function: Save XP to your personal vault.
Alias: /sxp
Permission: Open to all players
Example: /savexp 100
/givexp
Function: Give XP to another player.
Alias: /gxp
Permission: Open to all players
Example: /givexp Steve 500
/retrievexp [amount]
Function: Retrieve XP from your vault.
Alias: /rxp
Permission: Open to all players
Example: /retrievexp or /retrievexp 200
/adminxp <resetall|set|add|remove> [player] [amount]
Function: Administrative XP controls (reset, set, add, remove).
Permission: xpvault.admin required
Example: /adminxp set Player1 1000
/checkxp
Function: Display current and stored XP and levels.
Alias: /cxp
Permission: Open to all players
🔗 PlaceholderAPI Integration
Available Placeholder:
%xpvault_saved_xp%: Displays the amount of XP saved in a player's vault.
Example Usage (Scoreboard):
lines:
- "&aStored XP: &f%xpvault_saved_xp%"
💬 Message Customization
Supported Placeholders:
Placeholder Description
%player% Target player name %amount% XP amount %current_xp% Player's current XP %saved_xp% Player's saved XP %sender% Player who sent the XP %action% Action taken (set, add, remove) %new_xp% New XP value after the action
Example Messages (messages.yml):
plugin_enabled: "&aXPVault has been enabled!" xp_saved: "&aYour XP has been saved!" xp_given: "&aSuccessfully gave %amount% XP to %player%!" xp_retrieved: "&aYou retrieved %amount% XP from your vault." adminxp_player_success: "&a%action% %amount% XP for %player%. New saved XP: %new_xp%"
