xHub

Minecraft 版本： 1.20 1.20.1 1.20.2 1.20.3 1.20.4 1.20.5 1.20.6 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11 26.1 26.1.1 26.1.2

平台： bukkit paper purpur spigot

标签： game-mechanics minigame utility

✨ 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

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.