KBonk bilibili 食用教程
前言
????KBonk 是一款由原作者 typeou (個人主頁：https://www.typeou.dev/ ) 編寫的，用于與 Twitch 互動的一款應(yīng)用軟件，該軟件能夠從 Twitch 直播間接收消息，并朝 VTS 中的 L2D 模型投擲物品，KBonk 還能夠自定義圖片、投擲類型和事件，比如通過彈幕能夠操作投擲等。
????KBonk bilibili是由本人為能夠兼容B站直播，修改后的成果，該軟件能收取并處理包括禮物、彈幕、大航海和醒目留言。
????除了刪去僅Twitch有的消息事件類型外，還添加了用戶自定義禮物的功能（十分簡陋）、禮物單價最低限制、對禮物投擲的數(shù)量限制等等。
KBonk bilibili 食用教程
一、下載和安裝
下載地址：https://github.com/LuiScreaMed/karasubonk/releases/latest
下載完成后解壓，得到如下圖所示文件夾
雙擊 karasubonk_bilibili.exe 打開 KBonk bilibili
啟動程序后如圖
二、基礎(chǔ)使用
????程序自帶了部分B站直播禮物投擲和禮物事件，更多的禮物需要用戶自行導(dǎo)入、創(chuàng)建投擲和定義事件，具體方法在下文的其他功能教程中。
????1、連接直播間
????????在程序下方的文本框中輸入房間號，并點擊連接，即可連接到B站直播間。連接成功后界面如下所示（該頁面可通過點擊程序頂部的文字顯示）：
? ? 2、添加瀏覽器源
????KBonk通過一個網(wǎng)頁源生成并投擲物體，并同時在VTS的模型中對物體砸中做出反應(yīng)。在OBS中，添加上圖中的 bonker.html 為瀏覽器源的本地文件（本地文件的位置可以點擊上圖中的跳轉(zhuǎn)按鈕顯示），并將大小調(diào)整為OBS的分辨率大?。ㄕ埓_保與OBS的視頻分辨率相等，在寬高不相等或者進行拉伸后，后期校準的步驟可能會導(dǎo)致不準）：
????3、安裝 VTS 插件
????當您成功添加 bonker.html 為本地文件瀏覽器源后，KBonk bilibili 會自動連接到該瀏覽器源，并且顯示下方內(nèi)容（該頁面可通過點擊程序頂部的文字顯示）：
????上文中提到，KBonk 需要配合瀏覽器源，使用 VTS 的模型對投擲物進行反應(yīng)，所以需要在 VTS 中添加插件。請打開 VTS ，點擊左側(cè)的設(shè)置按鈕，進入設(shè)置開啟 VTS API 功能，并確保當前的 API 端口與 KBonk 中提示的端口一致（可進入 KBonk 的設(shè)置修改端口）：
????當您成功開啟了 VTS 的 API 功能，VTS 應(yīng)彈出一個 插件訪問授權(quán)窗口 ，請點擊允許以進行下一步：
????4、校準投擲目標點
????在允許了 VTS 插件訪問后，此時的 KBonk bilibili 程序應(yīng)如下所示：
????此時為了投擲物能夠準確砸到 VTS 中的人物模型，需要對投擲坐標進行校準，校準前需要注意以下內(nèi)容：
校準前，請確保 OBS?已經(jīng)添加 VTS 源，并且瀏覽器源置于 VTS 源的上方；
請確保未將 VTS 中的模型移動鎖定。
校準時，在模型自動縮小和放大的情況下，請不要手動調(diào)整大小；
校準時，請確保 VTS 窗口的比例與 OBS 中的瀏覽器源一致（最好分辨率相同），否則可能校準不準確；
校準后，如果調(diào)整了窗口的大小 / 調(diào)整了 OBS 中的 VTS 源，都需要重新進行校準。
????點擊 KBonk bilibili 程序中的 校準，此時程序的界面應(yīng)該如下圖所示：
????點擊 開始校準 進行校準，點擊開始后，OBS 中的瀏覽器源會顯示出校準的目標和文字提示，VTS 模型會縮至最小（可能會縮小到窗口邊界外），此時請 在 VTS 中拖動模型，并查看 OBS 界面，將 VTS 源中的模型的頭部置于目標的中心處 （也可在 OBS 瀏覽器源中移動目標準心進行校準，具體做法為：右鍵瀏覽器源 -> 點擊靠近選單底部的“互動” -> 在打開的新窗口中對目標準心進行調(diào)整），為了防止 OBS 中的?VTS 源?與?顯示器捕獲源?的模型混淆，請在此步關(guān)閉?顯示器捕獲源?， 或者對其進行遮擋。
????調(diào)整完成后的目標和模型的位置關(guān)系如圖：
????當您將模型頭部置于目標正中后，點擊 KBonk bilibili 界面中的下一步，進行下一步校準：
????點擊開始后，OBS 中的瀏覽器源會顯示出校準的目標和文字提示，VTS 模型會放至最大，此時請?在 VTS 中拖動模型，并查看 OBS 界面，將 VTS 源中的模型的頭部置于目標的中心處?（也可在 OBS 瀏覽器源中移動目標準心進行校準，具體做法為：右鍵瀏覽器源 -> 點擊靠近選單底部的“互動” -> 在打開的新窗口中對目標準心進行調(diào)整），為了防止 OBS 中的?VTS 源?與?顯示器捕獲源?的模型混淆，請在此步關(guān)閉?顯示器捕獲源?， 或者對其進行遮擋。
????調(diào)整完成后的目標和模型的位置關(guān)系如圖：
????當您確保模型的頭部在目標正中后，點擊 KBonk bilibili 界面中的“完成”按鈕結(jié)束校準，結(jié)束校準后，模型會恢復(fù)到原本的大小和位置。
????進入測試頁，對校準后的投擲目標進行測試，如果有偏移，請嘗試修改 VTS 的分辨率與 瀏覽器源的分辨率相同，并重新進行校準：
????5、開始使用
????KBonk bilibili 已經(jīng)設(shè)置完成，您可以在直播中自由玩耍了！
三、其他功能用法
????1、導(dǎo)入投擲物圖片
????KBonk bilibili 支持用戶導(dǎo)入圖片作為投擲物，此片段將對導(dǎo)入流程進行演示。
????進入 KBonk bilibili 程序首頁，點擊左邊列表的 投擲物圖片 進入投擲物圖片列表頁，點擊 添加圖片 按鈕添加新的圖片：
????除了基礎(chǔ)的投擲物外，還支持替換 大航海 和 電池、瓜子 的投擲物圖片，點擊當前頁面上方的 大航海 或者 電池瓜子 標簽，進入相應(yīng)頁面，在相應(yīng)頁面的相應(yīng)圖片卡片上，點擊 加號 進行圖片的選擇和替換：
????2、投擲物圖片編輯
????投擲物可以根據(jù)用戶的需要，調(diào)整其大小比例、重量、音量，添加專屬擊中音效等，此片段將對投擲物圖片編輯的流程進行演示。
????普通投擲物的圖片支持上述的所有調(diào)整，在 投擲物圖片 界面中，點擊需要編輯的投擲物圖片卡片上的齒輪按鈕，進入編輯界面：
????進入編輯界面后如下圖所示，左下角能夠調(diào)整圖片的 大小比例、重量和音量，右下角能夠更換圖片的專屬擊中音效（當沒有專屬音效時，為隨機播放擊中音效），右上角的測試按鈕能夠?qū)Ξ斍暗恼{(diào)整進行測試：
????大航海 和 電池瓜子 的投擲物圖片僅支持圖片大小比例上的修改。要進行修改，請在 投擲物圖片 界面中，點擊上方的 大航海 或者 電池瓜子 標簽，進入相應(yīng)頁面，在相應(yīng)投擲物圖片的卡片中，修改數(shù)值對投擲物圖片的大小比例進行調(diào)整（大航海 和 電池瓜子 的音效，為可選隨機地播放擊中音效）：
????3、擊中音效的添加
????KBonk bilibili 支持自定義添加投擲物的擊中音效，并且能夠勾選隨機播放的音效、調(diào)整音量等，本片段將對添加擊中音效的流程進行演示。
????在 KBonk bilibili 程序首頁中，點擊左側(cè)的 擊中音效 進入擊中音效列表界面，點擊 添加音效 卡片添加擊中音效：
????4、擊中音效的調(diào)整
????擊中音效可對音量進行調(diào)整，也可以對未使用專屬音效的 投擲物圖片 進行隨機播放。通過 拖動音量條 ，對每個擊中音效的音量進行調(diào)整。勾選 / 取消勾選 音效卡片上的勾選框，可以將音效 加入 / 移出 隨機播放列表：
????大航海 和 電池瓜子 的音效，可以在 默認擊中音效列表 中選擇相應(yīng)的音效并加入相應(yīng)的隨機播放列表。要實現(xiàn)這個效果，請點擊 擊中音效界面 上方的 大航海 或 電池瓜子 ，在相應(yīng)頁面中勾選需要隨機播放的擊中音效：
????5、自定義投擲的添加和調(diào)整
????KBonk bilibili 允許您添加自定義投擲，并且可以將該投擲自由地綁定在特定的事件上，本片段將對自定義投擲的添加和調(diào)整的流程進行演示。
????在 KBonk bilibili 程序首頁中，點擊左側(cè)的?自定義投擲?進入自定義投擲列表界面，點擊?添加自定義投擲?卡片添加自定義投擲：
????點擊 添加自定義投擲 卡片后，程序會在列表底部生成一個新的 投擲類型，點擊新投擲類型卡片 左邊的齒輪 ，進入 自定義投擲編輯 界面，并進行編輯：
????6、自定義禮物事件
????KBonk bilibili 自定義禮物事件支持對以下內(nèi)容自定義：
對每個禮物的投擲類型和冷卻時長進行自定義
限制最低投擲所需要的單個禮物的價值
是否開啟在收到?jīng)]有綁定過的禮物時，改用瓜子或者電池投擲，并且調(diào)整瓜子和電池的投擲上限、投擲單位（多少個算一個）、和冷卻時長
對復(fù)數(shù)的禮物開啟投擲上限
????要編輯自定義禮物事件，請在 KBonk bilibili 程序首頁中，點擊左側(cè)的 事件 ，進入 事件 界面，在上方可以對 每個禮物的投擲類型 進行自定義，禮物的名稱需要與B站顯示的名稱相同，否則不能識別，點擊 禮物類型 標題旁的 加號 添加自定義禮物事件：
????要修改投擲禮物的選項，請在禮物類型的 下方 進行調(diào)整：
????7、自定義彈幕關(guān)鍵字事件
????KBonk bilibili 支持對彈幕的內(nèi)容進行識別并進行投擲，也可以對直播表情的名稱進行識別并投擲，自定義流程與上文 自定義禮物事件 流程相同，只有從 禮物名 到 關(guān)鍵字（表情名稱） 的差別：
????8、其他事件的編輯
????其他事件包括關(guān)注事件、醒目留言事件、大航海事件。
????關(guān)注事件可編輯被關(guān)注后的 投擲類型 和 冷卻時長 。醒目留言為投擲相應(yīng)價值的電池，可以對 最低投擲價值 、投擲上線 、投擲單位（多少個當做一個）、冷卻時長 進行編輯。大航海為自動投擲相應(yīng)的 艦長、提督或者總督 投擲物，可以對 冷卻時長 進行編輯：
????KBonk bilibili 食用教程到這里就結(jié)束了，如果您喜歡，請讓更多人知道這款軟件的存在！
