ElvUI アドオン：必須フォルダー、プラグイン、互換性の確認方法

ElvUI アドオンとは何か

「ElvUI アドオン」という言い方には、ElvUIのZIPに含まれるフォルダー、ElvUIを拡張するプラグイン、そしてElvUIと一緒に使える独立したWoWアドオンの3種類が混ざりがちです。配布元、更新周期、エラーの原因はそれぞれ異なります。全部を1つのパッケージだと考えると、重複ファイル、Luaエラー、更新後にElvUIが消えたように見える問題につながります。

基本パッケージには、インターフェースの基盤、設定画面、ユニットフレーム、アクションバー、チャット、ネームプレートなどが含まれます。プラグインはテーマ、プリセット、レイアウト、他アドオンとの連携を追加できますが、基本パッケージの代わりにはなりません。Details!、BigWigs、PlaterなどはElvUI用スキンがあっても別プロジェクトです。

必須となるElvUIのフォルダー

通常の現行ElvUIアーカイブには、使用中のクライアントのInterface/AddOns直下に置く3つのフォルダーがあります。ZIPやGitHubの外側にあるラッパーフォルダーは、最終的なAddOnsフォルダーではありません。各フォルダー内のTOCファイルをWoWが直接見られる深さにしてください。

名前が同じだからといって、別リリースのフォルダーを組み合わせないでください。ElvUI本体、ライブラリ、設定画面は1つのリリースとして公開されています。1つだけ古い場合、設定項目の欠落や依存関係の警告、プロファイルに見えるエラーが発生します。

任意のプラグインと外部アドオン

任意プラグインは、テーマ、インストーラー、プロファイル管理、特定アドオンとの連携を追加したいときに役立ちます。ToxiUIはElvUIの上に構築されたプラグイン兼プリセットの一例です。したがって互換性のあるElvUI本体が先に必要であり、本体の代わりにはなりません。別ページのToxiUIガイドで個別の要件を確認できます。

外部アドオンはさらに広い分類です。ダメージメーター、ボスMOD、ネームプレート、メディアパックなどにはElvUI用のスキンやプロファイルがあっても、作者、配布元、更新方法は独立しています。公式サイト、GitHub、CurseForgeなど、出所を確認できるページから入手してください。ファイル名にElvUIと書かれているだけでは公式とは限りません。

フォルダーを間違えずに導入する手順

アドオンのコードを置き換える前にWorld of Warcraftを終了します。すでに動作する画面がある場合はElvUIプロファイルをエクスポートし、WTFフォルダーをコピーしてください。保存変数は通常残りますが、プラグインがプロファイルを変更した場合や、別のクライアントを選んだ場合に戻せます。

RetailとClassicのフォルダー名はElvUIインストールガイドで確認できます。最後のパスは.../Interface/AddOns/ElvUI/、.../ElvUI_Libraries/、.../ElvUI_Options/のようになります。.../AddOns/ElvUI-v15.18/ElvUI/のようにラッパーが1段増えた状態は避けてください。

1. 1

   確認できるリリースを選ぶ

   Tukuiの配布または一致する公開Gitタグを使い、異なるElvUIリリースのフォルダーを混ぜません。

2. 2

   設定をバックアップする

   現在のプロファイルをエクスポートし、WTFをコピーしてからファイルを変更します。

3. 3

   アーカイブを展開する

   ElvUI、ElvUI_Libraries、ElvUI_Optionsを見つけ、必要なら外側のラッパーだけを外します。

4. 4

   3つの基本フォルダーをコピーする

   使用中のRetailまたはClassicのInterface/AddOns直下に3つを置きます。

5. 5

   任意のプロジェクトを1つずつ追加する

   本体を確認してからプラグインや外部アドオンを追加し、原因を追跡しやすくします。

導入後に確認する互換性チェック

インストールできても、起動するクライアントと合っているとは限りません。キャラクター選択画面のアドオン一覧、RetailまたはClassicの正しいパス、依存関係の表示を確認してからプロファイルを変更します。ElvUIが一覧に出ない場合は、壊れたプロファイルよりもパスの深さ、無効化、クライアント違いを疑います。

任意プロジェクトを追加した直後にLuaエラーが出たら、最後に追加したプラグインを先に無効にしてリロードします。その後、本体と外部アドオンをそれぞれの配布元から更新してください。WTFをすぐ削除したり、古いフォルダーへ新しいコードを何度も重ねたりするより安全です。

安全な更新と削除の方法

バックアップ後にアドオンフォルダーをクリーンに置き換えるのが基本です。古いコードと新しいコードを混ぜない理由はElvUI更新ガイドで説明しています。通常の更新でWTFを削除する必要はありません。保存変数が入っているため、意図的に初期化するときだけ削除してください。

プラグインを削除するときは、先に通常のElvUIプロファイルへ切り替え、キャラクター画面で無効にして本体だけを確認します。その後、そのプロジェクトのフォルダーだけを削除します。テーマが残る場合はプロファイルが選択されたままかもしれません。プロファイルのインポートやバックアップはElvUIプロファイルガイドを参照してください。

• エクスポートしたプロファイルとWTFの完全なバックアップを残す。
• 古いコードと新しいコードを混ぜず、対応するフォルダーを置き換える。
• ElvUI、プラグイン、外部アドオンを別プロジェクトとして更新する。
• 多くの任意アドオンを同時に有効にする前に本体を確認する。
• 出所を確認できないミラーや実行ファイルを公式と呼ばない。