Epic Fight - EDP（扩展数据包）

被动技能实现后的效果图，请注意这仅适用于“武器被动技能”，使用其他技能将无效。

在此案例中，我们来看一个如何使用技能数据键与先前特性（被动技能）协同工作的例子。

此处，我们使用打刀的被动技能，该技能允许“收刀”入鞘。一旦此被动生效且值为 True，我们就切换到“收刀”风格。

这支持在谓词中使用以下列表：

• passive_skill_boolean_data_key
• passive_skill_float_data_key
• passive_skill_integer_data_key
• innate_skill_boolean_data_key
• innate_skill_float_data_key
• innate_skill_integer_data_key

对于布尔值，你需要添加技能数据键和期望的值： "skill_data_key": "namespace:path", "expected_value": true

对于整数，你需要添加技能数据键和期望的值： "skill_data_key": "namespace:path", "expected_value": 5

对于浮点数，你需要添加技能数据键、期望的值和一个容差： "skill_data_key": "namespace:path", "expected_value": 2.5, "tolerance": 0.01

⚠ 请确保对每个键使用正确的值 ⚠

理论实现示例

这里有一把武器，当它的天生技能充能超过“5”层时，便会从双持姿态切换到剑柄格（Ochs）姿态，直到“充能”层数小于或等于 5。

请记住，在处理浮点数时添加 ""tolerance": 0.X" ....

💡 好习惯！

有一点需要补充的是，为了更好地理解，将操作这样排序会很有帮助：

"skill_data_key": "modid:charge",

"comparison_type": ">",

"expected_value": 5

因为比较实际上是这样工作的： SkillKey | Comparison Type | ExpectedValue.

X | Comparison Type | Constant.

8 > 5.

当玩家发动蓄力攻击时，系统不会重置连击序列。这意味着内部连击计数会自然继续，允许你在普通攻击和蓄力攻击之间切换，而不会破坏战斗流程。

例如，如果你的武器有这样一个序列：

普通攻击：1AA → 2AA → 3AA → DA → AS

蓄力攻击：1CAA → 2CAA → 3CAA → CDA → CAS

你可以根据连击的位置将这两套动画串联起来。这允许类似这样的组合：

1AA → 2CAA → 3AA → 1CAA → CDA → AS

要保持在蓄力攻击模式，你必须按住按钮。当你松开按钮时，半秒钟后，系统会恢复到普通模式。

"allow_two_hand_compatibility" 条目表示，是否希望在考虑或不考虑副手物品的情况下进行蓄力攻击。

⚠ 注意，天生技能之间的能量不守恒。在示例中，天生技能是不同的，以便在视觉上显示从普通模式到蓄力模式的切换。

在此案例中，我们正在数据包中构建一个“Antitheus”物品。我们已经分配了被动和天生技能；但是，当使用右键时，相机会“出问题”。我们可以通过添加行 "zoom_in_type": "custom" 来解决这个问题。

但是如果我的物品不允许我使用右键怎么办？我们总有办法强制！

对手上任何包含所需标签的物品强制执行**“使用方法”**。这解决了在创建数据包物品时，EF 中出现的多个客户端/服务器使用物品问题。

为此，请在以下路径创建文件：data/epicfight_edp/tags/items/force_use_method.json。

并将物品添加到标签列表中。

现在，我们的武器可以使用右键了，它可以施放 Antitheus 的右键技能，并且相机不会再出问题了！

在这里，我将以钻石剑为例，展示根据其是单手还是双手模式而拥有不同的挥舞轨迹！

当你改变风格时，如果你想改变你的物品模型，并随之改变其挥舞轨迹，这将非常有用。

此功能还会对原始纹理进行“覆盖”，即使它附加在动画上。这确保了你的挥舞轨迹不会被动画修改，而是使用你想要的纹理。

这只是配置纹理；你还需要为相关物品创建 "item_skins" (assets/item_namespace/item_name.json) 文件。

