Stream Chat Connect

# Stream Chat Connect

**Stream Chat Connect** is a client-side Minecraft mod designed for streamers and viewers alike. It bridges the gap between your favorite live-stream platforms and Minecraft by relaying live chat messages, donations, and emotes directly into your in-game chat window in real time.

—

## ✨ Features

*   **Real-Time Integration:** Instantly displays chat messages from **Chzzk** and **Twitch**.
*   **Inline Emote Rendering:** Renders platform-native emotes directly inside the in-game chat text.
*   **Donation Alerts:** View Chzzk Cheese and Twitch Bits donations instantly as they happen.
*   **Smart Auto-Reconnect:** Automatically reconnects if the stream drops, and remembers your last connected channel on the next game launch.
*   **Pure & Lightweight:** Built using only standard Java libraries and Minecraft’s built-in Gson—zero bloated external dependencies.
*   **Client-Side Only:** Runs entirely on your client. You can use it on any server or single-player world without needing the mod installed on the server.

—

## ⚙️ Supported Loaders & Versions

Currently officially supporting **Minecraft 1.20.1** (Expansion to more versions is planned!).

*   **Forge:** Supported (Requires no extra dependencies)
*   **Fabric:** Supported (Requires **Fabric API**)
*   **NeoForge:** Supported (Compatible with 1.20.1 Forge source layout)

—

## 🚀 How to Use

Once installed, you can easily manage your stream connections using simple in-game client commands.

### Connect to a Channel
*   **Chzzk:** `/chzzk connect <channelId>`
    *(Your channelId can be found in your stream URL: chzzk.naver.com/<channelId>)*
*   **Twitch:** `/twitch connect <login_name>`
    *(Use your lowercase Twitch login/username)*

### Disconnect
*   `/<platform> disconnect`
    *(Clears the saved config so it won’t auto-connect on the next launch)*

—

## 💡 Important Notes & Limitations

*   **Chzzk:** Supports text-based Cheese donations that appear in public chat. Video/Mission donations are not supported as they rely on private streamer overlays.
*   **Twitch:** Connects via read-only IRC-over-WebSocket. Supports native Twitch emotes and Bits (Cheers). Third-party emotes (BTTV/FFZ/7TV) are not supported.
*   **SOOP (AfreecaTV):** The integration is currently implemented in the codebase but **disabled** in this release for further verification.

—

## 📝 License & Disclaimer

This project is licensed under the **MIT License**.
*Disclaimer: This mod connects to streaming platforms via standard connection protocols to fetch public chat data. Complying with each platform’s Terms of Service is the user’s responsibility.*