BloodyParticlesMod

兼容性： 支持 NeoForge、Forge 和 Fabric，适用于 Minecraft 1.20.1 和 1.21.1。100% 客户端模组——安装在客户端即可加入任何原版服务器。

游戏内配置： NeoForge 版本自带原生配置界面，无需额外组件。对于 Forge 1.20.1 和 Fabric 版本，游戏内配置需要安装 Cloth Config API（Fabric 还需 Mod Menu 来显示按钮）——这是可选的：模组无需它也能正常工作，此时需手动编辑 .toml 配置文件。

BloodyParticles

让每一次攻击都意义非凡。生物在受伤时会迸发符合其主题的血花与粒子效果——不同生物拥有不同效果，并且效果会随攻击蓄力与暴击而增强。

功能特性

• 覆盖 74 种原版生物，每种都有专属主题效果（僵尸的红色石血、蜜蜂的蜂蜜、烈焰人的火焰、美西螈的粉色染料...）。
• 100% 客户端运行——可在任何原版服务器上使用，无需服务端安装。
• 支持 NeoForge、Forge 和 Fabric（Minecraft 1.20.1 和 1.21.1）——基于统一代码库，所有加载器效果一致。
• 游戏内可配置：包含强度、可视半径、暴击倍率等滑块调节的配置界面。支持英文/西班牙语。
• 打击感知：粒子数量随攻击蓄力与暴击动态变化。
• 自定义粒子：注册独立粒子（例如鸡和鹦鹉的飘落羽毛），具备基于精灵图的物理效果。

本模组是对此前数据包的重新制作，原数据包虽实现相同功能，但在项目扩展性和效率方面存在不足。您可以在此查看原数据包：

BloodyParticles 数据包

---

本版本将 BloodyParticles 从生物血液模组扩展为完整的视觉反馈层，覆盖战斗、移动、附魔和弹射物。以下所有效果均可从游戏内配置界面（模组 → BloodyParticles → 配置）开关或微调——包括阈值、强度和纹理变体。

伤害来源变体

生物现在会根据受伤方式产生不同反应，而不仅仅是受伤本身：

• 火焰（火焰 + 小火苗）、熔岩（火焰 + 熔岩滴）、溺水（气泡破裂）、窒息（石砖裂纹）
• 中毒 → 自定义绿色骷髅烟雾（上升、消散）
• 凋零 → 自定义黑色骷髅烟雾
• 冰冻 → 自定义雪花（旋转、飘落）

每种生物默认自动应用以上效果。附加资源包可按生物覆盖这些效果。

动态自定义粒子

自定义粒子现已支持通过标准 mcmeta 实现多帧动画。按 名称_0.png、名称_1.png... 格式放置图片，并在粒子 JSON 中列出——羽毛、骷髅、雪花和末影珍珠粒子在提供多帧图像后将自动播放动画。

低生命值视觉效果

• 红色晕影覆盖层，提供两种纹理变体（V1 柔和 / V2 血腥），可配置生命值阈值（1–99%）。
• 血液粒子，在阈值以下稀疏脉动，低于半阈值时持续出现，强度可调。

玩家移动效果

• 疾跑尾迹——身后留下营火烟雾，冷却时间可配置。骑乘（马匹奔腾）时同样生效。在冰面和雪地自动跳过。
• 坠落尾迹——自由落体时身后喷出白色烟雾。
• 落地爆裂——从 3 格及以上高度坠落时，撞击点产生烟雾 + 灰尘 + 碎石。
• 入水飞溅——跳入水中时产生生态群系色调的水花 + 雪沫 + 海豚音效。

以上每项均可独立开关。

盾牌格挡

在格挡攻击时，面向方向会向前方投射木质 + 暴击粒子——即使盾牌完全吸收伤害时也稳定触发，并且适用于任何以原版方式格挡的物品，包括模组盾牌。

附魔箭矢（弓）

• 火焰附加：火焰 + 烟雾尾迹；击中生物时产生更大火焰 + 熔岩 + 浓烟爆裂。
• 力量：enchanted_hit + 女巫尾迹（数量随等级提升）；击中时产生 sweep_attack + dragon_breath 爆裂。
• 同一箭矢上同时存在两种附魔时也能正确检测。

火焰附加（剑）

持有火焰附加附魔武器进行近战攻击时，会触发与火焰箭矢相同的火焰爆裂效果。

击退 / 冲击波

使用剑（击退附魔）和弓（冲击附魔）时产生冲击波。

靴子附魔

• 摔落保护——落地时产生 2–5 片羽毛。
• 冰霜行者——在水面行走时脚下产生雪花 + 偶尔出现 end_rod 火花。
• 灵魂疾行——在灵魂沙/灵魂土上产生灵魂 + 尘埃羽流。强度可调。
• 深海探索者——水下腿部周围产生气泡、钓鱼、海豚和小型白色空气粒子。强度可调。

末影珍珠

• 自定义 wave_enderpearl 锚定于珍珠每帧位置——逐渐扩大并消散，在珍珠路径上形成"隧道"效果。
• 自定义 dot_enderpearl 散射粒子，具有离散效果。
• 传送门 + 偶尔出现的 dragon_breath 作为魔法基础效果。
• 珍珠撞击并传送玩家时产生传送爆裂效果，包含上述所有粒子。

着火效果

任何燃烧中的生物（或玩家）都会散发火焰和烟雾。火焰免疫生物（烈焰人、岩浆怪、恶魂、凋灵）将自动跳过此效果。强度可调。

---

一切皆可配置

模组附带游戏内配置界面（NeoForge 原生；Forge 和 Fabric 通过 Cloth Config 实现）——上述每个功能都有独立开关，多数功能还提供阈值、频率和强度的滑块调节。

• 不喜欢某个效果？关闭它。
• 希望效果更华丽？拉满滑块。
• 热重载支持：在 GUI 中更改后立即生效，无需重启。

---

附加包与模组生物

BloodyParticles 通过附加资源包实现完全扩展——无需编写代码。只需使用 blood_definitions/*.json 文件将任意实体映射到其专用的血花和命中粒子，即可为模组生物添加主题效果，获得与原版生物完全相同的逐生物控制能力。如果其他模组添加了新生物，附加包也能让它们流血。

BloodyParticles 附加包 —— 即插即用的血花定义，将 BloodyParticles 扩展至模组生物。

---

v4.0 - 更新内容

- 现已支持 NeoForge、Forge 和 Fabric

BloodyParticles 此前仅支持 NeoForge。现在它已可在 NeoForge、Forge 和 Fabric 上运行，适用于 Minecraft 1.20.1 和 1.21.1——每种组合均拥有相同功能集。整个模组已重构至统一代码库（Architectury + Stonecutter），因此各加载器上的效果表现一致，且未来支持新 Minecraft 版本的成本将大大降低。

- 所有加载器均支持游戏内配置

• NeoForge：原生配置界面，无需额外模组。
• Forge 1.20.1 / Fabric：通过 Cloth Config 实现游戏内配置（Fabric 还需 Mod Menu 显示按钮）。该功能为可选——缺少这些模组时，模组仍能正常工作，并读取其 .toml 配置文件。

- 重写的盾牌格挡检测

该检测在单人和多人游戏中均表现稳定，现在还能自动与模组盾牌配合使用——任何以原版方式格挡的物品都会触发效果，无需针对每一物品单独设置。

- 全加载器多人游戏验证

完整的客户端多人游戏层（其他玩家的移动、附魔、弹射物和战斗效果）已通过所有四种加载器/版本组合的验证——仍为 100% 客户端模组，仍兼容任何原版服务器。