Everloot: WoW Forever data

World of Warcraft: Forever の、オープンでプレイヤーが作るデータベースです。アドオンが目にした情報を記録し、サイトは3つのインストールから報告が一致した場合にのみ事実として示します。

Everloot はファンプロジェクトです。WoW: Forever は 2026-11-04 にリリースされます。Everloot は、初日から実際に役立つ情報を提供できるよう開発されています。ドロップ率、ベンダー価格、レシピの範囲、出現地点、タレントツリー、最新ビルドでの変更点などを確認できます。情報はプレイヤーが提供します。サイトでは各情報について、報告したインストール数と日付を表示し、誰でもその件数の根拠となる匿名レコードを確認できます。

他のサイトをスクレイピングせず、実行中のゲームに触れることもありません。アドオンはゲーム独自のアドオン API を使用し、専用のセーブファイルに書き込みます。ゲームファイルに由来する情報には、プレイヤーが確認するまで未確認のラベルが付き、ネタバレはデフォルトで非表示になります。完全なルールは docs/DATA_POLICY.md に記載されています。

everloot.app で利用できる機能

データベース。 プレイヤーのアップロードをもとに構築された、アイテム、NPC、クエスト、ベンダー、職業、オークション履歴のデータベースです。3 つのインストールから報告されるとデータが表示され、件数とデータの経過日数もあわせて確認できます。 everloot.app/database

タレント計算ツール。 あらゆるクラスのビルドを計画できます。ポイントのルール、2 つのタレントセット、取り消し機能、ゲームビルド名が付いた共有リンクを利用できます。アドオンにそのプランを読み込ませると、次に振るポイントが表示されます。 everloot.app/tools/talents

レイド編成ツール。 クラスとタレントツリーを選び、10 人、20 人、または 40 人のレイドを編成して、各グループとレイド全体が受けるバフとデバフを確認できます。編成プランはリンクに保存されます。 everloot.app/tools/raid

ワールドマップ。 ゾーンと入口の位置をゲームファイルから取得し、ゲーム内のアートを使わずに私たちが描画したマップです。everloot.app/map

変更トラッカー。 Blizzard スタッフの投稿、ホットフィックス、新しいゲームビルドを新しい順に掲載しています。元の情報へのリンクと RSS フィードもあります。everloot.app/changes

ニュース。 Everloot の最新情報と、それが Forever のプレイヤーにとって何を意味するのかを、各記事が参照した情報源とともに私たちが執筆しています。everloot.app/news

ロアアーカイブ。 Warcraft Wiki（CC BY-SA 4.0）を、種類別に閲覧したり検索したりできます。 everloot.app/lore

ギルドランキング。 レイドの攻略状況に応じたギルドランキングです。レイドごとにランキングがあります。2 人のギルドメンバーからのアップロードで撃破記録が一致すると、その撃破がカウントされます。アドオンが記録するのはギルド名のみで、キャラクター名は記録しません。 everloot.app/guilds

センサスとランキング。 アドオンのアップロードをもとに、陣営、種族、クラス、レベルを集計します。各キャラクターは 1 回だけカウントされ、グループはキャラクターが 10 人に達してから表示されます。ランキングでは、毎週最も多くプレイされているクラスと種族を確認できます。everloot.app/census · everloot.app/rankings

Everloot に質問。 自分の AI プロバイダーの API キーを使って、自然な言葉で質問できます。モデルは Everloot のデータを検索して回答し、情報源を示します。API キーはブラウザーのタブ内にとどまり、Everloot に送信されることはありません。 everloot.app/chat

アドオンのランキングとプロフィール。 リストの共有に同意した Forever プレイヤーが使っているアドオンを確認できます。3 つのインストールから報告されるまでは件数を表示しません。 everloot.app/addons/popular

ドキュメント。 ゲーム内で Everloot を使う方法や、AI アシスタントまたは自分のコードからオープンデータを利用する方法を説明します。 everloot.app/docs

