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

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

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:

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.