丟丟砸砸讓觀眾把東西丟向你的 VTube Studio 模型。物件會飛過畫面、命中模型， 模型會被推開、播表情、甚至被砸飛出畫面。
它解決什麼問題
對 VTuber 來說，觀眾能直接碰到你的方式其實很少—— 聊天是文字，斗內是數字，都隔著一層。丟擲是少數會讓模型真的動起來的互動： 觀眾丟了什麼、打到哪裡、你被推到多遠，全部看得見，而你的反應就是內容。
怎麼開始
- 把丟擲小工具的 OBS 網址加進實況軟體。
- 在 VTube Studio 開啟 API，把連線位址填進設定（通常是同一台電腦）。
- 調整命中區大小，讓它貼合你的模型。
- 建立可丟擲的物品：圖片、音效、以及命中時的反應。
命中與反應
命中區是一個跟著模型錨點移動的橢圓，尺寸以畫面高度的比例表示—— 所以換模型或改大小之後要重新校一次。命中時可以推動模型（擊退）、 觸發 VTube Studio 熱鍵（例如換表情），也可以設定停止被砸幾秒後自動飛回原位。
常見誤解
- 小工具是直連你電腦上的 VTube Studio，不是經過我們的伺服器。 模型位置與受擊反應都在你本機處理，所以 VTS 沒開就不會有反應。
- 「砸飛」的判定是模型中心被推出畫面多遠，不是看起來離開了沒。 模型以中心定位，所以放大的模型要把這個值調大，否則它會在你還看得到的時候就停住。
- 自動飛回的秒數是從「停止被砸」開始算。 連發還在打的時候不會中途回位，不用擔心動畫被打斷。
- 切換型熱鍵需要設定恢復秒數。 那是「再觸發同一個熱鍵一次」來還原；動畫播完會自動恢復的類型填 0 就好。
- 圖片只吃 http(s) 網址，不接受 data: 網址。 GIF 可以播動畫，但跨網域需要對方允許 CORS。
- 超出方案上限的物品不會被推到小工具。 它還在清單裡，只是不會出現在畫面上——刪掉其他物品或升級方案即可恢復。
設定項目
物理、命中區、受擊反應與 VTube Studio 設定。調整會即時套用並儲存到已連線的「OBS 小工具」。
觸發即「含丟擲動作」的自動化通知規則；冷卻、權限與進階條件到自動化通知編輯。
以下內容取自後台介面的說明文字，與實際介面同步。
| 設定 | 說明 |
|---|---|
| 命中粒子特效 | 物品命中模型時噴出粒子。 |
| 連發預設間隔 (ms) | 一次丟多件時每件之間的延遲。 |
| 頭部甩動 | 命中時以參數注入讓模型甩頭。 |
| 擊退 | 命中時推動模型；行為由下方擊退模式決定。 |
| 停砸後回位秒數 | 停止被砸後經此秒數自動飛回原位——連發還在打 (含已砸飛) 就不會中途回位。 |
| 砸飛判定距離 | 模型中心要被推出畫面邊界多遠才算「砸飛」 (1 = 剛過邊、5 = 很遠)。模型以中心定位，大型/放大的模型請調大，否則會在還看得到時就停住。 |
| VTS 熱鍵 ID | 命中時觸發的 VTube Studio 熱鍵 (如表情)，選填。 |
| 熱鍵恢復秒數 | 切換型熱鍵用：觸發後經此秒數再觸發同一熱鍵一次以恢復；效果進行中不重複觸發、被砸會順延恢復。0 = 不自動恢復 (動畫播完自動恢復或循環型不需要)。 |
| 連動 VTube Studio | 「OBS 小工具」會直連實況電腦上的 VTube Studio，取得模型位置並觸發受擊反應。 |
| VTS API 位址 | 通常為 ws://127.0.0.1:8001 (VTube Studio 與 OBS 同一台電腦)。 |
| 圖片 URL | 僅支援 http(s) 網址 (不接受 data: 網址)；GIF 會播動畫 (跨網域需 CORS)。 |
| 音檔 URL | http(s) 網址，瀏覽器可解碼的音檔 (wav/mp3/ogg)。 |
| 重量 × | 越重飛得越慢、砸得越大力。 |
| 超出上限 | 此物品超出目前方案的數量上限，不會下推至「OBS 小工具」；刪除其他物品或升級方案即可恢復。 |
| 校正標記 | 在「OBS 小工具」上顯示錨點十字 (綠) 與命中區橢圓 (紅)。十字 = VTS 回報的模型中心，常偏低甚至跑出畫面；先用「位移」把十字移到角色胸口，再用命中區讓紅橢圓蓋住想被砸中的部位。 |
| 縮放跟隨 | VTS 縮放模型時，位移與命中區的跟隨強度——縮放後越漂越遠 → 調大；跟過頭 → 調小。 |
| 啟用丟丟砸砸 | 關閉時丟擲觸發與「OBS 小工具」都不會運作；切換即時生效。 |
其他說明
- 命中區為跟隨模型錨點的橢圓，尺寸為相對畫面高的比例。
- 校正 = VTS 模型座標對畫面像素的換算；調整即時套用，請開啟校正標記、對照 OBS 畫面調整 (無 VTS 時標記顯示固定錨點)。
- 校正、命中區、VTS 熱鍵與出界判定依 VTube Studio 模型分開儲存 (上限 10 組)；切到已儲存的模型自動套用，其餘沿用全域預設。
- 熱鍵與出界判定為模型專屬欄位，目前的調整將儲存於此模型。
- 觀眾丟物品砸你的 Live2D 模型，命中會有反應（需 VTube Studio）
其他設定項目
這些設定在後台介面上沒有額外說明文字，此處僅列出名稱。
- 恢復預設
- 快速套用
- 溫和
- 標準
- 狂暴
- 物理
- 丟擲
- 命中區
- 受擊反應
- 音量
- VTube Studio
- 重力 (px/s²)
- 丟擲速度 (px/s)
- 最大自旋 (度/秒)
- 物品基準尺寸 (px)
- 同時物品上限
- 反彈係數
- 出生邊
- 左
- 右
- 上
- 下
- 命中橢圓半寬
- 命中橢圓半高
- 命中區垂直位移
- 反應整體強度
- 擊退模式
- 彈回
- 累積 (可砸飛)
- 擊退強度
- 回位秒數
- 熱鍵觸發機率
- 音效音量
- VTS 授權已保存：重新載入「OBS 小工具」不會再跳授權視窗。
- 尚未授權：「OBS 小工具」第一次連線時會在 VTube Studio 跳出授權視窗。
- 圖文教學
- VTube Studio 連線操作說明
- 開啟 VTube Studio，點左上角「⚙」齒輪圖示進入設定，找到「VTube Studio Plugins」卡片，開啟「開啟 API（允許外掛程式）」（埠號預設 8001，需與下方「VTS API 位址」欄一致）。
- 確認狀態顯示綠燈「API 已啟動並正在執行中」，代表 VTube Studio 這端已就緒。
- 回到本頁開啟「連動 VTube Studio」，VTube Studio 會跳出外掛授權視窗，找到「ChiwaBots Throwing」並點「允許」完成連線。只需授權一次，之後重新啟動不會再跳出。
- 新增物品
- 尚無物品。
- 升級 Pro 可提高物品數量上限。
- 名稱
- 音效
- 尺寸 ×
- 音量 ×
- 啟用
- 圖片來源
- 內建圖案
- Twitch 表情符號
- 媒體庫 / 自訂網址
- 內建圖案
- 選擇表情符號
- 試聽
- 無
- 噴濺
- 悶響
- 敲擊
- 金屬
- 媒體庫 / 自訂音檔…
- 前往自動化通知
- 快速建立
- 尚無丟擲觸發。
- 新增丟擲觸發
- 什麼時候砸？
- 尚未新增物品，請先到「物品」分頁新增。
- 名稱
- 觸發
- 已觸發
- 啟用
- 校正教學
- 校正與命中區設定
- 開啟下方「校正標記」——OBS 小工具上會顯示綠色十字（VTS 回報的模型中心）與紅色橢圓虛線（命中區範圍）。
- 拖曳「位移 Y (px)」把綠色十字移到角色脖子或胸口附近；通常為負數，依模型多落在 -200 到 -600 之間。
- 回到「命中區」，調整「命中橢圓半高」與「命中橢圓半寬」，讓紅色橢圓虛線貼合模型外緣、蓋住想被砸中的部位。
- 測試與校正
- 測試丟擲
- 測試丟擲 ×100
- 位移 X (px)
- 位移 Y (px)
- 立即回位
- 模型設定檔
- 目前模型
- 未偵測到模型 (「OBS 小工具」或 VTube Studio 未連線)
- 已有專屬設定
- 使用全域預設 (調整後自動建立)
- 已儲存的模型
- 模型專屬欄位——目前的調整將儲存於此模型
- 番茄
- 鮪魚罐頭
- 拖鞋
- 棒球
- 紙團