TeleHop

# 🌐 TeleHop Cross-server teleportation suite for Paper and Velocity Minecraft networks. TeleHop is built for multi-server Minecraft networks. It connects Paper backend servers through Velocity and keeps teleport data synced across the full network. Players can use homes, warps, player warps, TPA, RTP, `/back`, `/spawn`, and last-location teleporting across servers. TeleHop stores shared data in MySQL, so homes, warps, player warps, TPA requests, player tracking, and logout locations stay synced across every server. (https://github.com/gitEpildev/TeleHop) · (https://github.com/gitEpildev/TeleHop/tree/main/docs) · (https://github.com/gitEpildev/TeleHop/blob/main/docs/setup.md) · (https://github.com/gitEpildev/TeleHop/blob/main/docs/commands.md) · (https://github.com/gitEpildev/TeleHop/blob/main/docs/permissions.md) · (https://github.com/gitEpildev/TeleHop/blob/main/docs/configuration.md) · (https://github.com/gitEpildev/TeleHop/issues) --- ## ✨ What TeleHop Does TeleHop gives your Velocity network a complete teleport system. * Cross-server `/spawn` * Cross-server TPA * Cross-server homes * Cross-server warps * Cross-server player warps * Cross-server `/back` * Cross-server admin teleport * Named homes * Last logout location teleporting * Random teleport GUI * Random respawn system * MySQL-backed storage * Optional Redis TLS support for multi-proxy networks * Modular config files * Multi-language support * LuckPerms support * Permission-based limits * Admin management tools --- ## 📦 Version 2.1.0 TeleHop 2.1.0 adds encrypted Redis connections, live destination-ping display in the RTP menu, and fixes the RTP selection and cooldown flow. ### Added * Redis TLS support through `redis.ssl`, `redis.ssl-verify`, and `redis.ssl-ca-cert`. * Certificate and hostname verification for Redis connections, with support for a custom PEM CA certificate. * Destination-ping display on RTP region items. * Colour-coded ping values: green below 80 ms, yellow below 150 ms, and red above. * Live ping refresh twice per second while the RTP region menu is open. * Proxy-to-backend RTT measurement and the `SERVER_PING_UPDATE` network packet. * `rtp.gui.ping.enabled` and `rtp.gui.ping.proxy-ping` configuration options. ### Fixed * RTP menus close immediately after a destination is selected. * RTP cooldown starts only after a player selects a destination. * Pending RTP protection prevents players from stacking warmups through repeated clicks or `/rtp` commands. * RTP GUI tooltips hide standard item information, leaving the configured name, description, and ping line. ### Migration * Update the Paper and Velocity JARs together, as 2.0.0 does not recognise the new `SERVER_PING_UPDATE` packet. * Add the `rtp.gui.ping` section to existing `rtp.yml` files, or regenerate the file from the default configuration. * Add `rtp-in-progress` to customised language files. English fallback applies if the key is absent. * No database changes are required. --- ## 🚀 Teleportation ### Network Spawn `/spawn` sends players to the configured hub server. Spawn supports region-aware routing for multi-proxy networks. Example: * EU players can route to `lobby-eu` * US players can route to `lobby-usa` ### Random Teleport `/rtp` opens a GUI where players choose a region and dimension. TeleHop then finds a safe landing spot inside the configured radius. RTP supports: * Region selection * Dimension selection * Destination-ping display with a live, colour-coded value * Cooldown applied after destination selection * Warmup with pending-RTP protection * Move cancellation * Async safe-location search * Safe landing checks * GUI back button ### TPA TeleHop supports cross-server teleport requests. Commands: * `/tpa <player>` * `/tpahere <player>` * `/tpaaccept` * `/tpadeny` * `/tpacancel` * `/tpatoggle` TPA supports: * Cross-server requests * Clickable accept and deny buttons * Timeout * Cooldown * Warmup * Move cancellation * Session-based TPA toggle * Sender notification when the target has requests disabled ### Back Commands: * `/back` * `/back death` Features: * Return to your last location before teleporting * Return to your last death location * Works across servers * Session-based location tracking --- ## 🏠 Named Homes TeleHop now uses named homes instead of numeric slots. Players can create, delete, and teleport to homes by name. ### Commands * `/home` * `/home <name>` * `/sethome <name>` * `/delhome <name>` ### Features * Up to 10 homes per player * Permission-based home limits * Cross-server home teleportation * Case-insensitive home names * Names support letters, numbers, and spaces * Maximum home name length of 32 characters * 5-row homes GUI * Configurable bed colours * Empty beds can set homes * Occupied beds teleport to homes * Shift-click can delete homes * Locked slots show upgrade messaging * Server and world labels in the GUI *