以前面的示例钻石剑为例，它的物品皮肤是这样的 (assets/minecraft/item_skins/diamond_sword.json)

物品皮肤中包含了颜色、起始位置、结束位置、生命周期、插值和粒子类型等参数。只有当高级挥舞轨迹纹理及其回调轨迹失败时，才会使用 "texture_path"。

参数说明

• item: 将接收模型覆盖的目标物品。
• item_socket: 包含所有模型和纹理的插槽物品，按通道分隔。
• per_style: 布尔标志，指示纹理/模型是否应随玩家风格变化。
• style_config: 一个配置对象，定义每种风格应使用的插槽通道。
• style: 风格标识符。
• socket_channel: 将为该风格使用的物品插槽内的通道。

一旦我们有了这个，我们需要构建我们的“物品模型插槽”，它将在内部存储我们所有的模型覆盖；这对于加载模型并将所需纹理分配给通道非常有用。可添加的通道数量不限；你不需要在每个插槽中都放置一个。

这是在游戏中的样子，结合使用了按风格切换挥舞轨迹系统和按风格切换模型系统

这是产生该效果的资源包：** Google Drive - simply_sword_test.zip **

在某些情况下，Epic Fight 技能系统中的武器类别没有清晰或定义的图标。 当发生这种情况时，打开相关的技能书可能会因为缺少图标而导致异常。

（此问题发生在旧版本中；现在可能仍会发生，但此系统作为一个预防性解决方案存在。）

工作原理

添加图标很简单。你只需要定义：

• 要用作图标的物品
• 它所属的武器类别

⚠ 覆盖行为 ⚠

此系统允许覆盖。 如果多个配置为同一类别定义了图标，则只使用一个。

参数

• skill_builder: 存储所有条目的数组名称。
• skill_id: Epic Fight 技能 ID。目标技能必须包含一个用于存储武器类别的字段。如果技能不支持“可用武器类别”，此系统将不起作用。
• category: 要添加到技能中的武器类别。

⚠ 覆盖行为 ⚠

此系统不允许覆盖。 单个类别声明可以被多个被动技能使用，但不能被重新定义。

此系统比前几个更复杂，因为它需要定义：

• 格挡技能
• 武器类别
• 动画类型
• 动画是否随风格变化
• 动画是单个还是数组
• 所需的动画集：
  • 2 套：基础与破防
  • 3 套：基础、破防与高级（取决于技能）

尽管如此，配置仍然很直接。

核心参数

• skill_guard_builder: 存储所有格挡技能条目的数组名称。
• skill_guard_id: Epic Fight 格挡技能 ID。该技能必须继承自格挡技能并支持动画。任何满足这些要求的格挡技能都是兼容的。
• category: 要添加到格挡技能中的武器类别。

动画参数

取决于格挡技能类型：

• 格挡 / 冲击格挡 - 类似技能

  • guard_motion
  • guard_break_motion

• 招架类技能

  • guard_motion
  • guard_break_motion
  • guard_advanced_motion

动画定义

• guard_motion: 当玩家成功格挡一次来袭攻击时播放的动画。
• guard_break_motion: 当玩家的姿态/耐力被耗尽且格挡被击破、使玩家眩晕时播放的动画。
• guard_advanced_motion: 特殊的格挡互动动画。
  • 对于 招架示例：一个偏转动画
  • 对于 奇迹武器 – 反击：一个攻击动画

动画子配置

动画条目支持额外的参数：

• type: 定义是使用单个动画还是动画数组（multi）。只有 guard_advanced_motion 支持数组（multi）。为 guard_motion 或 guard_break_motion 设置的任何非 single 的值都将被视为无效。
• per_style: 定义使用动画的风格。
  • 使用 "return" 来忽略玩家的当前风格。如果你分配了 "return"，系统将理解你不想使用风格，所以如果你使用 return，请不要分配风格。
  • 要定义按风格切换的动画，请指定如：one_hand、two_hand 等值。

