Third Party Plugin: ChatIncluded

Adding ChatIncluded to Casterlabs-Caffeinated made by KiraLovey.

ChatIncluded is a plugin for Casterlabs-Caffeinated that automatically translates multilingual chat messages in real time and posts the translation back to chat — no commands needed, no manual copy-pasting.

It works seamlessly across Twitch, Kick, and YouTube simultaneously, making it perfect for multi-streamers with international audiences. Trovo and TikTok support coming soon.

Features #

🔤 Auto-translation — Detects viewer language automatically and translates to your language in real time
💬 Two-way conversation — @mention a viewer and ChatIncluded translates your reply into their language
🤖 Smart emote handling — Uses Casterlabs' message fragments to skip emotes and emoji on all platforms
🛡️ Bot exclusion list — Add your bots by username to prevent them from triggering translations
🌍 Multi-platform — Twitch, Kick, and YouTube simultaneously with cross-platform deduplication
📢 Chat commands — Viewers can request translations, set language preferences, and more
🔁 Loop prevention — ChatIncluded never re-translates its own output
🔔 Update notifications — Notifies you in the Casterlabs console when a new version is available
⚙️ Fully configurable — Every feature has a settings toggle in the Caffeinated widget panel

Requirements #

Tool	What it is	Download
Casterlabs Caffeinated	The streaming app ChatIncluded runs inside	casterlabs.co
DeepL API account	The translation service ChatIncluded uses	deepl.com

A free DeepL API account gives you 500,000 characters/month — plenty for most streamers.

Installation #

Download Casterlabs Caffeinated

ChatIncluded runs as a plugin inside Casterlabs. If you don't have it yet:
- Go to casterlabs.co and download Caffeinated
- Install and sign in with your streaming accounts
Get a DeepL API Key
- Go to deepl.com/pro-api and create a free account
- After signing in, click your account name → Account
- Scroll down to find your Authentication Key and copy it — you'll need it in Step 4
Install ChatIncluded

Installation varies by platform — see below for platform-specific instructions.
Configure the Plugin
- In Casterlabs, go to Widgets & Alerts
- Click the + button → Other → ChatIncluded Settings
- Go to the DeepL API tab and enter your API key and plan type (Free or Pro)
- Go to the Language tab and set your Target Language Code (e.g. EN for English)
- Settings save automatically — there is no Save button

Platform-Specific Instructions #

Download ChatIncluded-Setup.exe
Run the installer — it detects Casterlabs automatically and drops the plugin into the right place
Open (or restart) Casterlabs when the installer finishes

Download chatincluded-1.0.0.jar and install.sh into the same folder

Open Terminal and run:

text

```bash
chmod +x install.sh && ./install.sh
```

Follow the prompts — the script detects Casterlabs and installs into the correct plugins folder
Open (or restart) Casterlabs when the script finishes

Download chatincluded-1.0.0.jar and install.sh into the same folder

Open a terminal and run:

text

```bash
chmod +x install.sh && ./install.sh
```

Follow the prompts — the script installs into ~/.local/share/casterlabs-caffeinated/plugins by default
Open (or restart) Casterlabs when the script finishes

Manual install (any platform): If you prefer, just copy chatincluded-1.1.0.jar directly into your Casterlabs plugins folder. In Casterlabs: Settings → Plugins → Open Plugins Folder.

That's it! Send a message in another language from a second account to test it.

Updating ChatIncluded #

When a new version is available, ChatIncluded will notify you in the Casterlabs console at startup:

text

[ChatIncluded] A new version is available!
[ChatIncluded] Current version : 1.0.0
[ChatIncluded] Latest version  : 1.1.0
[ChatIncluded] Update guide    : https://chatincluded.live

To update, download and run the latest installer for your platform:

Windows — ChatIncluded-Setup.exe
macOS / Linux — download the new chatincluded-1.1.0.jar and re-run install.sh, or copy the JAR directly into your plugins folder

The installer overwrites the existing plugin file automatically. Your settings are preserved.

Settings Reference #

General #

Setting	Default	Description
Enable ChatIncluded	On	Master on/off switch for the entire plugin
Show sender username in translations	On	Adds `@username:` to translation output — helpful for busy chats

DeepL API #

Setting	Description
DeepL API Key	Your API key from deepl.com
API Plan	Free or Pro — must match your actual DeepL account type

Language #

Setting	Default	Description
Target Language Code	EN	The language to translate incoming messages into

Performance #

