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 teleports with you when you use /tp.
• 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 and cross-dimension teleports when LuckPerms is installed.
• 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.
• In-game commands — /leashedteleport info and /leashedteleport reload (operator level 2 required).
• 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.

---

🔄 Commands

Command	Description
/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.

Field	Type	Default	Description
leash_radius	double	10.0	Maximum distance in blocks from the player. Mobs further away are not teleported.
useLuckPerms	boolean	false	When true, Leashed Teleport checks LuckPerms permission nodes if LuckPerms is installed.
cross_dimension_teleport	boolean	true	Allow mobs to follow across dimensions. Set to false to restrict to the current dimension.
damage_resistance_duration_ticks	int	100	Duration of Damage Resistance V + Slow Falling after teleport (20 ticks = 1 second).
entity_blacklist	list	[]	Entity type IDs that will never teleport. See example below.

Blacklist Example

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

{
  "leash_radius": 15.0,
  "useLuckPerms": true,
  "cross_dimension_teleport": 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.).

🔐 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

Permission	Description
leashedteleport.use	Allow a player to bring leashed mobs along during teleports
leashedteleport.crossdimensionteleport	Allow a player to bring leashed mobs across dimensions

Example groups

group.default:
  permissions:
    - leashedteleport.use

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

LuckPerms quick start

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

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

Official LuckPerms docs:

• LuckPerms Wiki
• LuckPerms Command Usage

---

🧑‍🤝‍🧑 Compatibility

Mod	Status
Essential Commands	✅ Compatible
Fabric Essentials	✅ Compatible
TpWithMe	✅ Compatible

---

🧾 Notes

• Only /tp-based teleportation is supported. 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.
• /leashedteleport info is operator-only and shows whether LuckPerms is disabled, configured, but mod not installed, or active.
• Mod Menu and Cloth Config are purely optional client-side extras. A dedicated server does not need them.

---

📦 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.