末地链接

末地链接

一个Minecraft传送模组。添加、连接并传送!

技术

EnderLink

两个方块。一条链接。无限距离。

EnderLink 是一个 Fabric 传送模组,允许玩家注册传送垫、将它们链接在一起,并通过在方块上潜行来在它们之间传送。

它的设计目标是:对玩家简单易用,对服务器管理员可配置,并且在专用服务器上完全可用。

✨ 特性

  • 可配置的传送垫方块
  • 双向链接传送
  • 传送前的蓄力倒计时
  • 玩家移动时取消传送
  • 传送方块上支持地毯
  • 对被阻挡或不安全目的地的安全检查
  • 世界边界保护
  • 可配置的粒子和到达音效
  • 带可配置允许列表的跨维度传送
  • 每位玩家的传送垫和链接数量上限
  • 基于 UUID 的所有权
  • 可选 LuckPerms 支持
  • 可选 Mod Menu + Cloth Config 集成
  • 电梯兼容性保护

‼️ 工作原理

EnderLink 将正常配置的方块转变为传送垫。

典型流程:

  1. 放置一个已配置的传送方块。
  2. 站在上面并运行 /enderlink add。
  3. 在其他地方放置第二个已配置的传送方块。
  4. 站在上面并运行 /enderlink add。
  5. 使用 /enderlink link TP1 TP2 链接两个传送垫。
  6. 在任一已链接的传送垫上潜行,即可传送到另一个。

传送垫会永久存储在服务器上,可通过命令列出,并在方块被破坏或失效时自动移除。

🎮 命令

  • /enderlink add - 注册你当前站立的传送方块。
  • /enderlink link <first> <second> - 将两个传送垫链接在一起。链接始终是双向的。
  • /enderlink unlink <first> <second> - 移除两个传送垫之间的链接。
  • /enderlink remove <name> - 完全移除一个传送垫。
  • /enderlink rename <name> <newName> - 重命名一个传送垫。
  • /enderlink list - 显示所有已存储的传送垫和链接。
  • /enderlink info - 显示你当前站立的传送垫的信息。
  • /enderlink info <name> - 显示指定传送垫的信息。
  • /enderlink reload - 从磁盘重新加载配置。

🌍 配置要点

服务器管理员可以配置:

  • 允许的传送方块
  • 蓄力时间
  • 允许的维度
  • 粒子类型和粒子数量
  • 到达音效、音量和音调
  • 每位玩家的传送垫和链接数量上限
  • 命令访问规则
  • 可选 LuckPerms 集成

EnderLink 将共享配置和专用服务器数据存储在:

config/enderlink/

文件:

  • config/enderlink/enderlink.json 主模组配置

  • config/enderlink/teleports.json 专用服务器传送垫和链接数据(现有安装保留此路径)

单人游戏世界将其传送垫和链接存储在 <world>/enderlink/teleports.json。

配置选项
  • teleportBlocks - 可用作传送垫的方块 ID 列表。默认:minecraft:gold_block、minecraft:lapis_block
  • chargeTicks - 传送前的蓄力时间。20 ticks = 1 秒
  • safetyEnabled - 如果为 true,EnderLink 会阻止不安全的目的地。
  • particlesEnabled - 启用传送粒子。
  • particleType - 蓄力和到达期间使用的粒子 ID。
  • warmupParticleCount - 蓄力期间生成的粒子数量。
  • arrivalBurstParticleCount - 到达时立即生成的粒子数量。
  • arrivalTrailParticleCount - 在短暂的到达粒子轨迹期间每 tick 生成的粒子数量。
  • arrivalParticleDurationTicks - 传送后额外到达粒子轨迹持续的时间。
  • soundEnabled - 启用到达音效。
  • soundEvent - 到达时播放的音效事件 ID。
  • soundVolume - 到达音效的音量。
  • soundPitch - 到达音效的音调。
  • allowedDimensions - 允许参与传送的维度 ID 列表。你可以使用 overworld 之类的简写,或 minecraft:overworld 之类的完整 ID。
  • luckPerms - 如果安装了 LuckPerms 模组,则启用 LuckPerms 集成。
  • maxPadsPerPlayer - 每位玩家默认的最大传送垫数量。
  • maxLinksPerPlayer - 每位玩家默认的最大链接数量。
  • addAccess
  • linkAccess
  • unlinkAccess
  • removeAccess
  • renameAccess
  • listAccess
  • infoAccess - 禁用 LuckPerms 时的命令访问模式。有效值:EVERYONE、OPS_ONLY

✅ 地毯支持

你可以在传送方块顶部放置地毯来隐藏它。

传送垫仍然可用于:

  • 添加传送垫
  • 传送到它
  • 从它传送

🛑 安全规则

EnderLink 会阻止不安全的传送。

被阻止目的地的示例:

  • 目的地没有供玩家站立的空间
  • 目的地位于水下
  • 目的地位于熔岩或其他流体中
  • 目的地位于世界边界之外
  • 目的地方块缺失或不再有效
  • 目的地维度不被配置允许

🔄 权限

EnderLink 支持两种权限模式:

  1. 基于配置的访问控制
  2. 基于 LuckPerms 的访问控制

有关所有权限选项,请访问 GitHub 页面:https://github.com/SwordfishBE/EnderLink#-permissions

📄 说明

EnderLink 在专用服务器上完全可用。 只有在客户端想要可选的游戏内配置界面时,才需要 Mod Menu 和 Cloth Config。

🏜️ 测试服务器

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