!Banner

---

✨ Key Features (v1.0.1)

• 🏃 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.