Данные могли устареть: источник временно недоступен, показан кэш.

TeleHop
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.
- Загрузки
- 153
- Подписчики
- 4
- Обновлён
- 1 июня 2026 г.
- Лицензия
- MIT
Опубликован 11 апреля 2026 г.
🌐 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.
GitHub · Documentation · Setup · Commands · Permissions · Configuration · Support
✨ 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 support for multi-proxy networks
- Modular config files
- Multi-language support
- LuckPerms support
- Permission-based limits
- Admin management tools
📦 Version 2.0.0
TeleHop 2.0.0 is a major update focused on named homes, last-location tracking, multi-version support, multi-proxy support, stronger admin tools, and better cross-server reliability.
Added
- Multi-version Paper support with runtime version adapters
- Support for Paper 1.21.x with Java 21
- Support for Paper 26.1.x with Java 25
- Named homes with
/sethome <name>,/home <name>, and/delhome <name> - Up to 10 homes per player
- Permission-based home limits
- Homes GUI with 5 rows and configurable bed colours
- Persistent last logout location tracking
/lastlocation,/lastloc,/backlast, and/ll- Redis-based multi-proxy support for multiple Velocity proxies
- Region-aware
/spawnrouting - Coordinate teleport support for admin
/tp - Random respawn with async safe-location search
- RTP GUI back button
- Configurable teleport particles and sounds
- Expanded admin commands for homes, warps, player data, and last locations
- In-game help categories
- In-game permission reference
- CI checks, builds, CodeQL scanning, YAML validation, and language parity checks
Changed
- Homes now use names instead of numeric slots
- Homes now support up to 10 slots instead of 5
- Home GUI now uses a 5-row layout
- Cross-server home packets now use home names
/spawnnow supports regional hub routing- Admin teleport commands now support coordinate teleporting
- Velocity JAR now includes shaded Redis support through Jedis
- Config files now use a modular layout
Migration
- Existing slot-based homes migrate automatically
- Old homes become named homes such as
Home 1,Home 2, andHome 3 - No manual database migration is required
- Legacy
config.ymlmigrates into the new split config layout - Existing config files are not overwritten
- Grant
telehop.homes.2throughtelehop.homes.10for extra home slots
🚀 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
- Cooldown
- Warmup
- 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
- Blocked servers for setting homes
- Players can still teleport to existing homes from blocked servers
📍 Last Location
TeleHop saves each player’s last logout location to MySQL.
Players can return to their last saved logout location across servers.
Commands
/lastlocation/lastloc/backlast/ll
Features
- Saves location on quit
- Persists across restarts
- Works across servers
- Sends players to the correct backend server
- Admins can view, teleport to, or clear saved last locations
🌍 Warps
TeleHop supports admin warps and player warps.
Admin Warps
Commands:
/warp <name>/setwarp <name>/delwarp <name>/warps
Features:
- Global network warps
- Shared across all servers
- Stored in MySQL
- Per-warp permission support
- Cross-server teleporting
Example permission:
telehop.warp.shop
Player Warps
Commands:
/pwarp set <name>/pwarp del <name>/pwarp list/pwarp <name>/pwarp <player> <name>/pwarp public <name>/pwarp admin del <player> <name>
Aliases:
/playerwarp/pwarps
Features:
- Personal player warps
- Public or private toggle
- Cross-server teleporting
- Per-rank limits
- Admin delete command
- MySQL-backed storage
💀 Random Respawn
TeleHop can respawn players at a safe random location after death.
Features:
- Async safe-location search
- Paper HeightMap based lookup
- Configurable world
- Configurable radius
- Bed and respawn anchor respect
- Hub server skip support
- Per-server control through config
- Controlled through
config/respawn.yml
🛠 Admin Commands
TeleHop includes admin commands for cross-server teleporting, warp management, home management, last-location tools, player data checks, and plugin control.
Admin commands are permission-gated and hidden from tab completion for players without access.
TeleHop Management
| Command | Description | Permission |
|---|---|---|
/telehop |
Show TeleHop help | Everyone |
/telehop help |
Show categorised command help | Everyone |
/telehop version |
Show the installed TeleHop version | Everyone |
/telehop ver |
Alias for version | Everyone |
/telehop reload |
Reload config, messages, and warp cache | telehop.admin |
/telehop perms |
List all permission nodes | telehop.admin |
/telehop permissions |
Alias for permissions | telehop.admin |
Admin Teleport
| Command | Description | Permission |
|---|---|---|
/tp <player> |
Teleport yourself to a player across servers | telehop.tp |
/tp <player1> <player2> |
Teleport one player to another player across servers | telehop.tp |
/tp <x> <y> <z> |
Teleport yourself to coordinates in your current world | telehop.tp |
/tp <player> <x> <y> <z> |
Teleport a player to coordinates | telehop.tp |
/tphere <player> |
Pull a player to your location across servers | telehop.tphere |
Warp Admin
| Command | Description | Permission |
|---|---|---|
/setwarp <name> |
Create or update a global admin warp | telehop.admin |
/delwarp <name> |
Delete a global admin warp | telehop.admin |
/listwarps |
List all player warps across all servers | telehop.admin |
/listwarps <player> |
List a specific player’s warps with details | telehop.admin |
/forcedelwarp <name> |
Force-delete an admin warp | telehop.admin |
/forcedelwarp <player> <name> |
Force-delete a specific player warp | telehop.admin |
/pwarp admin del <player> <name> |
Delete any player’s personal warp | telehop.admin |
Home Admin
| Command | Description | Permission |
|---|---|---|
/forcedelhome <player> |
List a player’s homes with clickable delete buttons | telehop.admin |
/forcesethome <player> <name> |
Set a named home for another player at your current location | telehop.admin |
/listhomes <player> |
List a player’s homes with clickable teleport and delete buttons | telehop.admin |
Last Location Admin
| Command | Description | Permission |
|---|---|---|
/forcelastloc <player> |
View a player’s last logout location, including server, world, and coordinates | telehop.admin |
/forcelastloc <player> tp |
Teleport to a player’s saved last logout location | telehop.admin |
/forcelastloc <player> clear |
Clear a player’s saved last logout location | telehop.admin |
Alias:
| Alias | Command |
|---|---|
/forcell |
/forcelastloc |
Player Info
| Command | Description | Permission |
|---|---|---|
/playerinfo <player> |
Show a player’s TeleHop data, including homes, warps, last location, and current server | telehop.admin |
Alias:
| Alias | Command |
|---|---|
/pinfo |
/playerinfo |
🔐 Permissions
Use /telehop perms in-game to view the full permission list.
Player Permissions
| Permission | Command |
|---|---|
telehop.spawn |
/spawn |
telehop.rtp |
/rtp |
telehop.tpa |
/tpa |
telehop.tpahere |
/tpahere |
telehop.tpa.accept |
/tpaaccept |
telehop.tpa.deny |
/tpadeny |
telehop.tpa.cancel |
/tpacancel |
telehop.tpa.toggle |
/tpatoggle |
telehop.warp |
/warp, /warps |
telehop.pwarp |
/pwarp |
telehop.homes |
/home |
telehop.sethome |
/sethome |
telehop.delhome |
/delhome |
telehop.lastlocation |
/lastlocation |
telehop.back |
/back |
telehop.back.death |
/back death |
Home Limit Permissions
| Permission | Effect |
|---|---|
telehop.homes.1 |
1 home |
telehop.homes.2 |
2 homes |
telehop.homes.3 |
3 homes |
telehop.homes.4 |
4 homes |
telehop.homes.5 |
5 homes |
telehop.homes.6 |
6 homes |
telehop.homes.7 |
7 homes |
telehop.homes.8 |
8 homes |
telehop.homes.9 |
9 homes |
telehop.homes.10 |
10 homes |
TeleHop uses the highest matching home permission.
Player Warp Limit Permissions
| Permission | Effect |
|---|---|
telehop.warps.1 |
1 player warp |
telehop.warps.3 |
3 player warps |
telehop.warps.10 |
10 player warps |
telehop.warps.100 |
100 player warps |
telehop.warps.unlimited |
Unlimited player warps |
TeleHop uses the highest matching player warp permission.
Per-Warp Access
| Permission | Effect |
|---|---|
telehop.warp.<name> |
Access a specific admin warp |
Example:
telehop.warp.shop
Bypass Permissions
| Permission | Effect |
|---|---|
telehop.rtp.bypasscooldown |
Skip RTP cooldown |
telehop.rtp.bypassdelay |
Skip RTP warmup |
telehop.tpa.bypasscooldown |
Skip TPA cooldown |
Admin Permissions
| Permission | Effect |
|---|---|
telehop.admin |
Main admin tools, warp management, home management, last-location tools, player info, reload, and permission list |
telehop.tp |
Admin /tp commands |
telehop.tphere |
Admin /tphere command |
telehop.back |
Use /back |
telehop.back.death |
Use /back death |
telehop.warps.unlimited |
Unlimited player warps |
LuckPerms Example
# Default rank
lp group default permission set telehop.warps.3 true
lp group default permission set telehop.homes.2 true
lp group default permission set telehop.lastlocation true
# VIP rank
lp group vip permission set telehop.warps.10 true
lp group vip permission set telehop.homes.5 true
# MVP rank
lp group mvp permission set telehop.warps.unlimited true
lp group mvp permission set telehop.homes.10 true
# Staff rank
lp group staff permission set telehop.admin true
lp group staff permission set telehop.tp true
lp group staff permission set telehop.tphere true
lp group staff permission set telehop.back true
lp group staff permission set telehop.back.death true
lp group staff permission set telehop.warps.unlimited true
lp group staff permission set telehop.homes.10 true
⚡ Highlights
- Built for Velocity networks
- Supports Paper backend servers
- Paper 1.21.x and 26.1.x support
- Runtime version adapters
- MySQL-backed shared storage
- MariaDB support
- Optional Redis support for multi-proxy networks
- Region-aware hub routing
- Named homes
- Player warps
- Admin warps
- Cross-server TPA
- Cross-server
/back - Persistent last logout locations
- Random respawn
- RTP GUI
- Modular configuration
- Auto config migration
- Auto database migration
- Teleport effects
- Multi-language support
- LuckPerms support
- Network-wide tab completion
- Permission-gated admin suggestions
- In-game help
- In-game permission list
🧩 Multi-Server Support
TeleHop is designed for Velocity networks.
Paper handles teleport execution.
Velocity handles routing and player tracking.
MySQL stores shared network data.
Redis can sync multiple Velocity proxies when multi-proxy mode is enabled.
This enables:
- Cross-server TPA
- Cross-server homes
- Cross-server warps
- Cross-server admin teleportation
- Cross-server
/back - Cross-server last-location teleportation
- Shared player tracking
- Shared player warp data
- Shared TPA requests
- Multi-proxy player lists
- Region-aware spawn routing
Both the Velocity plugin and Paper plugin are required.
📥 Requirements
| Software | Version |
|---|---|
| Paper | 1.21.x or 26.1.x |
| Velocity | 3.3+ |
| Java | 21+ for Paper 1.21.x, 25+ for Paper 26.1.x |
| MySQL | 8.0+ |
| MariaDB | 10.5+ |
| LuckPerms | 5.4+ optional |
| Redis | Optional, for multi-proxy mode |
⚙️ Setup
- Create a MySQL database and user.
- Place
telehop-velocity-2.0.0.jarin your Velocity plugins folder. - Place
telehop-paper-2.0.0.jarin each Paper server plugins folder. - Start Velocity and the Paper servers once to generate files.
- Stop the servers.
- Configure MySQL credentials in
plugins/TeleHop/config/database.yml. - Set each Paper server
server-nameinplugins/TeleHop/config/general.yml. - Set the hub server.
- Start Velocity first.
- Start all backend Paper servers.
Database tables are created automatically on first startup.
🔄 Updating
From 1.0.0 or 1.0.2
- Replace the old Paper and Velocity JAR files.
- Start the network normally.
- Homes migrate from slot-based homes to named homes automatically.
- New config files are added automatically.
- Existing config files are not overwritten.
- Legacy
config.ymlmigrates into the split config layout when needed. - The old
config.ymlis renamed toconfig.yml.old. - Add new home permissions if ranks need more than one home.
Home Migration
Old homes convert into named homes during startup.
Example:
- Slot 1 becomes
Home 1 - Slot 2 becomes
Home 2 - Slot 3 becomes
Home 3
No manual SQL changes are needed.
📁 Paper Configuration Layout
plugins/TeleHop/
config/
general.yml
database.yml
features.yml
teleport.yml
tpa.yml
rtp.yml
home.yml
respawn.yml
WIKI.md
storage.yml
languages/
en.yml
nl.yml
de.yml
es.yml
zh.yml
pl.yml
Config Files
| File | Purpose |
|---|---|
general.yml |
Server name, hub server, server list, language, messaging, and regions |
database.yml |
MySQL connection settings |
features.yml |
Feature toggles |
teleport.yml |
Particles and sounds per teleport type |
tpa.yml |
Timeout, cooldown, warmup, and move cancellation |
rtp.yml |
Random teleport regions, dimensions, cooldowns, warmups, and GUI |
home.yml |
Homes, GUI rows, bed colours, blocked servers, and labels |
respawn.yml |
Random respawn behaviour |
WIKI.md |
Generated config reference |
storage.yml |
Runtime data such as spawn location |
languages/ |
Language files |
Most settings reload live with /telehop reload.
MySQL connection settings require a full server restart.
🌐 Velocity Configuration
Velocity uses config.properties.
Main settings include:
- MySQL host
- MySQL port
- MySQL database
- MySQL username
- MySQL password
- MySQL pool size
- Messaging dedupe window
- Request timeout
- Hub server
- Backend server list
- Proxy ID
- Multi-proxy toggle
- Redis host
- Redis port
- Redis password
- Redis channel prefix
🗄 Database Tables
TeleHop creates and updates database tables automatically.
| Table | Purpose |
|---|---|
players |
Tracks each player’s current server |
warps |
Stores admin warps |
player_warps |
Stores player warps |
tpa_requests |
Stores active TPA requests |
homes |
Stores named player homes |
last_locations |
Stores persistent logout locations |
💬 Languages
TeleHop includes 6 built-in languages.
- English
- Dutch
- German
- Spanish
- Chinese
- Polish
English fallback is used when a message key is missing.
Messages support MiniMessage formatting and placeholders.
🧪 Building From Source
mvn clean package
Build outputs:
paper/target/telehop-paper-2.0.0.jar
velocity/target/telehop-velocity-2.0.0.jar
Requires Java 21+ and Maven 3.8+.
The Paper 26.1.x adapter module compiles with Java 25 through Maven toolchains.
⚠ Compatibility
Supported:
- Paper
- Velocity
- MySQL
- MariaDB
- LuckPerms
- Redis for multi-proxy mode
Not supported:
- BungeeCord
- Hybrid servers
- Single-server-only setups without Velocity
👤 Author and Company
Developed by Epildev.
Company: Epildevconnect Ltd Company number: 17247566 Registered in: England and Wales Website: https://developer.epildevconnect.uk/ GitHub: https://github.com/GitEpildev Discord: Epildev
📄 License
TeleHop is licensed under the MIT License with Additional Terms.
Attribution to Epildevconnect Ltd is required.
See the GitHub license file for full details.
Ченджлог
2.0.0Релиз26.1, 26.1.1, 26.1.2 · 1 июня 2026 г.
[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 , /home , /delhome 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 and /tp with cross-server support Admin Commands
/forcedelhome to list and delete a player's homes /forcesethome to set a home for another player /listhomes with clickable [TP] and [DELETE] buttons /forcelastloc (alias /forcell) to view, teleport to, or clear a player's last logout location /playerinfo (alias /pinfo) to view a player's TeleHop data summary /forcedelwarp and /forcedelwarp 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
2.0.0Релиз26.1, 26.1.1, 26.1.2 · 1 июня 2026 г.
[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 , /home , /delhome 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 and /tp with cross-server support Admin Commands
/forcedelhome to list and delete a player's homes /forcesethome to set a home for another player /listhomes with clickable [TP] and [DELETE] buttons /forcelastloc (alias /forcell) to view, teleport to, or clear a player's last logout location /playerinfo (alias /pinfo) to view a player's TeleHop data summary /forcedelwarp and /forcedelwarp 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
1.0.2Релиз1.21.9, 1.21.10, 1.21.11 · 18 апреля 2026 г.
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
1.0.2Релиз1.21.9, 1.21.10, 1.21.11 · 18 апреля 2026 г.
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
1.0.0Релиз1.21.9, 1.21.10, 1.21.11 · 11 апреля 2026 г.
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.ymlto modularconfig/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
1.0.0Бета1.21.9, 1.21.10, 1.21.11 · 11 апреля 2026 г.
Changelog
[1.0.0] - 2026-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.ymlto modularconfig/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
Комментарии
Загружаем…