Leashed Teleport

A Fabric mod for Minecraft that brings your leashed entities along when you teleport via /tp.

✨ Features

• Leash-based teleportation — any mob leashed directly to you and within the configured radius can follow your /tp, ender pearl, and chorus fruit teleports.
• Intelligent safety checks — the mod automatically detects unsafe destinations (lava, fire, void, suffocation hazards) and finds a nearby safe location within a 5-block radius. If no safe spot is found, the teleport is cancelled to prevent mob death.
• Fall damage protection — teleported entities receive Damage Resistance V and Slow Falling for a configurable duration to survive the landing.
• Tame ownership check — tamed animals (dogs, cats, horses, etc.) only teleport if they are owned by the teleporting player. Animals tamed by other players are left behind.
• Sitting entities supported — sitting tamed animals teleport as long as they are leashed to and owned by the teleporting player.
• Cross-dimension support — entities can optionally follow you across dimensions (Overworld ↔ Nether ↔ End). Enabled by default; toggleable in config.
• Optional LuckPerms integration — enable permission nodes for general use, cross-dimension teleports, ender pearls, and chorus fruit when LuckPerms is installed.
• Optional Open Parties and Claims integration — when OPAC is installed, leashed mobs respect claim access plus OPAC's teleport, ender pearl, and chorus fruit protection rules.
• World border aware — if the destination is outside the world border, leashed entities are not teleported.
• Configurable blacklist — define entity types that should never teleport, even if leashed to you.
• Optional Mod Menu integration — when Mod Menu and Cloth Config are present on the client, you can edit the same config through an in-game screen.
• In-game commands — /leashedteleport info and /leashedteleport reload (operator level 2 required).
• Supports - Moonrise, C2ME and Async

🔄 Commands

⚙️ Configuration

Config file: .minecraft/config/leashedteleport.json

A default config is created automatically on first launch, with inline comments that explain each option.

If Mod Menu is installed on the client, Leashed Teleport exposes a config screen there too. Cloth Config is optional: without it, the mod still works normally, but no config GUI is shown.

{
  "leash_radius": 15.0,
  "useLuckPerms": true,
  "cross_dimension_teleport": true,
  "ender_pearl_teleport": true,
  "chorus_fruit_teleport": true,
  "respectOpenPartiesAndClaims": true,
  "damage_resistance_duration_ticks": 100,
  "entity_blacklist": [
    "minecraft:cow",
    "minecraft:pig",
    "minecraft:bee",
    "minecraft:horse",
    "minecraft:llama"
  ]
}

Note: Only mobs that can actually be leashed will ever teleport. You don't need to blacklist mobs that cannot be leashed in vanilla Minecraft (such as most hostile mobs, villagers, etc.).

🛡️ Open Parties and Claims

Open Parties and Claims is optional. Leashed Teleport does not depend on it directly, but when OPAC is installed and respectOpenPartiesAndClaims is true, leashed mobs will not be carried into claims that block the matching action.

• /tp and other general player teleports require normal claim access.
• Ender pearl mob-follow checks OPAC's Ender Pearls entity barrier group when that dynamic option exists.
• Chorus fruit mob-follow respects OPAC's chorus fruit claim exception/protection option.

Set respectOpenPartiesAndClaims to false if you want Leashed Teleport to ignore OPAC claim rules.

If OPAC is installed but its protection API cannot be read, mob-follow teleports are blocked and a warning is logged. Missing pearl or chorus protection options also deny entry for players without normal claim access. Without OPAC installed, teleports work normally.

🔐 LuckPerms

Leashed Teleport only uses LuckPerms when both conditions are true:

1. useLuckPerms is set to true in config/leashedteleport.json
2. The luckperms mod is actually installed on the server

If either condition is false, everyone can use Leashed Teleport and no permission plugin is required. If LuckPerms is active, missing permission nodes default to false.

Permission nodes

group.default:
  permissions:
    - leashedteleport.use

group.vip:
  permissions:
    - leashedteleport.use
    - leashedteleport.crossdimensionteleport
    - leashedteleport.enderpearlteleport
    - leashedteleport.chorusfruitteleport
    - leashedteleport.crossdimensionteleport

/lp group default permission set leashedteleport.use true
/lp group default permission set leashedteleport.crossdimensionteleport false
/lp group default permission set leashedteleport.enderpearlteleport false
/lp group default permission set leashedteleport.chorusfruitteleport false

/lp group vip permission set leashedteleport.use true
/lp group vip permission set leashedteleport.crossdimensionteleport true
/lp group vip permission set leashedteleport.enderpearlteleport true
/lp group vip permission set leashedteleport.chorusfruitteleport true

Official LuckPerms docs:

• LuckPerms Wiki
• LuckPerms Command Usage

🧑‍🤝‍🧑 Compatibility

This mod works with Moonrise, C2ME and Async. Some of these mods cannot be loaded together.

📦 Installation

1. Install Fabric Loader for Minecraft.
2. Download Fabric API and place it in mods/.
3. Download leashedteleport-<version>.jar and place it in mods/.
4. Launch Minecraft. The config is created automatically on first run.

🏜️ Test Server

Feel free to join my Minecraft server to test my mods: play.swordfishbe.eu