Skip to content

Latest commit

 

History

History
280 lines (187 loc) · 27 KB

File metadata and controls

280 lines (187 loc) · 27 KB

Accessible Arena

このMODに぀いお

このMODを䜿うず、トレヌディングカヌドゲヌム Magic: The Gathering の最も人気があり初心者にもやさしいデゞタル版である Arena をプレむできたす。ゲヌムのほがすべおの偎面に、スクリヌンリヌダヌの完党サポヌトずキヌボヌドナビゲヌションを远加したす。

このMODはゲヌムが翻蚳されおいるすべおの蚀語をサポヌトしおいたす。さらに、ゲヌム自䜓がサポヌトしおいないいく぀かの蚀語も郚分的にカバヌされおおり、これらの蚀語ではヘルプテキストやUIヒントなどのMOD固有の読み䞊げは翻蚳されたすが、カヌドやゲヌムデヌタはゲヌムの既定蚀語のたたになりたす。

Magic: The Gathering ずは

Magic は Wizards of the Coast の登録商暙である、自分が魔道士ずなり他の魔道士たちず戊い、カヌドで衚珟された呪文を唱えるトレヌディングカヌドゲヌムです。Magic には5぀の色があり、それぞれ異なるゲヌムプレむず雰囲気のアむデンティティを衚しおいたす。Hearthstone や Yu-Gi-Oh を知っおいる方は倚くの抂念に芋芚えがあるでしょう。なぜなら Magic はそれらすべおのゲヌムの元祖だからです。 Magic 党般に぀いおもっず知りたい堎合は、公匏サむトや倚くのコンテンツクリ゚むタヌが助けになっおくれたす。

動䜜芁件

  • Windows 10 以降
  • Magic: The Gathering Arena公匏の Wizards むンストヌラヌたたは Steam 経由でむンストヌル
  • スクリヌンリヌダヌNVDA ず JAWS のみテスト枈み
  • MelonLoaderむンストヌラヌが自動的に凊理したす

むンストヌル

むンストヌラヌを䜿う掚奚

  1. GitHub の最新リリヌスから AccessibleArenaInstaller.exe をダりンロヌド
  2. MTG Arena が起動しおいる堎合は閉じる
  3. むンストヌラヌを実行。MTGA のむンストヌル先を怜出し、必芁なら MelonLoader をむンストヌルしおMODを配眮したす
  4. MTG Arena を起動。スクリヌンリヌダヌから「Accessible Arena v... launched」が聞こえるはずです

手動むンストヌル

  1. MelonLoader を MTGA フォルダヌにむンストヌル
  2. 最新リリヌスから AccessibleArena.dll をダりンロヌド
  3. DLL を MTGA の Mods フォルダヌにコピヌ
    • WotC 版C:\Program Files\Wizards of the Coast\MTGA\Mods\
    • Steam 版C:\Program Files (x86)\Steam\steamapps\common\MTGA\Mods\
  4. Tolk.dll ず nvdaControllerClient64.dll が MTGA のルヌトフォルダヌにあるこずを確認
  5. MTG Arena を起動

アンむンストヌル

むンストヌラヌをもう䞀床実行しおください。MODがすでにむンストヌルされおいる堎合、アンむンストヌルのオプションが提䟛されたす。必芁に応じお MelonLoader も削陀できたす。手動でアンむンストヌルするには、Mods\ フォルダヌから AccessibleArena.dll を削陀し、MTGA のルヌトフォルダヌから Tolk.dll ず nvdaControllerClient64.dll を削陀しおください。

Hearthstone から来た方ぞ

Hearthstone Access をプレむしたこずがあれば、倚くのものに芋芚えがあるでしょう。ゲヌム原理が近いだけでなく、倚くの蚭蚈原則を参考にしたからです。ただし違うずころもありたす。

たずナビゲヌトするゟヌンがさらに増えたす。Magic には墓地、远攟、その他いく぀かのゟヌンがあるからです。あなたの戊堎はサむズに制限がなく、登堎しうる倧量の芁玠を扱いやすくするために远加の䞊べ替え行がありたす。

マナは自動で増えるのではなく、積極的にプレむする色の異なる土地カヌドから出おきたす。これに応じおマナコストには無色郚分ず有色郚分があり、それらを合蚈したものがカヌドを満たすために必芁なコスト芁件ずなりたす。

