Z80Z Elytra Trail

A Minecraft 1.20.1 Forge mod (Java 17, client & server) that draws continuous light ribbons, wingtip streams, stardust, water droplets and particle afterimages behind you while gliding with an elytra — 8 trail styles, dye recoloring and an in-game config screen.

How to play

1. Put the jar in the client's and the server's mods folders.
2. Wear an elytra and glide — the trail appears once you reach the configured speed.
3. Right-click into the air with any dye to recolor your trail; the dye isn't consumed.
4. Nearby players with the mod installed see your color, trail, stardust, droplets and afterimages.
5. Press K in game to open the config (rebindable): Visual / Audio / Performance / Trigger categories, changes apply instantly and save automatically. The Trigger page is read-only on servers (the server decides).

Default behavior

• Trail shows above 0.6 blocks/second glide speed
• Streamline ribbon + wingtip lines together; styles: Dust (follows dye color), Rainbow, Flame, Soul Fire, Starlight, Enchanted, Electric, Cherry Blossom
• Stardust density 0.05; more bubbles in rain; a particle afterimage every 0.5s
• Wind sound scales with speed; a roar when firework boost starts
• At most 200 mod particles per client per tick; auto-halved at low FPS or reduced particle settings

Install

1. Install Minecraft Forge 1.20.1-47.4.0.
2. Download the latest z80z-elytra-trail-<version>.jar from Releases.
3. Put it in the mods folder on client and server.

No third-party dependencies. Client-only install still shows your own trail, but other players need the mod to see your effects.

Config

Two files after first launch:

• serverconfig/elytra_trails-server.toml (per world) — server-wide trigger mode: GLIDE, HIGH_SPEED, ROCKET_ONLY, CUSTOM
• config/elytra_trails-client.toml — your own visuals, stardust, droplets, afterimages, audio and performance options

CUSTOM sets its own speed threshold and can require firework boosting.

License

MIT, see LICENSE.

怎么玩

1. 把模组 jar 放进客户端和服务器的 mods 文件夹。
2. 穿上鞘翅开始滑翔，达到配置的速度后会出现拖尾。
3. 手持任意染料对空气点右键，就能把自己的拖尾改成该染料颜色；染料不会被消耗。
4. 周围安装了本模组的玩家会看到你的颜色、拖尾、星尘、水珠和残影。
5. 游戏内按 K 打开配置界面（按键可在「按键绑定」里修改）：左侧切换 视觉 / 音效 / 性能 / 触发条件 分类，所有改动立即生效并自动写回配置文件；联机到服务器时「触发条件」页为只读（由服务器决定）。

默认效果

• 滑翔速度超过 0.6 格/秒后显示拖尾。
• 同时显示流线飘带和翼尖双线；拖尾样式可选 尘埃（跟随染料颜色）、彩虹、烈焰、灵魂之火、星辉、附魔、电光、樱花。
• 星尘密度为 0.05。
• 雨天会出现更多气泡水珠。
• 每 0.5 秒留下一个粒子勾勒的身姿残影。
• 高速时播放随速度变化的风声，烟花推进开始时播放轰鸣。
• 每个客户端每刻最多生成 200 个本模组粒子；低帧率或游戏粒子设置降低时自动减半。

安装

1. 安装 Minecraft Forge 1.20.1-47.4.0。
2. 从 Releases 下载最新的 z80z-elytra-trail-<版本>.jar。
3. 放入客户端和服务端的 mods 文件夹。

模组没有第三方前置。仅客户端安装也能看到自己的拖尾，但其他玩家需要同样安装才能看到你的效果。

配置

首次启动后，Forge 会生成两个配置文件：

• 单人世界存档或服务器世界里的 serverconfig/elytra_trails-server.toml：服务器统一的生成条件，可选 GLIDE、HIGH_SPEED、ROCKET_ONLY、CUSTOM。
• 游戏目录 config/elytra_trails-client.toml：每位玩家自己的外形、星尘、水珠、残影、音效和性能选项。

CUSTOM 模式可以单独设置速度门槛，并选择是否必须在烟花推进期间才显示。

从源码构建

需要 JDK 17，项目自带 Gradle Wrapper：

./gradlew build

产物位于 build/libs/z80z-elytra-trail-<版本>.jar。开发调试：./gradlew runClient。

许可证

MIT，详见 LICENSE。