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.