
TpWithMe – 与我同行
喜欢你的马吗?现在你不会再独自传送了。该模组同样适用于所有可骑乘的生物!
你的坐骑会跟随你进行每一次传送——无论是命令、插件、末影珍珠还是其他传送方式,只要你说得出,它都能做到。保持骑乘状态,一同抵达目的地。
✨ 功能特性
- ? 坐骑会在每次
/tp、/home、传送门、末影珍珠、紫颂果或任何其他传送方式中与你一同传送
- ??? 玩家传送后仍保持在坐骑上
- ? 跨维度旅行 — 主世界 ↔ 下界 ↔ 末地 (可配置)
- ? 安全检查 — 坐骑不会传送到实心方块内 (可配置)
- ?️ 在过渡期间为坐骑应用伤害抗性以防止死亡
- ? 实体黑名单 — 排除特定坐骑使其永远不随玩家传送
- ? 传送后重新骑乘监控器 — 自动检测并修复边缘情况下的下马问题
- ? 可选支持 Open Parties and Claims — 尊重领地访问权限、紫颂果规则以及末影珍珠屏障组
- ⚙️ 可选支持 Mod Menu + Cloth Config,提供游戏内客户端配置界面
- ? 支持 Moonrise、C2ME 和 Async
? 支持的坐骑
所有 14 种原版可骑乘实体:
| 坐骑 |
控制物品 |
备注 |
| 马 |
鞍 |
|
| 驴 |
鞍 |
|
| 骡子 |
鞍 |
|
| 骷髅马 |
鞍 |
|
| 僵尸马 |
鞍 |
|
| 骆驼 |
鞍 |
空间不足时会自动趴下 |
| 骆驼尸骸 |
鞍 |
空间不足时会自动趴下 |
| 猪 |
鞍 |
|
| 炽足兽 |
鞍 |
|
| 鹦鹉螺 |
鞍 |
|
| 僵尸鹦鹉螺 |
鞍 |
|
| 羊驼 |
(无 — 由拴绳控制) |
无需检查鞍 |
| 行商羊驼 |
(无 — 由拴绳控制) |
无需检查鞍 |
| 快乐的恶魂 |
挽具 |
|
? 指令
| 指令 |
权限 |
描述 |
/tpwithme info |
操作员 (gamemaster) |
在聊天栏显示当前配置值 |
/tpwithme reload |
操作员 (gamemaster) |
从磁盘重载 tpwithme.json |
⚙️ 配置
文件:config/tpwithme.json
首次启动时自动生成。使用 /tpwithme reload 即可应用更改而无需重启服务器。
{
"enabled": true,
"useLuckPerms": false,
"crossDimensionalTeleport": true,
"enderPearlTeleport": true,
"chorusFruitTeleport": true,
"respectOpenPartiesAndClaims": true,
"requireSaddle": true,
"checkSafety": true,
"applyTeleportProtection": true,
"protectionDurationTicks": 60,
"safetySearchRadius": 2,
"blacklistedEntities": []
}
? 选项说明
enabled
总开关。将其设置为 false 以完全禁用该模组而不删除它。
默认值:true
useLuckPerms
当安装了 luckperms 模组时,启用 LuckPerms 权限检查。
如果为 true 且存在 LuckPerms,TpWithMe 将检查以下权限:
tpwithme.use
tpwithme.crossdimensionalteleport
tpwithme.enderpearlteleport
tpwithme.chorusfruitteleport
当 LuckPerms 激活时,玩家必须被显式授予这些权限才能使用该模组。
如果未安装 LuckPerms,TpWithMe 会自动回退到允许所有人使用该模组的状态。
默认值:false
crossDimensionalTeleport
允许坐骑跟随玩家穿越维度变化(主世界 ↔ 下界 ↔ 末地)。
当设置为 false 时,仅同维度内的传送会携带坐骑。
默认值:true
enderPearlTeleport
允许末影珍珠携带你的坐骑一起传送。
当设置为 false 时,骑乘状态下投掷末影珍珠将使用原版行为,仅传送玩家本人。
默认值:true
chorusFruitTeleport
允许紫颂果携带你的坐骑一起传送。
落点计算基于实际碰撞表面(包括半砖等),并尊重 Minecraft 的 consumable_does_not_teleport_to 方块标签(包括数据包添加的方块)。
当设置为 false 时,骑乘状态下食用紫颂果将使用原版行为,仅传送玩家本人。
默认值:true
respectOpenPartiesAndClaims
当安装了 Open Parties and Claims 时,尊重其领地保护机制。
TpWithMe 在将坐骑移入领地前会检查领地访问权限。对于骑乘状态下的紫颂果,它会尊重 OPAC 的紫颂果例外选项;对于骑乘状态下的末影珍珠,若存在则尊重 OPAC 配置的末影珍珠实体屏障组。
仅在您故意希望 TpWithMe 忽略 OPAC 领地保护时才禁用此选项。
如果已安装 OPAC 但其 API 调用失败,在服务器重启或显式禁用此设置之前,坐骑携带功能将被阻止。模组不会静默允许进入受保护的目的地。
默认值:true
requireSaddle
仅当坐骑装备了相应的控制物品时才允许传送:
- 鞍 — 马、驴、骡子、骷髅马、僵尸马、骆驼、骆驼尸骸、猪、炽足兽、鹦鹉螺、僵尸鹦鹉螺
- 挽具 — 快乐的恶魂
- 豁免 — 羊驼和行商羊驼(由拴绳控制,无鞍槽)
默认值:true
checkSafety
在传送前,检查目的地是否有足够的空间让坐骑直立站立且骑手可以坐在上面。
如果空间太小,坐骑将留在原地,并向玩家发送提示信息。
使用直接方块碰撞形状迭代算法——即使对于像快乐的恶魂这样的大型坐骑(4×4×4 方块)也能可靠工作。
默认值:true
applyTeleportProtection
在传送后立即对坐骑应用 抗性提升 V,持续时间为 protectionDurationTicks 刻。这可以防止在过渡期间因窒息或摔落而死亡。
默认值:true
protectionDurationTicks
传送后伤害免疫的持续时间,单位为游戏刻(20 刻 = 1 秒)。
默认值:60(3 秒)
safetySearchRadius
当 checkSafety 为 true 且精确目标位置被阻挡时,模组将在该半径(以方块为单位)内搜索附近的安全位置。
在水平、向上和向下方向进行搜索,选择距离最近的安全候选位置。实际碰撞表面(包括半砖)会被考虑在内,因此珍珠弹射的高度可以调整到地面。半径限制了每个轴上的位移范围。选定的目标位置仍需通过世界边界和 OPAC 检查;搜索过程不会加载新的区块。
设置为 0 可禁用搜索功能,仅检查确切的目标位置。
允许范围:0 至 4。较大的值会被限制,以防止服务器 Tick 处理过载。
默认值:2
blacklistedEntities
必须永远禁止传送的实体类型 ID 列表,无论其他设置如何。
使用命名空间 ID,例如 "minecraft:horse" 或 "mymod:custom_mount"。
默认值:[](空列表)
? LuckPerms
TpWithMe 仅在同时满足以下两个条件时才会使用 LuckPerms:
config/tpwithme.json 中的 useLuckPerms 设置为 true
- 服务器上确实安装了
luckperms 模组
如果任一条件为假,则任何人都可以使用 TpWithMe,无需权限插件支持。
如果启用了 LuckPerms,缺失的权限节点默认为 false。
权限节点
| 权限 |
描述 |
tpwithme.use |
允许玩家在传送时携带坐骑 |
tpwithme.crossdimensionalteleport |
允许玩家跨维度传送时携带坐骑 |
tpwithme.enderpearlteleport |
允许玩家在使用末影珍珠传送时携带坐骑 |
tpwithme.chorusfruitteleport |
允许玩家在食用合唱果实传送时携带坐骑 |
示例
示例组配置
group.default:
permissions:
- tpwithme.use
group.vip:
permissions:
- tpwithme.use
- tpwithme.crossdimensionalteleport
- tpwithme.enderpearlteleport
- tpwithme.chorusfruitteleport
示例命令
/lp group default permission set tpwithme.use true
/lp group default permission set tpwithme.crossdimensionalteleport false
/lp group default permission set tpwithme.enderpearlteleport false
/lp group default permission set tpwithme.chorusfruitteleport false
/lp group vip permission set tpwithme.use true
/lp group vip permission set tpwithme.crossdimensionalteleport true
/lp group vip permission set tpwithme.enderpearlteleport true
/lp group vip permission set tpwithme.chorusfruitteleport true
/tpwithme info
/tpwithme info 现在还会显示 LuckPerms 的状态:
disabled(已禁用)
configured, but mod not installed(已配置但未安装模组)
active(已激活)
??? 兼容性
此模组与 Moonrise、C2ME 和 Async 兼容。其中一些模组无法同时加载。
其他模组
如果另一个模组在 TpWithMe 的 HEAD 注入之前强制玩家下车,则无法捕获载具。RemountWatcher 在某些情况下可能会恢复此状态。如果遇到冲突,请提交 Issue。
? 安装指南
- 为 Minecraft 安装 Fabric Loader。
- 下载 Fabric API 并将其放入
mods/ 目录。
- 下载
tpwithme-<version>.jar 并将其放入 mods/ 目录。
- 启动 Minecraft。配置文件将在首次运行时自动创建。
?️ 测试服务器
欢迎加入我的 Minecraft 服务器以测试我的模组:play.swordfishbe.eu

