unicum.gg

unicum.gg

免费、开源的《坦克世界》数据追踪工具。玩家档案、军团页面、排行榜。WN7、WN8、WNX。无广告。

访问 unicum.gg。

使用方法

• 玩家数据：WN8、WNX 和胜率排行榜、单车记录、精通标记
• 军团数据：排名、成员、要塞和军团战
• 坦克数据：规格、精通标记门槛，以及各次更新中的增强和削弱
• 地图和服务器在线人数
• 公共 API：网站读取的相同数据，并附有 OpenAPI 文档

MCP 服务

每个 API 端点也都是远程 MCP 服务上的工具，无需密钥。该服务已作为 gg.unicum/wot-stats 列入官方 MCP 注册表。

{
  "mcpServers": {
    "unicum": { "url": "https://unicum.gg/api/mcp" }
  }
}

技术栈

Next.js 16、React 19、TypeScript、通过 Drizzle 使用 PostgreSQL、Tailwind v4、shadcn/ui、Recharts。

Monorepo

pnpm 工作区。依赖单向流动，不存在循环依赖：

@unicum.gg/wargaming ──▶ @unicum.gg/shared ──▶ @unicum.gg/core ──▶ apps/web (server) + apps/worker
                                                       │ HTTP API
                                @unicum.gg/sdk ◀───────┘
                                       └──▶ web front + apps/bot

包 / 应用	作用
packages/wargaming	通用 Wargaming API SDK（客户端、速率限制、完整响应类型）
packages/shared	客户端安全的基础模块：环境变量、常量、数据库架构、纯领域计算和类型
packages/core	仅限服务端：数据库连接池、redis、定时任务、仓库、WG 获取器、身份验证
packages/sdk	用于自有公共 API 的流式客户端，类型根据 OpenAPI 规范生成
apps/web	Next.js 网站和公共 API
apps/worker	独立的定时任务运行器
apps/bot	Discord 机器人（/player、/clan）

wargaming、shared 和 sdk 均从各自包的入口文件导入（import { Region } from "@unicum.gg/wargaming"）。core 有意不提供统一入口：其模块会在导入时产生副作用（数据库连接池、身份验证密钥断言），因此服务端代码会导入所需的特定子路径（@unicum.gg/core/db，……）。前端和 Discord 机器人从不导入 core；它们通过 @unicum.gg/sdk 使用 API，通过 @unicum.gg/shared 使用类型。

本地运行

pnpm install
pnpm env:init   # generates .env.local from env.ts; fill in the values
pnpm dev

pnpm env:init 会读取 env.ts，并写入包含所有必需密钥的 .env.local。如果 .env.local 已存在，脚本会先将其备份为 .env.local.<timestamp>.bak，以免丢失任何内容。

前往 developers.wargaming.net 获取三个 WG 应用 ID（同一个 ID 可用于多个区域）。

数据库

for f in apps/web/drizzle/0*.sql; do psql "$DATABASE_URL" -f "$f"; done

贡献

欢迎提交问题和 PR。请先阅读 AGENTS.md。 这是项目的贡献指南，涵盖了容易忽略的注意事项（架构工厂模式、迁移工作流、定时任务循环、WG 数据获取和速率限制）。

许可证

AGPL v3。版权所有 (C) 2026 Antoine Kingue。

与 Wargaming.net 无关联。