WindowsおよびmacOSでWorld of Warcraftのアドオンをダウンロードしてインストールする方法のガイド。
World of Warcraftではmodではなくアドオンと呼ばれており、このガイドシリーズの中でも珍しく、ゲーム側が最初からそれを受け入れるように作られているケースだ。Blizzardはアドオン用のAPI、キャラクター選択画面でのアドオン管理画面、そしてアドオンが何をしてよく何をしてはいけないかを定めた公式ポリシーを提供している。modローダーもインジェクターも、パッチを当てる必要もない。正しい場所にフォルダを置くだけで、ゲームがそれを読み込んでくれる。
今回の例として使うのはDetails! Damage Meterで、3億6700万以上のダウンロード数を誇り、ゲーム史上最もインストールされているアドオンの一つだ。
必要なもの
- Windows 10以降を搭載したPC、またはMac。どちらも完全にサポートされており、このガイドの内容はどちらでも動作する。
- Battle.netランチャー経由でインストールされたWorld of Warcraft。
- ごくわずかなディスク容量。アドオンはLuaとXMLのテキストファイル、それにたまにテクスチャが加わる程度なので、大量に集めても容量は小さい。
- 手動でインストールする場合はファイル解凍ソフト。WindowsとmacOSはどちらも
.zipをネイティブに扱える。
アドオンは公式に認められている。BlizzardはUIアドオン開発ポリシーを公開してルールを定めており、それに従ったアドオンを使う分にはBAN(アカウント停止)のリスクはない。許されていないのは、あなたの代わりにゲームをプレイする自動化であり、CurseForgeやWagoにあるアドオンでそんなことをするものは存在しない。
WoWのアドオンの仕組み
アドオンとは、Luaスクリプト、XMLレイアウトファイル、そして.tocマニフェストが入ったフォルダのことだ。WoWは起動時に特定のフォルダをスキャンし、各.tocを読み込み、見つけたものをロードする。
その裏に何かをインストールする必要はない。ゲームをフックすることも、インジェクトすることも、WoW自身のスクリプティングサンドボックスの外で動くものも一切ない。
フレーバー
ここが人々を混乱させる部分だ。なぜなら今のWoWはもはや単一のゲームではないからだ。
RetailとそれぞれのClassicラインは別々のクライアントとして動作し、アドオンフォルダもアドオンのビルドも別々になっている。CurseForgeのアドオンページにはそのアドオンが対応するフレーバーが記載されており、Details!は現在以下をカバーしている。
| Flavor | What it is |
|---|---|
| Retail | The current expansion, on the 12.x client |
| Classic | Classic Era |
| Classic TBC | The Burning Crusade Classic |
| MoP Classic | Mists of Pandaria Classic |
| Titan Reforged Classic | The newer Classic line |
間違ったフレーバーをダウンロードすると、そのアドオンがまったく表示されないか、期限切れとしてグレーアウト表示されてしまう。アドオンマネージャーを使えば、どのインストール先を指定しているかに基づいて正しいものを自動で選んでくれる。これはマネージャーを使うべき理由の一つだ。
アドオンの保存場所
各フレーバーはWoWのインストール内にそれぞれ独自のフォルダを持つ。Windowsでは、Retailは以下の場所にある。
C:\Program Files (x86)\World of Warcraft\_retail_\Interface\AddOns
macOSでは:
/Applications/World of Warcraft/_retail_/Interface/AddOns
他のフレーバーも同じ構造で、フォルダ名だけが_classic_era_や_classic_のように異なる。パブリックテストレルムをインストールしている場合は_ptr_も存在する。
すべてのアドオンはAddOnsの直下にある1つのフォルダで、アドオンと同じ名前が付けられている。Details!はDetailsという名前のフォルダとしてインストールされる。
注記 - AddOnsフォルダがまだ存在しない場合は、作成すること。このフォルダは何かがそれを必要とした時に初めて作られるものだ。
CurseForgeアプリでのインストール
最も一般的な選択肢で、CurseForgeのアドオンページもこれを前提にしている。
- CurseForgeアプリをダウンロードする。軽量なスタンドアロン版と、ゲーム内機能付きのOverwolf版がある。どちらでも構わないが、スタンドアロン版の方が軽い。Windows、macOS、Linux版がすべて用意されている。
- 起動して、WoWのインストールを検出させる。各フレーバーを個別に見つけてくれる。
- World of Warcraftセクションを開き、アドオンを追加したいフレーバーを選ぶ。
- Details! Damage Meterを検索し、Installをクリックする。
- アプリがそのフレーバー用の正しいビルドをダウンロードし、正しい
AddOnsフォルダに配置する。
このアプリはアップデートも処理してくれる。これこそが使う本当の理由だ。WoWのアドオンはコンテンツパッチのたびに壊れるため、30個を一度にアップデートできることは、他の多くのゲームよりもここでは重要になる。
WowUpでのインストール
WowUpは無料でオープンソースの、コミュニティ製アドオンマネージャーで、Windows、macOS、Linux版がある。単一サイトだけでなく複数のアドオンサイトから取得できるため、CurseForgeにないアドオンがある場合に便利だ。
- wowup.ioからWowUpをダウンロードする。
- 初回起動時にWoWのインストールをスキャンし、見つかった各フレーバーを一覧表示する。
- Get Addonsを開き、Details! Damage Meterを検索してインストールする。
- My Addonsで導入済みのものを確認し、アップデートする。
WowUpは手動でインストールしたアドオンも取り込んで、元のソースと紐付けることでアップデートを受け取れるようにしてくれる。何年も前に手動でインストールしたアドオンがフォルダにたくさん溜まっている場合、WowUpにそこを指定させれば一気に管理下に戻すことができる。
Wagoアプリでのインストール
Wago Addonsはもう一つの主要なアドオンホストで、WeakAurasやその他のインポート文字列を扱うwago.ioと同じ運営元だ。Wagoアプリはそのカタログからアドオンを管理する。
- addons.wago.io/appからアプリをダウンロードする。
- WoWのインストールを見つけさせる。
- 閲覧または検索して、インストールする。
Wagoアプリの本当の強みは、Wagoエコシステムの残りの部分にある。すでにそこからWeakAurasの文字列やUIパックをインポートしているなら、それらと一緒にアドオンも扱える一つのアプリがあるのは便利だ。
TIP - 可能な限り、同じインストールに対して2つのアドオンマネージャーを同時に動かさないこと。両方が同じフォルダを自分のものとして扱おうとするため、重複したり、中途半端に更新されたアドオンが発生してしまう。どちらか一つを選ぶこと。
手動でのインストール
知っておく価値はあるし、WoWでは実際とても簡単だ。
- CurseForgeのDetails! Damage Meterページにアクセスします。
- Filesの中から、自分のフレーバーに合ったファイルを選びます。現行拡張版であればRetailビルドです。
.zipをダウンロードします。- 展開します。
- 展開されたフォルダ
DetailsをInterface\AddOnsフォルダにコピーします。 - WoWが起動中なら再起動します。
結果は以下のようになるはずです:
World of Warcraft\_retail_\Interface\AddOns\Details\
中にはアドオンの.tocファイルとLuaファイルが入っています。
警告 - アドオンフォルダはAddOns直下に置く必要があり、フォルダ名はアドオンが期待するものと一致していなければなりません。AddOns\Details-v1.2.3\Details\のようにネストしていると読み込まれませんし、AddOns直下にLuaファイルだけを置いても同様です。一部のアドオンは1つのzipに複数のフォルダ(メインアドオンとライブラリなど)を同梱しており、その場合はすべてをAddOns内に並べて配置します。
TMC App
最後の選択肢は私たち自身のアプリですが、断っておくと、マネージャーに関してはWoWはこのガイドシリーズの中ですでに最も充実したサポートを受けているゲームです。The TMC Appはワンクリックインストール、サンドボックス(ゲームごとに名前を付けられ、独自のデプロイ方式を持つMODプロファイル)、リアルタイムのレイテンシグラフ付きサーバーブラウザ、そしてRCONを備えています。
World of Warcraftはサポートゲーム一覧には含まれていません。 CurseForge app、WowUp、Wago Appがある以上、ここではアドオン管理はすでに解決済みの問題であり、まともなツールが全くないゲームに比べれば優先度は下がります。無理にリストを水増しするより、正直にそう言っておきたいと思います。
このアプリはまだ開発の非常に初期段階にあります。 READMEでも「部分的にテスト済み」と記載されており、それは正当な表現です。もし他のゲームでこのアプリを使っていて、WoWサポートを望むのであれば、その旨を伝えることが対応を早める一番の方法です。
このアプリはgithub.com/modcommunity/tmc-appにてGPL-3.0の下でオープンソースとして公開されています。バグ報告、機能リクエスト、「このゲームをサポートしてほしい」といった要望はすべてissueトラッカーへどうぞ。プルリクエストも歓迎しており、ゲームの追加はコードではなく4つのJSONファイルで済むため、WoWサポートへの貢献は十分現実的です。
インストール方法:
- Linux:1行のコマンドのみ、root権限もパッケージマネージャも不要です。
curl -fsSL https://raw.githubusercontent.com/modcommunity/tmc-app/main/scripts/install.sh | sh
- Windows:リリースページにある
setup.exeまたはsetup.msi。ポータブル版もありますが、ランチャーへの登録やtmc://リンクハンドラーの登録は行われません。 - macOS:同じリリースページにある
.dmg。
ゲーム内でアドオンを有効化する
インストールしただけでは、まだ作業は終わっていません。
- WoWを起動し、キャラクター選択画面に進みます。
- 左下のAddOnsをクリックします。
- 自分のアドオンにチェックが入っていることを確認します。
- ワールドに入ります。
新しいアドオンは通常デフォルトで有効になっていますが、インストールしたばかりのものが表示されない場合、まず確認すべき点です。
アドオンリストはデフォルトでキャラクターごとに管理されており、Allドロップダウンで選択内容を全キャラクターに適用できます。レイドキャラにはダメージメーターを表示させ、銀行キャラには表示させたくない、というような場合に便利です。
ゲーム内に入ったら、/reloadでログアウトせずにインターフェースを再読み込みでき、アドオンファイルの変更を反映できます。一部のアドオンは独自のスラッシュコマンドを登録しており、Details!では/detailsが使えます。
設定とセーブデータ
アドオンの設定はアドオン本体とは一緒に保存されません。他のインターフェース設定と共にWTFフォルダ内に保存されます:
World of Warcraft\_retail_\WTF\Account\<ACCOUNT>\SavedVariables
キャラクターごとのデータは、その下にあるレルムおよびキャラクターフォルダに保存されます。
これには2つの利点があります。設定は全く別の場所にあるため、アドオンの更新や再インストールをしても設定が失われません。また、WTFフォルダをバックアップすればUI設定全体をバックアップできるため、大型パッチ前には行っておく価値があります。
パッチ後もアドオンを動作させ続けるには
WoWのコンテンツパッチはすべてインターフェースバージョンを更新するため、.tocが古いバージョンを指定したままのアドオンは、古いとフラグを立てられ無効化されます。
その場合の対処法:
- まずアドオンを更新する。 ほとんどの作者はパッチから数時間以内に対応ビルドを公開しており、アドオンマネージャーを使えばワンクリックで済みます。
- アドオンが未更新の場合、キャラクター選択画面のAddOns画面でLoad out of date AddOnsにチェックを入れることができます。インターフェースバージョンは単なる宣言に過ぎないため、多くの場合問題なく動作します。頻繁にエラーが出る場合は無効化して待ちましょう。
- 大型拡張パッチではより多く壊れます。 数時間ではなく、数日単位でアドオンが追いつくのを見込んでおきましょう。
ヒント - パッチ後にUIが壊れて起動した場合、すべて無効化してデフォルトUIが正常か確認し、その後バッチ単位で再有効化していくのが最速の切り分け方法です。
アンインストール
マネージャー経由の場合、アドオンリストからアンインストールすればフォルダも削除されます。
手動の場合は、Interface\AddOnsからアドオンのフォルダを削除します。
いずれの方法でも、アドオンのセーブ変数はWTF内に残ります。これは意図的な仕様で、再インストール時に設定が復元されるようにするためです。完全にまっさらな状態にしたい場合は、SavedVariablesフォルダ内の該当する.luaファイルも削除してください。
トラブルシューティング
アドオンがAddOnsリストに表示されない。 フォルダ構造が誤っています。AddOns\Details-12.1\Details\Details.tocではなく、AddOns\Details\Details.tocのようになっているか確認してください。
リストには表示されるがグレーアウトしている。 無効化されているか、古いとフラグが立っています。チェックを入れ、必要ならLoad out of date AddOnsにもチェックを入れてください。
間違ったフレーバーにインストールされた。 よくあるケースです。マネージャーが_retail_を指しているか、あるいは逆にClassicインストールを指していないか確認してください。
パッチ後にLuaエラーが大量に出る。 アドオンを更新してください。それでも改善しないものがあれば無効化し、CurseForgeページで対応ビルドを確認してください。
アドオンは読み込まれるがウィンドウが表示されない。 多くのアドオンにはロックや非表示の切り替えがあり、画面外の位置を記憶していることもあります。まずはアドオン自身のオプションを確認してください。Details!なら/detailsです。最終手段として、セーブ変数ファイルを削除してリセットしてください。
2つのマネージャーが競合し続ける。 両方が同じフォルダを管理しようとしています。どちらか一方を選び、もう一方はアンインストールしてください。
Blizzardの標準UI設定がリセットされる。 WTFから何かを削除したり移動したりしていないか確認してください。このフォルダにはアドオンのデータだけでなく、Blizzard自身の設定も保存されています。
まとめ
WoWのアドオンは、この一連のガイドの中で最も簡単なインストール作業です。ローダーは不要で、ゲーム自体に管理画面が組み込まれており、CurseForge appやWowUpのようなマネージャーを使えば、検索してインストールをクリックするだけで済みます。
実際に問題を引き起こす要因は、フレーバーとパッチの2つだけです。正しいクライアント向けにインストールしているか確認し、コンテンツパッチのたびにアドオンの更新に数分かかることを見込んでおきましょう。
このゲームほど手厚くサポートされていないゲーム向けに、私たちが用意しているのがTMC Appです。オープンソースで開発初期段階にあり、フィードバックを歓迎しています。
関連情報
- CurseForgeのWorld of Warcraftアドオン
- Wago Addons
- WowUp
- GitHub上のDetails! Damage Meterソース
- 公式World of Warcraft Discord
- TMC App
このガイドはできる限り最新の状態を保つよう努めていますが、WoWのパッチもアドオンマネージャーもどちらも変化し続けます。ここに書かれている手順が実際の状況と一致しない場合は、報告するか、このガイドのGitHubリポジトリでプルリクエストを開いてください。
ご質問やModding関連で何かサポートが必要な場合は、Discordサーバーにご参加ください!

