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.