Documentation

First steps

1. Log in. On the home page choose to log in through Twitch or through Kick. The account is created by itself on the first visit.
2. Add the second platform. On the Dashboard you will see a tile "Połącz konto Kick" or "Połącz konto Twitch". You can do the same on the Włącz bota page, in the "Połączone konta" card at the top - that is also where you disconnect a platform. Until the second platform is connected, the bot works on one only.
3. Check the connection status. At the top of the Dashboard there are two badges, one per platform. Green means everything is fine. Orange "połącz ponownie" means the bot has nothing to work with there - click it and log in again. A red bar above the badges appears when the platform has revoked its permission; it holds a separate button for each platform, and after logging in again the bar disappears on its own. The same three states are visible in Ustawienia and on the Włącz bota page.
4. Enable the bot on your channel. This is a one-off step on the Włącz bota page. Without it CrossMod does not start reading your chat, so phrases and commands will not work. Details in the next chapter.
5. Add your first phrase. Fastest from the Dashboard, with the "Dodaj frazę automod" tile. From that moment the bot reacts to it on both platforms.

A login is valid for a week. If the dashboard starts refusing to save, refreshing the page and logging in again is usually enough.

Enabling the bot

The Włącz bota page gathers everything you do once, at the very beginning. This is where you come back whenever the dashboard says the connection to Twitch or Kick has expired.

• Połączone konta. The card at the very top of the page. Here you connect the second platform and here you disconnect it. The card tells two different things apart: connection expired in orange, meaning the platform stopped honouring the permission and the bot fell silent by itself, and disconnected in grey, meaning you clicked "Odłącz" yourself. In both cases the "Połącz ponownie" button comes back, and phrases, commands and overlay settings wait untouched.
• Stan bota. A list of what the bot reacts to on your channel right now. It checks itself when you open the page, and the button next to it checks again. It covers both platforms - each item carries the platform name, so it is immediately clear which side is missing something. An item with a cross has a sentence underneath saying exactly what is wrong.
• Włącz bota. One button and one click. Until you click it, CrossMod does not read your chat, so automod phrases and commands have nothing to react to. You can click it again whenever something stops working.
• Adresy overlayów do OBS. All the addresses to paste into OBS, each with a "Kopiuj" button. They are hidden by default, so they are not shown to viewers during a stream.
• Sesja. Logging out of the dashboard and disconnecting both platforms at once.

Overlay addresses contain your private key. Do not show this page on stream with the addresses revealed, and do not send them to anyone.

Automod phrases

The Frazy automod page is the heart of CrossMod. You type a word or a fragment of text, choose where to look for it and what the penalty should be. The bot checks every message on Twitch and Kick and reacts on its own.

What you set for a phrase

• Where to look: in the message, in the nickname or everywhere. The nickname option is useful against waves of bots with similar account names.
• Penalty: ban, timeout or deleting the message. For a timeout you choose the length: from 60 seconds to 24 hours.

A timeout must have a length set. A zero-second timeout is understood differently by each platform: Twitch rejects such a command and does nothing, while Kick treats a command without a duration as a permanent ban. New phrases get a length automatically, but an old entry with a zero may still be sitting on the list - the dashboard then labels it "Timeout bez czasu" and shows a red bar above the list. Select such a phrase and click "Timeout" in the selection bar, and it will get 10 minutes on both platforms.

How the bot matches phrases

• Letter case does not matter, Scam and scam are the same thing to the bot.
• A phrase must be at least three characters long and contain ordinary letters or digits. Shorter phrases, and ones made only of emoji, are skipped by the bot.
• Phrases of up to four characters match only as a whole word. Thanks to that cat will not punish someone who wrote "catalogue".
• Longer phrases also match inside a word, so discord.gg will work in any link.
• One message gets only one penalty, from the phrase the bot hits first. Penalties do not stack.

Who the bot does not skip

• Moderators, VIPs and subscribers get no special treatment. The bot checks their messages just like any other, so with phrases that someone from your team might write innocently it is worth being careful.
• On Twitch the bot skips exactly one person: the channel owner, that is you.
• On Kick it skips nobody. It checks your own messages just like anyone else's, so a phrase with a common word can hit you on your own chat.

