人类仁慈绕过 - 仁慈之环与帕尔驯兽师眼镜

人类仁慈绕过 - 仁慈之环与帕尔驯兽师眼镜

当装备仁慈之戒或触发仁慈一击时，该模组允许人类NPC正常被击败，而帕鲁仍保留1点生命值。这是一个轻量级的UE4SS Lua模组，无需直接编辑存档。

人类仁慈绕过 - 仁慈之环与帕尔驯兽师眼镜预览查看大图

概要

重要 - 请只选择其中一个下载

提供两种安装包。不要同时安装两者，因为它们都使用同一个 HumanMercyBypass 文件夹。

主文件 - 仅限人类NPC

  • 在慈悲效果激活时，可击败受支持的人类NPC。
  • 捕食者帕鲁和所有其他帕鲁仍会保留1点生命值并获得保护。
  • 推荐大多数用户使用。

可选文件 - 启用捕食者

  • 在慈悲效果激活时，可击败受支持的人类NPC和捕食者帕鲁。
  • 普通帕鲁仍会保留1点生命值并获得保护。

安装后也可在以下位置更改此选项： HumanMercyBypass\Scripts\config.lua

affectPredatorPals = false,  -- 仅限人类NPC
affectPredatorPals = true,   -- 人类NPC + 捕食者帕鲁

更改设置后，请完全关闭并重启《幻兽帕鲁》。

慈悲之戒、慈悲一击被动技能以及施加相同慈悲效果的装备（例如帕鲁驯服者眼镜）在捕捉帕鲁时非常有用，但它们也可能使人类NPC保留1点生命值而无法被击败。 人类慈悲绕过仅改变此行为。

  • 普通帕鲁仍会保留1点生命值并获得保护。
  • 受支持的人类NPC可以正常被击败。
  • 可选择将捕食者帕鲁纳入目标。
  • 玩家永远不会成为目标。
  • 游戏明确标记为不死状态的NPC会得到保留。
  • 不会直接编辑存档数据或生命值。
  • 对帕鲁仁慈，对人类不仁慈。

版本 1.1.3 版本1.1.3改进了受支持的人类NPC被模组击败时的正常物品掉落。

工作原理

当受支持的目标恰好处于1点生命值并受到额外正伤害时，该模组会：

  1. 确认目标是受支持的，并且不是玩家或不死的NPC。
  2. 通过《幻兽帕鲁》的 PalDamageReactionComponent:SlipDamage 路径施加最后1点伤害。
  3. 让《幻兽帕鲁》执行其正常的击败和死亡处理。

当支持的目标被击败时，可能会显示一个可见的额外“1”伤害数字。这是正常且预期的情况。 该模组不会直接覆盖生命值。

支持的慈悲来源

  • 慈悲之戒
  • 慈悲一击被动技能
  • 帕鲁驯服者眼镜（社区已确认）
  • 施加相同慈悲一击效果的其他装备可能也有效

该模组不会检查特定配件。它会在支持的目标被保持在1点生命值并随后受到额外正伤害时做出响应。这就是为什么帕鲁驯服者眼镜可以通过相同的慈悲一击行为起作用。

支持的目标

人类NPC

  • 默认支持以 BP_NPC_ 开头的人类类别。
  • 玩家被排除在外。
  • 《幻兽帕鲁》标记为不死的NPC会得到保留。

捕食者帕鲁

  • 可选择支持其 CharacterID 以 PREDATOR_ 开头的捕食者帕鲁。
  • 在主文件中默认禁用。
  • 在可选的捕食者启用包中默认启用。

受保护的帕鲁 除非启用捕食者支持，否则所有帕鲁都会保留在1点生命值并获得保护。 普通、阿尔法、幸运、塔、突袭和召唤帕鲁并非此模组有意针对的目标。

特点

  • 保持慈悲之戒对普通帕鲁的保护效果
  • 保持慈悲一击对普通帕鲁的保护效果
  • 支持帕鲁驯服者眼镜和施加相同慈悲一击效果的其他装备
  • 允许受支持的人类NPC正常被击败
  • 可选的捕食者帕鲁支持
  • 不直接写入生命值
  • 不直接编辑存档数据
  • 保留标记为不死的NPC
  • 排除玩家角色
  • 防止递归重复的最终伤害
  • 在可用时包含权限检查
  • 轻量级的UE4SS Lua实现
  • 无需安装PalSchema