TpWithMe – Teleport With Me
Like your horse? Now you won't teleport without it. Also works on all rideable mobs!
Your mount follows you through every teleport — commands, plugins, portals, you name it. Stay seated, arrive together.
✨ Features
- ? Mount teleports with you on every
/tp, /home, portal, ender pearl, chorus fruit, or any other teleport
- ??? Player stays seated on the mount after teleporting
- ? Cross-dimensional travel — Overworld ↔ Nether ↔ End (configurable)
- ? Safety check — mount won't teleport into solid blocks (configurable)
- ?️ Damage resistance applied to mount during transition to prevent death
- ? Entity blacklist — exclude specific mounts from ever teleporting
- ? Post-teleport remount watcher — catches edge-case dismounts and fixes them automatically
- ? Optional Open Parties and Claims support — respects claim access, chorus fruit rules, and ender pearl barrier groups
- ⚙️ Optional Mod Menu + Cloth Config support for an in-game client config screen
- ? Supports Moonrise, C2ME and Async
? Supported Mounts
All 14 vanilla rideable entities:
| Mount |
Control item |
Notes |
| Horse |
Saddle |
|
| Donkey |
Saddle |
|
| Mule |
Saddle |
|
| Skeleton Horse |
Saddle |
|
| Zombie Horse |
Saddle |
|
| Camel |
Saddle |
Auto lies down if space is tight |
| Camel Husk |
Saddle |
Auto lies down if space is tight |
| Pig |
Saddle |
|
| Strider |
Saddle |
|
| Nautilus |
Saddle |
|
| Zombie Nautilus |
Saddle |
|
| Llama |
(none — lead-controlled) |
No saddle check |
| Trader Llama |
(none — lead-controlled) |
No saddle check |
| Happy Ghast |
Harness |
|
? Commands
| Command |
Permission |
Description |
/tpwithme info |
Operator (gamemaster) |
Show current config values in chat |
/tpwithme reload |
Operator (gamemaster) |
Reload tpwithme.json from disk |
⚙️ Configuration
File: config/tpwithme.json
Created automatically on first launch. Use /tpwithme reload to apply changes without restarting.
{
"enabled": true,
"useLuckPerms": false,
"crossDimensionalTeleport": true,
"enderPearlTeleport": true,
"chorusFruitTeleport": true,
"respectOpenPartiesAndClaims": true,
"requireSaddle": true,
"checkSafety": true,
"applyTeleportProtection": true,
"protectionDurationTicks": 60,
"safetySearchRadius": 2,
"blacklistedEntities": []
}
? Options
enabled
Master switch. Set to false to disable the mod entirely without removing it.
Default: true
useLuckPerms
Enable LuckPerms permission checks when the luckperms mod is installed.
If true and LuckPerms is present, TpWithMe checks:
tpwithme.use
tpwithme.crossdimensionalteleport
tpwithme.enderpearlteleport
tpwithme.chorusfruitteleport
When LuckPerms is active, players must be explicitly granted these permissions.
If LuckPerms is not installed, TpWithMe automatically falls back to allowing everyone to use the mod.
Default: false
crossDimensionalTeleport
Allow mounts to follow through dimension changes (Overworld ↔ Nether ↔ End).
When false, only same-dimension teleports carry the mount.
Default: true
enderPearlTeleport
Allow ender pearls to take your mount along.
When false, mounted ender pearls use vanilla behaviour and only teleport the player.
Default: true
chorusFruitTeleport
Allow chorus fruit to take your mount along.
Grounding uses actual collision surfaces, including slabs, and respects Minecraft's consumable_does_not_teleport_to block tag (including datapack additions).
When false, mounted chorus fruit uses vanilla behaviour and only teleports the player.
Default: true
respectOpenPartiesAndClaims
Respect Open Parties and Claims claim protection when it is installed.
TpWithMe checks claim access before moving the mount into a claim. For mounted chorus fruit it respects OPAC's chorus fruit exception option. For mounted ender pearls it respects OPAC's configured Ender Pearls entity barrier group when present.
Disable this only if you deliberately want TpWithMe to ignore OPAC claim protection.
If OPAC is installed but its API fails, mount carry is blocked until the server restarts or this setting is explicitly disabled. The mod does not silently allow protected destinations.
Default: true
requireSaddle
Only teleport a mount if it has the appropriate control item equipped:
- Saddle — Horse, Donkey, Mule, Skeleton Horse, Zombie Horse, Camel, Camel Husk, Pig, Strider, Nautilus, Zombie Nautilus
- Harness — Happy Ghast
- Exempt — Llama and Trader Llama (lead-controlled, no saddle slot)
Default: true
checkSafety
Before teleporting, check whether there is enough room at the destination for the mount to stand upright and the rider to sit on top.
If the space is too small, the mount stays behind and a message is sent to the player.
Uses direct block collision shape iteration — reliable even for large mounts like Happy Ghast (4×4×4 blocks).
Default: true
applyTeleportProtection
Apply Resistance V to the mount for protectionDurationTicks ticks immediately after teleporting. This prevents death from suffocation or fall damage during the transition.
Default: true
protectionDurationTicks
Duration of the post-teleport damage immunity in game ticks (20 ticks = 1 second).
Default: 60 (3 seconds)
safetySearchRadius
When checkSafety is true and the exact destination is blocked, the mod searches for a safe nearby position within this radius (in blocks).
Searches horizontally, upward and downward, choosing the nearest safe candidate by distance. Actual collision surfaces (including slabs) are considered, so fractional pearl impact heights can be adjusted to the ground. The radius limits displacement on each axis. The selected destination still undergoes world-border and OPAC checks; searching does not load new chunks.
Set to 0 to disable the search and only check the exact destination.
Allowed range: 0 to 4. Larger values are clamped to prevent excessive server tick work.
Default: 2
blacklistedEntities
A list of entity type IDs that must never teleport, regardless of other settings.
Use namespaced IDs, e.g. "minecraft:horse" or "mymod:custom_mount".
Default: [] (empty)
? LuckPerms
TpWithMe only uses LuckPerms when both conditions are true:
useLuckPerms is set to true in config/tpwithme.json
- The
luckperms mod is actually installed on the server
If either condition is false, everyone can use TpWithMe and no permission plugin is required.
If LuckPerms is active, missing permission nodes default to false.
Permission nodes
| Permission |
Description |
tpwithme.use |
Allow a player to take their mount along during teleports |
tpwithme.crossdimensionalteleport |
Allow a player to take their mount across dimensions |
tpwithme.enderpearlteleport |
Allow a player to take their mount along with an ender pearl |
tpwithme.chorusfruitteleport |
Allow a player to take their mount along when eating chorus fruit |
Examples
Example groups
group.default:
permissions:
- tpwithme.use
group.vip:
permissions:
- tpwithme.use
- tpwithme.crossdimensionalteleport
- tpwithme.enderpearlteleport
- tpwithme.chorusfruitteleport
Example commands
/lp group default permission set tpwithme.use true
/lp group default permission set tpwithme.crossdimensionalteleport false
/lp group default permission set tpwithme.enderpearlteleport false
/lp group default permission set tpwithme.chorusfruitteleport false
/lp group vip permission set tpwithme.use true
/lp group vip permission set tpwithme.crossdimensionalteleport true
/lp group vip permission set tpwithme.enderpearlteleport true
/lp group vip permission set tpwithme.chorusfruitteleport true
/tpwithme info
/tpwithme info now also shows whether LuckPerms is:
disabled
configured, but mod not installed
active
??? Compatibility
This mod works with Moonrise, C2ME and Async. Some of these mods cannot be loaded together.
Other mods
If another mod forcibly dismounts the player before TpWithMe's HEAD injection, the vehicle cannot be captured. The RemountWatcher may recover this in some cases. Please open an issue if you encounter a conflict.
? Installation
- Install Fabric Loader for Minecraft.
- Download Fabric API and place it in
mods/.
- Download
tpwithme-<version>.jar and place it in mods/.
- 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
评论 0
登录后参与评分
还没有评论,来抢沙发吧