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

* Combat Roll Every aspect of the afterimage (duration, color, triggers) is controlled via JSON files. * Combat Roll 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`

```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 Combat Roll 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.