栓绳传送

🪢 Leashed Teleport

一个 Fabric Minecraft 模组，让你通过 /tp 传送时能带上拴绳牵引的生物。

 

✨ 功能特性

• 基于拴绳的传送 — 任何直接拴在你身上且在配置半径内的生物，都可以跟随你的 /tp、末影珍珠和紫颂果传送。
• 智能安全检查 — 模组会自动检测不安全的目的地（岩浆、火焰、虚空、窒息危险），并在 5 格半径内寻找附近的安全位置。如果找不到安全位置，传送将被取消，以防止生物死亡。
• 摔落伤害保护 — 被传送的生物会获得抗性提升 V 和缓降效果，持续可配置的时间，以在落地时存活。
• 驯服归属检查 — 驯服的动物（狗、猫、马等）只有在属于传送玩家时才会传送。被其他玩家驯服的动物会被留下。
• 支持坐着的生物 — 坐着的已驯服动物只要被拴在传送玩家身上且归属于该玩家，也会传送。
• 跨维度支持 — 生物可以选择性地跟随你跨越维度（主世界 ↔ 下界 ↔ 末地）。默认启用；可在配置中切换。
• 可选的 LuckPerms 集成 — 当安装 LuckPerms 时，可启用通用使用、跨维度传送、末影珍珠和紫颂果的权限节点。
• 可选的 Open Parties and Claims 集成 — 当安装 OPAC 时，被拴生物会遵守领地访问权限以及 OPAC 的传送、末影珍珠和紫颂果保护规则。
• 感知世界边界 — 如果目的地在世界边界之外，被拴生物不会被传送。
• 可配置黑名单 — 定义永远不应传送的实体类型，即使它们被拴在你身上。
• 可选的 Mod Menu 集成 — 当客户端存在 Mod Menu 和 Cloth Config 时，你可以通过游戏内界面编辑相同的配置。
• 游戏内命令 — /leashedteleport info 和 /leashedteleport reload（需要管理员等级 2）。

🔄 命令

/leashedteleport info - 仅限管理员。 - 显示当前配置值和 LuckPerms 状态 /leashedteleport reload - 仅限管理员。 - 无需重启即可从磁盘重新加载配置

 

⚙️ 配置

配置文件：.minecraft/config/leashedteleport.json

首次启动时会自动创建默认配置，并附有解释每个选项的内联注释。

如果客户端安装了 Mod Menu，Leashed Teleport 也会在其中提供一个配置界面。Cloth Config 是可选的：没有它，模组仍然正常运行，但不会显示配置 GUI。

黑名单示例

使用黑名单排除特定生物 — 例如体型过大或过于危险而不宜带上的动物：

{
  "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"
  ]
}

注意： 只有实际上能被拴绳拴住的生物才会传送。你无需将原版 Minecraft 中无法被拴住的生物（例如大多数敌对生物、村民等）加入黑名单。

🛡️ Open Parties and Claims

Open Parties and Claims 是可选的。Leashed Teleport 不直接依赖它，但当安装 OPAC 且 respectOpenPartiesAndClaims 为 true 时，被拴生物不会被带入阻止相应操作的领地。

• /tp 和其他通用玩家传送需要正常的领地访问权限。
• 末影珍珠生物跟随会在存在该动态选项时检查 OPAC 的末影珍珠实体屏障组。
• 紫颂果生物跟随会遵守 OPAC 的紫颂果领地例外/保护选项。

如果你希望 Leashed Teleport 忽略 OPAC 领地规则，请将 respectOpenPartiesAndClaims 设为 false。

🔐 LuckPerms

Leashed Teleport 仅在以下两个条件都为真时才使用 LuckPerms：

1. 在 config/leashedteleport.json 中 useLuckPerms 设为 true
2. 服务器上实际安装了 luckperms 模组

如果任一条件为假，所有人都可以使用 Leashed Teleport，且不需要权限插件。 如果 LuckPerms 处于活动状态，缺失的权限节点默认为 false。

权限节点

leashedteleport.use - 允许玩家在传送时带上被拴生物 leashedteleport.crossdimensionteleport - 允许玩家带着被拴生物跨越维度 leashedteleport.enderpearlteleport - 允许玩家在末影珍珠传送时带上被拴生物 leashedteleport.chorusfruitteleport - 允许玩家在紫颂果传送时带上被拴生物

LuckPerms 快速上手

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

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

官方 LuckPerms 文档：

LuckPerms Wiki： https://luckperms.net/wiki/Home LuckPerms 命令用法： https://luckperms.net/wiki/Command-Usage

 

🧑‍🤝‍🧑 兼容性

 

🧾 说明

• 仅支持基于 /tp 的传送。传送门不会触发拴绳传送。
• 支持的玩家传送类型为 /tp、末影珍珠和紫颂果。传送门不会触发拴绳传送。
• 对于跨维度传送，一旦实体在新维度中加载，拴绳会立即重新连接。
• 保护效果会静默应用。
• 安全系统会检查岩浆、火焰、虚空和窒息等危险。如果确切的传送目的地不安全，模组会在 5 格半径内搜索安全替代位置。这可以防止因传送到危险位置而导致的生物意外死亡。
• 模组必须安装在服务端。玩家无需在客户端安装该模组。该模组在单人游戏中也可正常工作。
• Mod Menu 和 Cloth Config 纯粹是可选的客户端附加功能。专用服务器不需要它们。
• /leashedteleport info 仅限管理员使用，会显示 LuckPerms 是 disabled、configured, but mod not installed 还是 active，以及 OPAC 检查是否启用。

📦 安装

1. 为 Minecraft 安装 [Fabric Loader]。
2. 下载 [Fabric API] 并将其放入 mods/。
3. 下载 leashedteleport-<version>.jar 并将其放入 mods/。
4. 启动 Minecraft。配置会在首次运行时自动创建。

 

🏜️ 测试服务器

欢迎加入我的 Minecraft 服务器测试我的模组：play.swordfishbe.eu