【ご購入前のご確認 (重要)】 本ソフトウェアは無料配布ですが、以下の点をご了承ください: ・Windows 10 22H2 以降 / Windows 11 (x64) 専用。macOS / Linux / 32bit は非対応。 ・VRChat クライアント側の OSC 有効化が必要です (Action Menu → Options → OSC → Enabled)。 ・本ツールは「1-shot 送信のみ」対応です。定期送信・マクロ記録再生・受信値の集計機能は意図的に含みません (それぞれ有料の姉妹商品で提供しています)。 ・サポート範囲は「本ソフトウェアが起動しない」等の致命的な動作不良に限ります。使い方の質問や機能追加のご要望は対象外です。 ・コード署名未取得の exe のため、初回起動時に Windows SmartScreen 警告が出ることがあります。同梱 README §3 の手順で回避できます。 ・本ソフトウェアを用いた、第三者アバターへの迷惑行為 (OSC の spam 送信等) は使用許諾契約違反となります。 【配布物 SHA256】 ダウンロード直後に PowerShell で以下を実行して完全性を検証してください: Get-FileHash -Algorithm SHA256 .\VRCOSCTesterLite_v1.0.0_win_x64.zip 期待値: 5559c87dbda21411f282bc8817b1f273af1fa83d26059c4e58032dfe76131962 この SHA256 値は同梱 Manual.pdf 付録 B.1 および QuickStartGuide.pdf 本文にも記載しています。 ──────────────────────────────────── 【本ソフトウェアは何をするものか】 VRChat OSC テスター Lite は、VRChat との OSC (Open Sound Control) 通信を GUI でリアルタイム可視化し、任意の OSC メッセージを手動送信できる「診断専用」の無料ツールです。 VRChat の OSC 機能は年々進化していますが、「自分のアバターが送っている Parameter 名は何か」「送信した値がちゃんと届いているか」を確認するツールは上級者向け CLI が中心で、改変師・クリエイター向けに日本語でわかりやすい GUI 版は空白でした。本ツールはその空白を埋める位置付けです。 【できること (4 機能)】 ●受信モニタ VRChat が送出する OSC パラメータ (address / 型 / 現在値 / 累計受信数 / 更新頻度 / 最終受信時刻) をテーブル形式でリアルタイム表示します。最大 1024 アドレス保持 (LRU eviction)、設定で 128-4096 の範囲に変更可能。float は小数 6 桁既定で表示、更新頻度は指数移動平均で算出します。 ●送信テスタ 任意の address + 型 (i / f / s / T / F) + 値で OSC メッセージを 1 回だけ手動送信できます。アバター側 Animator Parameter に対応する値があれば、VRChat 内部の状態が即座に変わります。入力内容は送信前に validate され、不正値は送信ボタンが灰色化 + 理由を赤文字で表示します。受信モニタの行をクリックすると、その address が送信テスタの Address 欄に自動コピーされます (手打ち不要)。 ●生パケット hex dump 受信した raw UDP バイト列を hex + ASCII で表示します。OSC 仕様外のパケット、バイナリ破損を疑う場合、OSC Bundle 受信時の内容確認などに使います。CPU 保護のため既定は OFF、必要時のみチェックで有効化。 ●ループバック自己診断 ステータスバーの「ループバック検査」ボタンで、localhost 上で本ツールが自己送信→自己受信を 10 回行い、OS ネットワークスタックと OSC パーサ/シリアライザの健全性を 1 クリックで判定します。結果は OK / WARN / FAIL で表示され、FAIL の場合はファイアウォール / アンチウイルス / UDP スタックの設定を疑う根拠になります。 【技術的な特性 (有料商品と同等の運用基準)】 本ツールは「Python 標準ライブラリのみ」で構成されており、ランタイム依存のサードパーティ Python パッケージは「ゼロ」です。将来のライブラリ互換性問題で動かなくなるリスクが最小です。 ・stdlib socket + 自前 OSC パーサ/シリアライザ (python-osc 非採用) ・4 バイト境界アライン / NUL 終端 / big-endian を厳格遵守、OSC 1.0 仕様完全準拠 ・受信は OSC 1.0 全型対応 (i/f/s/b/h/d/t/T/F/N/I/S/c/r/m)、送信は VRChat 実用 5 型 (i/f/s/T/F) ・単一プロセス + 3 スレッド (GUI / Receiver / Sender) + 一時 Loopback worker ・Windows Named Mutex による多重起動防止 ・config.json atomic write + 3 世代 .bak ローテーション + 破損時既定フォールバック ・2 段階 sys.excepthook (bootstrap 前 stderr → bootstrap 後 crash dir) ・179 件の pytest スイート all green ・PyInstaller --onedir で配布、起動 1-2 秒、Windows Defender 誤検知低 【動作環境】 ・Windows 10 64bit (バージョン 22H2 以降) または Windows 11 ・VRChat クライアント (Steam / Standalone どちらも可)、OSC 有効化必須 ・空きメモリ 約 80 MB / ディスク 約 30 MB macOS / Linux / 32bit Windows / Quest 単独版は非対応です。 【何をしないか (意図的な機能外)】 以下は本ツールの対象外です。同じ目的には GumGam Lab の有料商品をご検討ください: ・OSC の定常・周期送出 (天気・PC ステータス等) → VRCExt-Weather / PC ステータス OSC の領域 ・送信パターンのプリセット保存・再生・マクロ化 → OSC マクロレコーダの領域 ・OSC 受信値の集計・統計・時系列グラフ → アバター使用状況トラッカーの領域 ・OBS Browser Source 連携 / HTML オーバーレイ生成 → OBS オーバーレイ商品の領域 ・ログファイルの tail / 解析 → VRChat ログビューワ Lite の領域 ・VRChat 以外の OSC 対応アプリとの汎用性 (本企画は VRChat 特化) これらを削ることで、本ツールは「OSC の動作確認・診断」に徹した、シンプルで信頼できる道具になっています。 【関連ツール (GumGam Lab 他商品)】 本ツールで OSC の動作確認ができた方向けに、以下の有料商品をご用意しています: ●VRCExt-Weather【販売準備中】 現在地の天気・気温・日の出入りを OSC 経由で Avatar に送信、アバターのエフェクトを現実環境に連動させます。 ●PC ステータス → Avatar OSC【販売準備中】 CPU / GPU / バッテリー等を OSC で Avatar Parameter に送信。Animator 同梱テンプレート付き。 ●OSC マクロレコーダ【販売準備中】 OSC 送信パターンを記録・再生できるマクロツール。 最新の価格・仕様・販売状況は Booth ショップ (https://gumgamlab.booth.pm/) でご確認ください。 【同梱物】 ダウンロード ZIP: ・VRCOSCTesterLite.exe (本体) ・_internal\ (PyInstaller 依存ファイル) ・README.txt / LICENSE.txt / CHANGELOG.txt / THIRD_PARTY_LICENSES.txt 別添 PDF: ・Manual.pdf (21 ページ) - 機能詳細、トラブルシューティング、OSC 型タグ対応表 ・QuickStartGuide.pdf (2 ページ) - 5 分セットアップ手順 【ライセンス】 Proprietary EULA (同梱 LICENSE.txt 参照)。個人利用は許可、再配布・改変版配布・リバースエンジニアリングは禁止。本ソフトウェアはローカル PC 上でのみ動作し、OSC メッセージはユーザが明示的に設定した送信先 (既定では同一 PC 上の VRChat) にのみ送信されます。外部ネットワーク通信は発生しません。 【FAQ】 Q: VRChat が動いているのに受信モニタに何も表示されません。 A: VRChat 側 OSC が有効か / 受信ポートが 9001 か / 他の OSC ツール (Protokol など) が同時に 9001 を占有していないかをご確認ください。ループバック検査で OS スタックの問題切り分けも可能です。 Q: 送信が Avatar に反映されません。 A: 送信ポートが 9000 か、アバター Animator に対応する Parameter が存在するか、Parameter 名の大文字小文字まで一致しているか、Expression Parameters の Synced=ON か、をご確認ください。 Q: 周期送信はできますか？ A: 意図的にサポートしません。OSC マクロレコーダ【販売準備中】の領域です。 Q: Windows Defender に検知されました。 A: PyInstaller 製 exe の false positive の可能性があります。SHA256 値が一致していることを確認のうえ、同梱 README §3 の手順をご参照ください。 Q: ソースコードは公開されますか？ A: 本バージョンでは公開しません (Proprietary)。無料提供とソース公開は別の判断としています。 Q: サポートは受けられますか？ A: 致命的な動作不良 (exe が起動しない / クラッシュ) は Booth メッセージで対応しますが、使い方の質問や機能追加要望は対象外です。README と Manual.pdf に必要情報を集約しています。 ──────────────────────────────────── 本商品は「無料配布」ですが、有料商品と同等の堅牢性基準で設計されています。ダウンロード後は付属 QuickStartGuide.pdf の 7 手順に沿って 5 分でセットアップ可能です。 (c) 2026 GumGam Lab All rights reserved.