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

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

Anvil Recipes:

Exclusive Enchantment: "Protection from the Elytra"

A last‑resort safeguard for your vanilla elytra.

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

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.