Before adding a phrase with an ordinary word, check it in the "Sprawdź, co zrobi bot" field and set the author to "Moderator lub VIP". You will see straight away whether the penalty would also hit your team.

Not sure how your phrase will behave? At the top of the page there is a "Sprawdź, co zrobi bot" field. You paste a chat message into it, choose who wrote it, and immediately see whether any phrase catches it, which phrase that is and what penalty follows. It is calculated in your browser: nothing goes to chat and nobody gets punished.

A trial run on real chat

The field above checks one message that you type yourself - and nobody types from memory the exact sentence a regular viewer will write tomorrow. That is why there is a second card under the tester: "Próba na prawdziwym czacie". You enter the phrase alone, and CrossMod runs the latest messages saved from your chat through it and tells you how many of them it would catch, from how many people and what those messages looked like. It is the simplest way to see, before adding, whether a phrase with an ordinary word would hit your regulars.

Every phrase on your list carries the same button, labelled "próba" - one click checks a phrase added long ago, when chat has had time to change. A trial run sends nothing and punishes nobody; it only counts matches on saved messages. The chat record lives for 7 days, so there is nothing to check further back, and on a busy channel a trial run will cover the last few hours - the answer always says how far back the checked messages go.

Global filters

Below the form there is a list of global filters, shared by all channels in CrossMod. They catch typical scams and link spam. Each of the two lists, yours and the global one, has its own switch, so you can keep only the global one or only your own.

Tidying up the list

• Every phrase carries a number saying how many times the bot really punished someone for it. Clicking that number opens exactly those penalties in the Mod Log, with nicknames and message texts, so you can see at once whether the phrase catches too widely. A dashed outline marks a phrase that has not fired even once. When there are more such phrases, a filter appears above the list: "Pokaż tylko te, które nic nie złapały" - handy when cleaning up an old list.
• The label "ta nie zadziała" sits next to a phrase whose voice is taken by an older phrase. The bot stops at the first match, and the first one for it is the oldest - so once you have damn with message deletion, a later damn you with a ban will never ban. Hover over the label to see which phrase and which penalty wins.
• The search field above the list narrows it on the fly, without reloading the page.
• By selecting phrases on the left you can change the penalty for several at once or delete them with a single click.
• The "Pobierz kopię" button saves your list to disk, and the form next to it uploads it back. The same route moves a list to another channel. Global filters are not part of the copy, because they are added by themselves.

Commands and recurring messages

On the Komendy page you create what the bot should do on a keyword from chat, and what it should repeat by itself during a stream.

A command

• The name has to start with an exclamation mark, for example !discord.
• The most common action is a text reply. In the text you can use placeholders - the chapter below describes them.
• Beyond that there are ready-made actions to choose from: a raffle, followage, points and commands for Tibia (Drome rotation, Rashid, shared exp, stamina).
• You also choose who may use the command: only you, you together with moderators, or everyone.
• If the emotes on Kick differ from the ones on Twitch, tick "Osobna treść dla Kick" and enter a second version of the reply.
• A command can be set to be sent every few minutes. The bot sends it only while the stream is live.

Placeholders in the reply text

In a text reply the bot replaces six placeholders. They are written with a dollar sign and in curly brackets:

• ${sender} - the nickname of the person who typed the command.
• ${nick} - the first word after the command, for example @someone. ${1} means exactly the same.
• ${args} - everything someone added after the command.
• ${target} - the first word after the command, and when nobody gives one, a random viewer from the last half hour.
• ${randomviewer} - a random viewer from the last half hour, regardless of what anyone typed after the command.

Example of a !spank command: with the text ${sender} spanks ${target}!, typing !spank @someone sends "You spank @someone!", and plain !spank draws someone from chat.

Three things that are easy to forget. First, a placeholder with a typo or without the dollar sign ({nick}) will not be replaced with anything - it goes to chat literally, brackets included; the version without the dollar is used only by the raid greeting and the descriptions of channel-point videos. Second, placeholders work only when someone types the command in chat - with auto-sending every N minutes and in recurring messages there is neither a person writing nor an argument, so the plain text with brackets goes to chat. Third, when ${target} or ${randomviewer} has nobody to draw (nobody wrote for half an hour), the bot will not send your text but a ready-made sentence saying there are no volunteers. The dashboard explains each of these cases on the command card.