Setting	Default	Description
Translation Cooldown (ms)	500	Minimum time between translation requests
Burst Limit	5	Max translations allowed per cooldown window
Deduplication Window (seconds)	10	Prevents the same message being translated twice across platforms
Minimum Message Length	5	Skips very short messages that are often misdetected

Two-Way Conversation #

Setting	Default	Description
Enable Two-Way Translation	On	Translates streamer @mentions back into the viewer's language
Remember viewer language for (minutes)	30	How long to remember a viewer's language

Commands #

Setting	Description
!chatincluded response message	The message posted when viewers type `!chatincluded`. Fully customizable
!speak access level	Who can use `!speak`: Streamer / Mod / Subscriber / Everyone

Bot Exclusions #

Setting	Description
Excluded usernames	Comma-separated usernames to ignore (e.g. `fossabot, streamelements, nightbot`). Case-insensitive

Platforms #

Setting	Default	Description
Enable on Twitch	On	Toggle translations for Twitch
Enable on Kick	On	Toggle translations for Kick
Enable on YouTube	On	Toggle translations for YouTube

Chat Commands #

Command	Who can use it	What it does
`!chatincluded`	Everyone	Shows plugin info and a link to chatincluded.live
`!languages`	Everyone	Posts the most common language codes and a link to the full list
`!setlang ES`	Everyone	Pins your preferred language for the session. Sends confirmation in both English and your language. Can be changed any time.
`!translate ES`	Everyone	Translates the most recent chat message into Spanish
`!translate ES Hello!`	Everyone	Translates the provided text into Spanish
`!translate ES` (as a reply)	Everyone	Translates the specific message you replied to
`!speak Welcome!`	Configurable	Translates the streamer's message into every language active in the session

Tip for viewers: You don't need to use !setlang — ChatIncluded automatically detects your language the first time it translates one of your messages. Use !setlang only if short messages are being translated into the wrong language.

How Two-Way Conversation Works #

ChatIncluded remembers the language of every viewer it has translated. When you @mention a viewer in chat, it automatically translates your reply into their language:

text

Viewer:       hola como estas
ChatIncluded: [ES->EN] @viewer: Hello how are you
You:          @viewer Thanks for watching!
ChatIncluded: @viewer [EN->ES] ¡Gracias por ver!

No setup needed — it works automatically as soon as a viewer's language has been detected.

Language Codes #

Code	Language	Code	Language
`EN`	English	`KO`	Korean
`ES`	Spanish	`ZH`	Chinese (simplified)
`FR`	French	`RU`	Russian
`DE`	German	`AR`	Arabic
`PT`	Portuguese	`NL`	Dutch
`IT`	Italian	`PL`	Polish
`JA`	Japanese	`SV`	Swedish
`TR`	Turkish	`ID`	Indonesian

Full list: DeepL Supported Languages

Common mistakes: Use ID not IN for Indonesian, ZH not CN for Chinese, JA not JP for Japanese. ChatIncluded will suggest the correct code automatically.

Troubleshooting #

Plugin shows in the list but won't load Fully close Casterlabs (including from the system tray) and reopen it. If the issue persists, re-run the installer.

"Authorization header is missing API key" Make sure you created a ChatIncluded Settings widget and entered your API key. Check that API Plan matches your DeepL account type.

Emotes are being translated Make sure you are on the latest version. Re-run the installer to update.

Single words are being mistranslated Go to ChatIncluded Settings → Performance and increase the Minimum Message Length.

Translations work but replies don't appear in chat The Casterlabs account you are signed in as may not have chat permission on that platform. YouTube requires minimum account age before posting in chat.

Two-way @mention reply isn't working The viewer needs to have sent at least one message that ChatIncluded translated in the current session, or have used !setlang.

!setlang IN says it's not supported Use ID for Indonesian. ChatIncluded will suggest the correct code automatically.

Occasional "GOAWAY received" error A normal HTTP/2 network hiccup affecting only that one message. The plugin continues normally.

Security #

The installer (ChatIncluded-Setup.exe) is signed — see chatincluded.live/policy.html for the code signing policy
Your DeepL API key is stored inside Casterlabs — ChatIncluded never writes it to any file
Avoid sharing Casterlabs log files (%appdata%\casterlabs-caffeinated\logs\) during debug sessions
If your API key is ever exposed, regenerate it at deepl.com/account

Contributing #

ChatIncluded is in active beta. If you find a bug or have a feature request, please open an issue . Pull requests are welcome.