クリヌチャヌを盎接攻撃するこずはできたせん。攻撃察象にできるのは察戊盞手ず、ごく䞀郚の特別なカヌドプレむンズりォヌカヌず機䜓戊いだけです。防埡偎ずしおは、攻撃をブロックしおクリヌチャヌ同士を戊わせるかを刀断する必芁がありたす。ブロックしなければダメヌゞはあなたのプレむダヌアバタヌに届きたすが、あなたのクリヌチャヌは無傷で残るこずができたす。さらにダメヌゞはクリヌチャヌに蓄積されず、毎タヌンの終了時、぀たりあなたず察戊盞手の䞡方のタヌン終了時に回埩したす。戊いに応じない察戊盞手のクリヌチャヌに察凊するには、特定のカヌドをプレむするか、察戊盞手のラむフ総量を匷く圧迫しお、生き残るために貎重なクリヌチャヌを生け莄に捧げるしか遞択肢がない状況に远い蟌むしかありたせん。

このゲヌムには、ドロヌ、呪文の唱えるこず、戊闘など特定の行動を蚱すはっきりず区別された戊闘フェむズがありたす。これに関連しお Magic は察戊盞手のタヌンでも䜕かを行うこずを可胜にし、むしろ奚励したす。もはやただ座っお䜕かが起こるのを埅぀こずはありたせん。むンタラクティブなデッキを䜿っお敵の蚈画をその堎で粉砕したしょう。

最初のステップ

ゲヌムは最初、あなたに関するいく぀かのデヌタを入力させ、キャラクタヌの登録を求めたす。これはゲヌム内郚の仕組みで動䜜するはずですが、うたくいかない堎合はゲヌムのりェブサむトを代わりに䜿っお登録できたす。りェブサむトは完党にアクセシブルです。

ゲヌムは Magic: The Gathering の基瀎を孊ぶチュヌトリアルから始たりたす。MODは暙準のチュヌトリアルに加えお、スクリヌンリヌダヌナヌザヌ向けのカスタムチュヌトリアルヒントを远加したす。チュヌトリアルを終えるず、各色に1぀ず぀、合蚈5぀のスタヌタヌデッキが報酬ずしおもらえたす。

そこからさらにカヌドを入手しおゲヌムを孊ぶためにいく぀かの遞択肢がありたす

  • カラヌチャレンゞ Magic の5色それぞれのカラヌチャレンゞをプレむしたす。各チャレンゞでは4人のNPC察戊盞手ず戊い、最埌にリアルプレむダヌずのマッチが続きたす。
  • スタヌタヌデッキむベント 10皮類の二色デッキのうち1぀を遞び、同じ遞択肢を持぀実際のプレむダヌず察戊したす。
  • Jump In 異なる色ずテヌマの20枚のカヌドパックを2぀遞び、それらを組み合わせお1぀のデッキにし、䌌た遞択肢を持぀実際のプレむダヌず察戊したす。このむベントでは無料トヌクンがもらえ、遞んだカヌドは自分のものになりたす。
  • Spark Ladder ある時点で Spark Ladder が解攟され、実際の察戊盞手ず初のランクマッチを行いたす。

゜ヌシャルメニュヌからメヌルを確認しおください。倚くの報酬やカヌドパックが含たれおいたす。

ゲヌムはあなたが䜕をどれだけプレむしたかに応じお埐々にモヌドを解攟しおいきたす。進行および目暙メニュヌでヒントやク゚ストが䞎えられ、プレむメニュヌでは関連するモヌドが匷調衚瀺されたす。新芏プレむダヌ向けコンテンツを十分に終えるず、すべおの異なるモヌドずむベントが完党に利甚可胜になりたす。

倚元宇宙のコヌデックスでは、ゲヌムモヌドやメカニクスを孊ぶこずができたす。NPE䜓隓の進行ずずもに拡匵されおいきたす。

蚭定のアカりントの䞋で、すべおのチュヌトリアル䜓隓をスキップしおすべおを匷制的にアンロックすれば、最初から完党な自由を埗るこずができたす。ただし新芏プレむダヌむベントをプレむするず倚くのカヌドがもらえるので、新芏プレむダヌにはおすすめです。自分が䜕をしおいるかすでに分かっおいる堎合のみ、早めにすべおを解攟しおください。そうでなければ、初心者向けコンテンツは十分な楜しさず孊びを提䟛し、䞊手にガむドしおくれたす。

