コンテンツにスキップ

MTGカード支援

前提条件

このプラグインで出来ること

  • MTG ARENAのゲーム自動実況に応じて、カードを表示できます。
  • カード辞書による音声認識連動表示
  • 自動画像キャッシュシステム
  • OBS統合による配信支援
  • 複数画像フォーマット対応（JPG, PNG, GIF, BMP）
  • バックグラウンドデータ取得
  • プロキシ環境対応

謝辞

  • MTGA自動実況ツールの開発者はぽｓ様です。
  • ぽｓ様のご提案・ご協力により本システムは実現しております。

うまく動かないときのレポートについて

  • 本件に関し、MTG ARENAサイドへのお問い合わせはご容赦ください。

有効化

MTGA

  • プラグインを使うチェックをONにしてください。

準備順序

  1. MTGA自動実況ツールを入れる
  2. カード特定辞書が生成されるため、説明に従ってCardDictionary.csvを指定する

設定

MTGA

設定 意味
カード特定辞書 キーワードとカード名を紐づける辞書を指定します
検索言語 カードを探すときに使う言語を指定します
キャッシュフォルダ 写真をストックしておく場所を指定します
いつまで出す？ 表示時間を指定します
バックグラウンドクロール 未取得カードデータの事前取得機能
画像ウィンドウサイズ カード表示ウィンドウのサイズ調整

高度な機能

カード辞書システム

辞書ファイル形式

  • ファイル形式: CSV（UTF-8エンコーディング）
  • フォーマット: "認識テキスト, カード名"
  • 例: 
    "ライトニングボルト","Lightning Bolt"
"稲妻","Lightning Bolt"  
"青い呪文","Counterspell"

表示制御オプション

クリアモード

モード 説明 設定値
常時表示 カード画像を常に表示 "Never clear"
時間制限表示 指定秒数後に自動消去 デフォルト: 2秒

ウィンドウ管理

  • リサイズ可能: カード表示ウィンドウのサイズ変更対応
  • 位置記憶: ウィンドウ位置の自動保存・復元
  • 最前面表示: 他のウィンドウに隠れない表示オプション

画像キャッシュシステム

キャッシュ機能

  • 自動ダウンロード: MTG APIからの画像自動取得
  • ローカル保存: キャッシュフォルダでの永続化
  • カスタム画像: ユーザー独自画像での上書き対応
  • フォーマット対応: JPG, PNG, GIF, BMP

ファイル命名規則

  • パス正規化: 不正文字（"/"、"."）を"_"に変換
  • 重複回避: 同名ファイルの自動管理
  • 容量最適化: 使用済みキャッシュの効率的管理

ネットワーク機能

API統合

  • データソース: api.magicthegathering.io との連携
  • タイムアウト: 1分間のHTTP接続タイムアウト
  • 自動デコンプレッション: GZIP/Deflate対応
  • エラーハンドリング: 接続失敗時の適切な処理

プロキシ対応

  • 自動検出: Windowsプロキシ設定の自動適用
  • 認証対応: プロキシ認証情報の自動使用
  • 企業環境: 企業ネットワーク環境での動作保証

技術仕様

項目 仕様
SDK バージョン .NET Framework 4.8
外部依存関係 Newtonsoft.Json, System.Net.Http
対応言語 7言語（日本語、英語、スペイン語、ロシア語、中国語、韓国語、フランス語）
キャッシュ形式 ファイルシステムベース
ネットワーク HTTPS、プロキシ対応
メモリ管理 自動リソース管理とガベージコレクション

カードについて

  • 検索した結果ローカルに保存されていないカードについては、MTGカードデータベースより取得されます
  • カード画像を好みのものに差し替えたい場合はキャッシュフォルダの同カード名の画像ファイルを上書きしてください

VMC

  • OBS用テキストデータは、OBSに直接データを取り込みたい方向けです。

  • OBSのテキストソース側で生成されるファイルをしていすると字幕として表示されます OBS

ファイル名 内容
Flavor.txt カードのフレイバー（解説）
Explan.txt カードの説明
name.txt カード名
type.txt カードタイプ