Teleport Utils
Moving a single player across the map is simple. Moving a player, their horse, the chest boat the horse is riding in, and three leashed wolves all at once is a different story entirely. That is the exact problem Teleport Utils was built to solve. This library mod provides a universal, consistent API for teleporting nearly every kind of entity in Minecraft through a single method call, eliminating the messy type-checking that developers normally have to write by hand.
If you are a mod developer tired of writing separate teleport logic for players, animals, and vehicles, or a server admin curious about what this library unlocks, this guide covers everything you need to know.
What Teleport Utils Actually Does
At its core, the mod offers TeleportUtils.teleportEntity(...), a universal API that handles teleportation for many entity types, including players, animals, and more, using one method with many configurable options. The key word here is consistency: the same call behaves predictably whether the target is a villager, a minecart, or a player, which dramatically reduces edge cases in your code.
Beyond the basic method, the library ships a far more powerful option: TeleportUtils.teleportEntityWithItsPassengersLeashedAnimalsAndVehiclesRecursively(...). That mouthful of a name describes exactly what it does. It teleports an entity together with its passengers, leashed animals, and ridden vehicles, and it does so recursively. A player riding a boat that is towing a leashed llama? All of it moves together, correctly.
Inter-Dimensional and Portal Support
Teleportation is not limited to the Overworld. Inter-dimensional equivalents of the API were added for portal support, meaning you can travel through portals while riding a mount or leading leashed animals. This closes a long-standing gap in vanilla behavior where pets and vehicles often get left behind during dimension changes.
The /teleportWith Command
To prove the concept in real gameplay, the library includes a command called /teleportWith, along with its shorter alias /tpw. The command deliberately mirrors the signature of the vanilla /teleport and /tp commands, so experienced players can pick it up immediately without consulting documentation. The difference is that it moves connected entities along with the target.
- /teleportWith — teleports a target plus its attached entities.
- /tpw — the aliased, quicker-to-type version.
- Familiar syntax — matches vanilla argument order for minimal relearning.
Supported Versions and Loaders
Teleport Utils is built for Minecraft Java Edition and is distributed as a library mod for the Fabric loader, targeting modern 1.20.x and 1.21.x releases. Because it is a library rather than a standalone gameplay mod, you will most often encounter it bundled as a dependency inside larger mods. If you plan to download Teleport Utils for Minecraft on its own, check the mod page for the exact build matching your game version before installing.
Required Companion Fixes
The library depends on two companion patches from the same author to function correctly:
- player-vehicle-desync-fix — resolves desynchronization between players and the vehicles they ride.
- mtq-fix — a supporting fix required for correct teleport behavior.
Install both alongside the library, or teleportation of mounted entities may behave unpredictably.
How to Install Teleport Utils
Getting the mod running is straightforward, even if you are new to Fabric modding.
- Confirm your Minecraft version matches a supported Teleport Utils build.
- Install the Fabric loader and place the Fabric API jar in your mods folder.
- Download Teleport Utils and drop the jar into the same mods folder.
- Add the player-vehicle-desync-fix and mtq-fix jars as well.
- Launch the game and verify the mod loads without errors.
If you would rather skip manual jar juggling, the foxygame.net launcher streamlines the whole process: it installs Teleport Utils and its required companion fixes in one click, keeps every dependency version-matched automatically, and flags incompatible builds before they ever reach your mods folder. For players who manage dozens of Fabric mods, that kind of automated version compatibility checking saves hours of troubleshooting.
Why Developers Rely on This Library
Writing teleport logic from scratch means handling passengers, leads, vehicles, and cross-dimension edge cases one by one. Teleport Utils collapses that work into a pair of well-documented methods, and the recursive variant covers scenarios that would otherwise take hundreds of lines of custom code. The included command serves as both a testing tool and a genuinely useful admin utility.
Special credit goes to blay09 and LordDeatHunter, whose open-source code contributed significantly to the core logic behind these APIs.
Final Thoughts
Teleport Utils fills a niche that vanilla Minecraft has never addressed properly: moving entire entourages of entities in one clean operation. Whether you are a mod author building on its API or a player using /tpw to relocate your mounted, leashed menagerie, the library delivers consistency where the base game offers only frustration. Pair it with the required fixes, match your Minecraft version, and teleportation stops being a chore.