XP | Professional Global Economy - Vault v1.2

# ==========================================
#        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"

// 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);

# ==========================================
#        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 - 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 - 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!"