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.