---

✨ Key Features (v1.0.0)

• 🏃 Parkour System: Automatic checkpoints, rewards, void detection, and Double Jump.
• 🎩 Cosmetics: Particle trails and hats with a GUI menu.
• 💻 Developer API: xHubAPI class for easy integration with other plugins.
• 🎨 Full RGB/Hex Support: Use &#RRGGBB colors anywhere.
• 📂 Modular Menu System: Create unlimited GUI menus using YAML files.
• 📊 Animated Boards: Flicker-free Scoreboard and Tablist (PAPI supported).
• 🎒 Hotbar Manager: Custom items on join (Compass, PvP Sword, Cosmetics).
• 📢 Chat Manager: Formatting with Rank support ([Admin] Player: Hello).
• 🤖 Discord Logs: Built-in Webhooks for Join/Quit events.

---

🚀 Installation

1. Download xHub-1.0.0.jar.
2. Place it in your server's plugins folder.
3. (Required) Install PlaceholderAPI for variables.
4. (Optional) Install Vault for economy rewards.
5. Restart the server.

---

📂 Directory Structure

plugins/xHub/
├── config.yml           <-- Main settings
└── menus/               <-- Drop your menu files here
    ├── principal.yml    <-- Main Menu
    ├── selector.yml     <-- Server Selector
    ├── socials.yml      <-- Social Media
    └── cosmetics.yml    <-- Cosmetics Menu

---

📜 Commands & Permissions

Command	Permission	Description
/xhub setlobby	xhub.admin	Sets the spawn point.
/xhub spawn	xhub.spawn	Teleports you to the lobby spawn.
/xhub reload	xhub.admin	Reloads all configs and menus.
/xhub menu <id>	xhub.menu	Opens a specific menu.
/xhub cosmetic	xhub.cosmetic	Manage cosmetic effects.

Note: Permissions can be disabled in config.yml by setting them to false.

---

👨‍💻 Developer API

xHub exports a static API class for developers to hook into the core:

// Teleport a player to the Hub
xHubAPI.teleportToSpawn(player);

// Check if player is doing parkour
if (xHubAPI.isInParkour(player)) {
    // do something
}

// Activate a cosmetic trail
xHubAPI.setTrail(player, "FLAME");

---

🛠️ Default Configuration

Below is the full generated config.yml file explaining every feature.

#                      _
#  __  __ /\  /\_   _| |__
#  \ \/ // /_/ / | | | '_ \
#   >  </ __  /| |_| | |_) |
#  /_/\_\/ /_/  \__,_|_.__/ v1.0.0
#
#   Wiki: https://xplugins.es/plugins/xhub
#   Discord: https://discord.xplugins.es

# GENERAL SETTINGS
settings:
  debug: false

  # World Protection (Lobby Settings)
  world-protection:
    disable-damage: true
    disable-hunger: true
    disable-fall-damage: true
    disable-void-death: true
    void-teleport: true
    void-height: 0
    disable-block-break: true
    disable-block-place: true
    disable-item-drop: true
    disable-item-pickup: true
    disable-weather-change: true
    always-day: true

  menus-strict-mode: true

# PERMISSIONS
# Define the permissions for each command.
# If you set a value to 'false', everyone can use it (Default).
permissions:
  admin: "xhub.admin"   # For /xhub reload, setlobby
  spawn: "false"        # For /xhub spawn (false = everyone)
  menu: "false"         # For /xhub menu (false = everyone)

# JOIN SETTINGS
join-settings:
  teleport-spawn: true
  title:
    enabled: true
    title: "&#00A2FF&lxHub &3&lNetwork"
    subtitle: "&7Welcome, &f%player_name%"
    fade-in: 10
    stay: 60
    fade-out: 10
  sound:
    enabled: true
    type: "ENTITY_PLAYER_LEVELUP"
    volume: 1.0
    pitch: 1.0
  particles:
    enabled: true
    type: "TOTEM"
    amount: 50

# CHAT MANAGER
chat:
  enabled: true
  format: "%vault_rank% &7%player_name% &8» &f%message%"

