ETTA

ETTA — Event-Triggered Texture Animation

Dynamic, reactive texture animations for Minecraft

ETTA is a Fabric mod that allows resource packs to animate item, block, and UI textures based on real gameplay events — health, combat, movement, time, weather, and more.

No resource reloads. No hacks. Just smooth, event-driven animations.

---

✨ Features

• Event-Based Animations
  Textures react to player health, combat, movement, environment, and game state.

• Simple Text Format (.mcmetax)
  Human-readable animation definitions with conditions and expressions.

• High Performance
  Efficient texture updates without triggering resource reload screens.

• Vanilla Compatible
  Fully compatible with standard .mcmeta animations.

---

👀 Example

Totem of Undying — pulses faster when health is low:

[animation]
frametime: 2

[fallback]
frame: 0

[segment: critical]
frames: 10-15
priority: 200
frametime: 1
when: health <= 2

[segment: low]
frames: 5-9
priority: 100
when: health <= 5

[segment: idle]
frames: 0-4
priority: 10

---

📦 Resource Pack Structure

assets/minecraft/textures/item/
└── totem_of_undying.etta/
    ├── totem_of_undying.mcmetax
    └── frames/
        ├── 0.png
        ├── 1.png
        └── ...

Just enable the resource pack — ETTA handles the rest.

---

Conditions & Events

ETTA supports 40+ built-in events, including:

• player_attacking
• player_sprinting
• hurt_recently
• player_on_fire
• player_in_water
• daytime / nighttime
• raining

Plus math, randomness, biome checks, potion effects, and more:

when: random() < 0.1
when: holding_item("sword")
when: has_effect("regeneration")

---

Controls

• F8 — Toggle debug overlay

---

Requirements

• Minecraft 1.21.8
• Fabric Loader
• Fabric API
• Fabric Language Kotlin

---

Known Issues

• Some texture atlas edge cases are unsupported
• Debug overlay has minor rendering issues

---

🙏 Credits

Huge thanks to BasiqueEvangelist and the
ScaldingHot mod.

ETTA relies on the runtime texture-switching technique introduced there — making all of this possible without resource reload screens.

---

Why Use ETTA?

If you want alive, reactive textures that respond to gameplay —
ETTA is the missing link between logic and visuals.

---

Report bugs or request features via the Issues tab
🎨 Showcase your creations with #ETTAAnimations

Made with ❤️ for the Minecraft community