免费地图传送 - PBZModLoader

免费地图传送 - PBZModLoader

地图钟传送不消耗旅行护符且跳过其门。它调用游戏自身的传送系统,因此流式加载、加载过程和钟存档仍然有效。

免费地图传送 — PBZModLoader 版

版本 1.0.0 · 影之刃零(Steam)

功能说明

让游戏地图自带的铃铛传送免费:不消耗穿行符,也不再弹出费用确认对话框。它不替换任何游戏文件,也从不手动移动角色,因此传送仍然走游戏自身的引擎管线:关卡流送、加载界面、铃铛存档和关闭地图都保持原样。

工作原理

游戏自身的调用链为:

readyToTeleport -> tryTeleportByCharm -> runTeleportGates(需要至少 1 张穿行符、移动状态、战斗状态、阻挡体积、剧情门槛、附近铃铛)
                  -> confirmAndConsumeCharm(费用对话框 -> backpack.RemovePropsFromBackPack(1, charm))
                  -> doCharmTeleport -> PerformanceSystemSubsystem.teleportToPoint(...)

本模组在运行时包装 readyToTeleport:一旦选中的目标是铃铛,就直接调用游戏自身的 doCharmTeleport。对话框和扣除步骤被跳过;传送本身仍是未经修改的游戏代码。

设置

ProjectPBZ\Content\Paks~mods\PBZFreeTeleport.txt,或游戏内设置菜单:

  • Enabled — 总开关。
  • FreeTeleport — 开启:确认后直接进入 doCharmTeleport,不扣除任何物品。关闭:使用原版的对话框与扣费流程。
  • KeepGates — 默认关闭。开启:先运行游戏自身的 runTeleportGates。注意其第一道门槛要求至少拥有 1 张穿行符,因此在 0 张时会阻止传送;无论哪种情况都不会消耗穿行符。

安装

  1. 关闭游戏。
  2. 将压缩包中的 ProjectPBZ 文件夹合并到游戏根目录。
  3. 启动游戏;loader.log 应显示 [PBZMOD] loaded pbz-free-teleport。
  4. 打开地图,选择铃铛,确认。

前置要求

PBZModLoader。这是一个 PBZModLoader 模组;不需要任何 pak 替换。

注意事项

  • 本模组与 pak 版 FreeMapTeleport 只能保留一个:后者会整体替换 Map.js,二者会冲突。
  • 铃铛模式(在铃铛处打开地图)和大头地图交由游戏自身处理。
  • 如果无法传送,会回退到游戏自身的流程,并在日志中说明,而不是吞掉点击。日志:~mods\PBZFreeTeleport.log

致谢

  • Deletriuz 的 FreeMapTeleport(Nexus Mods,模组 43)。跳过穿行符消耗并使用游戏自身传送的思路来自该模组。本模组在运行时挂钩,而不是替换 Map.js,因此可与其他模组共存。
  • PBZModLoader 与 PbzModConfig 的作者。
  • pbz-map-tracker 的作者:其公开代码为本游戏运行时接口提供了关键线索,本模组的诊断功能基于此构建。

中文说明

让游戏地图自带的铃铛传送免费:不扣「穿行符」,也不再弹消耗确认框。它不替换任何游戏文件,也不手动搬动角色,传送仍走游戏自己的引擎管线(关卡流送、loading 图、铃铛存档、关地图都照旧),所以不会把人传到脱离地图的地方。

原理:只在运行时把 readyToTeleport 包一层,确认目标是铃铛后直接调用游戏自己的 doCharmTeleport,跳过确认框与 RemovePropsFromBackPack 那一步扣符。

设置:Enabled 总开关;FreeTeleport 开启即免费,关闭走原版扣符流程;KeepGates 开启会先跑游戏自己的检查(注意其中第一条要求背包里至少一张穿行符,0 张时反而传不了;两种情况下都不会扣符)。

安装:退出游戏,把压缩包里的 ProjectPBZ 合并进游戏根目录,启动后 loader.log 应出现 [PBZMOD] loaded pbz-free-teleport,然后开地图选铃铛确认即可。

注意:与 pak 版「FreeMapTeleport」只留一个(那个是整份替换 Map.js,会互相覆盖)。传送失败时会回退到游戏原流程并写日志,不会吞掉点击。

致谢:感谢 Deletriuz 的 FreeMapTeleport(Nexus mod 43),思路来自它;感谢 PBZModLoader 与 PbzModConfig 作者;感谢 pbz-map-tracker 作者,其公开代码为本游戏运行时接口提供了关键线索。

本模组的代码在本次会话中借助 AI 协助编写,并已在上方披露;其思路与参考实现归 Deletriuz 所有。