Magic Leads

MagicLeads

• Leashed mobs teleport with you through ender pearls, commands, and portals instead of being left behind.
• Leads never snap from distance; the mob is pulled back to its holder instead.
• Attach leads to any mob: villagers, zombies, iron golems, anything.
• Optional damage protection for leashed mobs.

How It Works

• The chain rule: features apply to a leashed entity only when its holder chain reaches a player (you -> ghast -> boat is magical end to end).
• When you teleport, your whole leashed convoy is brought along and re-attached to its original holders, with the rope rendering between the correct links.

Requirements

• Java 21 or newer.

Setup

1. Add MagicLeads jar into your plugins folder.
2. Restart your server.
3. Edit config.yml to your liking.
4. Type /magicleads reload.

Commands

• /magicleads Show the plugin version and which features are enabled. Alias: /ml.
• /magicleads reload Reload the plugin.

Permissions

• magicleads.leashany.* (default) Allows the player to attach leads to any mob type.
• magicleads.leashany.<type> Allows the player to attach leads to one mob type. The type is the lowercase entity id, for example magicleads.leashany.villager.
• magicleads.leashany Allows the player to attach leads to any mob (legacy catch-all).
• magicleads.reload Allows the player to reload the plugin.

To restrict leashing per mob type, negate magicleads.leashany.* in your permissions plugin and grant the specific magicleads.leashany.<type> nodes you allow.

Configuration
General

• disabled-worlds Worlds where MagicLeads is disabled. Names must match the real world folder name. Default: none.

Teleport With Player

• enabled Leashed mobs teleport along with you. Default: true.
• causes Teleport causes that bring leashed mobs along. Default: ENDER_PEARL, COMMAND, PLUGIN, NETHER_PORTAL, END_PORTAL, END_GATEWAY, CONSUMABLE_EFFECT.
• min-distance Same-world teleports shorter than this many blocks are ignored. Default: 8.0.
• reattach-delay-ticks Ticks to wait after a mob arrives before re-attaching its leash. Default: 10.
• block-mob-portals Stop leashed mobs from wandering through portals on their own; their holder drags them through instead. Default: true.
• include-convoys Also bring entities leashed to your mobs when you teleport, like a happy ghast towing boats. Default: true.

Unbreakable

• enabled Distance never snaps a lead; the mob is pulled back to its holder instead. Default: true.
• mob-held-leads Also protect leads held by mobs, as long as the chain traces back to a player. Default: true.

Leash Anything

• enabled Leads can attach to any mob. Default: true.
• blacklist Entity types that can never be leashed. Default: ENDER_DRAGON, WITHER.

Damage Protection

• enabled Leashed mobs cannot be damaged. Default: true.
• allow-player-damage Players can still hit leashed mobs. Default: true.

All player facing messages can be edited in messages.yml using MiniMessage format. Type /magicleads reload to apply changes.

Documentation
Full documentation for how to use this plugin can be found at the link below:
Magic Leads Documentation

Plugin Support
Link to the support discord server can be found below:
Support Discord Server

Support the author
Support the author of this plugin via Patreon.
Patreon