TeleHop

[2.0.0] - 2026-06-01 Added Version Adapters Multi-version support: a single JAR runs on Paper 1.21.x (Java 21) and Paper 26.1.x (Java 25) VersionAdapter interface abstracts World.getName() and Bukkit.getWorld() across API versions Paper121Adapter for 1.21.x (standard name-based world resolution) Paper261Adapter for 26.1.x (key-based world resolution with name fallback) Runtime version detection in Bootstrap using getMinecraftVersion() with Bukkit version string fallback Adapters loaded via Class.forName reflection to avoid NoClassDefFoundError on unsupported versions CI verification that both adapter modules compile against their respective Paper API versions Homes Named homes system: /sethome <name>, /home <name>, /delhome <name> Up to 10 homes per player, gated by telehop.homes.1 through telehop.homes.10 permissions 5-row GUI with configurable bed colours, world/server labels, and clickable set/delete Home names are case-insensitive, alphanumeric with spaces allowed, max 32 characters Blocked servers and blocked server prefixes to restrict where homes can be set Cross-server home teleportation via Velocity routing Back and Last Location /back and /back death to return to last teleport or death location (session-only, cross-server) /lastlocation (aliases: /lastloc, /backlast, /ll) for persistent logout location tracking Saved on quit, persisted in MySQL last_locations table Cross-server support with automatic server transfer TPA Toggle /tpatoggle to block incoming TPA requests (session-only, cross-server aware) Random Respawn Players respawn at a random safe location on death instead of world spawn Fully async safe-location search using Paper's HeightMap API Configurable via config/respawn.yml (world, radius, bed/anchor respect) Automatically skipped on the hub server Multi-Proxy Support Opt-in Redis-based cross-proxy communication for multiple Velocity proxies TPA requests, admin teleports, transfers, and player lists all work across proxy boundaries Region-aware /spawn routing maps servers to regional hubs (e.g. EU players go to lobby-eu) Configurable via multi-proxy.enabled, proxy.id, Redis connection in config.properties Coordinate Teleportation /tp <x> <y> <z> and /tp <player> <x> <y> <z> with cross-server support Admin Commands /forcedelhome <player> to list and delete a player's homes /forcesethome <player> <name> to set a home for another player /listhomes <player> with clickable [TP] and [DELETE] buttons /forcelastloc <player> (alias /forcell) to view, teleport to, or clear a player's last logout location /playerinfo <player> (alias /pinfo) to view a player's TeleHop data summary /forcedelwarp <name> and /forcedelwarp <player> <name> for admin warp management /listwarps [player] to list all player warps across servers RTP GUI Back button (spectral arrow) in the dimension picker to return to region selection Teleport Effects Configurable particles and sounds per teleport type (spawn, tpa, rtp, warp, home, back) Configuration Modular config split: config/general.yml, database.yml, features.yml, teleport.yml, tpa.yml, rtp.yml, home.yml, respawn.yml Auto-migration from legacy monolithic config.yml Configuration wiki (WIKI.md) bundled in plugins/TeleHop/config/ on first run In-Game Help /telehop help with categorised command listing (general, TPA, homes, back, warps, admin) /telehop perms with all permission nodes and descriptions CI/CD GitHub Actions: CI (checkstyle, tests, build), PR checks, release workflow, CodeQL security scanning Version consistency checks across pom.xml, plugin.yml, and Velocity @Plugin YAML syntax validation and language key parity checks Tab completion works across the entire network (player names + warp names) Permission-gated tab complete: /tp, /tphere, admin subcommands hidden from non-admins Changed (from 1.0.0) Homes migrated from slot-based (uuid, slot INT) to name-based (uuid, name VARCHAR) schema Cross-server home packets use homeName instead of homeSlot home.yml defaults: max-slots: 10, gui-rows: 5 SpawnCommand uses region-aware hub resolution AdminTeleportCommand supports coordinate forms alongside player-name modes Jedis 5.1.0 added as a dependency (shaded in Velocity JAR) for multi-proxy support Migration from 1.0.0 Drop in the new 2.0.0 JARs (Paper + Velocity) Homes table is migrated automatically on first startup (slot numbers converted to names) No manual database intervention needed Grant telehop.homes.N (2-10) to ranks via LuckPerms for additional home slots If upgrading from a pre-split config.yml, the plugin auto-migrates to the config/ directory layout

Version 1.0.2 Focus - Stability across servers - Safer teleport handling - Full feature completion for network use Added - Random respawn system on death - Async safe location search for respawn and RTP - Respawn configuration file (respawn.yml) - Auto-generated WIKI.md config reference - Expanded feature toggles for per-server control Improved - Cross-server sync for homes, warps, and TPA - Teleport safety checks to prevent unsafe locations - Async performance for teleport operations - Back command tracking across server boundaries - Config migration system with non-destructive updates - Reliability of MySQL-backed shared data Fixed - Cross-server teleport failures in edge cases - TPA request desync between servers - Back command inconsistencies after death - Incorrect handling when target server is unavailable - Minor permission inconsistencies across modules Notes - Random respawn is enabled by default - Existing configs are not overwritten on update - Legacy config.yml is migrated automatically to .old - Requires MySQL for full cross-server functionality

Changelog

[1.0.0] - 2025-04-11

Initial Release

This is the first public release of TeleHop.

Added

- /spawn — Cross-server hub teleportation - /tpa, /tpahere, /tpaaccept, /tpadeny, /tpacancel — Full TPA system, cross-server - /tpatoggle — Session-based toggle to block incoming TPA requests - /warp, /setwarp, /delwarp, /warps — Admin warp system, shared across all servers via MySQL - /pwarp — Player warp system with per-rank limits and public/private toggle - /home, /sethome — Permission-based home slots (1-5) with chest GUI and cross-server support - /back, /back death — Return to last teleport or death location, cross-server - /rtp — Random teleport with GUI region and dimension picker, safe landing detection - /tp, /tphere — Cross-server admin teleportation - /telehop reload/version/perms/help — Admin management commands - /listwarps, /forcedelwarp, /forcedelhome — Network-wide admin oversight - Configurable teleport effects (particles and sounds) per teleport type - Per-server feature toggles via features.yml - Modular config layout (general.yml, database.yml, features.yml, teleport.yml, tpa.yml, rtp.yml, home.yml) - Auto-migration from legacy monolithic config.yml to modular config/ layout - MySQL backend with automatic table creation on first startup; MariaDB 10.5+ supported - LuckPerms integration for permission-based home slots and player warp limits - 6 built-in languages: English, Dutch, German, Spanish, Chinese, and Polish - Network-wide tab completion for player and warp names - Full Velocity 3.3+ and Paper 1.21+ support