Recurring messages

These are short announcements sent automatically during a stream, for example a Discord reminder. You set the text, the platform and the interval, no shorter than five minutes. Every command and message has a "Testuj" option, which sends it to chat right away so you can check the text without waiting. In a command test your own nickname goes in place of the placeholders - a recurring message goes exactly as it is, because placeholders do not work there anyway.

"Testuj" sends the text even when the switch on the entry is off - so that you can look at the message itself. The dashboard then adds next to the result that the bot will not do it by itself until you turn the switch on. It says the same when the command cannot be triggered for another reason, for example when its name does not start with "!". Commands after which the bot writes nothing in chat (a VTube Studio hotkey, a raffle) have nothing to send in a test, and the dashboard then points you to typing them in chat with the overlay running. The same goes for commands that answer about the person asking, that is !followage and !points.

How you know it really works

Under the card of every recurring message and every command with auto-sending there is a Harmonogram line: when the entry last went out and in how many minutes it goes next. Above the whole list there is one sentence about which broadcasts the dashboard currently sees as live, because the bot sends these messages only during a live broadcast. So if an entry "does not work", the screen shows whether it is simply waiting for the stream to start, whether the interval has not passed yet, or whether something is wrong with it - in the last case a separate explanation stands by the card.

That sentence, however, says only what the bot has recorded on its side, and the record can drift away from reality. CrossMod asks Twitch itself every few minutes, but it learns about a broadcast on Kick from a single notification sent at the moment it starts. If that notification is lost, the bot considers Kick offline for the whole stream and will not send any recurring message to that chat. That is why above the list there is a "Sprawdź, czy bot widzi transmisję" button: it asks both platforms directly and shows one sentence for each about how things really are. When the bot says something different from the platform, a "Napraw to" button appears next to it and one click puts everything back in place. The check guesses nothing: if a platform does not answer, the dashboard says so plainly and changes nothing.

Backup

At the bottom of the Komendy page there is a Kopia zapasowa card. "Pobierz kopię" saves one file to disk with all commands and recurring messages, together with their text, permissions and intervals. It is worth making before you start a bigger clean-up or before you move settings to another channel.

"Wgraj kopię" works the same way as with automod phrases: it only adds the missing entries and never deletes or overwrites anything. A command with a name you already have, and a message with the same text, are skipped, so uploading the same file twice will not fill the list with duplicates. After the upload the dashboard lists how many entries were added, how many were skipped and why.

The overlay and the chat panel in OBS

The Overlay page gives you the address you paste into OBS. There are two views to choose from: Game, a transparent chat over the game picture, and Chat, the full view of chat from both platforms.

How to add an overlay to OBS

1. On the Overlay page choose the Game or Chat tab and copy the address with the button next to the field.
2. In OBS add a new source of type "Browser" ("Browser Source") and paste the address.
3. Set the size it should take on the scene. You do not need to turn off the background, the overlay is transparent.

Everything you change with the sliders on the right of the panel saves by itself and shows up straight away in the preview in the middle. The "Przywróć domyślne" button returns the look to factory settings, and "Pobierz kopię" and "Wgraj kopię" let you keep a polished look on disk or move it to the other overlay.

The "Nick" field decides the colour of viewer names and works in both views, Game and Chat. "Kolor użytkownika" keeps the colour a viewer chose for themselves on Twitch or Kick. "Kolor platformy" paints all nicknames from Twitch purple and those from Kick green, so you can see at a glance which side a message came from. "Własny kolor" gives every nickname one colour chosen by you. The change also covers messages already on screen, so there is no need to refresh the source in OBS.

In the bar at the top of the Overlay page there is a line "OBS: ile źródeł". It says how many of your overlays are actually connected right now, that is whether OBS on the other side really is receiving. Empty means no source is reporting in - usually OBS is turned off or the address in the source is out of date. The open dashboard itself does not count towards this.

The chat panel as a dock in OBS