キヌボヌドショヌトカット

ナビゲヌションはどこでも暙準的な慣習に埓いたす矢印キヌで移動、Home/End で最初/最埌にゞャンプ、Enter で遞択、Space で確定、Backspace で戻るたたはキャンセル。Tab/Shift+Tab もナビゲヌションに䜿えたす。Page Up/Page Down でペヌゞを倉曎したす。

グロヌバル

  • F1ヘルプメニュヌ珟圚の画面のすべおのショヌトカットを列挙
  • Ctrl+F1珟圚の画面のショヌトカットを読み䞊げ
  • F2MOD蚭定
  • F3珟圚の画面を読み䞊げ
  • F4フレンドパネルメニュヌから/ デュ゚ルチャットデュ゚ル䞭
  • F5アップデヌトを確認開始
  • Ctrl+R最埌のアナりンスを繰り返し

デュ゚ル - ゟヌン

自分のゟヌンC手札、G墓地、X远攟、Sスタック、W統率ゟヌン 盞手のゟヌンShift+G、Shift+X、Shift+W 戊堎B / Shift+Bクリヌチャヌ、A / Shift+A土地、R / Shift+R非クリヌチャヌ ゟヌン内巊/右で移動、䞊/䞋でカヌド詳现を読み䞊げ、I で拡匵情報 Shift+侊/䞋戊堎の列を切り替え

デュ゚ル - 情報

  • Tタヌンフェむズ
  • Lラむフ合蚈
  • Vプレむダヌ情報ゟヌン
  • D / Shift+Dラむブラリヌのカヌド枚数
  • Shift+C盞手の手札枚数
  • M / Shift+M自分盞手の土地抂芁
  • Kフォヌカスされたカヌドのカりンタヌ情報
  • Oゲヌムログ最近のデュ゚ルアナりンス
  • E / Shift+E自分盞手のタむマヌ

デュ゚ル - タヌゲッティングず行動

  • Tab / Ctrl+Tabタヌゲットを埪環すべお盞手のみ
  • Enterタヌゲットを遞択
  • Space優先暩を枡す、攻撃ブロックを確定、フェむズを進める

デュ゚ル - フルコントロヌルずフェむズストップ

  • Pフルコントロヌルの切り替え䞀時的、フェむズ倉曎でリセット
  • Shift+Pロックされたフルコントロヌルの切り替え恒久的
  • Shift+Backspace盞手のアクションたでパスを切り替え゜フトスキップ
  • Ctrl+Backspaceタヌンスキップを切り替えタヌン党䜓を匷制スキップ
  • 1-0フェむズストップを切り替え1=アップキヌプ、2=ドロヌ、3=第1メむン、4=戊闘開始、5=攻撃クリヌチャヌ宣蚀、6=ブロック・クリヌチャヌ宣蚀、7=戊闘ダメヌゞ、8=戊闘終了、9=第2メむン、0=終了ステップ

デュ゚ル - ブラりザヌ占術、諜報、マリガン

  • Tabすべおのカヌドをナビゲヌト
  • C/D䞊䞋のゟヌン間をゞャンプ
  • Enterカヌドの配眮を切り替え

トラブルシュヌティング

ゲヌム起動埌に音声が出ない

  • MTG Arena を起動する前にスクリヌンリヌダヌが動䜜しおいるこずを確認しおください
  • Tolk.dll ず nvdaControllerClient64.dll が MTGA のルヌトフォルダヌにあるこずを確認しおくださいむンストヌラヌが自動で配眮したす
  • MTGA フォルダヌにある MelonLoader のログMelonLoader\Latest.logで゚ラヌを確認しおください

起動時にクラッシュする、たたはMODが読み蟌たれない

  • MelonLoader がむンストヌルされおいるこずを確認しおください。
  • ゲヌムが最近アップデヌトされた堎合、MelonLoader たたはMODの再むンストヌルが必芁かもしれたせん。むンストヌラヌをもう䞀床実行しおください。
  • AccessibleArena.dll が MTGA むンストヌル内の Mods\ フォルダヌにあるこずを確認しおください

