Afterimages

一个轻量级、数据驱动的模组，为实体添加视觉残影轨迹！你可以完全通过资源包来配置哪些实体拥有残影、它们的外观以及出现的时机。

特性

• 数据驱动： 残影的每一个方面（持续时间、颜色、触发条件）都由 JSON 文件控制。
• 模组兼容： 内置对 Combat Roll 的支持，未来可根据请求支持其他模组。

---

全局配置

本模组使用 Cloth Config 进行全局设置。你可以通过 Mod Menu（在 Fabric 上）或配置的快捷键访问配置菜单。

选项	默认值	描述
Step Size	0.25	控制残影轨迹的密度。较低的值（例如 0.1）会创建更平滑、连贯的轨迹，但可能影响性能。较高的值会创建明显的“快照”。

---

实体配置

要为某个实体添加残影，请在资源包中的以下位置创建一个 JSON 文件： assets/<namespace>/afterimages/entities/<entity_name>.json

示例：标准箭矢轨迹

assets/example/afterimages/entities/arrow.json

{
  "entity": "minecraft:arrow",
  "speed_threshold": 0.5,
  "duration": 5,
  "color": "0xFFFFFF",
  "start_alpha": 0.6
}

示例：Combat Roll 专用

assets/example/afterimages/entities/player.json

{
  "entity": "minecraft:player",
  "combat_roll_only": true,
  "duration": 15,
  "start_alpha": 0.8
}

配置字段

字段	类型	默认值	描述
entity	String	文件名	实体 ID（例如 minecraft:ender_pearl）。如果省略，模组会尝试根据 JSON 文件名进行猜测。
speed_threshold	Double	0.5	触发效果所需的最低速度（方块/刻）。如果 combat_roll_only 为 true，则忽略此项。
duration	Integer	10	残影轨迹持续的时间，以刻为单位。
color	Hex String	"0xFFFFFF"	用于给残影着色的十六进制颜色代码。
start_alpha	Float	0.5	残影首次出现时的不透明度（0.0 到 1.0）。
overlay_only	Boolean	false	如果为 true，残影将仅渲染叠加层（例如，皮肤外层、盔甲光效）。适用于幽灵般的特效。
combat_roll_only	Boolean	false	如果为 true，残影将仅在实体执行 Combat Roll 时出现（需要 Combat Roll 模组）。

---

模组集成

Combat Roll

Afterimages 原生支持 Combat Roll 模组。

• 用法： 在你的玩家配置文件中设置 "combat_roll_only": true，使轨迹仅在翻滚闪避期间出现。

---

许可证

本项目基于 MIT 许可证 授权。

贡献

欢迎贡献！如果你发现 bug 或有功能请求，请提交 issue 或 pull request。