點歌系統讓觀眾用聊天指令點 YouTube 上的歌，進入待播佇列， 由整合播放器直接播出。你可以自訂佇列長度、每人上限與可點的範圍。
它解決什麼問題
背景音樂自己挑會膩，開放觀眾點又容易失控——重複的歌、一個人洗滿整排、 點到根本不是音樂的影片。點歌系統把「開放」和「可控」放在一起： 誰能點、能點多少、能點什麼範圍，全部有明確的閘門。
怎麼開始
- 啟用點歌模組，設定
待播佇列上限與每人同時排隊數。 - 把播放器的 OBS 網址加進實況軟體。
- 視需要建立播放清單，把可點範圍限制在清單內。
播放清單與續播
播放清單是曲庫的分類方式，同一首歌可以同時屬於多個清單，
而「全部歌曲」就是整個曲庫。設定目標播放清單之後，
點歌與收藏都會掛到那個清單；佇列播完時也會從那個範圍隨機續播。
不想續播就關掉，播完即停。
常見誤解
- YouTube 是歌曲來源，不是登入方式。 觀眾點的是 YouTube 影片，但 ChiwaBots 本身只支援 Twitch 登入， 也不管理 YouTube 直播。
- 「僅限播放清單」會停用搜尋。 開啟後只接受清單內已有的歌，不會再去 YouTube 搜尋—— 這是把曲庫收斂成你審過的範圍，代價是觀眾不能點新歌。
- 「僅限音樂類別」擋的是 YouTube 的分類，不是你的主觀判斷。 它依 YouTube 對影片的分類過濾，所以偶爾會擋掉你覺得是音樂的東西， 也可能放行你覺得不是的。
- 豁免身分是完全不受數量限制，不是上限加倍。 勾選的身分不受待播數量與每人上限管轄。
- 封鎖清單認影片 id，貼完整網址也可以。 系統會自動辨識，不用自己把 id 剪出來。
設定項目
以下內容取自後台介面的說明文字，與實際介面同步。
| 設定 | 說明 |
|---|---|
| 佇列上限 | 待播佇列最多可容納的歌曲數。 |
| 每人上限 | 每位觀眾最多可同時排隊的歌曲數。 |
| 僅限播放清單 (不搜尋 YouTube) | 開啟後只接受目標播放清單內已有的歌曲 (未設定 = 全部歌曲)，不搜尋 YouTube。 |
| 僅限音樂類別 (YouTube 類別 10) | 只接受 YouTube 音樂類別的影片。 |
| 目標播放清單 | 點歌與 !like 收藏會掛上此清單，佇列空續播也以此為範圍；未設定 = 全部歌曲。 |
| 自訂獎勵名稱 | 在 Twitch 建立頻道點數自訂獎勵，把名稱填到這裡 (需完全相同)。觀眾兌換時輸入的歌名或 YouTube 網址會自動變成點歌。留空 = 不啟用。 |
| 點歌目標 | 點歌與收藏會使用此播放清單 |
| 這個清單還沒有曲目 | 用上方輸入框搜尋歌曲加入，或貼上 YouTube 播放清單網址整批匯入。 |
| 不受點歌上限限制的觀眾 | 被勾選的身分不受待播數量與每人上限限制。 |
| 佇列空了自動播放清單 | 待播佇列播完後，從播放清單隨機續播 (範圍依「目標播放清單」，未設定 = 全部歌曲)；關閉則播完即停。 |
| 離線時自動暫停 | 關台時自動暫停播放，開台時自動繼續播放；觀眾仍可正常點歌。 |
| 贊助影片優先播放 | 開啟時，斗內贊助點歌的影片會自動插到佇列最前面；關閉則依付款完成時間排隊。 |
| 上一首 | 重新播放最近一次播放的歌曲 |
| 收藏 | 把現正播放收藏進目標播放清單 |
| 取消收藏 | 從播放清單移除這首 |
| 置頂 | 插到最前 (下一首播這首) |
聊天指令
以下為預設指令名稱，可在後台自訂或設定別名。
!song— 顯示目前歌曲的標題.!songrequest— 使用連結或搜尋結果, 將歌曲新增至點歌排隊中.!songlist— 查看點歌清單的網址.!songskip— 跳過當前歌曲!songpause— 暫停 音樂播放器 (如果已開啟且播放中)!songplay— 播放 音樂播放器 (如果已開啟且暫停中)!songvolume— 將目前音量變更為指定數字.!songlike— 輸入連結、搜尋或留白引用當前播放，新增至播放清單。!songdislike— 將當前播放之曲目從播放清單中移除。!songignore— 將指定使用者加入點歌忽略名單。
其他說明
- 同一首歌可同時屬於多個清單；「全部歌曲」即整個曲庫。
- 貼上 YouTube 播放清單網址 (youtube.com/playlist?list=…) 會整批匯入。
- 即時控制 OBS 點歌小工具。
- 以下為點歌系統的聊天室指令；實際啟用、冷卻、別稱與權限請到「指令」頁調整。
- 最近播放過的歌曲 (最多 20 首)。非永久保留——伺服器重新啟動即清空。
- 此清單每 12 秒自動更新；手動加歌與聊天室點歌都會出現在這裡。
- 以 YouTube 影片 id 或網址精確封鎖特定影片，貼上完整網址會自動辨識。
- 歌名包含以下任一關鍵字即拒絕點播，不分大小寫，自動忽略空白與標點的繞過。
- 上傳頻道名稱包含以下任一關鍵字即拒絕點播 (比對顯示名稱，非頻道 id)。
- 名單內的使用者點歌時一律靜默忽略，不會有任何回覆；已在待播佇列中的歌不受影響。
其他設定項目
這些設定在後台介面上沒有額外說明文字，此處僅列出名稱。
- 最短時長 (秒)
- 最長時長 (秒)
- 播放清單
- 播放清單
- 新增曲目
- 匯入
- 全部歌曲
- 這首歌已在曲庫中
- 清空此清單
- 清空曲庫
- 刪除清單
- 載入更多
- 在 YouTube 開啟
- 編輯所屬清單
- 所屬清單
- 已更新所屬清單
- 從此清單移除
- 從曲庫刪除
- 播放控制
- 播放
- 暫停
- 跳過
- 音量
- 套用音量
- 靜音
- 開啟聲音
- 啟用點歌模組以使用播放器。
- 點歌播放器
- 關閉播放器
- 拖曳調整大小
- 小工具外觀
- 儲存外觀
- 字型大小 (px)
- 字型
- 邊框留白 (rem)
- 行高 (rem)
- 文字特效
- Bot 語系
- 驚喜
- 波動
- 扭動
- 訊息覆蓋在影片框內
- 訊息置頂
- 隱藏訊息
- 訊息模板
- 點歌訊息
- 贊助斗內點歌訊息
- 一般顏色
- 背景
- 進度條
- 基本文字
- 使用者
- 標題
- 斗內顏色
- 斗內背景
- 基本文字
- 使用者
- 標題
- 金額
- 留言
- 新增播放清單失敗 (僅限 Pro)
- 刪除失敗 (清單非空？)
- 新增曲目失敗
- 匯入失敗
- 更新所屬清單失敗
- 小工具外觀目前無法載入。
- 點歌者
- 歌名
- 斗內金額
- 留言
- 點歌規則
- 播放行為
- 觀眾指令
- 管理指令
- 限 MOD
- 搜尋字串
- 使用者名稱
- 管理指令設定
- 待播清單
- 小費點播
- 目前沒有待播歌曲。
- 播放歷史
- 還沒有播放記錄。
- 加入點歌
- 重新整理
- 移除
- 加入失敗，請確認關鍵字或網址。
- 版面與字型
- 點歌變數
- 未知的變數
- {username} 點播：{title}
- {username} 贊助 {amount}$ 點播：{title}
- 預覽點歌
- 預覽贊助斗內
- 訊息位置
- 頂部
- 底部
- 隱藏
- 現正播放
- 目前沒有播放歌曲。
- 播放清單
- 已收藏到播放清單
- 這首已在播放清單中
- 已從播放清單移除
- 封鎖影片
- 尚無封鎖的影片
- 封鎖歌名關鍵字
- 尚無封鎖的歌名關鍵字
- 封鎖上傳者/頻道關鍵字
- 尚無封鎖的頻道關鍵字
- 忽略使用者
- 複製全部
- 已複製