# MESSAGES
messages:
  # Set to 'false' to disable prefix
  prefix: "&#00A2FF&lxHub &8» &f"

  join: "&8[&a+&8] &7%player_name% &fhas joined the Lobby."
  quit: "&8[&c-&8] &7%player_name% &fhas left."

  reload: "%prefix%&aConfiguration successfully reloaded."
  no-permission: "%prefix%&cYou do not have permission to do this."
  unknown-command: "%prefix%&cUnknown command."

# DISCORD WEBHOOK
discord-webhook:
  enabled: false
  url: "PUT_YOUR_WEBHOOK_HERE"
  join-message: "🟢 **%player_name%** has joined the server."
  quit-message: "🔴 **%player_name%** has disconnected."

# SCOREBOARD
scoreboard:
  enabled: true
  update-rate: 20
  title: "&#00A2FF&lxH&3&lu&#00A2FF&lb"
  lines:
    - "&7&m----------------------"
    - "&fUser: &b%player_name%"
    - "&fRank: &f%vault_rank%"
    - "&fPing: &a%player_ping%ms"
    - ""
    - "&fLobby: &e#1"
    - "&fOnline: &a%online%"
    - ""
    - "&#00A2FFxplugins.es"
    - "&7&m----------------------"

# TABLIST
tablist:
  enabled: true
  update-rate: 40
  header:
    - ""
    - "&#00A2FF&lxHub Network"
    - "&7Enjoy the best quality!"
    - ""
  footer:
    - ""
    - "&7Store: &dstore.xplugins.es"
    - "&7Discord: &9discord.gg/xplugins"
    - ""

# AUTO-ANNOUNCEMENTS
announcements:
  enabled: true
  interval: 60
  sound: true
  sound-type: "BLOCK_NOTE_BLOCK_PLING"
  messages:
    - "%prefix%&fRemember to visit our website: &nwww.xplugins.es"
    - "%prefix%&fNeed help? Join our &9Discord&f server."
    - "%prefix%&fUse &e/menu &fto navigate between servers."

# PARKOUR SYSTEM: Beta
parkour:
  enabled: true
  blocks:
    # Block for STARTING and saving CHECKPOINT (Gold Plate by default)
    start: "LIGHT_WEIGHTED_PRESSURE_PLATE"
    # Block to FINISH and win (Iron Plate by default)
    end: "HEAVY_WEIGHTED_PRESSURE_PLATE"
  rewards:
    # Commands to execute upon winning (%player% is the player)
    - "tellraw %player% {\"text\":\"&a&l[xHub] &f¡You have won 100 coins!\"}"
    - "eco give %player% 100"

# DOUBLE JUMP
double-jump:
  enabled: true
  power: 1.5           # forward force
  height: 1.0          # upward force
  sound: "ENTITY_BAT_TAKEOFF" # Sound when jumping

  # Cooldown in seconds (0 to disable)
  cooldown: 3

  # Cooldown message (%time% = seconds remaining)
  # Leave blank "" to avoid sending a message
  cooldown-message: "%prefix%&cWait &e%time%s &cto jump again."

# HOTBAR (ITEM JOIN)
hotbar:
  enabled: true
  clear-inventory: true
  items:
    hide-players:
      slot: 0
      material: LIME_DYE
      name: "&a&lToggle Players"
      command: "hideplayers"

    pvp-sword:
      slot: 2
      material: DIAMOND_SWORD
      name: "&#DC143C&lPvP Arena &7(Right Click)"
      command: "server pvp"
      texture: ""

    selector:
      slot: 4
      material: COMPASS
      name: "&#00A2FF&lServer Selector &7(Click)"
      command: "xhub menu selector"
      texture: ""

    cosmetics:
      slot: 6
      material: ENDER_CHEST
      name: "&#D02090&lCosmetics &7(Right Click)"
      command: "xhub menu cosmetics"
      texture: ""

    social-menu:
      slot: 8
      material: PLAYER_HEAD
      name: "&9&lSocial Media"
      command: "xhub menu socials"
      texture: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvYmFkYzA0OGE3Y2U3OGY3ZGFkNzJhMDdkYTI3ZDg1YzA5MTY4ODFlNTUyMmVlZWQxZTNkMzNiODU5OTIyDBiIn19fQ=="

# Data Storage
spawn-location: {}

---

🤝 Credits

Developed with ❤️ by xPlugins.
Copyright © 2026 xPlugins. All rights reserved.