xHub

<div align="center"> # 🛡️ xHub Core (Beta) ### The Ultimate All-in-One Lobby Solution | 1.20+ !(https://img.shields.io/badge/Version-v1.0.5-blue?style=for-the-badge&logo=rocket) !(https://img.shields.io/badge/Minecraft-1.20%2B-green?style=for-the-badge&logo=minecraft) !(https://img.shields.io/badge/Dev-xPlugins-orange?style=for-the-badge&logo=github) !(https://img.shields.io/badge/Brand-xPlugins-purple?style=for-the-badge&logo=discord) **xHub** is a high-performance, premium core designed to replace multiple lobby plugins. It now includes advanced features like Parkour, Cosmetics, Developer API, and dynamic permissions. (https://discord.gg/xplugins) • (https://xplugins.es) </div> !(https://cdn.modrinth.com/data/cached_images/67f8620834f9a2c2d0a6763ce130a5c5d5518fe0.jpeg) --- ## ✨ 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 (` 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 (https://papi.extendedclip.com/) for variables. 4. **(Optional)** Install (https://www.spigotmc.org/resources/vault.34315/) 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 &7%player_name% &fhas joined the Lobby." quit: "&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