リリース記念セール中【わんコメ連携】ジュエルヒット - ジュエル・スパチャがキャラに飛んできて砕ける投擲演出（フリー / バトル）【わんコメ9.1以降・VTube Studio対応】V1.0.1

▼ 概要

YouTubeの新しいギフト「ジュエル」を、ただ通知で流すだけじゃもったいない。

リスナーさんが投げたジュエルが、公式のギフト画像のまま画面外から飛んできて、あなたのキャラに命中して砕け散る。外れたら「○○さん外した！」。

連続で当てたら「○○さん5連続命中！」。頭に当たればヘッドショット。

「ジュエルヒット」は、わんコメ(OneComme)と連携して、YouTube Liveのジュエル・スーパーチャット・スーパーステッカーを「投擲物」に変えて、OBS上のキャラにぶつける演出ツールです。

投擲物は溜まりません。

当たって、砕けて、消える。一瞬の気持ちよさに特化しました。

残るのはヒットマーカーと、数秒の汚れと、コンボカウンターだけです。

・ジュエルは、YouTubeが配る公式のギフト画像そのものが飛んできます

・低額は軽く連射感、高額は巨大＋スローモーションで派手に砕けます

・当たり判定は OBS のソース位置、または VTube Studio のモデル輪郭に自動で追従

・雑談向けの「フリーモード」と、企画向けの「バトルモード」（HPバー・撃破・MVP）を配信中に切替

OBS側はブラウザソース1枚。設定はOBSのカスタムブラウザドックから、配信中にその場で変えられます。

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

▼ こんな方にオススメ

・YouTubeの新機能（ジュエルギフト）を配信の演出に取り入れたい方

・ギフトが来た瞬間の「気持ちよさ」を、画面いっぱいに出したい方

・リスナーさんに「当てる」「外す」「ヘッドショット」で遊んでもらいたい方

・記念配信や耐久企画で「HPを削り切ったら○○します」をやりたい方

・VTube Studio でキャラを動かしながら配信している方（動いても判定がついてきます）

・OBSのブラウザソースを増やしすぎたくない方

・わんコメを使ってYouTube配信をしている方

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

▼ 主な機能

【投げる】

・ジュエル / スーパーチャット / スーパーステッカー / メンバーシップ加入に対応

・ジュエルはYouTube提供のギフト画像で、スパチャは宝石（ボール / 絵文字にも変更可）で飛んできます

・金額で4段階: 軽い連射 → 中 → 巨大 → スローモーション（しきい値は設定可）

・投擲物に投げ手の名前を貼付。外れたときも「○○さん外した！」で拾えます

・ジュエルの連投は、同じギフトの更新として差分だけ投げます（二重に飛びません）

・高額連投時の同時表示上限あり（超過分は順番待ちで投げるので重くなりません）

【当てる】

・当たり判定は 頭 / 体 の2部位。ヘッドショットは専用表示（バトルでは倍率）

・OBS追従: obs-websocket でキャラソースの位置・大きさを取得して枠が追従

・VTube Studio追従: VTSのモデル輪郭を毎秒15回受信。VTS内でキャラを動かしても・拡縮しても実寸で追従

・手動の固定枠にも対応。枠の表示・オフセット・倍率・頭の範囲を配信中に調整できます

・狙いのばらつきで「必中」から「よく外す」まで調整

【演出】

・命中: 砕けて消える、ヒットマーカー、数秒残る汚れ、名前＋金額の表示（約1.5秒）

・連続命中でコンボ表示（「○○さん5連続命中！」）

・VTube Studio 連携時は、命中でキャラの首・体が一瞬揺れます（マウスで掴む操作を邪魔しません）

・効果音（投擲 / 命中 / ヘッドショット / 撃破 / 心音）は内蔵。音量調整・OFF可

・安全弁: 「今日は投げない」「避ける（全部外れる。VTSならキャラが実際に横へ退避）」

【バトルモード】

・画面上部にHPバー＋キャラ名。命中でダメージ（金額比例 × ヘッドショット倍率 × コンボ倍率）

・最大HPは手動、または過去の撃破履歴から「○分で撃破」になるよう自動設定

・回復: 一定時間ノーダメージで自然回復 / 特定コメント（メンバー限定可）で回復

・ガード: ドックのボタンを押している間ダメージ半減。ゲージ制で押しっぱなしはできません

・HP残量で 元気 → 息切れ → ボロボロ。OBSソース切替 または VTSの表情で差分表示、ビネット暗化、心音SE

・HP0で撃破演出: 「とどめ：○○さん」「最多ダメージ：○○さん」＋撃破メッセージ（「1曲歌います」「企画発表」など自由に設定）を表示

・撃破時に OBSソース表示 / VTSホットキー も発火。数秒後にHP全快で次のラウンド

・直近3人のダメージログを常時表示

