XP Economy | The Ultimate Global Infrastructure - Vault Support
Professional XP Economy is a high-tier asset management system engineered for high-traffic networks seeking a robust, scalable, and 100% customizable alternative to traditional economy plugins. Built upon a Reflection-based architecture, this plugin is natively Multi-Version (1.8.8 - 1.20+), ensuring that every Action Bar notification and GUI menu functions with surgical precision regardless of your server version.
Elite Technical Innovations
Native Multi-Version Architecture
- Vault Support: Full integration with Vault API. The plugin now acts as your server's primary economy provider.
- Total Compatibility: The plugin automatically detects the server version (NMS) to inject data packets.
- Universal Action Bar: Visual XP gain/loss notifications that work flawlessly on any version thanks to our optimized reflection engine.
- Starting Balance: New players now begin their journey with a customizable amount of XP (set to 100 by default).
- Goodbye Redis: We have implemented a native BungeeCord Plugin Messaging system that synchronizes balances across your entire network without the need for external services.
- Scalability: Ideal for networks with multiple game modes (Survival, Skyblock, Factions) that share a unified XP wallet.
- Total Command Control: You are not tied to default names. Change /xp to /credits, /coins, or any name of your choice directly in the config.
- Runtime Injection: Changes in commands.yml are injected directly into the server's CommandMap using Reflection, allowing for unlimited aliases.
- Dynamic Command Help: The help system now automatically detects changes in commands.yml using dynamic placeholders like %cmd%, %topcmd%, and more.
Spoiler: commands.yml
Code (YAML):
# ==========================================
# XP Economy - Command Settings
# Custom Names, Aliases & Permissions
# ==========================================
# Main economy command (Check balance, pay, admin actions)
xp-command:
name : "xp"
# Leave empty "" for no permission
permission : ""
admin-permission : "xp.admin"
aliases :
- "balance"
- "money"
# Ranking command
top-command:
name : "topxp"
permission : ""
aliases :
- "xptop"
# Global distribution command
admin-giveall-command:
name : "adminxp"
permission : "xp.admin.giveall"
aliases :
- "xpgiveall"
# Plugin reload command
reload-command:
name : "xpreload"
permission : "xp.admin.reload"
aliases :
- "relxp"
# XP Economy - Command Settings
# Custom Names, Aliases & Permissions
# ==========================================
# Main economy command (Check balance, pay, admin actions)
xp-command:
name : "xp"
# Leave empty "" for no permission
permission : ""
admin-permission : "xp.admin"
aliases :
- "balance"
- "money"
# Ranking command
top-command:
name : "topxp"
permission : ""
aliases :
- "xptop"
# Global distribution command
admin-giveall-command:
name : "adminxp"
permission : "xp.admin.giveall"
aliases :
- "xpgiveall"
# Plugin reload command
reload-command:
name : "xpreload"
permission : "xp.admin.reload"
aliases :
- "relxp"
Detailed Commands & Help System
The plugin includes a Dynamic Help System that adapts based on the user's rank to keep the chat clean.
User Commands
- /xp: Displays your current balance instantly.
- /xp <player>: Check the balance of any other player (Supports offline player tab-completion).
- /xp give <player> <amount>: Send XP to another user with fund validation and anti-dupe security.
- /xp help: Displays a professional help menu with configurable colors.
- /topxp: Opens the high-end visual ranking interface.
- /xp set <player> <amount>: Set a user's exact balance.
- /xp add <player> <amount>: Add XP to a balance (multipliers apply).
- /xp remove <player> <amount>: Securely subtract funds (never drops below 0).
- /adminxp give <amount>: An "Event" command that grants XP to all online players simultaneously.
- /xpreload: Instantly reloads YAML files and restarts the MySQL pool without affecting gameplay.
Intelligent Graphical Interface (GUI)
Our ranking menu is a fully adaptable interface that fits your network's specific needs.
- Dynamic Row System: Configure from 1 to 6 rows (9 to 54 slots).
- Smart Positioning: The "Your Info" item automatically adapts to stay centered in the bottom row.
- Async Skull Loading: Player textures for the TOP ranking are loaded asynchronously to prevent server stutters.
- Auto-Refresh: The ranking refreshes automatically every X seconds (configurable) to show live changes.
Prestige Multipliers
Incentivize donations and player progress. Create unlimited multipliers in config.yml based on permissions:
- VIP: 1.5x XP Multiplier.
- MVP: 2.0x XP Multiplier.
- ELITE: 3.0x XP Multiplier.
- HikariCP High-Performance: Utilizing the world's most efficient connection pool for MySQL/MariaDB, handling thousands of transactions per second.
- PlaceholderAPI: Native support for %economia_xp%.
- Developer API: Comprehensive XPAPI class for 3rd-party integrations.
Empower your custom plugins with our streamlined developer interface. The XPAPI allows you to interact with the global economy with just one line of code, automatically handling multipliers and action bar notifications.
Spoiler: View Java API Methods
Code (Java):
// Get a player's balance
int balance = XPAPI. getXP (player. getUniqueId ( ) ) ;
// Add XP (Automatically applies multipliers and sends Action Bar)
XPAPI. addXP (player. getUniqueId ( ), 500 ) ;
// Set or Remove XP
XPAPI. setXP (player. getUniqueId ( ), 1000 ) ;
XPAPI. removeXP (player. getUniqueId ( ), 200 ) ;
int balance = XPAPI. getXP (player. getUniqueId ( ) ) ;
// Add XP (Automatically applies multipliers and sends Action Bar)
XPAPI. addXP (player. getUniqueId ( ), 500 ) ;
// Set or Remove XP
XPAPI. setXP (player. getUniqueId ( ), 1000 ) ;
XPAPI. removeXP (player. getUniqueId ( ), 200 ) ;
Why use our API?
- Automatic Multipliers: When using addXP(), the plugin automatically calculates the player's highest permission-based multiplier.
- Visual Feedback: All API transactions trigger the professional Action Bar notifications configured in your messages.yml.
- Safety First: Methods are designed with anti-dupe validation and ensure balances never drop below zero.
Spoiler: config.yml
Code (YAML):
# ==========================================
# XP Economy - Main Configuration
# High-Performance Sync & Storage
# ==========================================
settings :
# Amount of XP players start with
start-balance : 100
# Enable Vault integration
# If true, this plugin will act as the server's primary economy
use-vault : true
# Multipliers based on permissions
# Format: permission: multiplier_value
multipliers:
vip_plus:
permission : "xp.multiplier.v3"
value : 3
vip:
permission : "xp.multiplier.v2"
value : 2
mysql :
# Professional database connection pool (HikariCP)
host : "localhost"
port : 3306
database : "minecraft"
username : "root"
password : ""
# SSL is usually not required for local setups
useSSL : false
placeholders :
# Sync interval in milliseconds for PAPI data
sync_interval : 5000
# INFO: This plugin uses BungeeCord Plugin Channels for cross-server sync.
# No extra configuration like Redis is required!
# XP Economy - Main Configuration
# High-Performance Sync & Storage
# ==========================================
settings :
# Amount of XP players start with
start-balance : 100
# Enable Vault integration
# If true, this plugin will act as the server's primary economy
use-vault : true
# Multipliers based on permissions
# Format: permission: multiplier_value
multipliers:
vip_plus:
permission : "xp.multiplier.v3"
value : 3
vip:
permission : "xp.multiplier.v2"
value : 2
mysql :
# Professional database connection pool (HikariCP)
host : "localhost"
port : 3306
database : "minecraft"
username : "root"
password : ""
# SSL is usually not required for local setups
useSSL : false
placeholders :
# Sync interval in milliseconds for PAPI data
sync_interval : 5000
# INFO: This plugin uses BungeeCord Plugin Channels for cross-server sync.
# No extra configuration like Redis is required!
Spoiler: messages.yml
Code (YAML):
# ==========================================
# XP Economy - Language System
# Global Messaging & Localization
# ==========================================
# You can use color codes with '&'
# All placeholders (like %player% or %amount%) must be kept for the plugin to work correctly.
prefix : "&a&l[XP] &r"
commands :
# General command error messages
no_permission : "&cYou do not have permission to execute this command."
player_only : "&cThis command can only be used by players."
invalid_amount : "&cPlease provide a valid numeric amount."
player_not_found : "&cPlayer &e%player% &cnot found or has no account."
reload : "&aConfiguration and database connections reloaded successfully."
# Administrative action messages
admin_set_success : "&aSuccessfully set &e%player%'s &aXP to &6%amount%&a."
admin_add_success : "&aSuccessfully added &6%amount% &aXP to &e%player%&a."
admin_remove_success : "&aSuccessfully removed &6%amount% &aXP from &e%player%&a."
economy :
# Player balance and transaction messages
current_balance : "&7Your current balance: &6%amount% XP"
others_balance : "&7Player &e%player% &7has: &6%amount% XP"
sent_xp : "&7You sent &6%amount% XP &7to &e%player%."
received_xp : "&aYou received &6%amount% XP &afrom &e%player%."
insufficient_funds : "&cYou do not have enough XP to do that."
cannot_pay_self : "&cYou cannot give XP to yourself."
admin_give_all : "&aAdmin &c%admin% &agave &6%amount% XP &ato everyone!"
# Action Bar notifications
action_bar_add : "&a+ %amount% XP"
action_bar_remove : "&c- %amount% XP"
# Dynamic Help System
# You can add or remove lines from these lists freely.
help:
user :
- "&b&lXP Economy &7- &fUser Help"
- "&e%cmd% &8- &fCheck your current balance"
- "&e%cmd% <player> &8- &fCheck someone else's balance"
- "&e%cmd% give <player> <amount> &8- &fTransfer XP to another player"
- "&e%topcmd% &8- &fOpen the top XP ranking menu"
admin :
- "&c&lXP Economy &7- &fAdmin Help"
- "&e%cmd% set <player> <amount> &8- &7Set player balance"
- "&e%cmd% add <player> <amount> &8- &7Add XP to player"
- "&e%cmd% remove <player> <amount> &8- &7Remove XP from player"
- "&e%admincmd% give <amount> &8- &7Give XP to all online players"
- "&e%relcmd% &8- &7Reload plugin configurations"
# XP Economy - Language System
# Global Messaging & Localization
# ==========================================
# You can use color codes with '&'
# All placeholders (like %player% or %amount%) must be kept for the plugin to work correctly.
prefix : "&a&l[XP] &r"
commands :
# General command error messages
no_permission : "&cYou do not have permission to execute this command."
player_only : "&cThis command can only be used by players."
invalid_amount : "&cPlease provide a valid numeric amount."
player_not_found : "&cPlayer &e%player% &cnot found or has no account."
reload : "&aConfiguration and database connections reloaded successfully."
# Administrative action messages
admin_set_success : "&aSuccessfully set &e%player%'s &aXP to &6%amount%&a."
admin_add_success : "&aSuccessfully added &6%amount% &aXP to &e%player%&a."
admin_remove_success : "&aSuccessfully removed &6%amount% &aXP from &e%player%&a."
economy :
# Player balance and transaction messages
current_balance : "&7Your current balance: &6%amount% XP"
others_balance : "&7Player &e%player% &7has: &6%amount% XP"
sent_xp : "&7You sent &6%amount% XP &7to &e%player%."
received_xp : "&aYou received &6%amount% XP &afrom &e%player%."
insufficient_funds : "&cYou do not have enough XP to do that."
cannot_pay_self : "&cYou cannot give XP to yourself."
admin_give_all : "&aAdmin &c%admin% &agave &6%amount% XP &ato everyone!"
# Action Bar notifications
action_bar_add : "&a+ %amount% XP"
action_bar_remove : "&c- %amount% XP"
# Dynamic Help System
# You can add or remove lines from these lists freely.
help:
user :
- "&b&lXP Economy &7- &fUser Help"
- "&e%cmd% &8- &fCheck your current balance"
- "&e%cmd% <player> &8- &fCheck someone else's balance"
- "&e%cmd% give <player> <amount> &8- &fTransfer XP to another player"
- "&e%topcmd% &8- &fOpen the top XP ranking menu"
admin :
- "&c&lXP Economy &7- &fAdmin Help"
- "&e%cmd% set <player> <amount> &8- &7Set player balance"
- "&e%cmd% add <player> <amount> &8- &7Add XP to player"
- "&e%cmd% remove <player> <amount> &8- &7Remove XP from player"
- "&e%admincmd% give <amount> &8- &7Give XP to all online players"
- "&e%relcmd% &8- &7Reload plugin configurations"
Spoiler: gui.yml
Code (YAML):
# ==========================================
# XP Economy - Interface Settings
# Custom Ranking & Menu Layout
# ==========================================
# Top XP Menu Configuration
menu:
title : "&8Top 18 XP Ranking"
# Number of inventory rows (Min: 1, Max: 6)
# Each row has 9 slots. Example: 3 rows = 27 slots.
rows : 3
update_interval : 30
items :
# Los slots se calculan automáticamente: (filas * 9)
rank_format:
display_name : "&d#%rank% &b%player%"
lore:
- "&eXP : &f%amount%"
empty_slot:
material : "SKULL_ITEM"
data : 0
display_name : "&8Empty Slot"
lore :
- "&7No player found in this rank."
info_item :
# Slot 22 is usually the center of the 3rd row
slot : 22
material : "EMERALD"
display_name : "&6Your Current XP"
lore:
- "&eXP : &f%amount%"
- "&eRank : &d#%rank%"
- ""
- "&7Keep playing to reach the top!"
# XP Economy - Interface Settings
# Custom Ranking & Menu Layout
# ==========================================
# Top XP Menu Configuration
menu:
title : "&8Top 18 XP Ranking"
# Number of inventory rows (Min: 1, Max: 6)
# Each row has 9 slots. Example: 3 rows = 27 slots.
rows : 3
update_interval : 30
items :
# Los slots se calculan automáticamente: (filas * 9)
rank_format:
display_name : "&d#%rank% &b%player%"
lore:
- "&eXP : &f%amount%"
empty_slot:
material : "SKULL_ITEM"
data : 0
display_name : "&8Empty Slot"
lore :
- "&7No player found in this rank."
info_item :
# Slot 22 is usually the center of the 3rd row
slot : 22
material : "EMERALD"
display_name : "&6Your Current XP"
lore:
- "&eXP : &f%amount%"
- "&eRank : &d#%rank%"
- ""
- "&7Keep playing to reach the top!"
Need Help or Support?
If you need assistance with my Minecraft plugins, join my Discord server for fast support: https://discord.gg/fC4Tkxm2zv
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.8, 1.9, 1.10
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
XP | Professional Global Economy - Vault Support is a free Minecraft Java mod. Compatible with Minecraft 1.8, 1.9, 1.10, 1.11 and newer. Downloaded 49 times (via Spigot). Download it and open it directly in the game.