ハンドル形式の名前を以前のユーザー名の形式に変更できるわんコメの配布プラグイン【youtube-handle-to-name】

YouTubeのチャット欄で、ハンドル形式(@handle)の名前になってしまったものを、以前から使われているユーザー名（チャンネル名）形式で表示させるわんコメプラグインです

「プラグイン」であるため、お持ちのテンプレートどれに対してでも利用は可能になっています

無料版と支援版では、中身に差はありません

ご支援をいただける場合にのみ、支援版をご購入ください

※ご支援をいただける場合でも、【無料版で正常動作することを必ずご確認の上で】支援版の購入をおすすめします

--------------------

なお、わんコメ9.0からは、わんコメ本体にて同等以上の機能をプラグインの導入なしに利用できる「設定項目」が追加されています

本プラグインやAPIキーの取得も必要なくなるため、わんコメ9.0にアップデートいただければ、難しいこともなくすぐに今まで通りの名前を表示させられます

プラグインの内容

一部のYouTubeのライブ配信で適用されている、コメントをしたリスナーのユーザー名から@handle形式への見た目の仕様変更に対応し、もともと見えていた「ユーザー名（チャンネル名）」を表示できるわんコメのプラグインです

テンプレートではなくプラグインでの設計のため、お持ちのテンプレートでバッジ情報が表示されるものであれば、どのテンプレートにも対応しています

無料で取得できるYouTube Data API v3のAPIキーが必須です

https://console.cloud.google.com/

APIキーの取得方法やプラグインの詳細については、下記公式サイトをご確認ください

公開中プラグインのバージョン

【通常版(ニックネーム版統合済み)】

1.3.7 メンバーシップギフト受け取り時のspeechTextを再修正(2026/09/18)

1.3.6 メンバーシップギフト受け取り時のspeechTextを修正(2026/09/08)

1.3.5 speechTextの誤変換が起こりにくいよう追加調整(2026/08/20)

1.3.4 speechTextの誤変換が起こりにくいよう調整(2026/07/26)

1.3.3 speechTextにscreenNameがより入らないよう再調整(2026/07/25)

1.3.2 speechTextにscreenNameがさらに入らないよう再調整(2026/07/25)

1.3.1 speechTextにscreenNameがより入りにくいように再調整(2026/07/25)

1.3.0 タイムスタンプ順に並びやすいように調整

ほぼ同タイミングでコメントを受信した場合にクォータ消費が減るように調整(2026/07/21)

--------------------------------------------

1.2.10 speechTextにscreenNameがより入りにくいように再調整(2026/07/16)

1.2.9 speechTextにscreenNameがより入りにくいように調整(2026/06/11)

1.2.8 speechTextにscreenNameが入りにくいように調整(2026/06/01)

1.2.7 JSONファイルチェックのタイムアウトを設定

ログ出力が最小限になるように調整(2026/03/30)

1.2.6 メンバーシップギフト受取時の文面にハンドル表記がより残りにくくなるように修正(2026/03/29)

1.2.5 メンバーシップギフト受取時の文面がハンドル表記のままになるのを再修正(2026/03/28)

1.2.4 Promise.allを用いた並列処理を追加(2026/03/28)

1.2.3 Promise.allを用いた並列処理(2026/03/28)

1.2.2 不必要なコードの微修正(2026/03/28)

1.2.1 メンバーシップギフトのハンドル置き換え言語をYouTubeの表示言語に合わせて自動変更

プラグインの更新をせずとも表示言語のデータが更新できるように(2026/03/28)

1.2.0 メンバーシップギフトのハンドル置き換え言語をわんコメ本体の言語設定に合わせて変更(2026/03/28)

1.1.8 定期的なキャッシュ削除のタイミングが正しくなかったためPT0時に再調整(2026/03/28)

1.1.7 giftReceiversをより正しく表示できるように調整

タイムアウト時間の調整(2026/03/27)

1.1.6 ハンドルの置き換えに失敗した際に次回のコメントで再取得を試みるように調整(2026/03/25)

1.1.5 avatar/絵文字/giftReceivedアイコンの高画質化(2026/03/23)

1.1.4 メンバーシップギフト受取時の文面がハンドル表記のままになるのを再修正(2026/03/14)

1.1.3 メンバーシップギフト受取時の文面がハンドル表記のままになるのを修正(2026/03/13)

1.1.2 枠名が変更されてしまうバグの修正(2026/03/10)