・HPは配信ごとにリセット。撃破回数・MVPの履歴だけ保存

【記録】

・今回の集計: ギフト件数 / 合計金額（円換算・ジュエル数）/ 投擲・命中・ヘッドショット・外れ / 投げ手ランキング

・撃破履歴（日時・ラウンド・とどめ・MVP・総ダメージ・所要時間）

・設定・履歴はわんコメ側に保存。OBSのキャッシュを消しても消えません

【設定がラク】

・OBS の WebSocket パスワードは「自動取得」ボタンで（手入力・貼り付け不要）

・シーン名・ソース名・VTSの表情・ホットキーは、一覧から「クリックで選ぶ」だけ（日本語入力不要）

・フリー / バトル、安全弁、ガードは「操作」タブの大きなボタンで配信中に即切替

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

▼ 導入手順

1. プラグインフォルダをわんコメのプラグインフォルダに配置し、設定 › プラグインで有効化

2. わんコメ(OneComme)でYouTubeの配信枠に接続

3. OBSのブラウザソースに表示用URLを追加（1920×1080・キャラより上のレイヤー）

4. OBSのカスタムブラウザドックに設定用URLを追加

5. 当たり判定を設定（OBS追従 / VTube Studio追従 / 手動枠）

6. ドックの「テスト」タブから投げて動作確認

詳しい手順は同梱の取扱説明書をご確認ください。

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

▼ 収録内容

・わんコメ用プラグイン一式

・OBS表示用ページ（オーバーレイ）

・設定ドック（同じページ内）

・取扱説明書（テキスト）

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

▼ 動作環境

・OBS Studio 28.x 以降（obs-websocket 5.x 内蔵）

・わんコメ(OneComme) v9.1 以降（v9.1.1 で動作確認済み）

※ ジュエルはわんコメ 9.1 以降でのみ受信できます。8系ではスパチャ・ステッカーのみ動作し、ジュエルは届きません

・VTube Studio 連携は任意（v1.35 で動作確認済み。VTS の API を ON にして初回に許可を押すだけ）

・YouTube Live

・Windows / macOS

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

▼ 注意事項

・本ツールの使用には、わんコメ(OneComme) 9.1 以降が必要です（ジュエル受信はわんコメ側の対応が 9.1 からのため）

・対応プラットフォームはYouTube Live向けです

・ジュエルはわんコメに「消費ジュエル個数」として届くため、円換算は目安レートの設定によるものです。実際の収益額を示すものではありません

・海外通貨のスパチャは、スパチャの階層から円の目安に換算します

・当たり判定の自動追従には OBS の WebSocket サーバー（OBS標準機能）または VTube Studio の API を使用します。どちらも使わない場合は手動の固定枠で動作します

・macOS で VTube Studio をOBSに映す場合、OBSに「画面収録」の許可が必要です

・投擲物の飛び方・当たり方はランダム要素を含みます。「必ず当たる」設定にもできます

・配信での使用は自由です（収益化配信含む）

・再配布、改変配布は禁止です

・本ツールの使用により生じた損害について、作者は一切の責任を負いません

・ダウンロード商品のため、購入後の返金には応じられません

・本ツール利用は連携元のわんコメの利用規約も適用されます。https://onecomme.com/terms をご確認ください

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

▼ サポート

ご不明な点やトラブルがございましたら、BOOTHのメッセージ機能よりお問い合わせください。

不具合のご連絡の際は、わんコメとOBSのバージョン、使用OS、症状のスクショや短い録画を添えていただけると確認がスムーズです。

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

▼ 姉妹ツール

・ジュエルプール: ジュエルが物理演算で溜まっていき、水面が上がって配信画面が沈んでいく「蓄積担当」

ジュエルヒットは「瞬発担当」。2つは独立したプラグインなので、同時に使っても干渉しません

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

▼ 更新履歴

・v1.0.1　バグ修正版（外れ球の手前落ち解消・画像読み込み待ち・取りこぼし再生・縦型対応強化）　2026/09/01

縦型配信向けに挙動を微調整実施

・v1.0.0　初回リリース　2026/08/29

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

投げられた瞬間に、当たって、砕けて、名前が残る。

ギフトの「一瞬」を、いちばん気持ちいい形で画面に出しませんか。

[For English Users]

An OBS overlay plugin for YouTube Live streamers using OneComme (v9.1 or later; Jewels are not delivered on v8).

Jewels (YouTube gifts) and Super Chats fly in as projectiles and hit your character. They don't pile up: hit, shatter, gone.

Hitbox follows your character via obs-websocket or the VTube Studio API (model outline, 15 fps).

Free mode (hit & vanish, combos, headshots) and Battle mode (HP bar, damage, regen, guard, expressions by HP, KO with "finisher" and MVP).

Gift images are YouTube's official ones. Settings live in an OBS custom browser dock.