わんこめ参加人数表示プラグイン v1.0.0（Mac・Windows対応）

わんコメの参加型機能の参加人数を、OBSの配信画面にリアルタイムで表示するプラグインです。

わんコメが自動生成する「waiting.txt」を監視し、人数が変わったら即座にテキストファイルへ書き出します。

そのテキストファイルをOBSで読み込むことで、配信画面に参加人数を表示できます。

《 導入手順 》

1. わんコメ（バージョン5.2以上）がインストールされていることを確認します。

2. プラグインフォルダに「waiting-count」フォルダをコピーしてください。

プラグインフォルダボタンをクリックすると、わんコメのプラグインフォルダが開きます。

コピー先のパス：

　Windows: C:\Users\（ユーザー名）\AppData\Roaming\onecomme\plugins\

　macOS: /Users/（ユーザー名）/Library/Application Support/onecomme/plugins/

3. 再読み込みボタンで、またはわんコメを再起動して、プラグインを有効化します。

詳細な手順はわんコメ公式ドキュメントをご確認ください。

https://onecomme.com/docs/feature/plugins

《 OBS設定手順 》

1. 上記プラグインを有効にした状態で、わんコメ「参加型管理」を起動し、参加型機能を開始します。

2. データを更新したいので、テストコメントで参加者を増やしてみてください（例：コメントに「参加」と入力）。

3. plugin フォルダに 「waiting_count.txt」が生成されているはずなので、そのファイルをOBSのテキストソースで読み込みます。

「参加型管理」ソースを複製して、テキストソースに変更してもOKです。テキストファイルの参照パスを以下のように指定してください。

　Windows: C:\Users\（ユーザー名）\AppData\Roaming\onecomme\plugins\waiting-count\waiting_count.txt

　macOS: /Users/（ユーザー名）/Library/Application Support/onecomme/plugins/waiting-count/waiting_count.txt

4. わんコメで参加型機能を開始し、参加者が増減したら画面の数字が更新されることを確認します。

《 表示テキストのカスタマイズ 》

plugin.js 内の config セクションを編集することで、表示テキストを変更できます。

　prefix: '参加者: '　　← 人数の前につく文字

　suffix: '人'　　　　　← 人数の後につく文字

例：prefix を '現在 '、suffix を '人が参加中！' に変更すると

　　「現在 5人が参加中！」と表示されます。

変更後はわんコメを再起動してください。

《 仕様・制限事項 》

・対応OS

macOS・Windows に対応しています。

・反映までの遅延（デバウンス処理）

ファイル変更を検知してから100ms後に人数を更新します。

これは連続したファイル変更イベントをまとめて処理するための仕様です。

・エラー時の動作

waiting.txt の読み込みに失敗した場合、直前の人数を維持します。

配信中に人数が0にリセットされることはありません。

・waiting.txt のフォーマット

わんコメが生成する以下の形式にのみ対応しています。

　1:佐藤 2:小林 3:武藤

この形式が変わった場合、正しく動作しない可能性があります。

《 トラブルシューティング 》

▼ 人数が表示されない

・わんコメのコンソールに「[WaitingCount] プラグイン起動」が表示されているか確認してください。

・OBSのテキストソースで指定しているファイルパスが正しいか確認してください。

・わんコメで参加型機能が開始されているか確認してください。

▼ 人数が更新されない

・わんコメを再起動してください。

・OBSのテキストソースを一度削除して再度追加してください。

▼ コンソールにエラーが表示される

・「ファイル監視エラー」→ waiting.txt のアクセス権限を確認してください。

・「ファイル書き込みエラー」→ onecomme フォルダの書き込み権限を確認してください。

《 免責事項 》

本プラグインの使用に起因して生じたいかなる損失・損害についても、

プラグイン作者は直接的・間接的に関わらず一切の責任を負いません。

ご利用は自己責任でお願いいたします。

《 更新履歴 》

[2025/02/28] v1.0.0

・プラグインを公開しました。

《 連絡先 》

作者: さくまね

X(旧Twitter): https://x.com/sa9manager39