# \ud83c\udf10 TeleHop
\n**Cross-server teleportation for Paper and Velocity networks**<\/p>\n
TeleHop is a full-featured teleportation suite built for **multi-server Minecraft networks**.
\nEvery feature works across servers, players stay connected across your entire network.<\/p>\n
All data is stored in **MySQL**, so homes, warps, teleport requests, and player state stay synced at all times.<\/p>\n
—<\/p>\n
## \ud83d\udd17 Links
\n– GitHub Repository
\n– Full Documentation
\n– Configuration Guide
\n– Installation Guide
\n– Permissions Reference
\n– Database Structure
\n– Issue Tracker and Support
\n– Releases <\/p>\n
—<\/p>\n
## \ud83d\udce6 Version 1.0.2
\nFocus on **stability, cross-server consistency, and feature completeness.**<\/p>\n
### \u2795 Added
\n– Random respawn system with safe async location search
\n– Respawn config with full control over behaviour
\n– Generated `WIKI.md` config reference on first run
\n– Improved feature toggles for per-server control <\/p>\n
### \ud83d\udd27 Improved
\n– Cross-server sync for homes, warps, and TPA
\n– Teleport safety checks for RTP and respawn
\n– Async handling for teleport and location search
\n– Config migration system with non-destructive updates <\/p>\n
### \ud83d\udc1b Fixed
\n– Cross-server teleport failures in edge cases
\n– TPA desync between servers
\n– Back command inconsistencies after death
\n– Permission inconsistencies across modules <\/p>\n
—<\/p>\n
## \u2728 Features<\/p>\n
### \ud83d\ude80 Teleportation
\n– `\/spawn` send players to the hub server from anywhere
\n– `\/tpa` request teleport to another player across servers
\n– `\/tpahere` pull another player to your location
\n– `\/tpaaccept`, `\/tpadeny`, `\/tpacancel`
\n– `\/tpatoggle` block incoming requests for the session
\n– `\/back` return to last teleport or death location across servers
\n– `\/rtp` random teleport with GUI region and dimension selection, configurable radius, safe landing <\/p>\n
—<\/p>\n
### \ud83d\udc80 Random Respawn
\n– Teleport players to a safe random location on death
\n– Async safe location search
\n– Respects beds and anchors
\n– Skips hub server
\n– Controlled via `respawn.yml`
\n– Enabled by default via `features.yml` <\/p>\n
—<\/p>\n
### \ud83c\udf0d Warps
\n– Admin warps: `\/warp`, `\/setwarp`, `\/delwarp`, `\/warps`
\n– Shared across all servers via MySQL
\n– Player warps: `\/pwarp` with per-rank limits and public or private toggle <\/p>\n
—<\/p>\n
### \ud83c\udfe0 Homes
\n– `\/home`, `\/sethome`
\n– Permission-based slots from 1 to 5
\n– GUI with slot indicators
\n– Cross-server teleport support
\n– Blocked server support <\/p>\n
—<\/p>\n
### \ud83d\udee0 Admin Tools
\n– `\/tp`, `\/tphere` cross-server admin teleportation
\n– `\/telehop reload` reload config
\n– `\/telehop version` show version
\n– `\/telehop perms` list permissions
\n– `\/telehop help` show help
\n– `\/listwarps` list all warps
\n– `\/forcedelwarp` remove warp
\n– `\/forcedelhome` remove player home <\/p>\n
—<\/p>\n
## \u26a1 Highlights<\/p>\n
– Fully cross-server, all features sync across Velocity
\n– MySQL backed, no per-server duplication, MariaDB supported
\n– Random respawn system with full config control
\n– Modular config, enable or disable features per server
\n– Teleport effects, configurable particles and sounds
\n– Multi-language, 6 built-in languages with fallback support
\n– LuckPerms support for limits and permissions
\n– Tab completion across the entire network
\n– Auto config migration with safe updates
\n– `WIKI.md` generated automatically for full config reference <\/p>\n
—<\/p>\n
## \ud83e\udde9 Multi-Server Support<\/p>\n
TeleHop is built for **Velocity networks**, not single-server setups.<\/p>\n
– Velocity handles routing and player tracking
\n– Paper handles teleport execution
\n– MySQL stores shared data <\/p>\n
This enables:
\n– Cross-server TPA and teleportation
\n– Shared homes and warps across all servers
\n– `\/back` working across server boundaries
\n– Session-based TPA toggle synced across servers <\/p>\n
Both Velocity and Paper plugins are required.<\/p>\n
—<\/p>\n
## \ud83d\udce5 Installation<\/p>\n
### Requirements
\n– Paper 1.21+
\n– Velocity 3.3+
\n– Java 21+
\n– MySQL 8.0+ or MariaDB 10.5+
\n– LuckPerms 5.4+ optional <\/p>\n
—<\/p>\n
### Setup
\n1. Create a MySQL database and user
\n2. Place `telehop-velocity-1.0.2.jar` in the Velocity plugins folder
\n3. Place `telehop-paper-1.0.2.jar` in each Paper server plugins folder
\n4. Start Velocity once to generate config, then stop
\n5. Configure `database.yml` with your credentials
\n6. Set `server-name` in `general.yml` to match Velocity config
\n7. Start Velocity, then start all backend servers <\/p>\n
Database tables are created automatically on first startup.
\nRandom respawn is enabled by default. Disable in `features.yml` if needed. <\/p>\n
—<\/p>\n
## \ud83d\udd04 Updating<\/p>\n
– Replace old `.jar` files
\n– New config files are added automatically
\n– Existing configs are not overwritten
\n– Legacy `config.yml` is migrated and renamed to `.old` <\/p>\n
—<\/p>\n
## \ud83d\udcc1 Configuration Layout<\/p>\n
“`
\nplugins\/TeleHop\/
\nconfig\/
\ngeneral.yml
\ndatabase.yml
\nfeatures.yml
\nteleport.yml
\ntpa.yml
\nrtp.yml
\nhome.yml
\nrespawn.yml
\nWIKI.md
\nstorage.yml
\nlanguages\/
\n“`<\/p>\n
—<\/p>\n
## \ud83d\uddc4 Database Tables<\/p>\n
– `players` tracks player server
\n– `warps` stores admin warps
\n– `player_warps` stores player warps
\n– `tpa_requests` stores active requests
\n– `homes` stores player homes <\/p>\n
—<\/p>\n
## \ud83d\udd10 Permissions<\/p>\n
Use `\/telehop perms` in-game for the full list.<\/p>\n
### Default Permissions
\n– `telehop.spawn`
\n– `telehop.rtp`
\n– `telehop.warp`
\n– `telehop.pwarp`
\n– `telehop.tpa`
\n– `telehop.tpahere`
\n– `telehop.tpa.accept`
\n– `telehop.tpa.deny`
\n– `telehop.tpa.cancel`
\n– `telehop.tpa.toggle`
\n– `telehop.homes`
\n– `telehop.homes.1` <\/p>\n
—<\/p>\n
### \ud83c\udfe0 Home Slots
\n– `telehop.homes.1` to `telehop.homes.5` <\/p>\n
—<\/p>\n
### \ud83c\udf0d Player Warp Limits
\n– `telehop.warps.1`
\n– `telehop.warps.3`
\n– `telehop.warps.10`
\n– `telehop.warps.100`
\n– `telehop.warps.unlimited` <\/p>\n
—<\/p>\n
### \ud83d\udd13 Per Warp Access —<\/p>\n ### \ud83d\udee0 Admin Permissions —<\/p>\n ## \u26a0 Compatibility<\/p>\n – Paper only —<\/p>\n ## \ud83d\udc64 Credits<\/p>\n Developed by Epildev & GitEpildev from Epildevconnect ltd Cross-server teleportation suite for Paper + Velocity networks. Includes homes, warps, TPA, RTP, \/back, and \/spawn – all synced across servers via MySQL. Features a modular config, multi-language support, and configurable teleport effects.<\/p>\n","protected":false},"featured_media":152787,"template":"","meta":{"_minecraft_slug":"telehop","_minecraft_project_id":"cjTmNjaL","_minecraft_author":"epildev","_minecraft_license":"MIT","_minecraft_downloads":29,"_minecraft_follows":3,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"telehop.zip","_minecraft_size_bytes":22341093,"_minecraft_version_count":4,"_minecraft_updated_at":"2026-05-15T22:07:08.517829Z","_minecraft_date_created":"2026-04-16T21:57:03.845631Z","_minecraft_date_modified":"2026-04-18T22:29:08.897651Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/telehop","_minecraft_icon_attachment_id":152787,"_minecraft_imported_at":"2026-06-09T05:54:26+00:00","_minecraft_import_hash":"3c0176074a7f7aa16dc5f4ed40d0f42e","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[90,127,91,869,92,985],"mod_loader":[132],"minecraft_version":[40,41,74,38,78,79,80,81,82],"class_list":["post-152786","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-optimization","mod_category-paper","mod_category-storage","mod_category-transportation","mod_category-utility","mod_category-velocity","mod_loader-paper","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n– `telehop.warp.
\n– `telehop.admin`
\n– `telehop.back`
\n– `telehop.back.death`
\n– `telehop.tp`
\n– `telehop.tphere`
\n– `telehop.rtp.bypasscooldown`
\n– `telehop.rtp.bypassdelay`
\n– `telehop.tpa.bypasscooldown`
\n– `telehop.warps.unlimited` <\/p>\n
\n– Velocity only
\n– BungeeCord not supported
\n– Hybrid servers not supported <\/p>\n
\nLicensed under MIT Licence<\/p>\n","protected":false},"excerpt":{"rendered":"