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



About this Mod

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": truein 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.
Available Versions
How to Install Afterimages on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set fabric Loader
In the panel under "Egg", select the fabric loader and matching Minecraft version (1.21.11).
Install Mod
Open the mod browser in the dashboard and search for "Afterimages". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.21.11, 1.21.8, 1.21.1 (+1 more)
Server-side
✗ UnsupportedRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
Afterimages server crashes on startup – what to do?
Most common cause: wrong fabric version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.21.11). You can switch loaders with one click in the panel.
Is Afterimages compatible with fabric and forge and neoforge?
Afterimages officially supports fabric, forge, neoforge for Minecraft 1.21.11, 1.21.8, 1.21.1. Note: Forge and Fabric mods are NOT cross-compatible – pick one loader and stick with it. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with Afterimages – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Afterimages consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Similar Mods
Rent Modded Server
Install Afterimages with just one click on your server.