市場価格。 Blizzard は Forever のオークション API を提供していないため、価格はプレイヤーがアドオンの Everloot scan ボタンから開始するオークション全件スキャンをもとにしています。サイトではレルムごとの一覧とアイテムごとの 60 日間のグラフを表示します。3 人の報告者の価格が一致すると、その日のデータが公開されます。同じ価格はゲーム内のアイテムツールチップにも表示されます。everloot.app/tools/auctions

MCP サーバー。 AI アシスタントがアーカイブを検索し、サイトに表示されるものと同じ、出典付きの情報を読み取るための 32 個のツールを提供します。アイテム、NPC、クエスト、ベンダー、職業の進行ルート、レシピのレベル範囲、オークション履歴、市場価格、ギルドの進行状況、最近の Blizzard の変更などを扱います。公開エンドポイントは読み取り専用で、レート制限があります：https://everloot.app/mcp/public。

全体の仕組み

flowchart LR
  subgraph player["Player's computer"]
    game["WoW: Forever"] --> addon["addon/<br/>Lua collector"]
    addon --> sv[("SavedVariables file")]
    sv --> companion["companion/<br/>uploader and /ask bridge"]
  end
  sv --> upload["everloot.app/upload<br/>preview, then send"]
  upload --> intake["web/ /api/intake<br/>quotas, schema checks, dedup"]
  companion --> intake
  intake --> store[("Raw uploads in R2<br/>index in Supabase")]
  store --> corpus["Corpus snapshot<br/>rebuilt every 10 minutes"]
  corpus --> rollups["Rollups<br/>a fact needs 3 installs"]
  store --> market["Market prices<br/>3 reporters a day"]
  market --> site
  market --> companion
  rollups --> site["Site pages and tools"]
  rollups --> mcp["MCP server<br/>32 tools"]
  wiki["Warcraft Wiki dump<br/>CC BY-SA 4.0"] --> kb["kb/<br/>import, provenance, snapshot"]
  files["Game files<br/>maintainer extraction"] --> gamedata["Reviewed game-data files<br/>unconfirmed"]
  kb --> site
  kb --> mcp
  gamedata --> site
  assistant["AI assistants"] --> mcp

部分	役割
addon/	ゲーム内コレクター（Lua）と /ask コマンド
web/	everloot.app：データベース、ツール、マップ、変更トラッカー、ロアアーカイブ、アップロードページ、MCP エンドポイント（Vercel 上の Next.js）
kb/	ナレッジベース：ロアのインポート、公開リリース、ゲームファイル抽出ツール、MCP サーバー（TypeScript、SQLite）
companion/	コマンドラインアップローダー：ファイルを送信し、ゲーム内で /ask に回答し、市場価格を書き込みます
desktop/	Everloot Desktop App：インストーラー付きのトレイアプリで、同じ処理を行います
packages/protocol/	アップロードの仕様：レコードの種類、エンベロープ、制限、それらの JSON Schema。サイト、ナレッジベース、アップローダー、アドオンのテストで共有されます
supabase/	サイトのデータベーススキーマ

docs/architecture.md では、それぞれの境界と設計上の判断について詳しく説明しています。

クイックスタート

プレイヤー向け

1. CurseForge からアドオンをインストールするか、 everloot.app/addon からダウンロードして、Everloot/ をゲームの Interface/AddOns/ に展開します。
2. プレイします。ログアウトするか、/reload と入力すると保存されます。
3. WTF/Account/<account>/SavedVariables/Everloot.lua を everloot.app/upload にアップロードします。送信前にすべてをプレビューできます。

または、Everloot Desktop App (ダウンロード) をインストールしてください。ログアウトするたびにアップロードし、アイテムのツールチップに市場価格を書き込み、アドオンのインストールと更新も行えます。

新規インストールでは、オークションの記録とセンサスは有効になっています（無効にするには /everloot auctions off と /everloot census off を実行します。センサスを無効にするコマンドは、その行も削除します）。オークションハウスで「Scan this house」をクリックするまでは、スキャンは行われません。インストール済みアドオンの一覧とプレイヤーモジュールは、オンにするまで無効です（/everloot addons on、/everloot players on）。コマンドラインアップローダーで、市場価格をゲームフォルダーに書き込むこともできます（prices --game）。

