Afterimages

!(https://cdn.modrinth.com/data/cached_images/e8c5585ea8a638c8885ce96312d3ebd35d27d7d3.png)

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//afterimages/entities/.json`

#### Example: Standard Arrow Trail

`assets/example/afterimages/entities/arrow.json`

```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`

```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 *(https://modrinth.com/mod/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.