Elytra Contrails Mod — Guide
Mechanics
Trail Generation
Trails are generated based on the movement of the Elytra's wingtips. The mod calculates the "Angle of Attack" to ensure trails spawn at the most realistic point. By default, trails only appear when the player is moving above a certain speed threshold, though this can be overridden in the settings.
Twirling
Twirling is a core mechanic that allows players to rotate their character model during flight. This is not just visual; the trails follow the rotation, allowing for the creation of complex spiral and helix shapes in the sky.
| Feature | Description |
|---|---|
| Helix Trails | Created by constant twirling while moving forward. |
| Input Buffer | Ensures twirls feel natural and responsive to key presses. |
| Camera Sync | Optional setting to make the camera roll with the player during a twirl. |
Twirling!
Twirling adds a new layer of expression to flight. You must bind keys in the standard Minecraft Controls menu to use these features.
- Twirl Left/Right: Rotates the player 360 degrees in the chosen direction.
- Constant Twirl: Keeps the player spinning as long as the key is held, perfect for long helix trails.
- Random Twirl: Performs a random roll or flip.
- Twirl Timing: Adjust how fast the rotation occurs.
- Twirl Types: Choose from 6 different animation styles, ranging from tight barrel rolls to wide loops.
- Ignore Speed for Twirling: Allows trails to spawn during a twirl even if the player is moving below the minimum required speed.
Presets
The mod includes a Preset system to quickly switch between different trail styles.
- Built-in Presets: Includes defaults like "Rainbow," "Fire," "Ice," and "Classic White."
- Custom Presets: Players can save their current configuration as a new preset to be reloaded later.
- Other's Defaults: You can set a specific preset to be applied to all other players who do not have the mod installed or have not shared their config.
- Resource Pack Presets: Resource packs can bundle
.jsonfiles that add new presets to the selection menu.
Resource Packs
Custom Textures
To add custom trail textures, place .png files in assets/elytracontrails/textures/trails/. These can then be selected in the Trail Specific Settings.
EMF (Entity Model Features) Integration
If you use custom Elytra models via EMF, you can define exactly where trails spawn by naming bones in your model:
* leftWingTip / rightWingTip: Standard dual-trail setup.
* trailSpawner: A generic name for any bone that should emit a trail.
Custom Trail Spawners
Advanced creators can define trails for any entity (not just players). By adding a JSON file to assets/elytracontrails/trails/, you can attach contrails to Arrows, Allays, or even custom modded mobs.
{
"entity": "minecraft:arrow",
"color": "#FFFFFF",
"width": 0.2,
"length": 20,
"texture": "elytracontrails:textures/trails/smoke.png"
}