開発者向け

Node 22 と Python 3.12（アドオンのテスト用）が必要です。

git clone https://github.com/Everloot/everloot.git
cd everloot
(cd kb && npm install)
cd web && npm install
npm run sample-release   # prints a KB_SNAPSHOT_PATH line: put it in web/.env.local
npm run dev              # http://localhost:3000

サンプルリリースには、作業に使えるロアページが約 35 件含まれています。ストレージが必要なページには利用できないと表示されますが、ローカル環境では想定どおりです。各部分の README にテストコマンドが記載されており、CONTRIBUTING.md には CI で実行される内容が記載されています。

AI アシスタントの利用者向け

任意の MCP クライアントをパブリックエンドポイントに接続してください。

claude mcp add --transport http everloot https://everloot.app/mcp/public

または、クライアントの設定に { "mcpServers": { "everloot": { "type": "http", "url": "https://everloot.app/mcp/public" } } } を追加してください。ドキュメントには、各ツールとその引数、すべての JSON エンドポイント、レート制限、データのクレジット表記方法が記載されています。API は /api/openapi.json（OpenAPI 3.1）で説明されており、プロトコルの JSON Schema ファイルは /schema/ にあります。

プロジェクトの状況

リリース前です。WoW: Forever のベータは 2026-10-23 に終了し、ゲームは 2026-11-04 にリリースされます。

アドオンは自動テストに合格しており、CurseForge と everloot.app/addon でアルファ版として公開されています。 ゲーム内での確認は、 docs/2026-10-08-beta-client-checklist.md、 docs/2026-10-18-addon-0.3.2-beta-checklist.md、および docs/2026-10-19-addon-0.3.3-beta-checklist.md に記載されており、 ライブサーバーが稼働するまで未完了のままです。Everloot Desktop App のビルドには、まだコード署名がありません。 ゲームファイルから読み取る情報（タレント、レイドバフ、マップ）はすべて、プレイヤーがゲーム内で確認するまで未確認として扱われます。 ビルドの監視が 30 分ごとに新しいビルドを確認し、見つかった場合はレビュー済みのプルリクエストを作成します。

次の予定は ROADMAP.md に記載されています。リリース済みの内容は CHANGELOG.md に記載されています。 アドオンの夜間プレリリース版はリリースページで公開されています。

協力方法

コードを書く必要はありません。アドオンを使ってみてアップロードすることや、誤った情報を報告することも、プルリクエストと同じくらい役に立ちます。

• 質問やアイデア：GitHub Discussions
• バグや誤ったデータ：issues
• 初めてのコード貢献：good first issue ラベル付きの issue
• チャット：Everloot Discord
• セキュリティ上の問題：SECURITY.md を確認し、公開 issue では報告しないでください

まず CONTRIBUTING.md をお読みください。署名（git commit -s）、プルリクエストのタイトル、データに関するルールについて説明しています。

ドキュメント

docs/README.md が目次です。まず確認するドキュメントは次のとおりです。

• docs/DATA_POLICY.md：公開するもの、公開しないもの、その理由
• docs/architecture.md：サービスとデータの概要
• docs/RELEASING.md：安定版と夜間リリース
• docs/sources/LEDGER.md：これまでに使用したすべての情報源
• docs/design/：日付別の設計仕様と計画

ライセンス

コード：AGPL-3.0-only、© 2026 R21 Media Group, LLC および Everloot の貢献者。 公開データ：CC BY-SA 4.0、Everloot の貢献者のクレジットを表示してください。サードパーティの素材： THIRD_PARTY.md。Everloot の名称とロゴはこれらのライセンスの対象外です： TRADEMARKS.md。

World of Warcraft は Blizzard Entertainment, Inc. の商標です。Everloot はファンプロジェクトであり、Blizzard との提携や Blizzard による公認はありません。