A lightweight, data-driven mod that adds visual afterimage trails to entities!

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.
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". |
To add an afterimage to an entity, create a JSON file in your resource pack at:
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
}
assets/example/afterimages/entities/player.json
{
"entity": "minecraft:player",
"combat_roll_only": true,
"duration": 15,
"start_alpha": 0.8
}
| 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). |
Afterimages has native support for the Combat Roll mod.
"combat_roll_only": true in your player configuration file to make trails appear exclusively during a roll dodge.This project is licensed under the MIT License.
Contributions are welcome! If you find a bug or have a feature request, please open an issue or submit a pull request.
Conversation