1.1.1 ニックネーム出力時のアイコン置き換え処理の改善(2026/03/10)

1.1.0 「出力にもニックネームを使用する」機能に対応(2026/03/09)

1.0.5 アイコンを置き換えた際のエスケープ処理に対応(2026/03/08)

1.0.1 speechTextでハンドルが正常に置き換えられない現象の改善(2026/02/13)

1.0.0 正式版としてのリリース

speechText内におけるハンドル置換の対象を絞り込み(2026/02/13)

--------------------

通常版

* giftReceiversの安定性を若干向上(0.1.12-beta)

* アイコンの置き換え時チャンネル名表記に対応(0.1.11-beta)

* わんコメ9.0向けのgiftReceivers形式に対応(0.1.10-beta)

* ギフト受信時の受信者名を修正(0.1.9-beta)

* ニックネーム出力に対応したバージョンの公開(0.1.8-beta)

* ギフト受信時の名前取得精度を向上(0.1.7-beta)

* 読み上げ時の名前も置換処理追加(0.1.6-beta)

* ハンドル名の大文字・小文字区別の強化(0.1.5-beta)

* ギフト受信時の送信者名を修正(0.1.4-beta)

* コードの可読性向上(0.1.3-beta)

* 併記されるハンドル表記の大文字小文字を、ハンドル名でのコメント時に正しく表示

* ユーザー名でのコメント時のハンドル表記は、大文字小文字の区別なし

(0.1.2-beta)

* ユーザー名でのコメント時にハンドル名を取得(0.1.1-beta)

* ユーザー名とハンドル名の併記に対応(0.1.0-beta)

* キャッシュ効率の強化(0.0.7-beta)

* ハンドル名のキャッシュを強化(0.0.6-beta)

* メンバーシップギフトの受け取りパターンに対応(0.0.5-beta)

* メンバーシップギフト受取時のパターンに仮対応(0.0.4-beta)

* わんコメ8.0-beta.23のハンドル名の@を取り除く設定時にも対応(0.0.3-beta)

ニックネーム出力版は通常版に統合されました（ver1.1.0）

「youtube-handle-to-name」と「youtube-handle-to-nickName」の2バージョン（各無料版、支援版）を提供していましたが、バージョン1.1.0にて通常版に機能を統合させました

わん コメの「出力にもニックネームを使用する」機能に対応し、「出力にもニックネームを使用する」のON/OFFでテンプレートの表示が変化します

メンバーシップギフトのハンドル置き換え対応言語

2026年3月28日現在、対応しているのは以下の言語です

・日本語

・英語

・中国語（繁体字/簡体字/香港）

・タイ語

・韓国語

YouTubeの表示言語内で、順次自動アップデートが入る可能性があります

YouTube Data API v3のAPIキーについて

取得はこちらから行えます

https://console.cloud.google.com/

APIキーの取得方法やプラグインの詳細については、下記公式サイトをご確認ください

なお、このAPIキーは【共有厳禁】です

必ずご自身で取得し、第三者に公開することがないようにしてください

また最近だと、AIに読み込ませてしまい流出するケースもあるため、

・AIに読み込ませない

・定期的に新しいものに置き換え古いものは無効化する

など対策を講じてください

アップデート時の注意

バージョンアップ（アップデート）後は、古いバージョンはフォルダごと削除し、わんコメでプラグインの再読み込みや、わんコメの再起動を行ってください

上記手順を踏まないと、同じuidを使っているため、正常に読み込みがなされません

また、バージョン1.2.1からは、「config.json」で「enableGiftPatternsAutoUpdate」を「false」にしない限り、メンバーシップギフト受け取り時の辞書的存在となる「giftReceived_text.json」ファイルが自動更新される可能性があります

「giftReceived_text.json」をカスタマイズされる場合には、「enableGiftPatternsAutoUpdate」を「false」にして運用し、アップデート後にも「enableGiftPatternsAutoUpdate」を「false」に戻すのを忘れないでください

対応バージョン

7.2.0以上

動作確認バージョン

わんコメ 9.1.0-beta.0

利用規約

カスタマイズは可能ですが、再頒布や自作発言等はなさらないでください

クレジット表記について

クレジット（利用元）の表記は、必要ありません

完全に「任意」です

書いていただけると嬉しくはあります

公式サイト

プラグインの詳しい内容は、公式サイトをご確認ください

https://nvl-game.tokyo/plugins/5578

作者𝕏

https://x.com/shinkunoshizuku