Afterimages

A lightweight, data-driven mod that adds visual afterimage trails to entities! You can configure which entities have afterimages, how they look, and when they appear—entirely through Resource Packs.

Features

• Data-Driven: Every aspect of the afterimage (duration, color, triggers) is controlled via JSON files.
• Mod Compatible: Built-in support for Combat Roll and other mods in the future, upon request.

---

Global Configuration

This mod uses Cloth Config for global settings. You can access the config menu via Mod Menu (on Fabric) or the configured keybind.

Option	Default	Description
Step Size	0.25	Controls the density of the afterimage trail. Lower values (e.g. 0.1) create smoother, connected trails but may impact performance. Higher values create distinct "snapshots".

---

Entity Configuration

To add an afterimage to an entity, create a JSON file in your resource pack at: assets/<namespace>/afterimages/entities/<entity_name>.json

Example: Standard Arrow Trail

assets/example/afterimages/entities/arrow.json

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

Example: Combat Roll Exclusive

assets/example/afterimages/entities/player.json

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

Configuration Fields

Field	Type	Default	Description
entity	String	Filename	The entity ID (e.g. minecraft:ender_pearl). If omitted, the mod tries to guess based on the JSON filename.
speed_threshold	Double	0.5	The minimum speed (blocks/tick) required to trigger the effect. Ignored if combat_roll_only is true.
duration	Integer	10	How long the afterimage trail lasts in ticks.
color	Hex String	"0xFFFFFF"	A hex color code to tint the afterimage.
start_alpha	Float	0.5	The opacity of the afterimage when it first appears (0.0 to 1.0).
overlay_only	Boolean	false	If true, the afterimage will render only the overlay layer (e.g., skin outer layer, armor glint). Useful for ghost-like effects.
combat_roll_only	Boolean	false	If true, afterimages will only appear when the entity is performing a Combat Roll (requires the Combat Roll mod).

---

Mod Integration

Combat Roll

Afterimages has native support for the Combat Roll mod.

• Usage: Set "combat_roll_only": true in your player configuration file to make trails appear exclusively during a roll dodge.

---

License

This project is licensed under the MIT License.

Contributing

Contributions are welcome! If you find a bug or have a feature request, please open an issue or submit a pull request.