{"counters-and-quotes":{"sections":{"counters":{"title":"Create a counter","paragraphs":["Open Chat Bot → Counters & quotes to add a named counter and a response template. Choose the rank allowed to edit it and check the command examples shown by the editor.","Use a counter for wins, attempts or other moments you track during a stream. Test reading and updating the value separately so viewers cannot change a moderator-only counter."]},"quotes":{"title":"Save and review quotes","paragraphs":["The quotes controls let you manage saved channel quotes. Check the quote text before sharing your public quotes page, and remove private information or material that should not remain public."]}}},"commands":{"sections":{"create":{"title":"Create your first command","steps":["Open Chat Bot in the dashboard and choose the Commands tab. Custom commands are yours; Default commands are the built-in ones every channel gets.","Press Add command and type the name viewers will use, without the prefix. Names can be up to 32 characters with no spaces.","Write the message the bot should send. A live preview below the field shows how variables will look.","Choose who can use it, a cooldown and, if you like, a price in points. Save, then type the command in your chat to try it."],"paragraphs":["Every command you create answers on the platform it was typed on, so one command works on Kick, Twitch and YouTube at the same time. Commands typed in TikTok chat are answered on your other connected platforms, because bots cannot post in TikTok chat."]},"examples":{"title":"Examples to copy","paragraphs":["A few commands most channels add on day one. Paste the text after the arrow into the message field."]},"fields":{"title":"Every option in the editor","table":{"headings":["Option","What it does"],"rows":[["Command","The name after the prefix. Names and aliases must be unique across all commands, including the default ones."],["Alias","Up to 10 other names for the same command, separated by commas."],["Message","The reply, up to 500 characters on the free plan and 2000 on Premium."],["Rank","Who can use it: Anyone, Subscriber, VIP, Moderator or Owner. Higher ranks pass lower gates, so a moderator can use a Subscriber command."],["Cooldown","From none to 10 minutes. Global means once per cooldown for the whole chat; Per user means each viewer waits on their own. Moderators and the owner skip cooldowns."],["Access","Anytime, Online only or Offline only. Online means live on any connected platform."],["Price","Points the command costs. It only charges when the points system is on."],["Activation","Command (typed with the prefix) or Chat keyword (Premium): the bot replies whenever the word appears anywhere in a message."]]}},"variables":{"title":"Variables","paragraphs":["Variables are written as $(name) and are filled in when the command runs: $(user) is the viewer who typed it, $(touser) the first word after the command, $(args) everything after it, and $(uptime), $(title) and $(game) describe your stream. A variable that can’t be resolved stays as plain text, which makes typos easy to spot.","Some variables take a value: $(random 1-100) picks a number, $(random red,blue,green) picks from a list, $(time Europe/London) shows the time in a time zone and $(countdown 2026-12-31T20:00) counts down to a date. The full list with examples is in the commands and variables reference."]},"random":{"title":"Random replies and keyword commands","paragraphs":["On Premium, write several messages on separate lines and the bot picks one at random each time. On the free plan only the first line is sent.","A keyword command (Premium, up to 10) answers whenever its word appears anywhere in a chat message, without the prefix. Matching is case-insensitive and whole-word, and rank, access, cooldown and price still apply. Use them for questions viewers keep asking, like “discord” or “specs”."]},"defaults":{"title":"Default commands","paragraphs":["Every channel gets a set of default commands such as !commands, !uptime, !followage, !so, !title, !game, !addcom and the commands for points, games and song requests. You can rename them, add aliases, change who can use them and edit their replies, but you can’t delete them; switch one off instead. A warning icon next to a default command means the feature it needs, for example the points system, is turned off.","Moderators can manage simple commands from chat: !addcom !name message creates one, !editcom changes its message and !delcom removes it."]},"limits":{"title":"Plan limits","table":{"headings":["","Free","Premium"],"rows":[["Custom commands","100","Unlimited"],["Keyword commands","Not available","10"],["Random replies","First line only","Yes"],["Message length","500 characters","2000 characters"],["$(urlfetch)","Not available","Yes"]]},"paragraphs":["If you move back to the free plan, your newest commands above the limit are marked “Paused by plan” and come back when you upgrade again."]},"troubleshooting":{"title":"When a command doesn’t answer","bullets":["The command is switched off or marked “Paused by plan”.","The Chat Bot is off, or the bot is paused for that platform on the Platforms page.","The viewer’s rank is too low, or Access doesn’t match whether you are live.","It is on cooldown. Commands on cooldown stay silent instead of posting a wait message.","It has a price and the viewer can’t afford it.","A moderation filter removed the message first, for example because it contained a link.","There is a space after the prefix: “! hello” is not a command."]},"faq":{"title":"Questions","faq":[{"q":"Can I import commands from another bot?","a":"Yes. Chat Bot → Extras → Import from other bots reads your public command lists from Nightbot, StreamElements, Fossabot and other bots, or a file you paste, and shows every command before anything is saved."},{"q":"Where can viewers see all my commands?","a":"On your public command list, linked from the Public list button and from the !commands reply. It shows every enabled command with its reply and who can use it."},{"q":"Can I change the ! prefix?","a":"Yes, in Settings → Command prefix. It applies to every command on your channel."}]}}},"timers":{"sections":{"setup":{"title":"Create a timer","steps":["Open Chat Bot → Timers and press Add timer.","Write the message, up to 500 characters. Variables like $(uptime) and $(game) work here.","Pick an interval: the minimum time between two posts of this timer, from 5 to 60 minutes.","Pick how many chat lines must arrive since its last post, so the bot doesn’t talk to an empty chat.","Choose Online only (the default), Offline only or Anytime, and save."]},"rule":{"title":"Exactly when a timer posts","paragraphs":["A timer posts when both conditions are met: its interval has passed since it last posted, and at least the chosen number of chat lines have arrived since then. Chat lines count every viewer message on every connected platform, including commands; messages removed by a moderation filter don’t count.","To keep chat readable, at most one timer message is posted per minute per channel. When several timers are due, they take turns."]},"platforms":{"title":"Where timers post","paragraphs":["Timers post on every connected platform where the bot can chat. If two or more such platforms are connected, a checkbox per platform lets you pick where each timer goes. Kick and Twitch accept timers whenever the bot is on; YouTube only while you are live; TikTok never, because it is read-only for bots."]},"examples":{"title":"Messages that work well","paragraphs":["Short, useful lines with one clear call to action perform best. Rotate a few instead of repeating one."]},"limits":{"title":"Limits and tips","bullets":["Free channels can have 20 timers, Premium channels 100.","Timers only run while the Chat Bot is on.","In timers $(user) is your own name, and $(count) has no value.","After a server restart the chat line counters start from zero, so timers wait for fresh chat before posting again.","There is no fixed clock schedule; timers run on intervals and chat activity."]},"faq":{"title":"Questions","faq":[{"q":"Why didn’t my timer post?","a":"Check that the interval has passed, that enough chat lines arrived, that Access matches whether you are live, and that the Chat Bot is on. If another timer posted in the last minute, yours takes its turn next."},{"q":"Can a timer post only on Kick?","a":"Yes, when more than one platform is connected, untick the platforms it shouldn’t use."}]}}},"moderation":{"sections":{"filters":{"title":"The seven filters","paragraphs":["Open Chat Bot → Moderation. Every filter starts switched off; turn on the ones you need and press Configure to tune them."],"table":{"headings":["Filter","What it catches"],"rows":[["Caps protection","Messages written mostly in capitals. Default: 70% capitals, messages of 15 characters or more. Letters without capitals, like Hebrew, don’t count."],["Link protection","Links, including disguised ones like “site dot com” or site[.]com. Allowed domains (kick.com by default) pass."],["Emote protection","More than 10 emotes in one message. Works on Kick and Twitch."],["Symbol protection","Messages full of symbols, or the same character repeated more than 10 times."],["Bad words protection","Words and phrases on your blocklist, with wildcards and leetspeak detection."],["Raid protection","Waves of the same message from many first-time chatters, like a bot or hate raid."],["Shared ban list","Accounts that several other InstiBot channels banned or caught in a raid wave."]]}},"actions":{"title":"Actions and exceptions","paragraphs":["Each filter has the same action settings. The offending message is always deleted; choose Timeout or Ban to add a penalty. Timeouts run from 1 minute to 7 days.","Escalate repeat offences turns the filter into three steps: the first offence deletes the message, a second within 10 minutes times the viewer out, and a third gives a ten times longer timeout. Offences are counted across all filters.","Exempt ranks skip the filter: moderators are exempt by default, and you can add subscribers and VIPs. The channel owner and the bot are never moderated. Optional warnings tell the viewer why their message went, at most once every 15 seconds."]},"links":{"title":"Links and !permit","paragraphs":["Link protection blocks web addresses unless the domain is on your allowed list; subdomains of an allowed domain pass too. A moderator can let one viewer post a single link with !permit, valid for 60 seconds by default. You can also let subscribers and VIPs post links freely."]},"badwords":{"title":"Bad words, wildcards and regex","paragraphs":["Add words or phrases to the blocklist, up to 2000 entries. “Match whole words only” avoids catching words inside longer ones, and “Catch leetspeak” also matches spellings like 4 for a or 3 for e. A * inside an entry acts as a wildcard.","Premium channels can add regular expressions written as /pattern/. On the free plan regex entries are kept but ignored."]},"raids":{"title":"Raid protection and the shared ban list","paragraphs":["Raid protection looks for the same message from 5 or more chatters within 30 seconds, by default only counting first-time chatters. It acts on every message in the wave, including the earlier ones, with a 10 minute timeout by default. You can limit it to the minutes right after a raid.","The shared ban list bans accounts that at least three other InstiBot channels banned permanently or caught in a raid wave. Only the number of channels is shared, never which ones, and flags expire after 60 days."]},"console":{"title":"The live mod console","paragraphs":["The mod console lives on the Stream control page. It shows chat as it arrives, with each viewer’s rank, a “New” tag for first messages and a warning if other channels flagged them. Hover a message to delete it, time the viewer out for 1, 10 or 60 minutes, or ban them; click a name for the viewer’s history.","The side panel holds the moderation log, a moderators overview for the last 30 days and ban appeals, which viewers send from your public appeal page."]},"platforms":{"title":"Platforms","paragraphs":["Filters read chat on every connected platform. Deleting, timeouts and bans work on Kick, Twitch and YouTube. TikTok doesn’t allow bots to moderate, so a TikTok message that breaks a rule is only kept away from commands and points. Actions run with your own channel’s permission, so on Kick they appear as taken by you."]},"faq":{"title":"Questions","faq":[{"q":"Does InstiBot need to be a moderator?","a":"Filters work with your channel’s permission, so moderation doesn’t depend on it. Making the bot a moderator with /mod InstiBot is still recommended so it can chat freely."},{"q":"Is moderation free?","a":"Yes. All seven filters, the mod console, ban appeals and the shared ban list are on the free plan. Only regex entries in the bad words list need Premium."},{"q":"Can my moderators change the filters?","a":"Team members with the Moderator role can use the mod console but not edit filters. Give someone the Editor role, or the “Edit moderation filters” permission, to let them change settings."}]}}},"custom-bot-name":{"sections":{"setup":{"title":"Choose a bot identity","paragraphs":["The Name tab in Chat Bot provides the supported Kick custom-identity setup. Follow the account or application connection instructions shown there, and check plan availability first.","A custom display identity does not remove the need for channel permissions. The account that performs moderation must have the required access."]},"test":{"title":"Test before going live","steps":["Finish the connection in the Name tab.","Grant the selected account the required channel permissions.","Run a simple command and verify which account replies.","Test moderation separately, and return to the default identity if the connection is incomplete."]}}},"kick-clips":{"sections":{"command":{"title":"Save a moment from Kick chat","paragraphs":["The clip command attempts to capture the preceding moment on Kick. InstiBot also saves a stream-time marker in Chat Bot → Extras → Clip markers. If Kick cannot create the clip, the marker helps you find the moment in the recording instead.","A marker is not a downloadable video. Check whether the result includes a playable clip link before assuming a video was created."]},"automatic":{"title":"Chat-activity auto clips","paragraphs":["The existing auto-clips setting watches for bursts of chat activity and triggers the same clip-or-marker behavior. Configure sensitivity and cooldown, then review the saved moments after a stream.","Chat activity is a signal, not a guarantee of an interesting moment. Quiet highlights may be missed and busy conversations may trigger a marker."]},"availability":{"title":"Current scope","paragraphs":["This guide describes the Kick clip command and chat-activity markers. It does not promise automatic editing, captions, vertical exports or social publishing. Check the dashboard for the features currently available to your account."]}}},"commands-reference":{"sections":{"syntax":{"title":"How to read this page","paragraphs":["Commands are shown with the default ! prefix; if you changed the prefix in Settings, use yours. Words in angle brackets are values you replace, words in square brackets are optional. Every default command can be renamed, given aliases or limited to a rank under Chat Bot → Commands → Default commands.","Variables are written $(name) inside a command or timer message. Names are not case-sensitive. A variable that can’t be resolved is left as plain text."]},"chat":{"title":"Chat and stream commands","table":{"headings":["Command","Who","What it does"],"rows":[["!commands","Anyone","Posts the link to your public command list."],["!uptime","Anyone","How long the stream has been live."],["!followage [@viewer]","Anyone","How long a viewer has followed, counted from follows InstiBot has seen."],["!title [new title]","Moderator","Shows the title, or changes it on Kick (and Twitch if connected)."],["!game [category]","Moderator","Shows the category, or changes it to the best match. Alias !category."],["!so @viewer","Moderator","Shoutout with a link and the Shoutout overlay. Aliases !shoutout, !promo."],["!addcom !name message","Moderator","Creates a custom command."],["!editcom !name message","Moderator","Changes a custom command’s message."],["!delcom !name","Moderator","Deletes a custom command."],["!permit @viewer","Moderator","Lets a viewer post one link while link protection is on."],["!quote [add text | number | word]","Anyone (add and delete: Moderator)","Shows, searches, adds or deletes community quotes."],["!schedule","Anyone","Your next planned stream. Alias !nextstream."],["!clip [title]","Anyone","Kick only: clips the last 30 seconds, or saves a marker you can cut later."],["!appeal","Anyone","Posts the unban request link when appeals are on."],["!level / !xp [@viewer]","Anyone","Level and XP, when the level system is on."],["!birthday DD/MM","Anyone","Saves a birthday for birthday greetings."],["!tts message","Anyone (off by default)","Reads a message aloud on the TTS widget, for a price in points."]]}},"points":{"title":"Points and interaction commands","table":{"headings":["Command","Who","What it does"],"rows":[["!points [@viewer]","Anyone","Shows a viewer’s points."],["!give @viewer amount","Anyone","Gives some of your points to another viewer."],["!top","Anyone","Posts the link to your points leaderboard."],["!watchtime","Anyone","Time active in chat."],["!shop","Anyone","Posts the link to your points shop."],["!redeem item name","Anyone","Redeems a shop item from chat."],["!addpoints @viewer amount","Owner","Adds points; a negative amount removes them."],["!sr song","Anyone","Requests a song (YouTube). Also !song, !wrongsong, !skip."],["!join / !leave / !queue","Anyone","The viewer queue. Moderators use !next and !pick."],["!bet option amount","Anyone","Bets on a community prediction."],["!giveaway start prize [5m]","Moderator","Starts a giveaway from chat. Viewers enter with !enter by default."],["!poll Question | Option 1 | Option 2 60s","Moderator","Opens a poll. Viewers vote with !vote and a number."]]},"paragraphs":["Every mini-game also has its own commands, such as !roulette, !slots, !heist and !crash. Each game’s guide lists them with examples."]},"variables":{"title":"Variables","table":{"headings":["Variable","Returns","Example"],"rows":[["$(user)","The viewer who used the command","Hi $(user)!"],["$(touser)","The first word after the command without @, otherwise the viewer","$(user) hugs $(touser)"],["$(args)","Everything written after the command","You said: $(args)"],["$(1), $(2) …","The first, second … word after the command","Rating $(1) out of 10"],["$(channel)","Your channel name","Welcome to $(channel)"],["$(random 1-100)","A random number in the range","You rolled $(random 1-6)"],["$(random a,b,c)","A random pick from the list","Tonight: $(random apex,valorant,chess)"],["$(randomchatter)","A random viewer who chatted in the last 10 minutes","$(randomchatter) gets the next shoutout"],["$(count)","How many times this command has been used","Used $(count) times"],["$(uptime)","How long the stream has been live, or offline","Live for $(uptime)"],["$(title), $(game)","The current title and category","Now playing $(game)"],["$(followage)","How long the viewer has followed","Following for $(followage)"],["$(points), $(pointsname)","The viewer’s points and your currency name","$(points) $(pointsname)"],["$(watchtime), $(level), $(xp), $(rank)","The viewer’s time in chat, level, XP and leaderboard place","Rank #$(rank)"],["$(time Europe/London)","The current time in a time zone","It is $(time America/New_York) in New York"],["$(countdown 2026-12-31T20:00)","Time left until a date and time","Event starts in $(countdown 2026-12-31T20:00)"],["$(math 2*3)","A calculation with + - * / % ^ and brackets","$(math 1500/3) each"],["$(counter deaths)","The value of a chat counter","Deaths: $(counter deaths)"],["$(nextstream)","Your next planned stream","Next stream: $(nextstream)"],["$(urlfetch https://…)","Text returned by a web address (Premium)","$(urlfetch https://example.com/status)"]]}},"notes":{"title":"Good to know","bullets":["Viewer variables such as $(points) and $(rank) read the viewer on the platform the command came from. Viewers on Kick and Twitch are counted separately.","In timers, $(user) is your own name and $(count) has no value, so leave it out of timer messages.","$(followage) only knows follows InstiBot has seen, because Kick offers no list of older followers.","Messages longer than a platform allows are shortened on Kick and split into up to three messages on YouTube."]}}}}