vHubs

vHubs is a lightweight, configurable Velocity plugin for managing hub servers and hub behaviour across your proxy network. It focuses on easy setup, flexible hub definitions, and useful convenience commands to streamline player flow on large networks.

Features

• Hub server management: define one or more hub servers. Allows for randomized server selection.
• Simple commands for staff and users to teleport to hubs.
• Permission-based control for fine-grained access.

Quick start

1. Drop vHubs-VERSION.jar into your Velocity plugins folder.
2. Start or restart your Velocity proxy to generate the default config.
3. Edit plugins/vhubs/config.yml to add your hubs and preferences.

Installing

1. Place vHubs-VERSION.jar into your Velocity plugins folder.
2. Start or restart your Velocity proxy.
3. Edit the generated configuration file (plugins/vhubs/config.yml) to suit your preferences.

Once installed and configured, vHubs will automatically handle hub commands behavior according to your config.

Permission nodes are configurable in your permission manager of choice.

Why vHubs?

• Purpose-built for Velocity: simple, stable, and focused on proxy-side hub logic.
• Quick setup: install, edit a small YAML, and you're ready.
• Community-friendly: open to feedback and contributions.

Contributing

Contributions are welcome. Good first steps:

• Open issues to report bugs or propose features.
• Submit pull requests with clear descriptions and tests where possible.
• Follow repository code style and include a changelog entry for larger changes.

Building from Source

Prerequisites: Java 17+, Maven.

git clone https://github.com/szymon-off/vHubs.git
cd vHubs
mvn clean package

The built jar will be in the target directory.

Support

For help or to report issues, please use the GitHub Issues page or join our Discord server.

License

vHubs is licensed under the GPLv3 License. See the LICENSE file for details.