指令

自訂指令是觀眾與機器人互動的入口。這裡集中管理所有指令的啟用、冷卻、別名與權限， 不論那個指令屬於哪個模組。

它解決什麼問題

「社群連結在哪」「這是什麼遊戲」「你的配備是什麼」，同樣的問題每場都會被問幾次。 指令讓答案只要寫一次；更重要的是，各模組的指令 (點數、簽到、點歌、排隊…) 全部在同一頁調整，你不必為了改一個冷卻而在五個模組之間跳來跳去。

怎麼開始

1. 在指令頁找到要用的指令，把它啟用。
2. 設定冷卻與觀眾的權限。
3. 需要的話加上別稱，讓同一個功能有第二個名字。

常見誤解

• 指令預設是關閉的。 啟用某個模組不等於它的指令自動可用，這是刻意的， 免得你開了模組就突然多出一批你沒預期的指令。
• 別稱要自己加 ! 前綴，也不能有空格。 系統不會幫你補前綴；「hi」和「!hi」是兩個不同的觸發字。
• 冷卻滑桿只到 300 秒，不代表上限是 300 秒。 要更長就在右邊的輸入框直接填，最長 24 小時。
• 透過忠誠獎勵綁定觸發的指令，不受權限與冷卻管轄。 綁定本身就是授權，所以指令關閉時那條路徑照樣生效。 要限制頻率請在 Twitch 該獎勵上設冷卻或每人上限。
• 全體冷卻與個人冷卻是兩道獨立的閘。 全體是整個頻道共用一個計時器，個人是每位觀眾各自計算；兩道都要過。

設定項目

以下內容取自後台介面的說明文字，與實際介面同步。

聊天指令

以下為預設指令名稱，可在後台自訂或設定別名。

• !commands — 顯示已啟用指令和 ChiwaBots 的自訂指令的網址。
• !followtime — 顯示觀眾追隨頻道多久了。
• !title — 顯示當前直播的標題，並允許管理員編輯標題。
• !game — 顯示當前直播的遊戲分類，並允許管理員編輯遊戲分類。
• !watchinfo — 查詢當月的 累計觀看時數、觀看直播場數.
• !pickuser — 從過去 10 分鐘內有傳訊息的觀眾中選一個出來. 在指令後面加上數字即可設定分鐘數, 預設10分鐘.
• !cmd — 在聊天室新增、編輯或刪除簡易文字指令 (僅限 MOD 與主播). 用法: !cmd add <指令> <回應>、!cmd edit <指令> <回應>、!cmd del <指令>.
• !points — 查看觀眾擁有多少點數和目前排名.
• !addpoints — 增加觀眾的點數. 使用 'all' 對聊天室所有人增加
• !setpoints — 將觀眾的點數設為指定數量. 強制覆蓋原本的點數 (不是增減)
• !givepoints — 將點數轉移給另外一位觀眾.
• !toppoints — 顯示點數前三名和排行榜網址.
• !gamble — 賭上你的點數.
• !slots — 觀眾在拉霸機賭上自己的點數.
• !checkin — 簽到指令. 依設定同時計算每日簽到 (UTC 0 點換日, 即台灣時間早上 8 點) 與每場簽到 (限開台中, 每場一次).
• !infocheckin — 查詢自己的簽到資料; 每場簽到啟用時一併顯示連續與累計場數.
• !topcheckin — 簽到排名, 顯示每日連續天數前三名; 每場簽到啟用且開台中時一併顯示本場連續場數前三名.
• !recheckin — 用小奇點補回指定天數內漏掉的每日簽到, 回復連續天數.
• !recheckinlive — 用小奇點補回漏掉的場次, 還原連續簽到場數.
• !qjoin — 加入排隊，使用 !qjoin <暱稱> 可在排隊清單附註暱稱
• !qleave — 使用此指令離開排隊
• !qlist — 顯示排隊清單網址
• !qinfo — 查詢排隊相關資訊
• !qstart — 開始允許加入排隊
• !qstop — 停止新加入要求
• !qnext — 呼叫新一輪排隊
• !qclear — 清空排隊紀錄資料
• !song — 顯示目前歌曲的標題.
• !songrequest — 點一首歌加入待播清單 (預設別稱 !sr)。
• !songlist — 查看點歌清單的網址.
• !songskip — 跳過當前歌曲
• !songpause — 暫停 音樂播放器 (如果已開啟且播放中)
• !songplay — 播放 音樂播放器 (如果已開啟且暫停中)
• !songvolume — 將目前音量變更為指定數字.
• !songlike — 輸入連結、搜尋或留白引用當前播放，新增至播放清單。
• !songdislike — 將當前播放之曲目從播放清單中移除。
• !songignore — 將指定使用者加入點歌忽略名單。
• !coverrequest — 從實況主的翻唱歌單點一首歌，排進演唱順序 (預設別稱 !cr)。
• !cover — 查目前正在翻唱哪一首 (只回報，不會點歌)。
• !coverlist — 列出目前可以點的翻唱曲目。
• !time — 查詢倒數計時器剩餘時間
• !addtime — 手動新增需要的時間(負數則減少時間)
• !settime — 設定時間並開始
• !pausetime — 暫停計時器
• !starttime — 繼續/開始計時器
• !trans — 使用指令翻譯訊息.
• !trans-auto — 開啟或關閉自動翻譯.
• !trans-ignore — 忽略指定使用者自動翻譯、使用翻譯指令.
• !shop — 列出可兌換獎勵。
• !redeem — 用頻道點數兌換獎勵 (!redeem 名稱)。
• !bet — 對進行中的預測下注頻道點數 (!bet 編號 點數|all|N%)。
• !lockbet — 鎖定停止下注 (MOD)。
• !endbet — 結算並發放點數 (!endbet 編號，MOD)。

其他說明

• 滑桿最高 300 秒；更長請用右側輸入框填 (最長 86400 秒 / 24 小時)。
• 觸發指令的另一個名稱，不能使用空格。若需 ! 前綴，請在別稱中自行加入。
• 設定誰、在什麼情況下可以使用這個指令。
• 限制指令被觸發的頻率，避免洗頻。
• 為指令設定額外的觸發名稱。

其他設定項目

這些設定在後台介面上沒有額外說明文字，此處僅列出名稱。

• 啟用全部
• 停用全部
• 停用整個分類
• 機器人語言
• 個人冷卻 (秒)
• 權限
• 僅開台
• 別名 (逗號分隔)
• MOD 與實況主不受此限制。
• 所有人
• VIP
• 訂閱 T1
• 訂閱 T2
• 訂閱 T3
• MOD
• 實況主
• 翻唱
• 通用
• 點數
• 遊戲
• 紅利
• 簽到
• 排隊
• 點歌
• 馬拉松
• 翻譯
• 兌換
• 預測
• 計數
• 推幣機
• 其他
• 全部
• MOD 以上
• 指令列表
• 搜尋指令
• 找不到符合的指令。
• 編輯指令
• 全體冷卻時間
• 個人冷卻時間
• 無冷卻時間。
• 觀眾的權限
• 僅在直播時才能使用
• 僅直播
• 全體
• 個人
• 限 MOD/實況主
• 新增
• 別稱重複了。
• 別稱不能包含空格。
• 需啟用功能
• 自訂
• 使用條件
• 冷卻時間
• 別稱