unicum.gg

unicum.gg

無料のオープンソース World of Tanks 戦績トラッカーです。プレイヤープロフィール、クランページ、ランキングを提供します。WN7、WN8、WNX に対応しています。広告はありません。

公開サイトは unicum.gg です。

ご利用ください

• プレイヤー戦績：WN8、WNX、勝率のランキング、車両ごとの記録、優等マーク
• クラン戦績：ランキング、メンバー、拠点戦、クランウォーズ
• 車両戦績：性能、マークの基準値、アップデートごとの強化と弱体化
• マップ と サーバー人口
• 公開 API：サイトが読み込むものと同じデータを OpenAPI で文書化しています

MCP サーバー

すべての API エンドポイントはリモート MCP サーバー上のツールとしても利用でき、キーは不要です。公式 MCP Registry には gg.unicum/wot-stats として登録されています。

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

技術スタック

Next.js 16、React 19、TypeScript、Drizzle 経由の PostgreSQL、Tailwind v4、shadcn/ui、Recharts。

モノレポ

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	クライアントセーフな基盤：環境変数、定数、DB スキーマ、純粋なドメイン計算と型
packages/core	サーバー専用：DB プール、Redis、cron、リポジトリ、WG データ取得機能、認証
packages/sdk	独自の公開 API 用の流暢なクライアント。OpenAPI 仕様から型を生成
apps/web	Next.js サイトと公開 API
apps/worker	単独の cron ランナー
apps/bot	Discord ボット（/player、/clan）

wargaming、shared、sdk は、それぞれのパッケージのバレルからインポートします（import { Region } from "@unicum.gg/wargaming"）。core は意図的にバレル化していません。モジュールにはインポート時の副作用（DB プール、認証シークレットのアサーション）があるため、サーバーコードでは必要なサブパスを個別にインポートします（@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 としてバックアップされるため、失われるものはありません。

3 つの WG アプリケーション ID は developers.wargaming.net で取得できます（1 つの ID を複数のリージョンで再利用できます）。

データベース

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

コントリビューション

Issue と PR を歓迎します。まず AGENTS.md をお読みください。 プロジェクトのコントリビューションガイドであり、注意が必要な点（スキーマファクトリーパターン、マイグレーションのワークフロー、cron ループ、WG データ取得、レート制限）を説明しています。

ライセンス

AGPL v3。Copyright (C) 2026 Antoine Kingue.

Wargaming.net とは提携していません。