Emote Relay
See each other's Emotecraft emotes on servers that don't have Emotecraft installed.
Emote Relay is a client-side add-on for Emotecraft. When the server you join doesn't run Emotecraft, your emotes are sent through an online relay instead, so everyone with the mod can see you dance, wave and pose on any vanilla, Paper or proxy-protected server.
It uses the same relay and packet format as Online Emotes, rebuilt from scratch to fix its crash.
Why Emote Relay?
- No more "currentAnimation is null" crashes. Online Emotes applies incoming emotes on its network thread while the game is rendering the same player, which randomly crashes with
Rendering entity in worldorTicking entity. Emote Relay decodes packets in the background and applies them on the game thread, exactly like Emotecraft does with its own networking. - One jar for every Emotecraft build of your version. Emotecraft changed its packet API in the middle of some release lines. Emote Relay detects the installed build at startup, so it keeps working after Emotecraft updates.
- Never freezes or crashes the game. Network work never blocks, connections reconnect on their own, and a bad packet is logged and ignored instead of taking the game down.
- Fully client-side. Nothing to install on the server.
Requirements
| Minecraft | Loader | Emotecraft | Other |
|---|---|---|---|
| 1.21.11 | Fabric | 3.2.x (build 147 or newer) | Fabric API |
| 26.1.2 | Fabric | 3.3.x (build 152 or newer) | Fabric API |
| 26.2 | Fabric | 3.4.x (build 170 or newer) | Fabric API |
Remove Online Emotes before installing. Both mods do the same job, so Emote Relay refuses to load next to it.
How it works
- You join a multiplayer server (or a LAN world) that doesn't have Emotecraft.
- Emote Relay connects to the relay and joins the "room" for that server.
- When you play an emote, it goes to the relay, which forwards it to everyone in the same room.
- Players who don't have the mod simply see nothing. Nothing changes for them.
Private singleplayer worlds never connect.
Configuration
config/emoterelay.json is created on first launch:
| Option | Default | What it does |
|---|---|---|
enabled |
true |
Turns the relay on or off. |
serverKey |
"ip" |
How players are grouped. "ip" uses the server IP, the same as Online Emotes. "synthetic" uses a fixed key built from the address you typed, for servers whose DNS gives each region a different IP. |
reconnectSeconds |
15 |
Time between reconnection attempts. |
statusToasts |
false |
Shows a toast when the relay connects or disconnects. |
relayUri |
Online Emotes relay | The websocket relay to use. |
Privacy
To route your emotes, the mod sends the relay your Minecraft profile (name, UUID and skin), the IP of the server you're on and the emote data. This is the same information Online Emotes sends.
FAQ
Do other players need the mod? Yes. Only players with Emote Relay (or Online Emotes) can see relayed emotes.
Does it do anything on servers that already have Emotecraft? No. Emotecraft uses the server's own networking and the relay stays out of the way.
Is this affiliated with Online Emotes or Redlance? No. Emote Relay is an independent project. It uses the public relay run by Redlance, which also powers Online Emotes.