⚠ 覆盖行为 ⚠

此系统不允许覆盖。 单个类别声明可以被多个格挡技能重用。

参数文件结构

每个文件定义了着色器的运行方式和时间。一个典型的文件如下所示：

字段定义：

执行模式 (Type)

• Skill → 支持：hold
• Style → 支持：hold
• Animation → 支持：oneshot

Hold: 条件为真时，着色器持续运行 Oneshot: 在特定的经过时间里，着色器运行一次

运行、参数格式

当 payload_on = "Style" 时

skill: <skill_id>

effect:

Style/Hold 的有效效果：

• Overlay Color
• Radial Blur In
• Radial Blur Out

当 payload_on = "Skill" 时

skill: <skill_id>

effect:

Skill/Hold 的有效效果：

• Overlay Color
• Radial Blur In
• Radial Blur Out

当 payload_on = "Animation" 时

animation: <animation_id>

elapse:

effect:

Animation/Oneshot 的有效效果：

• Noise Overlay
• Impact Frame

ShaderFx 参数参考

Impact Frame

Noise Overlay

Radial Blur (In / Out)

Color Overlay

⚠ 重要说明

• 并非所有 intensity 值 在不同着色器中的行为都相同
• 某些系统依赖于正确的 技能兼容性
• 错误的配置可能导致崩溃

根据您的偏好，可以执行以下操作：

• 对于配置：.minecraft/config/epicfight_edp/weapon_builder/category/your_files.json
• 对于 Jar 内：your_mod.jar/lzm_runner/<your_modid>/weapon_builder/category/your_files.json

您的文件应该如下所示：

重要提示：如果您从配置文件夹注册类别，则必须声明一个 modID。 如果您使用 Jar 内文件，则无需指定 modID，因为文件本身所在的命名空间被视为签名者。

在那里你可以创建这样的文件；在这个例子中，它适用于单手和双手模式。

如您所见，如果我们想使用一个简单的叠加层，即单个图像，我们只需传递： "overlay_path": "epicfight_edp:overlays/flame/fireflay_50.png"

同时，您必须始终声明您要写入的物品。在示例中，是："item": "minecraft:diamond_sword",

另一方面："per_style": true, 只是官方程序；它目前不执行任何操作。如果将来我希望叠加层以不同的参数启动，这将很有用。

分配给纹理的路径不会自动位于“textures”文件夹中。图像显示："epicfight_edp:overlays/flame/fireflay_50.png"

这意味着它位于：assets/epicfight_edp/overlays/flame/fireflay_50.png

不在： assets/epicfight_edp/textures/overlays/flame/fireflay_50.png

重要提示： 大小必须与可用于动画的图像数量相匹配。FPS 不能超过 游戏刻评估阈值的 20 刻（20 FPS）。

系统从 1 -> Size 开始计数，而不是从 0 开始，并且星号 (*) 必须与图像集中的数字对应。此外，表示法很简单：0 -> 1 -> 10 -> 11 -> 100，等等。

不兼容 000 -> 001 -> 010 -> 11 -> 100...

简单天生技能

它们使用单个动画和单个属性集。

⚙️ 通用技能字段

这些字段被大多数天生技能类型共享。

⚔️ 技能属性

properties 对象控制技能的 combat 行为。

动画眩晕

击中时造成的眩晕类型

条件型天生技能

条件型技能会根据玩家的当前状态动态选择动画。

支持的条件：

• sprinting
• in_air
• kneeling
• use_item

如果没有任何条件满足，将使用在 animation 中定义的默认动画。

可保持型天生技能

可保持型技能引入了基于蓄力的机制。

特性：

• 自定义蓄力动画
• 最小和最大蓄力时长
• 蓄力超时控制
• 可选的移动减速

此系统为未来混合技能（如条件可保持型天生技能）奠定了基础。

按类别注册

按物品注册：