Chat Emotes Mod Wiki

Chat Emotes Mod, originally known as EiraMoticons, is a specialized utility mod designed to enhance the social experience in Minecraft. It allows players to use and view popular streaming emotes—such as Kappa, PogChamp, and LUL—directly within the Minecraft chat window. The mod is entirely client-side, meaning it does not need to be installed on the server for it to function, though only players with the mod installed will be able to see the graphical emotes.

By default, the mod provides access to Twitch Global emotes and can be configured to support subscriber-specific emotes, BetterTwitchTV (BTTV), and FrankerFaceZ (FFZ) libraries. It also features a robust API that allows other mods to display custom icons or badges in the chat.

The mod supports several major emote providers and custom local files:

• Twitch Global Emotes: Includes all standard emotes available to every Twitch user (e.g., :Kappa:, :BibleThump:, :PogChamp:).
• Twitch Subscriber Emotes: Allows users to see emotes from specific Twitch channels. These must be enabled individually in the configuration.
• BetterTwitchTV (BTTV): Support for global BTTV emotes and channel-specific BTTV emotes.
• FrankerFaceZ (FFZ): Support for the FFZ emote library.
• Custom Emotes: Users can add their own image files to a local directory to use as emotes in-game.
• Twitch Smileys: Support for the standard set of Twitch-themed smileys.

Chat Integration

When a player types a supported emote code (e.g., Kappa) into the chat, the mod intercepts the text and renders the corresponding image in the chat history. This works on any server because the transformation happens locally on the client's screen.

Client-Side Nature

Because the mod is client-side only, it does not add any physical blocks, items, or mobs to the game world. It functions strictly as a UI enhancement. If a player without the mod is on the same server, they will simply see the text code (e.g., "Kappa") instead of the image.

Emote Rendering

Emotes are scaled to fit within the standard chat line height. The mod supports animated GIFs (in certain versions) and high-resolution PNGs, though they are typically downscaled for readability.

The mod includes several commands to manage emote subscriptions and settings in-game.

The mod can be configured via the in-game Mod Options menu (if using Forge) or by editing the eiramoticons.cfg file located in the .minecraft/config/ directory.

Key Settings

• enableTwitchGlobal: (Boolean) Toggles the standard Twitch global emotes.
• enableBTTV: (Boolean) Toggles BetterTwitchTV emote support.
• enableFFZ: (Boolean) Toggles FrankerFaceZ emote support.
• subscriberChannels: (List) A list of Twitch channel names whose subscriber emotes should be downloaded and displayed.
• renderTwitchBadges: (Boolean) Toggles the rendering of Twitch badges (like Moderator or Turbo) if integrated with other mods like EiraIRC.

Users can add their own custom emotes by following these steps:

1. Navigate to your Minecraft installation folder (usually %appdata%/.minecraft).
2. Locate or create a folder named emoticons.
3. Place any .png or .jpg images you wish to use into this folder.
4. The filename (without the extension) becomes the emote code. For example, myface.png will be usable in-chat by typing myface.
5. Restart the game or use /emoticons reload to see the changes.

Chat Emotes Mod is designed to be highly compatible with other chat-related mods:

• EiraIRC: This mod was originally built as a companion to EiraIRC. When used together, it can sync emotes and badges directly from IRC channels connected to Twitch.
• API Support: The mod includes an API that allows other developers to register their own "Emote Packs." This is often used by server-specific mods to add custom server icons or rank badges to the chat.