HubTools
Managing player movement across a Minecraft server network can quickly become a headache. Without the right tools, players logging out on minigame or survival servers often find themselves stranded in the wrong place when they return. HubTools solves this problem elegantly by automating cross-server teleportation on Velocity proxies. It ensures that every player who disconnects outside a designated hub is gently guided back to a predefined spawn point on their next login, creating a smooth and frustration-free experience.
What is HubTools?
HubTools is a lightweight, AI-developed plugin designed specifically for Minecraft Velocity proxy networks. Its core purpose is to manage cross-server teleportation intelligently. When a player leaves a server that is not the configured target server, HubTools records that event. On the player’s next login, the plugin forces a teleport to exact coordinates on the target server, overriding the default spawn behavior. This means your lobby or hub world always remains the central gathering point, no matter where players were adventuring when they last logged off.
Key Features of HubTools
HubTools packs a focused set of features that make it indispensable for network administrators. It avoids bloat while delivering exactly what you need for reliable teleport management.
Smart Teleportation Logic
The plugin’s intelligence lies in its conditional checks. HubTools verifies the server name against the configuration file and only triggers a forced teleport if the logout occurred outside the target server. This prevents unnecessary teleports when a player is already in the right place. It supports dynamic coordinates with decimal precision for X, Y, and Z, and allows you to specify any world name on the target server. The result is a flexible system that adapts to your network’s layout.
Real-Time Sync and Automatic Data Cleanup
HubTools uses Velocity’s plugin messaging channels to communicate with downstream Paper servers in real time. This ensures that teleport coordinates are received instantly and accurately. After a successful teleport, the plugin automatically removes the player’s record from its storage, keeping memory usage minimal. There’s no lingering data to clutter your proxy, making HubTools an efficient choice even for large networks with hundreds of concurrent players.
How to Install HubTools
Getting HubTools up and running is straightforward. The plugin is compatible with Velocity 3.4.0 and newer, while the optional downstream component works on Paper 1.16.5 and above. Follow these steps to download HubTools and integrate it into your network.
Manual Installation Steps
- Download HubTools: Obtain the latest HubTools.jar file from the official GitHub repository or trusted distribution channels. Make sure you grab the correct version for your proxy.
- Install on Velocity: Place the HubTools.jar into the
plugins/directory of your Velocity proxy server. - Install on Paper (Optional): For full coordinate syncing, place the HubTools-Paper.jar into the
plugins/folder of every downstream server that players might leave from. This step is not mandatory but recommended for precise teleport handling. - Start Your Servers: Launch Velocity and your downstream servers. On first run, HubTools will automatically generate the configuration file at
plugins/HubTools/config.yml.
For server administrators who prefer a more automated approach, the foxygame.net launcher provides a one-click install for HubTools, ensuring the correct JAR is placed in the right directory and keeping the plugin up to date with the latest version. With foxygame.net’s add-on catalog, you can also manage HubTools alongside other Velocity plugins, simplifying network maintenance and reducing manual setup time.
Configuration and Customization
Once installed, HubTools is ready to work with its default settings, but you’ll likely want to tailor it to your network. The configuration file is clean and self-explanatory.
Open config.yml and adjust these parameters:
- server: The name of the downstream server registered in Velocity that acts as your hub. The default is “lobby”.
- world: The target world name on that server, such as “world” or “hub_world”.
- x, y, z: The exact coordinates where players will be teleported. Decimals are supported, so you can set precise spawn points like x: 0.5, y: 64.0, z: 0.5.
After editing, simply reload the plugin or restart Velocity to apply changes. The real-time sync mechanism ensures that all downstream servers immediately respect the new coordinates.
Why HubTools is Essential for Your Minecraft Network
HubTools for Minecraft fills a specific gap that many server networks overlook. Without it, players who disconnect from a minigame server might reappear in that same minigame lobby, bypassing your main hub entirely. This fragments your community and can confuse new players. HubTools gently enforces a consistent entry point, which is especially valuable for networks that rely on a central hub for navigation, rules, or announcements.
The plugin’s lightweight design means it won’t impact proxy performance. Automatic data cleanup prevents storage bloat, and the multi-condition checks avoid unnecessary teleports. Whether you run a small private network or a large public one, HubTools scales effortlessly. Its compatibility with Velocity 3.4.0+ and Paper 1.16.5+ ensures broad support across modern Minecraft server software.
Conclusion
HubTools brings order to cross-server teleportation with minimal configuration and maximum reliability. By automatically guiding players back to your chosen hub coordinates, it enhances the player experience and keeps your network cohesive. The installation process is quick, and the configuration is intuitive. If you’re looking for a straightforward way to manage where players land after logging in, download HubTools today and give your Velocity network the smart teleport management it deserves.