Перейти к содержимому
Mineforgian

Teleport Commands Fabric (TPC)

Async server-side teleport command mod with multiple teleport features and flexible configuration.

Загрузки
5K
Подписчики
9
Обновлён
24 июля 2026 г.
Лицензия
GPL-3.0-only

Опубликован 21 февраля 2026 г.

Исходный кодСообщить об ошибке

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.

Ченджлог

2.4Релиз26.1.1, 26.1.2, 26.2 · 24 июля 2026 г.

TeleportCommandsFabric v2.4

✨ New Features

Shared Homes

  • Added runtime Home sharing and subscription
    • Publish a Home with /sharehome <name>
    • Subscribe directly from the broadcast message
    • Browse subscriptions with /sharedhomes
    • Teleport with /sharedhome <name>
  • Added pagination, sorting, filtering, map visibility controls, and unsubscribe actions to /sharedhomes
  • Added shared Home synchronization for supported Xaero and JourneyMap integrations
  • Added configurable publication limits and broadcast cooldowns

Home and Warp Management

  • Added dedicated management pages for Homes and Warps
  • Added context-preserving actions that return to the previous filtered, sorted, and paginated list
  • Added delete confirmation to reduce accidental removals
  • Home management now also supports publishing and withdrawing shared Homes

Wild Teleport

  • Added /wild as an independent long-range exploration teleport
  • Added configurable Wild module state, minimum radius, and maximum radius
  • Wild loads distant candidate chunks in bounded batches and searches for safe surface destinations
  • /rtp remains the short-range random teleport and uses its existing execution path

🛠 Improvements

  • Shared Home broadcasts are processed with bounded per-tick work, reducing spikes under heavy usage
  • Repeated broadcasts for the same publication are coalesced
  • Updating or deleting a published Home now updates its publication and subscribed map waypoints
  • Overlapping target teleports can share destination preload tickets safely
  • Timed-out safety searches now request cancellation and discard late results without delaying later teleports

🐞 Fixes

  • Fixed Home, Warp, shared Home, and TPA suggestions not consistently filtering against the text already entered
  • Fixed /tpc reload potentially overwriting a configuration change made while reload was still running
  • Fixed integer configuration commands displaying the requested value instead of the normalized value actually stored
  • Fixed safety worker warmup accessing world chunks during early server startup

⚠️ Important Notes

  • Shared Home publications, subscriptions, and personal map visibility preferences are runtime-only and are cleared when the server restarts
  • Temporary Homes cannot be published
  • Version 2.4 retains protocol v1 compatibility with 2.3 clients and servers for existing Home and Warp map synchronization
  • Shared Home map synchronization requires protocol v2, normally meaning both the client and server should use version 2.4
  • This update does not change the configuration or storage schema version
  • Standard and Core builds remain available; the Core build does not bundle map integrations
2.4-coreРелиз26.1.1, 26.1.2, 26.2 · 24 июля 2026 г.

TeleportCommandsFabric v2.4

✨ New Features

Shared Homes

  • Added runtime Home sharing and subscription
    • Publish a Home with /sharehome <name>
    • Subscribe directly from the broadcast message
    • Browse subscriptions with /sharedhomes
    • Teleport with /sharedhome <name>
  • Added pagination, sorting, filtering, map visibility controls, and unsubscribe actions to /sharedhomes
  • Added shared Home synchronization for supported Xaero and JourneyMap integrations
  • Added configurable publication limits and broadcast cooldowns

Home and Warp Management

  • Added dedicated management pages for Homes and Warps
  • Added context-preserving actions that return to the previous filtered, sorted, and paginated list
  • Added delete confirmation to reduce accidental removals
  • Home management now also supports publishing and withdrawing shared Homes

Wild Teleport

  • Added /wild as an independent long-range exploration teleport
  • Added configurable Wild module state, minimum radius, and maximum radius
  • Wild loads distant candidate chunks in bounded batches and searches for safe surface destinations
  • /rtp remains the short-range random teleport and uses its existing execution path

🛠 Improvements

  • Shared Home broadcasts are processed with bounded per-tick work, reducing spikes under heavy usage
  • Repeated broadcasts for the same publication are coalesced
  • Updating or deleting a published Home now updates its publication and subscribed map waypoints
  • Overlapping target teleports can share destination preload tickets safely
  • Timed-out safety searches now request cancellation and discard late results without delaying later teleports

