KBonk bilibili 食用教程
前言
KBonk 是一款由原作者 typeou (个人主页：https://www.typeou.dev/ ) 编写的，用于与 Twitch 互动的一款应用软件，该软件能够从 Twitch 直播间接收消息，并朝 VTS 中的 L2D 模型投掷物品，KBonk 还能够自定义图片、投掷类型和事件，比如通过弹幕能够操作投掷等。
KBonk bilibili是由本人为能够兼容B站直播，修改后的成果，该软件能收取并处理包括礼物、弹幕、大航海和醒目留言。
除了删去仅Twitch有的消息事件类型外，还添加了用户自定义礼物的功能（十分简陋）、礼物单价最低限制、对礼物投掷的数量限制等等。
KBonk bilibili 食用教程
一、下载和安装
下载地址：https://github.com/LuiScreaMed/karasubonk/releases/latest
下载完成后解压，得到如下图所示文件夹
双击 karasubonk_bilibili.exe 打开 KBonk bilibili
启动程序后如图
二、基础使用
程序自带了部分B站直播礼物投掷和礼物事件，更多的礼物需要用户自行导入、创建投掷和定义事件，具体方法在下文的其他功能教程中。
1、连接直播间
在程序下方的文本框中输入房间号，并点击连接，即可连接到B站直播间。连接成功后界面如下所示（该页面可通过点击程序顶部的文字显示）：
2、添加浏览器源
KBonk通过一个网页源生成并投掷物体，并同时在VTS的模型中对物体砸中做出反应。在OBS中，添加上图中的 bonker.html 为浏览器源的本地文件（本地文件的位置可以点击上图中的跳转按钮显示），并将大小调整为OBS的分辨率大小（请确保与OBS的视频分辨率相等，在宽高不相等或者进行拉伸后，后期校准的步骤可能会导致不准）：
3、安装 VTS 插件
当您成功添加 bonker.html 为本地文件浏览器源后，KBonk bilibili 会自动连接到该浏览器源，并且显示下方内容（该页面可通过点击程序顶部的文字显示）：
上文中提到，KBonk 需要配合浏览器源，使用 VTS 的模型对投掷物进行反应，所以需要在 VTS 中添加插件。请打开 VTS ，点击左侧的设置按钮，进入设置开启 VTS API 功能，并确保当前的 API 端口与 KBonk 中提示的端口一致（可进入 KBonk 的设置修改端口）：
当您成功开启了 VTS 的 API 功能，VTS 应弹出一个 插件访问授权窗口 ，请点击允许以进行下一步：
4、校准投掷目标点
在允许了 VTS 插件访问后，此时的 KBonk bilibili 程序应如下所示：
此时为了投掷物能够准确砸到 VTS 中的人物模型，需要对投掷坐标进行校准，校准前需要注意以下内容：
校准前，请确保 OBS 已经添加 VTS 源，并且浏览器源置于 VTS 源的上方；
请确保未将 VTS 中的模型移动锁定。
校准时，在模型自动缩小和放大的情况下，请不要手动调整大小；
校准时，请确保 VTS 窗口的比例与 OBS 中的浏览器源一致（最好分辨率相同），否则可能校准不准确；
校准后，如果调整了窗口的大小 / 调整了 OBS 中的 VTS 源，都需要重新进行校准。
点击 KBonk bilibili 程序中的 校准，此时程序的界面应该如下图所示：
点击 开始校准 进行校准，点击开始后，OBS 中的浏览器源会显示出校准的目标和文字提示，VTS 模型会缩至最小（可能会缩小到窗口边界外），此时请 在 VTS 中拖动模型，并查看 OBS 界面，将 VTS 源中的模型的头部置于目标的中心处 （也可在 OBS 浏览器源中移动目标准心进行校准，具体做法为：右键浏览器源 -> 点击靠近选单底部的“互动” -> 在打开的新窗口中对目标准心进行调整），为了防止 OBS 中的 VTS 源 与 显示器捕获源 的模型混淆，请在此步关闭 显示器捕获源 ， 或者对其进行遮挡。
调整完成后的目标和模型的位置关系如图：
当您将模型头部置于目标正中后，点击 KBonk bilibili 界面中的下一步，进行下一步校准：
点击开始后，OBS 中的浏览器源会显示出校准的目标和文字提示，VTS 模型会放至最大，此时请 在 VTS 中拖动模型，并查看 OBS 界面，将 VTS 源中的模型的头部置于目标的中心处 （也可在 OBS 浏览器源中移动目标准心进行校准，具体做法为：右键浏览器源 -> 点击靠近选单底部的“互动” -> 在打开的新窗口中对目标准心进行调整），为了防止 OBS 中的 VTS 源 与 显示器捕获源 的模型混淆，请在此步关闭 显示器捕获源 ， 或者对其进行遮挡。
调整完成后的目标和模型的位置关系如图：
当您确保模型的头部在目标正中后，点击 KBonk bilibili 界面中的“完成”按钮结束校准，结束校准后，模型会恢复到原本的大小和位置。
进入测试页，对校准后的投掷目标进行测试，如果有偏移，请尝试修改 VTS 的分辨率与 浏览器源的分辨率相同，并重新进行校准：
5、开始使用
KBonk bilibili 已经设置完成，您可以在直播中自由玩耍了！
三、其他功能用法
1、导入投掷物图片
KBonk bilibili 支持用户导入图片作为投掷物，此片段将对导入流程进行演示。
进入 KBonk bilibili 程序首页，点击左边列表的 投掷物图片 进入投掷物图片列表页，点击 添加图片 按钮添加新的图片：
除了基础的投掷物外，还支持替换 大航海 和 电池、瓜子 的投掷物图片，点击当前页面上方的 大航海 或者 电池瓜子 标签，进入相应页面，在相应页面的相应图片卡片上，点击 加号 进行图片的选择和替换：
2、投掷物图片编辑
投掷物可以根据用户的需要，调整其大小比例、重量、音量，添加专属击中音效等，此片段将对投掷物图片编辑的流程进行演示。
普通投掷物的图片支持上述的所有调整，在 投掷物图片 界面中，点击需要编辑的投掷物图片卡片上的齿轮按钮，进入编辑界面：
进入编辑界面后如下图所示，左下角能够调整图片的 大小比例、重量和音量，右下角能够更换图片的专属击中音效（当没有专属音效时，为随机播放击中音效），右上角的测试按钮能够对当前的调整进行测试：
大航海 和 电池瓜子 的投掷物图片仅支持图片大小比例上的修改。要进行修改，请在 投掷物图片 界面中，点击上方的 大航海 或者 电池瓜子 标签，进入相应页面，在相应投掷物图片的卡片中，修改数值对投掷物图片的大小比例进行调整（大航海 和 电池瓜子 的音效，为可选随机地播放击中音效）：
3、击中音效的添加
KBonk bilibili 支持自定义添加投掷物的击中音效，并且能够勾选随机播放的音效、调整音量等，本片段将对添加击中音效的流程进行演示。
在 KBonk bilibili 程序首页中，点击左侧的 击中音效 进入击中音效列表界面，点击 添加音效 卡片添加击中音效：
4、击中音效的调整
击中音效可对音量进行调整，也可以对未使用专属音效的 投掷物图片 进行随机播放。通过 拖动音量条 ，对每个击中音效的音量进行调整。勾选 / 取消勾选 音效卡片上的勾选框，可以将音效 加入 / 移出 随机播放列表：
大航海 和 电池瓜子 的音效，可以在 默认击中音效列表 中选择相应的音效并加入相应的随机播放列表。要实现这个效果，请点击 击中音效界面 上方的 大航海 或 电池瓜子 ，在相应页面中勾选需要随机播放的击中音效：
5、自定义投掷的添加和调整
KBonk bilibili 允许您添加自定义投掷，并且可以将该投掷自由地绑定在特定的事件上，本片段将对自定义投掷的添加和调整的流程进行演示。
在 KBonk bilibili 程序首页中，点击左侧的 自定义投掷 进入自定义投掷列表界面，点击 添加自定义投掷 卡片添加自定义投掷：
点击 添加自定义投掷 卡片后，程序会在列表底部生成一个新的 投掷类型，点击新投掷类型卡片 左边的齿轮 ，进入 自定义投掷编辑 界面，并进行编辑：
6、自定义礼物事件
KBonk bilibili 自定义礼物事件支持对以下内容自定义：
对每个礼物的投掷类型和冷却时长进行自定义
限制最低投掷所需要的单个礼物的价值
是否开启在收到没有绑定过的礼物时，改用瓜子或者电池投掷，并且调整瓜子和电池的投掷上限、投掷单位（多少个算一个）、和冷却时长
对复数的礼物开启投掷上限
要编辑自定义礼物事件，请在 KBonk bilibili 程序首页中，点击左侧的 事件 ，进入 事件 界面，在上方可以对 每个礼物的投掷类型 进行自定义，礼物的名称需要与B站显示的名称相同，否则不能识别，点击 礼物类型 标题旁的 加号 添加自定义礼物事件：
要修改投掷礼物的选项，请在礼物类型的 下方 进行调整：
7、自定义弹幕关键字事件
KBonk bilibili 支持对弹幕的内容进行识别并进行投掷，也可以对直播表情的名称进行识别并投掷，自定义流程与上文 自定义礼物事件 流程相同，只有从 礼物名 到 关键字（表情名称） 的差别：
8、其他事件的编辑
其他事件包括关注事件、醒目留言事件、大航海事件。
关注事件可编辑被关注后的 投掷类型 和 冷却时长 。醒目留言为投掷相应价值的电池，可以对 最低投掷价值 、投掷上线 、投掷单位（多少个当做一个）、冷却时长 进行编辑。大航海为自动投掷相应的 舰长、提督或者总督 投掷物，可以对 冷却时长 进行编辑：
KBonk bilibili 食用教程到这里就结束了，如果您喜欢，请让更多人知道这款软件的存在！