已在版本 1.1.3 上验证

单人游戏实机测试已确认：

  • 笼子营地的人类NPC可以被击败并产出正常掉落
  • 多种迷你石油平台猎人变种可以正常被击败
  • BP_NPC_Hunter_C 的击败处理有效
  • 捕食者支持对 PREDATOR_FeatherOstrich / BP_FeatherOstrich_BOSS_Predator_C 有效
  • 普通帕鲁继续以1点生命值存活
  • 保留了已验证的 SlipDamage(1, true, 1, true) 终结路径

测试环境

  • 《幻兽帕鲁》版本：1.0.1
  • 平台：Steam
  • 游戏模式：单人游戏
  • UE4SS：v3.0.1 Beta #0
  • UE4SS Git SHA：b50986bd

尚未测试

  • 托管多人游戏
  • 以客户端身份加入其他玩家的多人游戏会话
  • 专用服务器
  • Game Pass / Microsoft Store 版本
  • 每种特殊人类NPC类型
  • 每种捕食者帕鲁类型
  • 游戏玩法、伤害、死亡处理和掉落相关模组的每种组合

要求

  • 适用于PC的《幻兽帕鲁》
  • 与已安装的《幻兽帕鲁》版本兼容的UE4SS

已测试的UE4SS构建： UE4SS v3.0.1 Beta #0 Git SHA：b50986bd

其他《幻兽帕鲁》和UE4SS版本也可能有效，但尚未验证。

安装

  1. 安装与您当前《幻兽帕鲁》版本兼容的UE4SS版本。
  2. 完全关闭《幻兽帕鲁》。
  3. 删除任何旧的 HumanMercyBypass 测试、诊断或替代版本。
  4. 解压下载的存档。
  5. 将 HumanMercyBypass 文件夹放入您的UE4SS Mods 文件夹中。

常见安装位置：

Palworld\Mods\NativeMods\UE4SS\Mods\HumanMercyBypass

或：

Palworld\Pal\Binaries\Win64\ue4ss\Mods\HumanMercyBypass

最终的文件夹结构应类似于此：

HumanMercyBypass
├─ enabled.txt
├─ README_EN.txt
├─ README_JP.txt
├─ CHANGELOG.txt
├─ DROP_COMPATIBILITY_FIX.txt
├─ PREDATOR_OPTION.txt
├─ RELEASE_NOTES_v1.1.3.txt
├─ LICENSE.txt
├─ VALIDATION_REPORT.json
└─ Scripts
   ├─ main.lua
   └─ config.lua
  1. 启动《幻兽帕鲁》并进入一个世界。

该模组会创建以下日志文件： HumanMercyBypass\HumanMercyBypass.log

成功启动应包含类似于以下内容的行：

[BOOT] mod=HumanMercyBypass
[READY]

不要同时安装主文件和可选捕食者启用包。

从旧版本更新

  1. 完全关闭《幻兽帕鲁》。
  2. 删除现有的 HumanMercyBypass 文件夹。
  3. 从某个 v1.1.3 包中安装新的 HumanMercyBypass 文件夹。
  4. 启动游戏。

不要合并不同版本的文件或将旧的诊断脚本留在同一文件夹中。

卸载

删除以下文件夹： HumanMercyBypass

该模组不会直接修改存档数据，因此无需进行存档清理或转换。

配置

配置选项位于： HumanMercyBypass\Scripts\config.lua

建议使用默认设置。

仅限人类：

affectPredatorPals = false,

人类和捕食者帕鲁：

affectPredatorPals = true,

每个目标的详细日志记录：

debugLogging = true,

请保留 config.lua 中的尾随逗号，在更改后重启《幻兽帕鲁》。

已知限制

  • 受支持的人类NPC类别当前必须以 BP_NPC_ 开头。
  • 使用其他类别命名方案的特殊人类角色可能不受影响。
  • 捕食者帕鲁通过以 PREDATOR_ 开头的 CharacterID 进行识别。
  • 击败受支持的目标时，可能会显示一个可见的额外“1”伤害数字。
  • 该模组检查受支持的目标是否处于1点生命值并受到正伤害。
  • 它不会检查特定配件或被动。使用相同慈悲一击效果的装备也可能有效。
  • 修改伤害、生命值、不死状态、死亡处理、伤害反应或掉落处理的模组可能会产生冲突。
  • 多人游戏和专用服务器的行为尚未验证。

