Hubber

A modern, ultra-lightweight and high-performance Hub / Lobby management plugin engineered for Paper 26.3 servers running Java 25+. Fully utilizes native Kyori Adventure components and modern Paper APIs.

⚡ Why Hubber? (Zero-Bloat & Ultra-Lightweight)

• 🪶 Featherweight (< 50 KB): Absolutely zero heavy dependencies or bloated third-party shading.
• ⚡ Instant Startup (< 5 ms): Loads in a blink without stalling server boot time.
• 🧠 Minimal Memory Footprint: Consumes under 2 MB of RAM, leaving all resources for your game worlds.
• 🚀 Zero Tick Lag (20.0 TPS): Event listeners are strictly optimized with block-level delta checks, keeping CPU impact at virtually 0.00% even with hundreds of concurrent players.
• 🌐 Universal Proxy Support: Works natively out-of-the-box with BungeeCord, Waterfall, and Velocity (via bungee-plugin-message-channel = true).

🌐 Languages / Языки

Hubber comes with built-in multi-language support. English is the default primary language, with Russian fully supported as a secondary language.

To change the language, edit plugins/Hubber/config.yml:

# "en" for English (default) or "ru" for Russian
language: "en"

Language files (messages_en.yml and messages_ru.yml) are generated automatically in the plugin folder and can be customized freely.

✨ Features

• 📖 Server Connection Book:

  • Automatically given to players upon joining (customizable hotbar slot).
  • Right-clicking instantly executes /joinserver from the player's perspective.
  • Equipped with spam cooldown, drop prevention (Q), and inventory move locks.
  • Tagged using PersistentDataContainer (immune to renaming or visual glitches).

• 🛡️ Comprehensive Hub Protection:

  • Block Break & Place Restrictions: Players cannot break or place blocks. Only operators (OP) or players with bypass permissions can modify the world.
  • Absolute Damage Immunity: Players are protected from all damage sources (fall, fire, lava, suffocation, void, etc.).
  • PvP & Combat Disabled: Players cannot attack each other or shoot projectiles.
  • No Player Pushing (Collision Removal): Players pass smoothly through each other with zero push/collision glitching, achieved via Paper's native collidable flag and Scoreboard Team collision rules (COLLISION_RULE NEVER).
  • Hunger Lock: Players never lose food or saturation.
  • Void Fall Rescue: Players falling below $Y = -64$ (configurable) are instantly and safely teleported back to the hub spawn.

• 🧍 Native Paper NPCs (/hub <command> <skin> <name> <color> [bold] [italic]):

  • Create interactive player-model NPCs directly at your location using Paper's native Mannequin API.
  • Right-clicking the NPC executes the specified command (e.g. joinserver, verification, or any custom command) from the player's perspective.
  • Advanced Skin Support: Automatic SkinsRestorer integration (supports skins by name or player from SkinsRestorer), direct textures.minecraft.net URLs, 64-character texture hashes, and fallback Mojang API lookup with signed textures.
  • Customizable nametag colors (gold, red, aqua, #FFD700, etc.) with optional bold and italic styling.
  • Safe and persistent: NPCs are invulnerable, immovable, silent, and saved across restarts in npcs.yml.
  • Management: /hub list to inspect active NPCs, /hub remove [id] to delete by ID or remove the nearest one.

• 📍 Persistent Spawn & Hub Commands:

  • /hubspawn: Easily set the hub spawn point to your current position.
  • /back (aliases: /hub, /spawn, /lobby): Teleport back to the hub spawn point.
  • Forced Spawn on Join: Players are always spawned at the hub spawn point upon connecting, regardless of where they were when they logged off.
  • Respawn redirection to hub spawn.

• ⚡ Spawn Teleportation Triggers (/settrigger):

  • Create interactive regions or points that automatically teleport any player stepping into them to /hubspawn.
  • Create spherical radius triggers (e.g. /settrigger 2.5 or /settrigger portal 3.0).
  • Create 3D bounding box regions using /settrigger pos1, /settrigger pos2, and /settrigger create <name>.
  • Persistent storage saved in triggers.yml.

• 🔗 Discord Verification (/verification):

  • Sends a customizable message with an interactive clickable Discord invite link.
  • Supports RGB HEX colors (&#RRGGBB / <#RRGGBB>) and legacy color codes (&a, &e, etc.).

• ⚔️ Forced Survival Mode:

  • Enforces Survival mode (SURVIVAL) for all regular players upon join.
  • Blocks unauthorized gamemode changes with configurable OP bypass.

📜 Commands & Permissions

Additional Bypass Permissions:

• hubber.bypass.break — Allow breaking blocks in the hub.
• hubber.bypass.place — Allow placing blocks in the hub.
• hubber.bypass.gamemode — Allow switching gamemode in the hub.

📥 Installation

1. Download or compile the Hubber-1.0.0.jar file.
2. Place Hubber-1.0.0.jar into your server's plugins/ directory.
3. Start or restart your server (requires Paper 26.3 and Java 25+).
4. Run /hubspawn in-game as an operator to configure your spawn location.
5. (Optional) Customize config.yml, messages_en.yml, or messages_ru.yml to your preference and execute /hubber reload.

🔨 Building from Source

To compile Hubber from source, ensure you have JDK 25+ and Apache Maven installed:

git clone https://github.com/kilkazens/Hubber.git
cd Hubber
mvn clean package

The compiled binary will be located at:

target/Hubber-1.0.0.jar

language: "ru"

👤 Developer

• Author: kilkazens
• Repository: https://github.com/kilkazens/Hubber

Note: Originally was created for Initium Magnum Terra.
(Пометка: Изначально было создано для Initium Magnum Terra)