心态 | MR Portal

心态 | MR Portal

MR Portal是一个受游戏Magic Rampage启发的模组。它添加了一根传送门法杖,用于保存路径点和通过黑色传送门进行即时旅行。传送门对其他玩家可见,怪物和其他玩家可以通过。

冒险

Mentalitys | MR Portal

Mentalitys | MR Portal 是一个 Fabric 1.20.1 模组,添加了受 Magic Rampage 启发的个人传送门和逐玩家路径点。

当前版本:2.3

功能说明

MR Portal 允许每位玩家保存路径点位置,并打开通往这些位置的临时传送门。源传送门会在玩家面前打开,传送后会出现目标传送门。其他玩家和实体可以在已激活的传送门保持开启期间穿过它们。

基础模组支持普通生存使用、一次性卷轴传送、创造/管理员传送、收藏路径点,以及一个快速收藏快捷键。

特性

  • Fabric 1.20.1 模组。
  • 逐玩家路径点存储。
  • 路径点 GUI,用于添加、选择、重命名、删除和收藏路径点。
  • 用于生存传送的传送门法杖。
  • 用于创造/管理员用途的无限传送门法杖。
  • 传送卷轴作为一次性传送物品。
  • 支持收藏路径点。
  • 快速收藏传送快捷键。
  • 选择目标时显示预览光点/目标点。
  • 传送门在玩家面前打开。
  • 传送后出现目标传送门。
  • 其他实体和玩家可以穿过已激活的传送门。
  • 普通法杖和卷轴仅限同维度。
  • 无限法杖和创造模式可以绕过普通维度限制。
  • 可配置传送门时机、消耗、缩放、语言和视觉效果。

2.3 新增内容

版本 2.3 更新了内部传送路由,但不改变默认的 MR Portal 玩法:

  • GUI 路径点传送现在通过请求服务进行路由。
  • 快速收藏传送现在通过同一服务层进行路由。
  • 附加组件可以通过公共 API 注册自定义传送处理器。
  • 活动处理器根据处理器优先级选择。
  • 基础 MR Portal 保留验证、支付、冷却、物品消耗和同维度检查。
  • 处理器负责执行风格和验证后的传送行为。
  • 处理器可以通过 usesDefaultPreviewSpark() 控制基础 MR Portal 是否发出其默认预览光点。
  • 内置默认处理器保留正常的 MR Portal 传送门行为。

这为 MR Portal 支持诸如 Chrono Portal 支持之类的外部附加组件做好了准备,而无需将附加组件逻辑硬编码到基础模组中。Chrono Portal 未捆绑到基础 MR Portal 中。

物品

传送门法杖

  • ID:mr_portal:portal_staff
  • 生存传送物品。
  • 传送门启动时消耗末影珍珠。
  • 应用法杖冷却。
  • 仅限同维度。

传送卷轴

  • ID:mr_portal:teleport_scroll
  • 一次性传送物品。
  • 传送门启动时被消耗。
  • 不消耗末影珍珠。
  • 不应用法杖冷却。
  • 仅限同维度。

无限传送门法杖

  • ID:mr_portal:infinite_portal_staff
  • 创造/管理员传送物品。
  • 无珍珠消耗。
  • 无冷却。
  • 可以绕过普通维度限制。

使用方法

  1. 手持传送门法杖或传送卷轴。
  2. 右键打开路径点 GUI。
  3. 将你的当前位置添加为路径点,或选择一个现有路径点。
  4. 确认传送,在你面前创建一个传送门。
  5. 走进传送门进行传送。

如果你携带法杖或卷轴,也可以使用配置的快捷键快速打开路径点 GUI。

支付在传送门启动时应用,而不仅仅是在打开 GUI 时。

收藏路径点与快速传送门

  • 在路径点 GUI 中将一个路径点标记为收藏。
  • 使用快速收藏快捷键排队打开通往该收藏路径点的传送门。
  • 快速收藏路径会在激活前显示预览延迟。
  • 支付在延迟激活时发生,而不是在按键时。
  • 首选快速激活器顺序为:无限传送门法杖、传送门法杖、传送卷轴。
  • 普通法杖和卷轴的快速传送仅限同维度。
  • 无限法杖和创造模式可以绕过普通限制。

附加组件/API 支持

MR Portal 2.3 包含一个可供附加组件使用的传送处理器 API。

附加组件处理器可以:

  • 注册一个 MRPortalTeleportHandler;
  • 使用优先级成为活动处理器;
  • 接受或拒绝已经验证的请求;
  • 在基础验证后执行不同的传送风格;
  • 通过 usesDefaultPreviewSpark() 选择不发出基础预览光点。

基础 MR Portal 仍然负责:

  • 路径点所有权和查找;
  • 物品检测;
  • 同维度验证;
  • 珍珠消耗检查和消耗;
  • 卷轴消耗;
  • 法杖冷却检查和应用;
  • GUI 和快速收藏请求时机。

这使附加组件行为与基础经济系统和规则保持兼容,同时允许外部视觉或传送风格。

配置

配置文件会自动创建:

  • config/mr_portal.json

选项:

  • language:模组语言,auto、en 或 ru。
  • cooldownSeconds:生存法杖冷却时间,以秒为单位。
  • maxWaypoints:每位玩家的路径点上限。
  • portalOpenDelay:传送门打开时间,以刻为单位。
  • portalActiveTicks:传送门打开后保持开启的时长。
  • portalCloseDelayTicks:传送后传送门在开始坍缩前保持存在的时长。
  • portalPearlCost:普通法杖的传送消耗。
  • applyBlindnessOnTeleport:启用或禁用传送后的失明效果。
  • blindnessDuration:失明持续时间,以刻为单位。
  • portalScale:传送门视觉大小。
  • portalSpawnDistance:玩家到源传送门的距离。
  • portalVerticalOffset:传送门垂直偏移。
  • portalAnimationSpeed:传送门动画速度倍率。
  • quickFavoritePortalDelayTicks:快速收藏传送门启动前的延迟。
  • portalExitBehindDistance:传送后目标传送门出现在玩家身后多远的位置。

默认值:

  • language = auto
  • cooldownSeconds = 60
  • maxWaypoints = 10
  • portalOpenDelay = 60
  • portalActiveTicks = 100
  • portalCloseDelayTicks = 60
  • portalPearlCost = 3
  • applyBlindnessOnTeleport = true
  • blindnessDuration = 40
  • portalScale = 1.5
  • portalSpawnDistance = 2.2
  • portalVerticalOffset = 0.0
  • portalAnimationSpeed = 1.0
  • quickFavoritePortalDelayTicks = 30
  • portalExitBehindDistance = 0.2

安装 Cloth Config API 后,可以在游戏内通过 ModMenu -> Mentalitys | MR Portal 编辑设置。

依赖项

  • 适用于 Minecraft 1.20.1 的 Fabric API。
  • 推荐安装 Cloth Config API 以使用游戏内配置界面。
  • 推荐安装 ModMenu 以从 Mods 菜单打开配置界面。