Leashed Teleport

!(https://cdn.modrinth.com/data/cached_images/371e85a9cb7fabe4a1b7e53839636c939b08d6d0_0.webp) # 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

| 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. | | `ender_pearl_teleport` | boolean | `true` | Allow leashed mobs to follow ender pearl teleports. Set to `false` for vanilla pearl behaviour. | | `chorus_fruit_teleport` | boolean | `true` | Allow leashed mobs to follow chorus fruit teleports. Set to `false` for vanilla chorus fruit behaviour. | | `respectOpenPartiesAndClaims` | boolean | `true` | Respect OPAC claim protections when Open Parties and Claims is installed. | | `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:

```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 telepo