Ender Pearl Swap
by Mindoth
Throwing an ender pearl at another living entity in Ender Pearl Swap exchanges the thrower's position with the target's instead of only teleporting the thrower.
What it does
After an ender pearl is thrown, a hit on a mob or another player swaps the two positions, so the target lands where the pearl was thrown and the thrower takes the target's former place. Without a hit, the pearl teleports its thrower as in vanilla. The behavior applies to any living entity the pearl strikes.
By default the swap happens only on a direct hit. A config option switches the trigger to a radius, so a pearl that lands near a mob can still cause the swap. The distance is set in the config file that ships with the mod. At a value of 10, a pearl thrown into the ground moves everyone within a 10 by 10 by 10 area to the thrower's previous location.
The mod is published for Forge only, with a single build, 1.19.2-1.0.1 for 1.19.2, released on 2023-07-08. It is a client and server mod, so the server and every player need it. The code is under All rights reserved, and the source code and issue tracker are public.
Key features
Position swap on hit
A pearl that strikes a mob or player exchanges the two positions instead of moving only the thrower.
Direct-hit default
By default the swap needs a direct hit with the pearl, so stray throws keep vanilla behavior.
Radius trigger mode
A config setting replaces the direct hit with a radius check, so landing near a target is enough.
Adjustable radius
The swap distance is a value in the config file, and a larger number widens the area that gets pulled in.
Compatibility
Latest build for each game version and loader.
Only full game releases are shown. This mod publishes no snapshot builds.
Use cases
Pranks between players
Players on a shared world can swap places with each other by throwing a pearl at one another.
Mob escapes
A pearl thrown at a mob moves the mob to the spot where the pearl landed, which changes how an encounter plays out.
Who it’s for: Players who want pearl throws to move others as well as the thrower, on single-player worlds or multiplayer servers that run Forge 1.19.2.
How it compares
Ender Pearl Recipe is a Forge mod for 1.12.2 that is client and server, released under the CC0 1.0 Universal license, and is not open source. Swap Pearl is a Forge mod for 1.16.5 that is client and server and released under All rights reserved. Craftable Ender Pearls is a Forge mod for 1.20.1 released under the MIT License. Ender Pearl Swap differs by targeting only 1.19.2.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| Ender Pearl Swap | Forge | 1.19.2 | Client and server | 2023-07-08 |
| Ender Pearl Recipe | Forge | 1.12.2 | Client and server | 2025-03-16 |
| Swap Pearl | Forge | 1.16.5 | Client and server | 2023-07-01 |
| Craftable Ender Pearls | Forge | 1.20.1 | Client and server | 2025-06-30 |
Questions
Does Ender Pearl Swap need to be on the server?
Can the swap trigger without hitting a mob directly?
Which Forge version does the mod support?
More from Mindoth
What the author says
This mod is really simple and does exactly what is said in its summary. After throwing an Ender Pearl, if it hits another living entity like a mob or another player you swap places with each other instead of you just teleporting over to where the pearl landed. By default the mod works only when directly hitting…
Official listing
- Modrinth page
- modrinth.com/mod/ender-pearl-swap
- Owner
- Mindoth
- Published
- 2023-07-07
- Updated on Modrinth
- 2023-07-08
- Facts verified
- 2026-10-15