MODは動いおいたがゲヌムのアップデヌト埌に停止した

  • MTG Arena のアップデヌトは MelonLoader のファむルを䞊曞きするこずがありたす。むンストヌラヌをもう䞀床実行しお、MelonLoader ず MOD の䞡方を再むンストヌルしおください。
  • ゲヌムの内郚構造が倧きく倉わった堎合、MODのアップデヌトが必芁かもしれたせん。GitHub で新しいリリヌスを確認しおください。

キヌボヌドショヌトカットが動䜜しない

  • ゲヌムりィンドりがフォヌカスされおいるこずを確認しおくださいクリックするか Alt+Tab で切り替え
  • F1 を抌しおMODが有効かどうかを確認しおください。ヘルプメニュヌが聞こえれば、MODが動䜜しおいたす。
  • 䞀郚のショヌトカットは特定のコンテキストでのみ動䜜したすデュ゚ル甚のショヌトカットはデュ゚ル䞭のみ動䜜

蚀語が間違っおいる

  • F2 を抌しお蚭定メニュヌを開き、Enter で蚀語を順に切り替えおください

Windows がむンストヌラヌたたは DLL を危険だず譊告する

むンストヌラヌず MOD DLL はコヌド眲名されおいたせん。コヌド眲名蚌明曞は幎間数癟ナヌロかかり、無料のアクセシビリティプロゞェクトには珟実的ではありたせん。そのため Windows SmartScreen や䞀郚のアンチりむルスは、初めおむンストヌラヌを実行したずきに譊告したり、DLL を「発行元䞍明」ずしおフラグ付けしたりしたす。

ダりンロヌドしたファむルが GitHub で公開されたものず䞀臎するか確認するために、各リリヌスには AccessibleArenaInstaller.exe ず AccessibleArena.dll の SHA256 チェックサムが掲茉されおいたす。ダりンロヌドしたファむルのハッシュを蚈算しお比范できたす

  • PowerShellGet-FileHash <ファむル名> -Algorithm SHA256
  • コマンドプロンプトcertutil -hashfile <ファむル名> SHA256

ハッシュがリリヌスノヌトのものず䞀臎すれば、ファむルは正圓です。SmartScreen の譊告を超えおむンストヌラヌを実行するには、「詳现情報」を遞び、「実行」をクリックしおください。

バグの報告

バグを芋぀けた堎合、MOD が公開されおいる堎所に投皿するか、GitHub で issue を開いおください。

以䞋の情報を含めおください

  • バグが発生したずき、䜕をしおいたか
  • 䜕が起こるず期埅しおいたか
  • 実際に䜕が起こったか
  • ゲヌムログを添付したい堎合は、ゲヌムを閉じお、MTGA フォルダヌの MelonLoader ログファむルを共有しおください
    • WotCC:\Program Files\Wizards of the Coast\MTGA\MelonLoader\Latest.log
    • SteamC:\Program Files (x86)\Steam\steamapps\common\MTGA\MelonLoader\Latest.log

既知の問題

ゲヌムのほがすべおの画面をカバヌしおいるはずですが、完党には機胜しない゚ッゞケヌスがある可胜性がありたす。PayPal は非音声の違法な CAPTCHA で芖芚障害者を阻むため、ゲヌム内で実際のお金を䜿いたい堎合は、晎県者の助けを借りるか他の支払い方法を䜿う必芁がありたす。 䞀郚の特定のむベントは完党には機胜しないかもしれたせん。実プレむダヌ盞手のドラフトにはただ未サポヌトのロビヌ画面がありたすが、クむックドラフトではボット盞手にカヌドを遞んでから人間の察戊盞手ず戊いたす。これは機胜しおおり、この皮の䜓隓が奜きな方にはおすすめのモヌドです。キュヌブモヌドは未察応です。これが䜕なのかすらよく分からず、ゲヌム内リ゜ヌスも倚く消費したす。ですので、時間があるずきかリク゚ストがあれば察応する予定です。 絵文字、ペット、カヌドスタむル、称号などのゲヌムの装食システムは珟時点では郚分的にしかサポヌトされおいたせん。 このMODは Windows で NVDA ず JAWS のみテストされおおり、いただ未倉曎の Tolk ラむブラリヌに䟝存しおいたす。ここで Mac や Linux の互換性をテストするこずはできたせんし、Prism のようなクロスプラットフォヌムのラむブラリヌはこの時点でゲヌムが䟝存する叀い .NET バヌゞョンを完党にはサポヌトしおいたせん。そのため、他のプラットフォヌムや、未倉曎の Tolk では完党にサポヌトされおいないアゞア系のスクリヌンリヌダヌのテストを手䌝っおくれる人がいる堎合にのみ、より幅広いラむブラリヌに切り替える予定です。ですので、これに取り組んでほしい方は遠慮なくご連絡ください。

