Teleport Commands Fabric
A server-side-first teleport toolkit for Fabric servers.
Give players Homes, Warps, TPA, Back, short- and long-range random teleport, shared locations, and map integration without installing a large server plugin stack. Every core command works with a vanilla client; installing the Standard build on the client adds richer map interaction.
Wiki · Source · Issues · Discord
⚠️ Important Upgrade Warning
If you use TeleportCommandsFabric
2.0through2.2, keepwarp.deleteInvalid = falseto avoid data loss. Enabling it in those versions can incorrectly remove all Warp data when the server starts.
Upgrade to a current release before enabling invalid Warp cleanup, and back up your server data before any major update.
Choose Your Build
| Build | Includes | Recommended for |
|---|---|---|
| Standard | All teleport features plus bundled Xaero, JourneyMap, and BlueMap integrations | Most servers and players |
| Core | The same core commands and storage behavior, without bundled map-integration code | Command-only servers or setups that do not need map integration |
Not sure which file to download? Choose Standard. Bundled integrations remain inactive when their corresponding map mods are absent.
For client waypoint synchronization, install the Standard build on both the server and client. A Core server still provides every teleport command, but it does not send waypoint data to Standard clients.
Quick Installation
- Install Fabric API and your chosen TeleportCommandsFabric build in the server's
modsfolder. - Start the server and run
/tpc helpor/tpc status. - Optionally install the Standard build on clients that use Xaero or JourneyMap integration.
No client installation is required for commands, clickable chat controls, TPA actions, or list pages.
What It Adds
| Feature | What players can do |
|---|---|
| Homes | Save permanent or temporary personal locations, choose a default Home, restore facing direction, and manage everything from /homes |
| Warps | Travel to administrator-managed server destinations with personal and global map-visibility controls |
| TPA | Send /tpa and /tpahere requests, accept or deny them from chat, and define per-player or global trust rules |
| Back | Return to the latest death location or the position before the previous TPC teleport, with /back preview |
| RTP | Find a safe random destination within a configurable nearby radius |
| Wild | Explore farther away through a separate long-range surface teleport designed for large search radii |
| World Spawn | Return to the configured world spawn through the same controlled teleport flow |
| Shared Homes | Publish a Home, subscribe from chat, and browse subscribed locations through /sharedhomes |
Common player commands:
/home /homes /warp /warps
/tpa /tpahere /back /rtp /wild
/worldspawn /tpcancel /sharehome /sharedhome /sharedhomes
The Wiki contains complete syntax, permissions, configuration, and module-specific behavior.
Clickable Home and Warp Pages
/homes and /warps are compact chat interfaces rather than plain text dumps:
- page navigation with four locations per page;
- filtering by initial letter or dimension;
- sorting by name or creation sequence;
- clickable teleport and map-visibility controls;
- dedicated management pages for update, rename, default Home, sharing, and deletion;
- confirmation before a Home or Warp is deleted.
The current page, filter, and sort state is preserved when returning from management actions. All controls work with a vanilla client.
Shared Homes
Players can publish permanent Homes without copying location data into another profile:
/sharehome <name>
/sharedhomes
/sharedhome <name>
Other online players receive a chat action that lets them subscribe. Subscribed Homes have their own paginated page, personal map visibility, teleport action, and unsubscribe control.
The original player keeps ownership. Renaming or updating the Home updates it for subscribers; withdrawing or deleting it removes the subscriptions. Publications and subscriptions are session state and reset when the server restarts, while the original Home remains stored normally.
Administrators can configure publication limits and broadcast cooldowns through /tpc config home.
RTP and Wild
Two random-teleport modes cover different server needs:
/rtpsearches within a configurable nearby radius for routine random movement./wildsearches distant surface locations for exploration, with a default range of 512 to 4096 blocks.
Wild prepares candidate chunks in bounded batches, validates surface destinations through its own safety path, and releases loading resources when the search finishes or is cancelled. Configure its radius through /tpc config wild, or cancel an active search with /tpcancel.
RTP and Wild use their own destination-selection and safety logic. They do not depend on the target preload and default safety settings used by Home, Warp, Back, and World Spawn.
Map Integrations
The Standard build bundles support for:
| Integration | Support |
|---|---|
| Xaero's Minimap / World Map | Personal Homes, server Warps, subscribed Shared Homes, waypoint visibility, and TPC teleport routing |
| JourneyMap | Separate TPC waypoint groups for Homes, Warps, and Shared Homes, plus teleport routing and matching death-location handling |
| BlueMap | Public server Warp markers on BlueMap web maps |
Xaero and JourneyMap synchronization requires the Standard build on both the server and client, together with the corresponding map mod. BlueMap integration runs on the server; players view its markers through the server's BlueMap website.
Disable all bundled map integration at runtime with:
/tpc disable integration
Core teleport commands remain available whether or not a supported map mod is installed.
Server Control
Known-target teleports support configurable delay, cooldown, chunk preloading, safety searches, rotation restoration, effects, and previous-location recording. Administrators can manage common settings while the server is running:
/tpc status
/tpc enable <module>
/tpc disable <module>
/tpc config <module> ...
/tpc reload
/tpc debug <true|false>
Target preloading and default target safety checks are disabled by default. They can be enabled through /tpc config teleporting; target safety searching only runs while target preloading is enabled. RTP and Wild keep their independent loading and safety behavior.
Need command examples or configuration details? Start with the Quick Start or browse the full Wiki.