🐞 Fixes

  • Fixed Home, Warp, shared Home, and TPA suggestions not consistently filtering against the text already entered
  • Fixed /tpc reload potentially overwriting a configuration change made while reload was still running
  • Fixed integer configuration commands displaying the requested value instead of the normalized value actually stored
  • Fixed safety worker warmup accessing world chunks during early server startup

⚠️ Important Notes

  • Shared Home publications, subscriptions, and personal map visibility preferences are runtime-only and are cleared when the server restarts
  • Temporary Homes cannot be published
  • Version 2.4 retains protocol v1 compatibility with 2.3 clients and servers for existing Home and Warp map synchronization
  • Shared Home map synchronization requires protocol v2, normally meaning both the client and server should use version 2.4
  • This update does not change the configuration or storage schema version
  • Standard and Core builds remain available; the Core build does not bundle map integrations
2.4-snapshot-2Бета26.1.1, 26.1.2, 26.2 · 20 июля 2026 г.

TeleportCommandsFabric v2.4-snapshot 2

This snapshot introduces Wild as a dedicated long-range exploration teleport and focuses on keeping distant chunk loading controlled under concurrent use.

✨ New Features

Wild Teleport

  • Added /wild as an independent long-range random teleport command
  • Uses the player's current location and dimension as the search center
  • Searches distant surface locations instead of reusing the short-range RTP path
  • Supports the global teleport delay and cooldown
  • Active Wild searches can be cancelled with /tpcancel

Wild Configuration

  • Added an independent Wild module switch:
    • /tpc enable wild
    • /tpc disable wild
  • Added configurable search radii:
    • /tpc config wild minRadius <blocks>
    • /tpc config wild maxRadius <blocks>
  • The default search range is 512 to 4096 blocks
  • The minimum permitted radius is 128 blocks

🛠 Improvements

  • Wild candidate chunks are loaded and processed in bounded batches
  • Surface candidates use a dedicated safety check for standing support, body space, fluids, hazardous blocks, and the world border
  • Wild loading resources are released when the operation succeeds, fails, is cancelled, or the player disconnects
  • Changing dimension during an active Wild search now cancels that search cleanly
  • Multiple concurrent Wild requests share global loading and per-tick processing limits

🐞 Fixes

  • Fixed /tpc config integer success messages sometimes displaying the requested value instead of the normalized value actually saved

⚠️ Notes

  • /wild is now independent from /rtp
    • Use /rtp for nearby random movement
    • Use /wild for long-range exploration
  • Wild uses its own loading and safety pipeline and is not affected by target teleport preload or default safety-check settings
  • Dimensions with a natural ceiling, such as the Nether, are currently unsupported
  • This snapshot does not change the storage schema
2.4-snapshot-1Бета26.1.1, 26.1.2, 26.2 · 17 июля 2026 г.

TeleportCommandsFabric v2.4-snapshot 1

✨ New Features

Shared Homes

  • Added a runtime Shared Home publish/subscribe system
  • Publish or rebroadcast a permanent Home with:
    • /sharehome <name>
    • [Share] and [Broadcast] controls in the Home management page
  • Subscribe to shared Homes directly from chat announcements
  • View subscribed Homes with /sharedhomes
    • Supports pagination, sorting, and filtering
    • Includes teleport, map visibility, and unsubscribe controls
  • Teleport directly to a uniquely named subscribed Home with:
    • /sharedhome <name>
  • Withdraw a published Home to remove all associated subscriptions
  • Renaming or updating a published Home automatically updates its subscribers
  • Shared Home teleports support the existing delay, cooldown, preload, safety-check, rotation, effects, and previous-location behavior

Shared Home Configuration

  • Added /tpc config home sharedMax <count>
    • Controls how many Homes each player may publish
    • Defaults to 1
  • Added /tpc config home sharedBroadcastCooldown <seconds>
    • Controls the minimum interval between broadcasts
    • Defaults to 60 seconds
    • Has a minimum value of 10 seconds
  • Subscription count is not limited

Map Integrations

  • Added Shared Home waypoint synchronization for Xaero and JourneyMap
  • Subscribers can independently control whether each shared Home appears on their map
  • Added map synchronization protocol v2 for Shared Home support
  • Existing protocol v1 clients remain compatible with regular Home and Warp synchronization
  • BlueMap remains limited to server Warp markers

🛠 Improvements

Home and Warp Pages

  • Reworked /homes and /warps actions around dedicated management pages
  • Replaced crowded inline editing controls with a clearer [Manage] action
  • Management pages provide teleport, rename, update, default Home, sharing, and deletion controls where applicable
  • Added confirmation before deleting a Home or Warp
  • Management actions use stable waypoint identities instead of relying only on names
  • Page, sorting, and filtering context is preserved when returning from supported management actions

