xHub

---

✨ Key Features (v1.0.1)

* 🤖 Discord Logs: Automatic checkpoints, rewards, void detection, and Double Jump. * 🤖 Discord Logs: Particle trails and hats with a GUI menu. * 🤖 Discord Logs: `xHubAPI` class for easy integration with other plugins. * 🤖 Discord Logs: Use `&#RRGGBB` colors anywhere. * 🤖 Discord Logs: Create unlimited GUI menus using YAML files. * 🤖 Discord Logs: Flicker-free Scoreboard and Tablist (PAPI supported). * 🤖 Discord Logs: Custom items on join (Compass, PvP Sword, Cosmetics). * 🤖 Discord Logs: 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. (Optional) Install (Optional) for variables. 4. (Optional) Install %%MD1%% for economy rewards. 5. Restart the server.

---

📂 Directory Structure

```text 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:

```java // 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.

```yaml

_

__ __ / /| |__

/ // // / | | | '

> </ __ /| || | |) |

/// /_/ __,|.__/ 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.