Twitch Chat Bridge

💬 Twitch Chat Bridge

Bring Twitch chat directly into Minecraft with badges, animated emotes, replies, channel-point redemptions, Shared Chat support, and more.

Twitch Chat Bridge is a client-side Fabric mod that mixes messages from one or more Twitch channels into normal Minecraft chat. It is designed to feel like a natural part of the game while still preserving Twitch features such as badges, emotes, username colors, replies, events, and channel identity.

---

✨ Main Features

Twitch Chat in Minecraft

• Twitch messages appear directly inside normal Minecraft chat

• Connect to multiple Twitch channels simultaneously

• Select which channel /tc sends messages to

• Send a one-time message to another configured channel

• Optional timestamps, channel prefixes, and profile pictures

• Per-channel mute and display settings

• Readable gray fallback for pure-black Twitch usernames

Badges, Emotes and GIFs

• Twitch global and channel badges

• Static and animated Twitch emotes

• Best-effort Twitch GIF Keyboard support

• 7TV global and channel emotes

• BetterTTV global and channel emotes

• FrankerFaceZ channel emotes

• Separate per-channel controls for avatars, badges, and emotes

Replies and Conversations

• Twitch reply previews inside Minecraft chat

• Click a username to prepare a message to that user

• Click the username on a reply to continue the same Twitch reply thread

• Reply to the latest message in any configured channel

• Replies are sent through Twitch’s proper reply system instead of only inserting @username

Twitch Events

The mod can display:

• New subscriptions

• Resubscriptions

• Gift subscriptions

• Community gifts

• Raids

• Announcements

• Bits and cheers

• Channel-point redemptions

• Silent rewards such as Hydrate and Stretch

Silent channel-point rewards are available for the broadcaster account that authorized the application. Twitch does not allow one account to receive private redemption events from unrelated broadcasters.

Moderation Updates

Choose what happens when Twitch deletes a message, times out a user, or clears chat:

Mode	Behavior
Remove	Removes the affected Twitch message from Minecraft chat
Cross out	Keeps the message visible but marks and strikes it out
Leave alone	Ignores the Twitch moderation update

Minecraft and server messages are never modified by this feature.

Mention Alerts

• Detect your Twitch name, Minecraft name, or custom aliases

• Checks only the message body—not the sender’s username

• Configurable notification sound

• Adjustable sound volume and pitch

• Configurable alert cooldown

• Built-in test button

• Your own messages do not trigger alerts

---

⚡ Performance and Caching

Twitch Chat Bridge includes a persistent local cache for:

• Avatars

• Badges

• Twitch emotes

• Animated GIFs

• 7TV, BTTV, and FFZ provider data

Animated assets are processed using a minimum-priority background worker. GIF frames are combined into compact texture atlases instead of creating a separate GPU texture for every frame.

Performance controls include:

• GIF frame-rate limit

• Pause animations while Minecraft chat is closed

• Simultaneous image-download limit

• Completed-image upload limit

• Enable or disable the disk cache

• Configurable cache-size limit

• Clear-cache button

---

🎮 Commands

Command	Description
/tc <message>	Send a message to the selected Twitch channel
/tc @channel <message>	Send once to another configured channel
/tc reply <message>	Reply to the latest message in the selected channel
/tc reply @channel <message>	Reply to the latest message in another channel
/tc channel <channel>	Change the selected outgoing channel
/tc channels	Show configured channels and connection states
/tc reconnect	Reconnect Twitch chat
/tc config	Open the configuration screen
/tc	Display connection status and command help

---

🔐 Twitch Login Setup

Twitch requires chat applications to identify themselves with a Client ID.

You only need a Client ID. Never enter a Client Secret into Minecraft.

1. Open the Twitch Developer Console.

2. Register a new application.

3. Set the application/client type to Public.

4. Use http://localhost for the redirect URL.

5. Copy the application’s Client ID.

6. Start Minecraft and run /tc config.

7. Paste the Client ID and select Connect Twitch.

8. Approve the requested permissions in your browser.

9. Add any additional channels from the Channels menu.

The mod uses Twitch’s Device Code login flow, so you do not need to paste an OAuth token manually.

Automatic Token Refresh

Access and refresh tokens are stored locally in:

config/twitch-chat-bridge.json

The mod automatically:

• Refreshes the access token before it expires

• Saves the new access token

• Saves rotated refresh tokens

• Retries temporary refresh failures

• Asks you to reconnect if authorization is permanently lost

Your Client Secret is never requested or stored.

---

🌐 Multiple Channels and Shared Chat

You can add multiple Twitch channels and independently configure each one.

Every channel supports:

• Enable or disable

• Mute

• Custom prefix

• Custom prefix color

• Avatar toggle

• Badge toggle

• Emote and GIF toggle

• Outgoing-channel selection

When Twitch Shared Chat provides source-channel information, the mod uses it to display the correct:

• Channel profile picture

• Channel badges

• Channel-specific emotes

• Channel identity

Mirrored Shared Chat messages are automatically deduplicated when possible.

---

⚙️ Requirements

Requirement	Version
Minecraft Java Edition	1.21.11
Fabric Loader	0.19.3 or newer
Fabric API	0.141.4+1.21.11 or newer
Java	21
Mod Menu	17.0.0 or newer — optional

This is a client-side mod. It does not need to be installed on the Minecraft server.

---

🎨 Supported Emote Services

• Twitch

• 7TV

• BetterTTV

• FrankerFaceZ

---

📁 Configuration Files

Main configuration:

config/twitch-chat-bridge.json

Downloaded asset cache:

config/twitch-chat-bridge-cache

Settings can also be exported and imported through the configuration screen. OAuth access and refresh tokens are deliberately excluded from exported settings.

---

⚠️ Twitch GIF Support

Twitch does not currently provide a consistently documented GIF fragment format through its public EventSub chat documentation.

The mod searches unknown message fragments for supported media URLs and displays the GIF when Twitch supplies one. If Twitch does not include a usable media URL, the text supplied by Twitch is displayed instead.

---

📜 Disclaimer

Twitch Chat Bridge is an independent project. It is not affiliated with or endorsed by Twitch, Mojang Studios, Microsoft, Fabric, 7TV, BetterTTV, or FrankerFaceZ.

All trademarks belong to their respective owners.