WorldConnect

A lightweight proxy + backend plugin that lets you route players to a specific world when sending them between servers via Velocity.

Perfect for hub setups where one backend server has multiple worlds (minigames, lobbies, gamemodes) and you want NPCs/commands to send players straight into the correct world — not just the server.


✦ Features

- One jar — install on Velocity proxy + Paper/Spigot/Folia backends + lobby
- /worldconnect <server> <world> — sends you to a server and teleports to the chosen world
- /worldconnect <player> <server> <world> — admin routing of other players
- PlaceholderAPI placeholders for per-world player counts
- Auto-broadcasts world counts across the network every 5 seconds
- Works with FancyNPCs (and any plugin that runs player commands)
- Built-in tab completion for servers and players
- /wc alias for quick use


✦ Requirements

- Velocity proxy
- Backend: Paper/Spigot 1.21+ (Folia supported)
- Multiverse-Core on backend (for /mvtp)
- PlaceholderAPI on lobby (for placeholders)
- Java 21+


✦ Installation

1. Drop the SAME jar in /plugins on your proxy, backend, and lobby
2. Restart all servers
3. On each backend, edit plugins/WorldConnect/config.yml:
server-name: "ExactNameFromVelocityToml"
4. Done


✦ Usage

FancyNPCs setup:
/npc edit <npcID> action add player_command worldconnect HubServer World1

Manual:
/worldconnect HubServer World1
/wc HubServer World2


✦ Placeholders (lobby)

%worldconnect_count_<server>_<world>% → players in that world
%worldconnect_total_<server>% → total players on that server

Example for a hologram:
HubServer • World1: %worldconnect_count_HubServer_World1% online


✦ Permissions

worldconnect.use - use the command
worldconnect.others - route other players (admin)


✦ Support

Feedback, issues, and feature requests: leave a review or message me on SpigotMC.