Everloot: WoW Forever data

一个开放的、由玩家共同构建的《魔兽世界：Forever》数据库。插件会记录你看到的内容，只有当三个安装实例报告一致时，网站才会将其确认为事实。

Everloot 是一个粉丝项目。《魔兽世界：Forever》将于 2026-11-04 发布，Everloot 旨在从首日开始就提供可靠答案：掉率、商人价格、配方范围、刷新点、天赋树，以及最新版本有哪些变化。玩家提供观察记录。网站会在每条事实旁显示报告该事实的安装实例数量和日期，任何人都可以查看这些计数背后的匿名记录。

它不会抓取其他网站，也绝不会接触正在运行的游戏。插件使用游戏自带的插件 API，并写入自己的存档文件。所有来自游戏文件的内容都会标注为未经确认，直到玩家亲自看到为止；剧透默认隐藏。完整规则请见docs/DATA_POLICY.md。

everloot.app 上的内容

数据库。 包含物品、NPC、任务、商人、专业和拍卖历史数据，均根据玩家上传的数据构建。一条数据至少由 3 个安装实例报告后才会显示，旁边会标明报告数量和数据的时间。 everloot.app/database

天赋计算器。 为任意职业规划配点方案：支持点数规则、两套天赋配置、撤销，以及会注明游戏版本的分享链接。插件可以加载该方案，并显示下一个要投入点数的位置。 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

公会排名榜。 按团队副本进度为公会排名，每个团队副本各有一个榜单。只有两名公会成员上传的数据一致时，击杀才会计入；插件记录的是公会，而非角色名称。 everloot.app/guilds

人口统计和排行榜。 根据插件上传的数据统计阵营、种族、职业和等级。每个角色只计一次；某个群体至少有 10 个角色时才会显示。排行榜展示每周最热门的职业和种族。everloot.app/census · everloot.app/rankings

询问 Everloot。 使用自己的 AI 提供商 API 密钥，用日常语言提问。模型会在 Everloot 的数据中查找答案并注明来源。密钥会留在浏览器标签页中，不会发送给 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 服务。 提供 32 个工具，让 AI 助手搜索档案并读取网站展示的同源数据，包括物品、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 桌面应用：以带安装程序的托盘应用形式执行相同任务
packages/protocol/	上传协议：记录类型、信封、限制及其 JSON Schema，供网站、知识库、上传器和插件测试共享
supabase/	网站的数据库架构

docs/architecture.md 详细介绍了各部分的边界及其背后的决策。

快速开始

玩家

1. 从 CurseForge 安装插件，或从 everloot.app/addon 下载 并将 Everloot/ 解压到游戏的 Interface/AddOns/ 中。
2. 开始游戏。退出游戏或输入 /reload 即可保存。
3. 在 everloot.app/upload 上传 WTF/Account/<account>/SavedVariables/Everloot.lua。发送前 可以预览所有内容。

或者安装 Everloot 桌面应用 (下载)：每次退出游戏后都会上传数据，为物品提示信息写入市场价格，还可以帮你安装和更新插件。

全新安装时，拍卖行采集和普查功能默认开启（输入 /everloot auctions off 和 /everloot census off 可将其关闭；关闭普查的命令也会删除其记录）。在你点击拍卖行中的“扫描此拍卖行”之前，不会扫描任何内容。已安装插件列表和玩家模块默认关闭，需手动开启（输入 /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 发布。

此插件已通过自动化测试，并以 Alpha 版本发布在 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 桌面应用的构建版本尚未进行代码签名。从游戏文件读取的所有内容（天赋、团队增益、地图）在玩家于游戏中确认之前，都会标记为未确认。构建监控每半小时检查一次是否有新构建，并在发现新构建时创建经审核的拉取请求。

后续计划见 ROADMAP.md。已发布内容见 CHANGELOG.md。插件的每夜预发布版本可在发布页面获取。

如何提供帮助

你不需要编写代码。体验插件并上传内容，或报告错误信息，都能像提交拉取请求一样提供帮助。

• 问题和想法：GitHub Discussions
• 错误和错误数据：问题
• 首次代码贡献：标记为 good first issue 的问题
• 聊天：Everloot Discord
• 安全问题：请参阅 SECURITY.md，切勿提交公开问题

请先阅读 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 无关，也未获其认可。