Teleport Commands Fabric

An async 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.0 through 2.2, keep warp.deleteInvalid = false to 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

1. Install Fabric API and your chosen TeleportCommandsFabric build in the server's mods folder.
2. Start the server and run /tpc help or /tpc status.
3. 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:

• /rtp searches within a configurable nearby radius for routine random movement.
• /wild searches 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.