You can add the same chat address in OBS as your own dock ("Custom Browser Dock") and have chat next to the scene preview. To be able to moderate from it, it has to be paired once:

1. A six-digit code appears in the chat window in OBS, valid for ten minutes.
2. Enter it in the dashboard, on the Overlay page under the "Paruj" button, or on the crossmod.app/pair page.
3. Once paired, you can ban and mute a viewer straight from the chat window, without switching to a browser.

Next to it there is also the address of the "Aktywni" list, that is the people writing in chat right now. This is a dock too, not a scene source. You click a nickname once you have greeted someone and it gets struck through; the "Ukryj OK" button hides the struck-through ones completely. Someone who got a ban or a timeout leaves the list by themselves. By default the list keeps the last fifteen minutes - you set a different range by adding &min= and the number of minutes, from 1 to 1440, to the address. When the window loses its connection to the server, it says so at the top instead of quietly emptying.

All the addresses at once, including the rarely used ones, are collected on the Włącz bota page, in the "Adresy overlayów do OBS" card.

Videos for channel points

The Video Overlays page pins short videos to channel point rewards. A video fires when the name of the redeemed reward contains one of the fragments entered in the "Nazwy nagród" field - letter case does not matter, and there can be several fragments, separated by commas. Checking does not stop at the first match, so one reward can start several videos at once; the dashboard warns about this on the card.

• The interval between firings is the shortest gap between two firings of the same video. Redemptions that fall inside it are skipped - thanks to that one person will not play the same video ten times in a row. The gap is counted from the moment the video went on the scene, and restarting the bot starts it over.
• When the queue of videos on the scene already stretches more than two minutes ahead, further rewards are skipped - a video watched half an hour after being redeemed means nothing to anyone anyway.
• One redemption plays once. If the same reward is pinned both to a video and to the monkey, whichever came first takes effect.

In the rewards dock in OBS every reward has a "Test" button. After a click, the bubble at the bottom says what really went on the scene, and when nothing fired - for what reason, together with the number of seconds left of the interval.

VTube Studio hotkeys

On the Overlay page, in the "Overlay kolejki" card, you pin a channel point reward to a hotkey in VTube Studio. The hotkey fires when the name of the redeemed reward contains the title entered here, and it works the same on Twitch and on Kick. You can add a short sound to the link, which plays together with the animation.

• The interval is the shortest gap between two firings of the same hotkey. A redemption or command falling inside the gap is skipped, so ten redemptions in a row will not interrupt the model's animation ten times. Zero means: no gap. The gap is counted from the moment of firing, and refreshing the source in OBS starts it over.
• Wyłącz stops the hotkey from firing after a reward is redeemed, while the link itself stays on the list together with its sound and interval. There is no need to delete it and type it in again after a stream on which the model is meant to stay calm. The chat command has its own switch, next to it on the command list.
• The same hotkey is also fired by a chat command, set on the Komendy page with the "hotkey VTS" action. The command takes its interval and sound from the link with the same hotkey name, so one interval setting covers both the reward and the command.
• The sound can be in mp3, wav, ogg or m4a format and weigh at most 5 MB. The "Posłuchaj" button plays exactly the file that will play on stream. A failed upload does not take away a sound that already worked - the previous one stays, and the dashboard says what went wrong. Deleting the whole link also deletes the sound uploaded to it.

The overlay address contains your account's private key. Anyone who knows it sees your chat live, so do not show that address on stream and do not send ready-made OBS scenes to strangers.

Alerts on stream

The Alerty page sets up the graphics that pop up on stream when someone follows you, subscribes, raids you or sends bits or Kicksy. This one source in OBS handles all the events from Twitch and from Kick at once.

Display, appearance, animations, per-event settings, your own sounds and the numbers for raids, gifts and subscription renewals all work - more on that below.

How to start it

1. Copy the address from the "Adres do OBS" card at the top of the page. If the field is empty, go to the Overlay page first - the address will be generated there by itself.
2. In OBS add a "Browser" source the size of the canvas, usually 1920 by 1080, and turn off the background.
3. One such source is enough for all events, no matter which corner of the screen they are meant to appear in.

