Elytra Music

Elytra Music : Description and Mechanism

Custom flight music and elytra totem survival mechanics — give your elytra a guardian soul.

Overview

Elytra Music enhances the vanilla elytra experience with two core features:

• Flight Music System – Automatically play custom music from a local folder while gliding, with smooth fade‑in/fade‑out.
• Elytra Totem Mechanic – Turn your elytra into a second line of defense against fatal damage, through three distinct forms and a unique enchantment.

Supported Versions

| Minecraft Version | Branch | Mod Version | Fabric Loader |
|——————-|——–|————-|—————|
| 1.21.1 | 1.21.1 | 1.7.2 | >=0.19.2 |
| 1.20.1 | 1.20.1 | 1.7.2 | >=0.19.2 |

The 1.20.1 branch is a backport with identical features.

Features

Custom Flight Music

• Automatically switches to custom music when gliding with an elytra, and resumes vanilla background music when you stop.
• Place .ogg audio files in elytra_custom_music_folder/ (created automatically in the game root directory).
• Random playback with smooth crossfade (default 5 seconds, configurable).
• Shows the current track name on the HUD (reuses the vanilla jukebox overlay).

Elytra Totem – Three‑Form Evolution Chain

| Form | How to Obtain | Survival Mechanic | Consequence on Trigger |
|——|—————|——————-|————————-|
| Vanilla Elytra | End ship loot | None | — |
| Totemized Elytra | Anvil: Vanilla Elytra + Totem of Undying | Built‑in totem effect | Becomes a vanilla elytra after triggering, preserving all enchantments and data. |
| Untotemized Elytra | Automatically converted from a vanilla elytra after totem trigger | Trigger consumes large durability | Retains 1/3 durability (minimum 18), cannot be repaired with Mending. Can be fully repaired back to a vanilla elytra using a Totem of Undying on an anvil. |

Anvil Recipes:

| Left Input | Right Input | Output | Experience Cost |
|————|————-|——–|—————–|
| Vanilla Elytra | Totem of Undying | Totemized Elytra | 1 level (configurable) |
| Untotemized Elytra | Totem of Undying | Vanilla Elytra (full durability) | 6 levels (configurable) |

Exclusive Enchantment: “Protection from the Elytra”

A last‑resort safeguard for your vanilla elytra.

| Attribute | Description |
|———–|————-|
| Applicable to | Only vanilla elytra (minecraft:elytra) |
| How to Obtain | End City treasure chests (10% chance by default, configurable) |
| Max Level | I |

Trigger Logic:

When a player wearing an elytra with this enchantment takes fatal damage:

1. Prioritises consuming a Totem of Undying from the inventory → triggers the vanilla totem effect (green particles) and keeps the enchantment.
2. If no totem is in the inventory → consumes itself (removes the enchantment) as a substitute, triggers a custom effect (purple portal particles + soul sand / ghast death sounds), and leaves the elytra intact (no durability loss, no form conversion).

This enchantment effectively stores one extra totem charge on your elytra, serving as a final safety net when your totem supply runs out.

Configuration

A JSON config file is generated in the config/ folder on first run:

{
  "anvil": {
    "repairCost": 6,
    "repairCost_2": 1
  },
  "music": {
    "fadeSeconds": 5.0
  },
  "enchantment": {
    "bookChance": 0.1
  }
}

The mod generates a JSON config file in the config/ folder on first launch. The file is named elytra-music-config.json and contains the following options:

• anvil.repairCost (default: 6): Experience levels required to repair an Untotemized Elytra back to a vanilla Elytra (with full durability) on an anvil.
• anvil.repairCost_2 (default: 1): Experience levels required to upgrade a vanilla Elytra to a Totemized Elytra on an anvil.
• music.fadeSeconds (default: 5.0): Duration (in seconds) of the fade-in and fade-out transition when custom flight music starts or stops.
• enchantment.bookChance (default: 0.1): Probability (0–1) of finding the “Protection from the Elytra” enchantment book in End City treasure chests.

Item IDs

| Item | ID |
|——|—–|
| Totemized Elytra | elytra-music:totemized_elytra |
| Untotemized Elytra | elytra-music:untotemized_elytra |
| Protection from the Elytra enchantment | elytra-music:elytra_totem_enchantment |

Notes

• Music format: Only .ogg (Vorbis) is supported.
• Music playback is client‑side; other players will not hear your tracks.
• The enchantment cannot be obtained from an enchanting table – it is only found in End City loot.
• May conflict with mods that modify elytra rendering or durability.

License

MIT License – Free to use, modify, and distribute.

May every glide be accompanied by music, and every peril be shielded by your elytra.