🪢 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).

🔄 Commands

/leashedteleport info - OP only. - Display the current config values and LuckPerms status 
/leashedteleport reload - OP only. - Reload the config from disk without restart

⚙️ 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.

Blacklist Example

Use the blacklist to exclude specific mobs — for example animals that are too large or too dangerous to bring along:

json
{
  "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.

🔐 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

`leashedteleport.use` - Allow a player to bring leashed mobs along during teleports 
`leashedteleport.crossdimensionteleport` - Allow a player to bring leashed mobs across dimensions 
`leashedteleport.enderpearlteleport` - Allow a player to bring leashed mobs along with ender pearl teleports
`leashedteleport.chorusfruitteleport` - Allow a player to bring leashed mobs along with chorus fruit teleports

LuckPerms quick start

/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: https://luckperms.net/wiki/Home
LuckPerms Command Usage: https://luckperms.net/wiki/Command-Usage

🧑‍🤝‍🧑 Compatibility

🧾 Notes

• Only `/tp`-based teleportation is supported. Portals do not trigger leash teleportation.
• Supported player teleport types are `/tp`, ender pearls, and chorus fruit. Portals do not trigger leash teleportation.
• For cross-dimension teleports, the leash is re-attached as soon as the entity is loaded in the new dimension.
• Protection effects are applied silently.
• The safety system checks for hazards like lava, fire, void, and suffocation. If the exact teleport destination is unsafe, the mod searches within a 5-block radius for a safe alternative. This prevents accidental mob deaths from teleporting into dangerous locations.
• The mod must be installed server-side. Players do not need to install the mod on their client. This mod does work in single-player.
• Mod Menu and Cloth Config are purely optional client-side extras. A dedicated server does not need them.
• `/leashedteleport info` is operator-only and shows whether LuckPerms is `disabled`, `configured, but mod not installed`, or `active`, plus whether OPAC checks are enabled.
  
  

📦 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