What you set

• Shared appearance: style, typeface, entry and exit animation, time on screen, size, the gap between consecutive alerts and three switches: countdown bar, platform icon and nickname in capitals. Changes save by themselves and show up straight away in the preview in the middle of the page.
• Each event separately: click its name on the list to set the colour, the text, the time and the sound for that one event, and also to switch it on or off and choose a corner of the screen. The time entered for an event fits in the same range as the shared slider, from 2 to 15 seconds; zero means "as much as the slider sets".
• Placeholders in the text: {nick} is the person the event concerns, and {tekst} is the ready-made sentence from the platform.
• Sound: there are ten ready-made CrossMod sounds to choose from, and under the event list, in the "Twoje dźwięki" card, you upload your own recordings. They appear straight away on the list for every event. Formats mp3, wav, ogg and m4a, at most 5 MB per file and ten files at a time. Short ones, up to two seconds, sound best.

The {ile} placeholder inserts the number from the alert: viewers for a raid, subs for a gift, bits for Bits and Kicksy for Kicksy. For a subscription renewal that role is played by {miesiace}, that is which consecutive month it is. For those same events the "alert dopiero od" threshold works: enter 5 for raids, for example, and a raid with four viewers will not show at all. A follow and a first subscription have no number - the dashboard does not offer these settings there, because there would be nothing to compare.

Every event has a "Na żywo" button. It sends a real test event, so it shows not only in the preview but also in OBS. The preview on the page is local and silent.

Alerts do not overlap: when several events arrive at once they line up in a queue and are shown one after another. That is why the time on screen and the gap between alerts decide not only about a single alert, but also about how quickly the whole queue clears.

When the connection drops for a moment

The alert source in OBS keeps a constant connection to CrossMod. If it breaks - the internet disappears for a moment, the server reloads - the alerts from that gap are not lost: once back, the source asks about what it missed and plays it with a delay. This covers gaps of up to a minute and at most five alerts in a row.

After a longer break, and also after every restart of the source in OBS, old events are skipped - otherwise subscriptions and follows from hours ago would come back on screen. You will always find all the events from the whole stream in the chat history in the dashboard.

Mod Log

Mod Log is the shared history of penalties from both platforms: bans, timeouts, deleted messages, automod reactions and lifted bans. It shows who the action concerned, who carried it out and at what time.

• The "Nowe" tab shows what you have not looked at yet, and the "Oznacz jako przeczytane" button moves everything to the "Przeczytane" tab. The "Wszystko" tab shows the full history.
• The badges above the list narrow the view to one kind of penalty, to one platform, or to the last day, seven or thirty days. The number on a badge says in advance how many entries will be left after clicking, and the filters combine with each other and with the search.
• The numbers "Bany, ostatnie 24 godziny" and "Timeouty, ostatnie 24 godziny" on the main dashboard page are links. Clicking opens the Mod Log narrowed exactly to the entries that number was made of.
• The search looks for a nickname in the whole history, not only on the open page. The list goes fifty entries per page.
• For a penalty applied by the bot the reason looks like this: "Automod: phrase". Clicking the phrase itself narrows the list to all penalties that this one phrase has ever applied - you can then see at once who it caught and whether it takes too much. From that view you come back with the "Otwórz tę frazę na liście" link, which opens the Frazy automod page with that phrase already typed into the search. The other way round works through the "ile razy" number next to a phrase and the ranking in Statystyki.
• The "Pobierz historię" button saves to disk what you have on screen right now, together with the chosen tab, the searched nickname, the badges and the chosen period. You can open the resulting file in Excel or Google Sheets - handy when you have to show someone what a penalty was for, or keep a history longer than the dashboard does.
• Next to a ban and a timeout there is a "Zdejmij karę" button, which reverses it on the same platform where it landed.
• Under the nickname there is one sentence about whether that penalty still applies: "Ban nadal obowiązuje", "Wyciszenie trwa do 21:40", "Wyciszenie skończyło się o 19:05", "Kara zdjęta 20:12" or "Potem doszła kolejna kara". Without it, a mute from five hours ago looked exactly like one from a minute ago, and a ban lifted in the evening like one that is still in force. When there is nothing left to lift, the button next to it has a dashed frame - it stays in place, because a penalty lifted by hand on the Twitch or Kick site leaves no trace in the Mod Log, and that is exactly when this button is needed.
• Next to it there is "Też na Kicku" or "Też na Twitchu". The bot always punishes only where the message was written, so a punished person can enter the other chat a moment later and keep writing. This button applies exactly the same penalty on the other side: a permanent ban or a mute for the same number of minutes. Before it is sent, a question appears with exactly what it will do.
• There is one condition: the nickname has to be the same on both sides. If that person writes there under a different one, you will get a message about it and nothing will happen. The button does not appear when the second platform is not connected, or when that person is already banned there - a short note stands in its place instead.
• Above the list a frame "Kary, które nie weszły w życie" appears. The list itself shows only penalties that succeeded, so without this frame a click rejected by the platform left no trace at all - neither the one from the dashboard nor the one from the chat panel in OBS, where the message fades away after a few seconds. Every attempt carries the time, the nickname, the platform, where the click came from and a sentence about what to do. The frame disappears by itself after a day, after the bot is restarted, or once another penalty for the same person finally goes through.