🐞 Bug Fixes

  • Fixed parallel target safety checks applying the 5-second timeout separately to each worker result, which could block a server tick considerably longer than intended
  • Fixed timed-out safety checks performing an additional synchronous main-thread fallback after the timeout
  • Safety batches now use one shared 5-second deadline; timed-out operations fail safely, late results are discarded, and unfinished workers cancel cooperatively

⚠️ Snapshot Notes

  • This is a beta snapshot intended for testing before the final v2.4 release
  • Shared Home publications and subscriptions are runtime-only and reset when the server restarts
  • Temporary Homes cannot be shared
  • Shared Home map synchronization requires v2.4 integration support on both the client and server
  • The Standard build includes Xaero and JourneyMap Shared Home integration
  • The Core build supports Shared Homes through commands and chat UI without bundled map integrations
  • No storage schema version change is required
2.3.1Релиз26.1.1, 26.1.2, 26.2 · 14 июля 2026 г.

TeleportCommandsFabric v2.3.1

This maintenance release focuses on stability, safety, and map integration reliability following the v2.3 release.

🛠 Improvements

  • Limited target chunk preload radius to a maximum of 3 chunks
    • Existing larger values are normalized automatically
    • /tpc config teleporting preloadRadius now enforces the same range
  • Improved /tpc help and /tpc status so they report whether client map synchronization is available
  • Updated the bundled Xaero integration metadata to reflect its client-side runtime role

🐞 Fixes

  • Fixed teleport safety workers attempting to load missing chunks synchronously
    • Safety warmup now waits for all required chunks to finish loading
    • Parallel safety checks no longer fall back to worker-thread world chunk loading
  • Fixed an asynchronous cleanup edge case that could remove a newly created or updated home/warp sharing the name of an older invalid waypoint
  • Fixed a BlueMap lifecycle race that could access an outdated API instance while BlueMap was being disabled or reloaded
  • Hardened current and legacy map synchronization packets against malformed waypoint counts and unsafe client-side memory allocation

📦 Upgrade Notes

  • No config or storage migration is required
  • Both Standard and Core builds retain the same core teleport and storage behavior
  • Updating from 2.3 to 2.3.1 is recommended
2.3.1-coreРелиз26.1.1, 26.1.2, 26.2 · 14 июля 2026 г.

TeleportCommandsFabric v2.3.1

This maintenance release focuses on stability, safety, and map integration reliability following the v2.3 release.

🛠 Improvements

  • Limited target chunk preload radius to a maximum of 3 chunks
    • Existing larger values are normalized automatically
    • /tpc config teleporting preloadRadius now enforces the same range
  • Improved /tpc help and /tpc status so they report whether client map synchronization is available
  • Updated the bundled Xaero integration metadata to reflect its client-side runtime role

🐞 Fixes

  • Fixed teleport safety workers attempting to load missing chunks synchronously
    • Safety warmup now waits for all required chunks to finish loading
    • Parallel safety checks no longer fall back to worker-thread world chunk loading
  • Fixed an asynchronous cleanup edge case that could remove a newly created or updated home/warp sharing the name of an older invalid waypoint
  • Fixed a BlueMap lifecycle race that could access an outdated API instance while BlueMap was being disabled or reloaded
  • Hardened current and legacy map synchronization packets against malformed waypoint counts and unsafe client-side memory allocation

📦 Upgrade Notes

  • No config or storage migration is required
  • Both Standard and Core builds retain the same core teleport and storage behavior
  • Updating from 2.3 to 2.3.1 is recommended
2.3Релиз26.1.1, 26.1.2, 26.2 · 8 июля 2026 г.

TeleportCommandsFabric v2.3

📦 Build Variants

This version now provides two build variants:

  • Standard build
    Includes the full TeleportCommandsFabric experience, with bundled map integrations for Xaero, JourneyMap, and BlueMap.

  • Core build
    Includes the core teleport features only, without bundled map integrations. Use this if you want the smallest build or do not need map mod integration.

Core teleport commands and storage behavior are the same between both builds.

✨ New Features

Map Integrations

  • Added JourneyMap integration

    • Syncs TPC homes and warps to JourneyMap
    • Supports TPC teleport routing from synced JourneyMap waypoints
    • Supports TPC death-location teleport handling for matching JourneyMap death waypoints

  • Added BlueMap integration

    • Publishes server-side warp markers to BlueMap web maps

  • Added a shared map integration sync layer used by bundled map integrations