兼容性

此模组通常应与不替换《幻兽帕鲁》角色伤害、死亡或掉落处理系统的模组兼容。

可能的冲突包括修改以下内容的模组：

  • 角色生命值处理
  • 伤害计算
  • 慈悲之戒、慈悲一击或使用相同慈悲效果的装备
  • 不死状态
  • 伤害反应
  • 死亡动画
  • NPC击败状态
  • 物品掉落处理
  • PalCharacterParameterComponent
  • PalDamageReactionComponent

故障排除

首先，检查： HumanMercyBypass\HumanMercyBypass.log

成功启动应包含：

[BOOT] mod=HumanMercyBypass
[READY]

当 debugLogging=false 时，日志仅包含启动、就绪和错误信息。 在 Scripts/config.lua 中将 debugLogging 设置为 true 以记录每个处理目标的详细信息。

报告问题时，请包含：

  • 《幻兽帕鲁》版本
  • UE4SS版本
  • Steam 或 Game Pass 版本
  • 单人游戏、主机、客户端或专用服务器
  • 主文件或可选捕食者启用包
  • 测试过的人类NPC或捕食者帕鲁
  • 目标是否死亡
  • 物品是否掉落
  • HumanMercyBypass.log
  • UE4SS.log
  • 其他游戏玩法、伤害、NPC或掉落相关模组
  • 尽可能提供截图或短视频

错误报告模板

《幻兽帕鲁》版本：
UE4SS版本：
平台：
游戏模式：
已安装的包：主文件 / 捕食者启用
测试的目标：
affectPredatorPals 设置：
预期结果：
实际结果：
目标是否死亡？：
是否掉落正常物品？：
其他游戏玩法、伤害、NPC或掉落相关模组：
附带的 HumanMercyBypass.log：
附带的 UE4SS.log：
附带的截图或视频：

鸣谢

由 tomo3032 创建并测试。 开发协助、Lua实现支持和代码审查由 OpenAI 的 ChatGPT 提供。 不包含《幻兽帕鲁》游戏文件、官方资产或其他模组作者的文件。

权限

在以下条件下，您可以创建和分发修改版本：

  • 注明 tomo3032 为原作者。
  • 包含指向原始 Nexus Mods 页面的链接。
  • 清晰描述您的修改。

您不得：

  • 原封不动地重新上传原始存档。
  • 声称原始作品是您自己的。
  • 出售此模组。
  • 在付费墙后分发此模组。

更新日志

版本 1.1.3

  • 改进了部分受支持的人类NPC的正常物品掉落。
  • 保留了已验证的击败处理路径。
  • 已使用笼子营地NPC和多种迷你石油平台猎人变种进行验证。
  • 减少了正常日志记录；每个目标的详细日志由 debugLogging 控制。

版本 1.1.0

  • 添加了可选的 affectPredatorPals 设置。
  • 可选择击败 CharacterID 以 PREDATOR_ 开头的捕食者帕鲁，同时保持慈悲效果激活。
  • 在主文件中默认禁用捕食者支持。
  • 添加了预配置的可选捕食者启用包。
  • 保留了已验证的人类NPC伤害钩子和 SlipDamage 执行路径。
  • 已使用 PREDATOR_FeatherOstrich / BP_FeatherOstrich_BOSS_Predator_C 进行验证。

版本 1.0.0 Beta

  • 初始公开版本。
  • 为受支持的人类NPC添加了正常的击败处理。
  • 保持对帕鲁的慈悲之戒和慈悲一击行为。
  • 使用《幻兽帕鲁》的 SlipDamage 死亡处理路径，而非直接写入生命值。
  • 添加了玩家排除。
  • 添加了不死NPC保护。
  • 在可用时添加了权限检查。
  • 添加了递归伤害保护。
  • 添加了可选的调试日志记录。
  • 已使用 BP_NPC_Hunter_C 进行验证。
  • 已在《幻兽帕鲁》1.0.1 Steam单人游戏上测试。
  • 已使用 UE4SS v3.0.1 Beta #0，Git SHA b50986bd 测试。