The frame with failed penalties is the dashboard's memory, not an entry in the history - which is why it does not go into the history file and cannot be narrowed with the badges. Most often all the attempts from one evening bounce off the same thing, for example a platform connection that has expired; then one repair on the "Włącz bota" page is enough.

Statistics

The Mod Log answers the question "what happened", and Statystyki the question "was this month calmer". It is the same history of penalties, only counted and shown on charts. You choose the period at the top of the page: 7, 30 or 90 days.

• The numbers at the top: penalties in total and separately bans, timeouts and deleted messages, each with its percentage share. Next to them are lifted bans, which deliberately do not count towards the total. The total also shows whether it turned out better or worse than in the previous period of the same length.
• Day by day: one bar for each day of the period. Below the chart there is a sentence about the hottest day and about how many days passed without a single penalty.
• Time of day: at what hour chat gets heated. Useful when planning when it is worth having a live moderator.
• Where the penalties came from: how many the automod handled, how many came out of the CrossMod dashboard, and how many a human did directly on Twitch or Kick. Below, the same split by platform.
• The phrases that fired most often: a ranking of automod phrases, together with the date of the last hit. Clicking a phrase opens all the penalties it applied in the Mod Log. Phrases that caught nothing in that period do not make the list.
• The most frequently punished viewers: clicking a nickname opens all of their entries in the Mod Log, and the "Ukarz" button next to it takes you to Szybka moderacja with the nickname already filled in.
• Chat traffic: the card at the bottom of the page shows how many messages really landed in your chat, day by day, split between Twitch and Kick, and at what time it is loudest. Thanks to that the number of penalties has something to be compared with: twenty penalties against a thousand messages means something entirely different from twenty penalties against fifty. This one card always counts the last 7 days, also when the period chosen is 30 or 90 days, because chat content is deleted from the database after a week. It also shows up when not a single penalty was applied.

A day is counted in Warsaw time, including the switch between summer and winter time, so a penalty from two in the morning lands in the right day. When there was not a single penalty in the period, the page says so plainly instead of showing empty charts.

Quick moderation

The Szybka moderacja page serves one person and one decision, without opening Twitch or Kick. You type a nickname, without the at sign, tick the platforms and click "Timeout", "Ban na stałe" or "Zdejmij bana".

• The ticked platforms get the same command, and the result for each is shown separately, so you know right away whether something failed somewhere.
• You choose the timeout length from a list, from a minute to a day. A ban holds until you lift it.
• The "Kim jest ten widz" card fills in by itself a moment after you type the nickname, before you send anything. It shows whether that person is currently punished on either platform, whether they have written in your chat at all, what they wrote last and what penalties they have already had from you. Chat is counted from the last 7 days, because that is how long CrossMod keeps chat content, and penalties from the whole history of the account.
• The "Kto ma teraz karę" card is a list of people who currently have a ban or a mute on your Twitch channel. It is fetched straight from Twitch and not from CrossMod's record, so it also shows penalties applied outside the dashboard and ones from before the bot was connected, and mutes show the time at which they will end by themselves. Every item has a "Zdejmij karę" button, and clicking the nickname puts it into the form above.
• Below there is the history of actions sent from the dashboard. Clicking a nickname puts it back into the form. Penalties applied by the bot and ones made directly on Twitch or Kick are in the Mod Log.