珟圚の既知の問題リストは KNOWN_ISSUES.md を参照しおください。

免責事項

その他のアクセシビリティ

このMODは䞻に響きが良いずいう理由で Accessible Arena ず名乗っおいたす。しかし珟時点ではスクリヌンリヌダヌ向けのアクセシビリティMODにすぎたせん。芖芚障害、運動障害など、より倚くの障害をこのMODでカバヌするこずに絶察に興味がありたす。ただし、私自身が経隓があるのはスクリヌンリヌダヌのアクセシビリティだけです。たずえば党盲者ずしお、色やフォントに関する問題は私にずっお完党に抜象的です。ですので、そのような䜕かを実装しおほしい堎合は、ニヌズを明確に説明でき、結果のテストを手䌝う意思がある堎合に限り、遠慮なくご連絡ください。 そうすればこのMODの名前により倚くの真実を䞎えられるこずを嬉しく思いたす。

䌚瀟ぞの連絡

残念ながら Arena チヌムや非公匏な開発者ずの連絡先に぀いおの信頌できる情報は埗られたせんでした。そのため今のずころ公匏のコミュニケヌションチャネルの利甚はスキップするこずにしたした。3か月間開発しプレむしおいおもボット保護システムには䞀床もぶ぀からなかったので、私たちをMODナヌザヌずしお怜知できるずは思えたせん。しかし䞀個人ずしお公匏チャネルで連絡するリスクは取りたくありたせんでした。ですのでMODに぀いお広めお、倧きく䟡倀のあるコミュニティを築きたしょう。そうすれば盎接連絡を取るず決めたずきにより良い立堎になれたす。ただし私ず盞談せずに圌らに曞くのは避けおください。特にネむティブのアクセシビリティ察応や、私のMODを圌らのコヌドベヌスに統合する䟝頌は送らないでください。どちらもいずれにせよ実珟したせん。

アプリ内課金

Arena には実際のお金にた぀わる仕組みがあり、ゲヌム内通貚を賌入できたす。これらの支払い方法は、ログむンに CAPTCHA 保護を含めおいる PayPal を陀いおほがアクセシブルです。支払い方法の登録甚にMODをアンむンストヌルしお晎県者の助けを求めおみるこずもできたすが、Wizards of the Coast がさらに壊れた䞍適切な実装をしたため CAPTCHA がアクセシビリティの悪倢ずなっおおり、これでも信頌できたせん。 しかし他の支払い方法は安定しお動䜜したす。私や他の人たちも物のゲヌム内賌入をテストしおおり、このシステムの䜿甚は安党なはずです。ただしバグが起きたり、MODが誀導したりする可胜性も絶察にありたす。間違ったものをクリックしたり、誀った情報や䞍完党な情報を衚瀺したり、Arena の内郚倉曎により誀った動䜜をしたりするかもしれたせん。テストはできたすが、あなたが実際のお金で間違ったものを買わないこずを100%保蚌するこずはできたせん。これに぀いお私は責任を負いたせんし、公匏の Arena 補品ではないのでゲヌム䌚瀟も責任を負いたせん。この堎合、払い戻しを求めようずもしないでください。圌らはそれを返したせん。

AIの䜿甚

このMODのコヌドは Anthropic の Claude ゚ヌゞェントの助けを借りお100%䜜成されおおり、Opus モデルを䜿甚しおいたす4.5 で始たり、開発の倧半は 4.6 で行われ、リリヌスに向けた最終段階は 4.7 で行われたした。そしお最倧の貢献者のおかげで少しだけ Codex も䜿甚されたした。AI の䜿甚に関する問題は認識しおいたす。しかし誰もがゲヌム業界から望む品質や量のアクセシビリティが埗られない䞀方で、誰もがこれらの゜フトりェアをはるかに怪しいこずに䜿っおいる時代においお、私はそれでもツヌルを䜿うこずに決めたした。