Compatibility

  • Added a legacy Xaero sync compatibility path for waypoint snapshot exchange during the transition from 2.2 and older builds to 2.3+
  • Added Mod Menu build-variant badges and updated mod metadata

🛠 Improvements

  • Improved map waypoint synchronization so clients only receive changed waypoint snapshots instead of repeated unchanged data
  • Improved synced waypoint persistence behavior for supported map integrations
  • Updated admin command wording from Xaero-specific naming to the more general integration module naming
  • Improved RTP chunk-read handling for safer random teleport searches
  • Kept the existing xaero config section for backward compatibility
  • Normalized command return values across modules for clearer behavior in command blocks and admin tooling
  • Improved teleport execution state handling
    • Previous-location records are captured before teleport and saved only after successful teleport execution
  • Improved target teleport safety checks for special collision blocks
    • Doors are treated as passable space
    • Fences, walls, and fence gates are no longer accepted as safe standing support
  • Added a defensive timeout fallback for parallel target teleport safety checks

🐞 Fixes

  • Fixed a data-loss risk where enabling deleteInvalid could remove valid warp data during server startup before all dimensions were available
    • Valid entries are no longer removed during startup just because their dimension is not available yet
  • Fixed creative/fall-flying state and camera reset edge cases after teleport, especially around cross-dimension teleport behavior
  • Cleaned command suggestions for new warp names so /setwarp no longer suggests existing warp names

⚠️ Notes

  • The Standard build is recommended for players who want map integration features
  • The Core build does not include Xaero, JourneyMap, or BlueMap integration code
  • The config file still uses the historical xaero section name for map integration settings
  • For map sync features, using matching 2.3 client/server builds is recommended
  • Back up your server data before upgrading, as usual for storage-related updates
2.3-coreРелиз26.1.1, 26.1.2, 26.2 · 8 июля 2026 г.

TeleportCommandsFabric v2.3

📦 Build Variants

This version now provides two build variants:

  • Standard build
    Includes the full TeleportCommandsFabric experience, with bundled map integrations for Xaero, JourneyMap, and BlueMap.

  • Core build
    Includes the core teleport features only, without bundled map integrations. Use this if you want the smallest build or do not need map mod integration.

Core teleport commands and storage behavior are the same between both builds.

✨ New Features

Map Integrations

  • Added JourneyMap integration

    • Syncs TPC homes and warps to JourneyMap
    • Supports TPC teleport routing from synced JourneyMap waypoints
    • Supports TPC death-location teleport handling for matching JourneyMap death waypoints

  • Added BlueMap integration

    • Publishes server-side warp markers to BlueMap web maps

  • Added a shared map integration sync layer used by bundled map integrations

Compatibility

  • Added a legacy Xaero sync compatibility path for waypoint snapshot exchange during the transition from 2.2 and older builds to 2.3+
  • Added Mod Menu build-variant badges and updated mod metadata

🛠 Improvements

  • Improved map waypoint synchronization so clients only receive changed waypoint snapshots instead of repeated unchanged data
  • Improved synced waypoint persistence behavior for supported map integrations
  • Updated admin command wording from Xaero-specific naming to the more general integration module naming
  • Improved RTP chunk-read handling for safer random teleport searches
  • Kept the existing xaero config section for backward compatibility
  • Normalized command return values across modules for clearer behavior in command blocks and admin tooling
  • Improved teleport execution state handling
    • Previous-location records are captured before teleport and saved only after successful teleport execution
  • Improved target teleport safety checks for special collision blocks
    • Doors are treated as passable space
    • Fences, walls, and fence gates are no longer accepted as safe standing support
  • Added a defensive timeout fallback for parallel target teleport safety checks

🐞 Fixes

  • Fixed a data-loss risk where enabling deleteInvalid could remove valid warp data during server startup before all dimensions were available
    • Valid entries are no longer removed during startup just because their dimension is not available yet
  • Fixed creative/fall-flying state and camera reset edge cases after teleport, especially around cross-dimension teleport behavior
  • Cleaned command suggestions for new warp names so /setwarp no longer suggests existing warp names

⚠️ Notes

  • The Standard build is recommended for players who want map integration features
  • The Core build does not include Xaero, JourneyMap, or BlueMap integration code
  • The config file still uses the historical xaero section name for map integration settings
  • For map sync features, using matching 2.3 client/server builds is recommended
  • Back up your server data before upgrading, as usual for storage-related updates

Комментарии

Загружаем…