Embers Text API

🔍 Overview

Docs/Wiki: https://docs.tysontheember.dev/Embers-Text-API/

Ember’s Text API lets your mod display polished, animated text overlays without building a custom renderer. Messages can include gradients, backgrounds, fonts, typewriter effects, and shake animations, all controlled through a fluent builder API.

Why make this?

Immersive Messaging API(which this was built to replace) uses her lib, txnilib, which jar-in-jars(aka has another mod inside her mod) Forgified Fabric API, making all of his FORGE mods have FABRIC overhead. That, along with the features I want that IM didn't have(like multiple attributes working together like obfuscation and typewriter, and gradients), made me want to make this, so… cheers 🍻

---

✨ Features

• Fluent Builder API – easily chain together effects
• Custom Fonts – ship your own bitmap fonts under assets/emberstextapi/font/
• Backgrounds – tooltip-style frames or textured panels with scaling/padding controls
• Gradients & Styling – single color, gradients, bold/italic, or full RGB hex
• Animations – typewriter reveal, obfuscation effects, per-character shakes, whole-message shakes
• Flexible Positioning – anchors, alignment, offsets, scaling, wrapping
• Command Support – test or prototype with /emberstextapi send and /emberstextapi sendcustom

---

undefined

🛠 Developer Integration

From the server, build a message and send it:

ImmersiveMessage msg = ImmersiveMessage.builder(100f, "Hello world!")
    .anchor(TextAnchor.CENTER_CENTER)
    .gradient(0xFF0000, 0x00FF00)
    .typewriter(2f, true);
EmbersTextAPI.sendMessage(player, msg);

• Works with single players or a broadcast to everyone.
• Backgrounds and textures are fully customizable.
• Fonts and assets are data-driven.

For full developer docs and examples, see the GitHub Wiki.

---

⌨ Commands

• /emberstextapi send <player> <duration> <text> – simple messages
• /emberstextapi sendcustom <player> <nbt> <duration> <text> – full NBT-driven customization
• /emberstextapi test <id> – play built-in demo messages

---

undefined

📦 For Modpack Makers

• This is a library mod – it does nothing on its own in gameplay, though you can use the included command system for some pretty cool stuff
• Safe to include in packs.
• Perfect for immersive cutscenes, boss fights, quests, or stylish announcements.