There is no "Kto ma teraz karę" list for Kick and there cannot be one: Kick accepts moderation commands but does not publish a list of penalties in force. You can check the state of a single person on Kick by nickname in the "Kim jest ten widz" card - with the reservation that it comes from CrossMod's record and not from Kick.

On Kick, CrossMod recognises a viewer by the trace they left in your chat - Kick cannot search for ordinary viewers by nickname alone, it only finds channels. We keep chat content for 7 days, and a punished person usually stops writing, so with a very old penalty the dashboard may no longer have a way to point at that person. It will say so plainly, and you then lift such a penalty on your channel's page on Kick.

You also reach this page with one click from other places in the dashboard: with the "Ukarz" button next to a nickname in Statystyki. The nickname is then already filled in, so only the penalty is left to choose.

Bot settings

Ustawienia gathers what belongs to none of the other pages:

• Stan automodu. The card at the very top says in one sentence whether the automod will do anything at all right now, and shows the state of your phrase list and of the global list separately. When one of them is off or empty, the card immediately suggests what to change.
• Greeting after the broadcast starts. One sentence that the bot writes in Twitch and Kick chat when CrossMod learns that you have gone live. There are no placeholders here, the text goes exactly as you type it, at most 400 characters. The button next to it sends a test version with a TEST note, but it takes the saved text, so click "Zapisz ustawienia" first. On a real start the bot writes the greeting at most once every fifteen minutes, so that a short break in broadcasting does not flood chat.
• Auto-shoutout after a raid. When someone raids your channel, the bot recommends them in chat. The placeholders {raider} and {link} work in the text; the link is composed separately for each platform, so on Twitch it comes out as twitch.tv/nick and on Kick as kick.com/nick. The button next to it sends a test message with a TEST note - in exactly the form in which the bot will write it.
• The switch decides, not the text. With both the shoutout and the greeting the bot checks the switch itself: when it is off, the text you entered just sits in the database and nothing comes out of it. The test buttons send to chat anyway (because they check the text and the platforms' permissions), but with the switch off they add a sentence next to themselves saying that the bot will not handle a real raid or a real broadcast start that way. The same sentence shows under the text field.
• Overlay event tests. With one click you fake a follow, a subscription, a raid or bits and check how they look in the overlay, without waiting for a real viewer.
• Kick emotes from subscriptions. Kick does not publish a list of your subscriptions, so you enter the channels once, separated by commas, exactly as in the address kick.com/name. After clicking "Zapisz kanały" the emotes are fetched right away, and the field next to it says which channels they came from and for which nothing was found. The fetching is done by your browser, because Kick shows subscriber emotes only to a logged-in account: if you are not logged in to kick.com in the same browser, nothing will be found. The emotes then go into the emote picker in the chat panel in OBS. Channels that CrossMod detects by itself from your chat messages are added to the list separately and disappear when you have not used any of their emotes for a month; a channel entered by hand stays until you delete it yourself.
• Overlay addresses. A button that changes the address pasted into OBS. Useful when the address has been shown on stream or reached a stranger. The old address stops working immediately, so afterwards you have to paste the new one into every source in OBS and pair the chat panel again.

Connected accounts and logging out are no longer here. Both have moved to the Włącz bota page, so that everything from the start is in one place.

You switch between the light and dark theme in the side menu, at the bottom. The choice is remembered in the browser.

When something does not work

The bot does not react to phrases

The first answer is already on the Dashboard: the third tile says how many phrases the bot really watches for in every message - yours and CrossMod's shared ones together, but only those whose switch is on. When both switches are off or the enabled lists are empty, the tile turns orange and says so plainly, instead of showing a meaningless number.

The "Stan automodu" card in Ustawienia settles it more broadly: it says plainly whether the automod will do anything. If it says it works and the bot still stays silent on a particular message, paste that message into the "Sprawdź, co zrobi bot" field on the Frazy automod page - you will see whether it matches any phrase at all.

Apart from that, check one by one: whether the switch on your phrase list is on, whether the list has phrases longer than two characters and whether there is no red bar about an expired connection on the Dashboard. If everything is fine and the bot still stays silent, go to the Włącz bota page and click "Włącz bota" there - a channel requires a one-off start, and that button can be pressed again at any time. If that does not help either, write to Grithn.

The bot suddenly stopped seeing chat on Twitch

It happens that everything is reported correctly and yet no message from Twitch arrives: the bot does not punish, does not answer commands and the chat window in OBS shows only Kick. Twitch sends chat messages by a different route than the rest of the events, and that route can get suspended - most often when the CrossMod server was briefly unavailable.

Go to the Włącz bota page and look at the "Stan bota" card. When this is the case, the "Czytanie wiadomości z czatu" item has a cross and a sentence saying that Twitch has suspended sending. It is enough to click "Włącz bota" below - that sets this route up again. Give it a minute and check the state once more.

A command or recurring message does not go to chat

Sending every few minutes works only while the stream is live. Off stream the bot deliberately stays silent. The "Testuj" button next to a command sends it right away and says whether the message actually arrived.

If the stream is running and still nothing goes out, especially on Kick, click "Sprawdź, czy bot widzi transmisję" above the list of recurring messages. It happens that the notification about a broadcast starting on Kick did not reach CrossMod and the bot thinks you are offline - then the "Napraw to" button sets everything right with one click, without waiting for the end of the stream.

Also look at the Harmonogram line under the entry's card on the Komendy page. It says when the entry last went out and in how many minutes it goes next, and if it is waiting for a broadcast to start or goes to a platform that is not live right now, it says that plainly too.

When the bot sent an entry by itself and chat did not accept it, the card says so plainly: instead of "Ostatnio poszła" it says "Ostatnia próba", and underneath there is an orange note with the reason - for example a repeated text or AutoMod. The note disappears by itself once the next automatic send succeeds. The dashboard remembers this from the last restart, so right after a new version is deployed the cards have nothing to say yet.

The bot writes and nothing appears in chat

Twitch and Kick can accept a message from the bot and still not show it in chat. That happens when AutoMod holds it back, when chat is set to followers only or subscribers only, when slow mode or "emotes only" mode is on, and also when the bot sent exactly the same text a moment earlier - no chat accepts two identical messages in a row.

CrossMod no longer treats such a message as sent. The "Testuj" button next to a command and the test buttons in Ustawienia say plainly that the message did not appear in chat, and give the reason together with what to do about it. In the chat window in OBS the same reason shows in a bubble at the bottom of the window, and the text goes back into the field if it did not land in any of the chats.

The overlay in OBS is empty

Most often the address was not copied in full or comes from before a key change. Copy it again from the Overlay page and paste it into the source in OBS. The "Refresh cache of current page" button in the browser source settings also helps.

The line "OBS: ile źródeł" at the top of the Overlay page settles which side to look for the problem on. If it says nothing is connected while OBS is running, the address in the source is to blame. If it counts your source and the scene is still empty, check the size and visibility of the source in OBS.

The dashboard refuses to save

Usually this is an expired login. Refresh the page and log in again. If the message mentions the database, wait a moment and try again, your settings have not disappeared.

The pairing code stopped working

The code is valid for ten minutes, and the chat window in OBS shows a new one by itself when the old one expires - it does not need to be refreshed. If instead of digits you see a message about the overlay address, copy the address again from the Overlay page: after a key change the old address no longer allows pairing.

If the dashboard said "Sparowano" and the window in OBS still asks for a code, wait a few seconds - it unlocks by itself. When it says the write key is missing, open the Overlay page and generate the addresses anew.

Privacy and contact

What exactly CrossMod stores and for how long is described in the privacy policy. The rules of use are in the terms. The list of changes in the dashboard, release by release, is in the changelog.

Something missing here, or something works differently than described? Write on Twitch to @Grithn, the documentation is written as things go.

The dashboard described is version Beta v.0495.