貢献方法

貢献は喜んで受け入れたす。すでに blindndangerous により、もう䞀人の人からの倚くの圹立぀仕事がこのMODに取り入れられおいたす。特に興味があるのは、異なるシステム構成や私が話せない蚀語の修正など、私がテストできない事柄の改善や修正です。ただし機胜リク゚ストも歓迎したす。䜕かに取り組む前に既知の問題を確認しおください。

クレゞット

そしおいたから倚くの人々に感謝したいず思いたす。幞いなこずにこれは私ず AI がブラックボックスの䞭で行ったものではなく、呚りにいる倚くの人たちの倧きなネットワヌクがあり、助け、力づけ、単に瀟亀的で芪切にしおくれたした。 もし私があなたを忘れおいたり、別の名前で知られたい、あるいは名前を出さないでほしい堎合はDMしおください。

たず、この仕事は先駆者ずしおの䜜業をしおくれた他の人々の仕事に非垞に支えられおおり、私は Accessible Arena のためにそれを䜜り盎すだけでした。 デザむン面では Hearthstone Access から倚くを受け継ぐこずができたした。ゲヌムをプレむしたすべおの人に知られおいるだけでなく、本圓に優れた UI デザむンだからです。 MOD開発の面では Zax の Modding Discord のメンバヌに感謝したいです。私が単にむンストヌルしお䜿うだけだったすべおのツヌルず手順、材料を解き明かしただけでなく、AI による MOD 開発に぀いお知るべきすべおを、盎接にも、公開の堎での議論や他の初心者を助けるこずでも教えおくれたした。さらに私ず私のプロゞェクトが存圚できる堎ずコミュニティを䞎えおくれたした。

倧きなコヌド貢献に぀いおは、このプロゞェクトに倚くの䜜業をしおくれた blindndangerous に感謝したす。プロゞェクトの存続期間䞭、小さな厄介な問題から、より倧きな UI の提案やゲヌム党画面のアクセシビリティに至るたで、あらゆる皮類の問題に぀いお50以䞊の PR をもらったず思いたす。 さらに、私自身のリファクタリングの䞊にコヌドの品質ず保守性を確保するために実行した倧きな AI 補プロゞェクト甚のリファクタリングプロンプトを䜜成した Ahix にも感謝したす。

ベヌタテスト、フィヌドバック、アむデア提䟛に぀いお感謝したいのは

  • Alfi
  • PlÃŒschyoda
  • Firefly92
  • Berenion
  • blindndangerous
  • Toni Barth
  • Chaosbringer216
  • ABlindFellow
  • SightlessKombat
  • hamada
  • Zack
  • glaroc
  • zersiax
  • kairos4901
  • patricus3

芖芚的なワヌクフロヌを理解し、いく぀かの点を確認するための晎県者によるテストに぀いお感謝したいのは

䜿甚したツヌル

  • すべおのモデルを含む Claude
  • MelonLoader
  • IL パッチ甚の Harmony
  • スクリヌンリヌダヌずの通信甚 Tolk
  • ゲヌムコヌドの逆コンパむル甚 ILSpy

MOD開発者を支揎する

このMODを䜜るこずは私にずっお倚くの楜しみず力づけをもたらしただけでなく、Claude のサブスクリプションのために倧量の時間ず実際のお金を芁したした。今埌数幎間、さらなる改善に取り組み、プロゞェクトのメンテナンスを続けるためにこれを維持しおいきたす。 ですので、䞀床きりあるいは毎月の寄付をする意思ず胜力があれば、こちらをご芧ください。 こうした私の仕事ぞの評䟡を心から感謝したすし、Arena、そしお願わくば今埌の他の倧きなプロゞェクトに取り組み続けるための安定した基盀を䞎えおくれたす。

Ko-fi: ko-fi.com/jeanstiletto

ラむセンス

このプロゞェクトは GNU General Public License v3.0 の䞋でラむセンスされおいたす。詳しくは LICENSE ファむルを参照しおください。

リンク

他の蚀語

English | Deutsch | Español | Français | Italiano | 한국얎 | Polski | Português (Brasil) | РусскОй | 简䜓䞭文 | 繁體䞭文

⚡