Merge branch 'main' of https://github.com/blitzkit/blitzkit

* New translations en.json (French)

* New translations en.json (Spanish)

* New translations en.json (Japanese)

* New translations en.json (Polish)

* New translations en.json (Portuguese)

* New translations en.json (Russian)

* New translations en.json (Ukrainian)

* New translations en.json (Chinese Simplified)

.github/workflows/assets.yml

@@ -0,0 +1,153 @@
+name: Build Assets
+
+on:
+  push:
+    branches: main
+
+  workflow_dispatch:
+    inputs:
+      cdn_branch:
+        type: string
+        required: false
+        default: main
+        description: What CDN branch to write to
+      zip_url:
+        type: string
+        required: false
+        description: ZIP URL to download instead of Steam client
+      zip_root:
+        type: string
+        required: false
+        description: Root dir of ZIP which houses the executable and Data dir
+
+  schedule:
+    - cron: '0 2 * * *'
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}-${{ github.event.inputs.cdn_branch }}
+  cancel-in-progress: true
+
+env:
+  DISCORD_CLIENT_ID: ${{ secrets.DISCORD_CLIENT_ID }}
+  GH_TOKEN: ${{ secrets.GH_TOKEN }}
+  DISCORD_TOKEN: ${{ secrets.DISCORD_TOKEN }}
+  DATABASE_URL: ${{ secrets.DATABASE_URL }}
+  VIDEOS_SHEET: ${{ secrets.VIDEOS_SHEET }}
+  GOOGLE_APPLICATION_CREDENTIALS: ${{ secrets.GOOGLE_APPLICATION_CREDENTIALS }}
+  WOTB_GLOSSARY: ${{ secrets.WOTB_GLOSSARY }}
+  WOTB_DLC_CDN: ${{ secrets.WOTB_DLC_CDN }}
+  PUBLIC_WARGAMING_APPLICATION_ID: ${{ secrets.PUBLIC_WARGAMING_APPLICATION_ID }}
+  PUBLIC_ASSET_REPO: blitzkit/assets
+  PUBLIC_ASSET_BRANCH: main
+  WOTB_GLOSSARY_DOMAIN: ${{ secrets.WOTB_GLOSSARY_DOMAIN }}
+  WOTB_GLOSSARY_PATH: ${{ secrets.WOTB_GLOSSARY_PATH }}
+  PUBLIC_PROMOTE_OPENTEST: ${{ secrets.PUBLIC_PROMOTE_OPENTEST }}
+  ALLOW_ROBOTS: true
+  PUBLIC_GOOGLE_TAG_MANAGER_ID: ${{ secrets.PUBLIC_GOOGLE_TAG_MANAGER_ID }}
+  PUBLIC_GOOGLE_ANALYTICS_PROPERTY_ID: ${{ secrets.PUBLIC_GOOGLE_ANALYTICS_PROPERTY_ID }}
+  PUBLIC_PATREON_CLIENT_ID: ${{ secrets.PUBLIC_PATREON_CLIENT_ID }}
+  PUBLIC_PATREON_REDIRECT_URI: ${{ secrets.PUBLIC_PATREON_REDIRECT_URI }}
+  PATREON_CLIENT_SECRET: ${{ secrets.PATREON_CLIENT_SECRET }}
+  PUBLIC_NITROPAY_ID: ${{ secrets.PUBLIC_NITROPAY_ID }}
+  PUBLIC_DEBUG_MISSING_I18N: false
+  PUBLIC_DISCORD_SERVER_ID: ${{ secrets.PUBLIC_DISCORD_SERVER_ID }}
+  PUBLIC_ASSET_FAST_USER: blitzkit
+  PUBLIC_ASSET_FAST_REPO: assets
+  PUBLIC_ASSET_BASE: ${{ secrets.PUBLIC_ASSET_BASE }}
+
+jobs:
+  download_client:
+    name: Download client
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: (ZIP) Maximize build space
+        if: github.event.inputs.zip_url != ''
+        uses: easimon/maximize-build-space@master
+        with:
+          root-reserve-mb: 512
+          swap-size-mb: 1024
+          remove-dotnet: 'true'
+
+      - uses: actions/checkout@v4
+        with:
+          submodules: recursive
+          token: ${{ secrets.GH_TOKEN }}
+
+      - name: (Steam) Setup bun
+        uses: oven-sh/setup-bun@v1
+        if: github.event.inputs.zip_url == ''
+
+      - name: (Steam) Install dependencies
+        if: github.event.inputs.zip_url == ''
+        run: bun install
+
+      - name: (Steam) Setup DepotDownloader
+        if: github.event.inputs.zip_url == ''
+        run: bun run setup:depotdownloader
+
+      - name: (Steam) Download client
+        if: github.event.inputs.zip_url == ''
+        run: |
+          chmod +x ./temp/depotDownloader/DepotDownloader
+          ./temp/depotDownloader/DepotDownloader -q -os windows -app 444200 -username ${{ secrets.DEPOT_DOWNLOADER_USERNAME }} -password "${{ secrets.DEPOT_DOWNLOADER_PASSWORD }}"
+
+      - name: (Steam) Apply patches
+        if: github.event.inputs.zip_url == ''
+        run: bun setup:patches --depot
+
+      - name: (ZIP) Download client
+        if: github.event.inputs.zip_url != ''
+        env:
+          ZIP_URL: ${{ github.event.inputs.zip_url }}
+          ZIP_ROOT: ${{ github.event.inputs.zip_root }}
+        run: |
+          wget -q -O client.zip $ZIP_URL
+          unzip -q client.zip -d client
+          rm client.zip
+          mkdir -p depots/444202/0
+          mv client/$ZIP_ROOT/* depots/444202/0
+
+      - name: Archive depots
+        uses: actions/upload-artifact@v4
+        with:
+          name: depots
+          path: depots
+
+  build_assets:
+    name: Build assets
+    runs-on: ubuntu-latest
+    needs: download_client
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: recursive
+          token: ${{ secrets.GH_TOKEN }}
+
+      - name: Setup bun
+        uses: oven-sh/setup-bun@v1
+
+      - name: Install dependencies
+        run: bun install
+
+      - name: Lint
+        run: bun run lint:website
+
+      - name: Download depots
+        uses: actions/download-artifact@v4
+        with:
+          name: depots
+          path: depots
+
+      - name: AppArmor hack
+        run: echo 0 | sudo tee /proc/sys/kernel/apparmor_restrict_unprivileged_userns
+
+      - name: Start server and build assets
+        run: |
+          bun dev:website --verbosepa & 
+          SERVER_PID=$!
+
+          bun run build:assets --all-targets --depot --production
+
+          kill $SERVER_PID || true

.github/workflows/averages.yml

@@ -0,0 +1,49 @@
+name: Averages
+
+on:
+  workflow_dispatch:
+  schedule:
+    - cron: '0 8 * * *'
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+env:
+  PUBLIC_ASSET_REPO: ${{ secrets.PUBLIC_ASSET_REPO }}
+  PUBLIC_WARGAMING_APPLICATION_ID: ${{ secrets.PUBLIC_WARGAMING_APPLICATION_ID }}
+  PUBLIC_ASSET_FAST_USER: ${{ secrets.PUBLIC_ASSET_FAST_USER }}
+  PUBLIC_ASSET_FAST_REPO: ${{ secrets.PUBLIC_ASSET_FAST_REPO }}
+  PUBLIC_PROMOTE_OPENTEST: ${{ secrets.PUBLIC_PROMOTE_OPENTEST }}
+  ALLOW_ROBOTS: 'true'
+  WOTB_GLOSSARY: ${{ secrets.WOTB_GLOSSARY }}
+  PUBLIC_GOOGLE_TAG_MANAGER_ID: ${{ secrets.PUBLIC_GOOGLE_TAG_MANAGER_ID }}
+  PUBLIC_GOOGLE_ANALYTICS_PROPERTY_ID: ${{ secrets.PUBLIC_GOOGLE_ANALYTICS_PROPERTY_ID }}
+  GOOGLE_APPLICATION_CREDENTIALS: ${{ secrets.GOOGLE_APPLICATION_CREDENTIALS }}
+  WOTB_GLOSSARY_DOMAIN: ${{ secrets.WOTB_GLOSSARY_DOMAIN }}
+  WOTB_GLOSSARY_PATH: ${{ secrets.WOTB_GLOSSARY_PATH }}
+  PUBLIC_DISCORD_SERVER_ID: ${{ secrets.PUBLIC_DISCORD_SERVER_ID }}
+  PUBLIC_ASSET_BASE: ${{ secrets.PUBLIC_ASSET_BASE }}
+  PUBLIC_BRANCH: ${{ secrets.PUBLIC_BRANCH }}
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+      - uses: oven-sh/setup-bun@v1
+
+      - name: Install dependencies
+        run: bun install
+
+      - name: Build averages
+        env:
+          PUBLIC_ASSET_BRANCH: main
+          DISCORD_CLIENT_ID: ${{ secrets.DISCORD_CLIENT_ID }}
+          GH_TOKEN: ${{ secrets.GH_TOKEN }}
+          DISCORD_TOKEN: ${{ secrets.DISCORD_TOKEN }}
+          DATABASE_URL: ${{ secrets.DATABASE_URL }}
+          VIDEOS_SHEET: ${{ secrets.VIDEOS_SHEET }}
+          GOOGLE_APPLICATION_CREDENTIALS: ${{ secrets.GOOGLE_APPLICATION_CREDENTIALS }}
+        run: bun run build:averages --production

.github/workflows/build-bot.yml

@@ -0,0 +1,33 @@
+name: Build Bot
+
+on:
+  push:
+  workflow_dispatch:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  build:
+    name: Build
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+      - uses: oven-sh/setup-bun@v1
+
+      - name: Install dependencies
+        run: bun install
+
+      - name: Build Prisma
+        run: bun run build:prisma
+
+      - name: Build bot
+        run: bun run build:bot
+
+      - name: Archive build
+        uses: actions/upload-artifact@v4
+        with:
+          name: bot
+          path: dist/bot

.github/workflows/cd-assets.yml

@@ -1,67 +0,0 @@
-name: CD Build Assets
-
-on:
-  push:
-    branches: main
-  workflow_dispatch:
-  schedule:
-    - cron: '0 2 * * *'
-
-concurrency:
-  group: ${{ github.workflow }}-${{ github.ref }}
-  cancel-in-progress: true
-
-jobs:
-  build:
-    runs-on: windows-latest
-
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
-        with:
-          submodules: recursive
-          token: ${{ secrets.GH_TOKEN }}
-
-      - name: Use node
-        uses: actions/setup-node@v4
-        with:
-          node-version: 18
-          cache: 'npm'
-
-      - name: Install Yarn
-        run: npm install --location=global yarn
-
-      - name: Use node_modules cache
-        uses: actions/cache@v3
-        with:
-          path: '**/node_modules'
-          key: ${{ runner.os }}-modules-${{ hashFiles('**/yarn.lock') }}
-
-      - name: Install dependencies
-        run: yarn
-
-      - name: Add fixed sharp
-        run: yarn add [email protected] --ignore-engines
-
-      - name: Setup DepotDownloader
-        run: yarn setup:depotdownloader
-
-      - name: Run DepotDownloader
-        run: ./temp/depotDownloader/DepotDownloader.exe -app 444200 -username ${{ secrets.DEPOT_DOWNLOADER_USERNAME }} -password "${{ secrets.DEPOT_DOWNLOADER_PASSWORD }}"
-
-      - name: Apply patches
-        run: |
-          $env:GH_TOKEN = "${{ secrets.GH_TOKEN }}"
-          $env:DISCORD_TOKEN = "${{ secrets.DISCORD_TOKEN }}"
-          $env:DATABASE_URL = "${{ secrets.DATABASE_URL }}"
-          $env:WOTB_DLC_CDN = "${{ secrets.WOTB_DLC_CDN }}"
-          yarn setup:patches --depot
-
-      - name: Build assets
-        run: |
-          $env:GH_TOKEN = "${{ secrets.GH_TOKEN }}"
-          $env:DISCORD_TOKEN = "${{ secrets.DISCORD_TOKEN }}"
-          $env:DATABASE_URL = "${{ secrets.DATABASE_URL }}"
-          $env:VIDEOS_SHEET = "${{ secrets.VIDEOS_SHEET }}"
-          $env:GOOGLE_APPLICATION_CREDENTIALS = "${{ secrets.GOOGLE_APPLICATION_CREDENTIALS }}"
-          yarn build:assets --all-targets --depot ${{ github.ref == 'refs/heads/main' && '--production' || '' }}

.github/workflows/cd-docs.yml

@@ -1,60 +0,0 @@
-name: CD Docs
-
-on:
-  push:
-    branches: main
-
-jobs:
-  build:
-    name: Build
-    runs-on: ubuntu-latest
-    permissions:
-      pages: write
-      id-token: write
-
-    environment:
-      name: github-pages
-      url: ${{ steps.deployment.outputs.page_url }}
-
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Use node
-        uses: actions/setup-node@v4
-        with:
-          node-version: 18
-          cache: 'npm'
-
-      - name: Install Yarn
-        run: npm install --location=global yarn
-
-      - name: Use node_modules cache
-        uses: actions/cache@v3
-        with:
-          path: '**/node_modules'
-          key: ${{ runner.os }}-modules-${{ hashFiles('**/yarn.lock') }}
-
-      - name: Install dependencies
-        run: yarn
-
-      - name: Build docs
-        run: yarn build:docs
-
-      - name: Configure pages
-        uses: actions/configure-pages@v2
-
-      - name: Upload pages artifact
-        uses: actions/upload-pages-artifact@v1
-        with:
-          path: dist/docs
-
-      - name: Deploy
-        id: deployment
-        uses: actions/deploy-pages@v1
-
-      - name: Archive build
-        uses: actions/upload-artifact@v4
-        with:
-          name: dist
-          path: docs/.vitepress/dist

.github/workflows/cd-host.yml

@@ -1,36 +0,0 @@
-name: CD Host
-
-on:
-  push:
-    branches: main
-  schedule:
-    - cron: '0 */5 * * *'
-  workflow_dispatch:
-  release:
-    types: [created, published, released, edited]
-
-concurrency:
-  group: ${{ github.workflow }}-${{ github.ref }}
-  cancel-in-progress: true
-
-jobs:
-  host:
-    runs-on: ubuntu-latest
-
-    steps:
-      - name: Use node
-        uses: actions/setup-node@v4
-        with:
-          node-version: 18
-
-      - name: Download release assets
-        run: |
-          DOWNLOAD_URL=$(curl -s https://api.github.com/repos/tresabhi/blitzkit/releases/latest \
-            | grep "browser_download_url.*bot.zip" \
-            | cut -d : -f 2,3 \
-            | tr -d \")
-          curl -L -o bot.zip $DOWNLOAD_URL
-          unzip bot.zip
-
-      - name: Run bot
-        run: NODE_ENV=production GH_TOKEN=${{ secrets.GH_TOKEN }} DISCORD_TOKEN=${{ secrets.DISCORD_TOKEN }} DATABASE_URL=${{ secrets.DATABASE_URL }} node --enable-source-maps index.cjs

.github/workflows/cd-rating-asia.yml

@@ -1,34 +0,0 @@
-name: CD Rating Asia
-
-on:
-  schedule:
-    - cron: '0 17 * * *'
-
-jobs:
-  host:
-    runs-on: ubuntu-latest
-
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Use node
-        uses: actions/setup-node@v4
-        with:
-          node-version: 18
-          cache: 'npm'
-
-      - name: Install Yarn
-        run: npm install --location=global yarn
-
-      - name: Use node_modules cache
-        uses: actions/cache@v3
-        with:
-          path: '**/node_modules'
-          key: ${{ runner.os }}-modules-${{ hashFiles('**/yarn.lock') }}
-
-      - name: Install dependencies
-        run: yarn
-
-      - name: Generate leaderboard
-        run: GH_TOKEN=${{ secrets.GH_TOKEN }} DISCORD_TOKEN=${{ secrets.DISCORD_TOKEN }} DATABASE_URL=${{ secrets.DATABASE_URL }} yarn publish:ratingleaderboard --region=asia --target=midnight --production

.github/workflows/cd-rating-eu.yml

@@ -1,34 +0,0 @@
-name: CD Rating Europe
-
-on:
-  schedule:
-    - cron: '0 23 * * *'
-
-jobs:
-  host:
-    runs-on: ubuntu-latest
-
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Use node
-        uses: actions/setup-node@v4
-        with:
-          node-version: 18
-          cache: 'npm'
-
-      - name: Install Yarn
-        run: npm install --location=global yarn
-
-      - name: Use node_modules cache
-        uses: actions/cache@v3
-        with:
-          path: '**/node_modules'
-          key: ${{ runner.os }}-modules-${{ hashFiles('**/yarn.lock') }}
-
-      - name: Install dependencies
-        run: yarn
-
-      - name: Generate leaderboard
-        run: GH_TOKEN=${{ secrets.GH_TOKEN }} DISCORD_TOKEN=${{ secrets.DISCORD_TOKEN }} DATABASE_URL=${{ secrets.DATABASE_URL }} yarn publish:ratingleaderboard --region=eu --target=midnight --production

.github/workflows/cd-rating-latest.yml

@@ -1,34 +0,0 @@
-name: CD Rating Latest
-
-on:
-  schedule:
-    - cron: '0 0 * * *'
-
-jobs:
-  host:
-    runs-on: ubuntu-latest
-
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Use node
-        uses: actions/setup-node@v4
-        with:
-          node-version: 18
-          cache: 'npm'
-
-      - name: Install Yarn
-        run: npm install --location=global yarn
-
-      - name: Use node_modules cache
-        uses: actions/cache@v3
-        with:
-          path: '**/node_modules'
-          key: ${{ runner.os }}-modules-${{ hashFiles('**/yarn.lock') }}
-
-      - name: Install dependencies
-        run: yarn
-
-      - name: Generate all leaderboards
-        run: GH_TOKEN=${{ secrets.GH_TOKEN }} DISCORD_TOKEN=${{ secrets.DISCORD_TOKEN }} DATABASE_URL=${{ secrets.DATABASE_URL }} yarn publish:ratingleaderboard --region=na,asia,eu --target=latest --production

.github/workflows/cd-rating-na.yml

@@ -1,34 +0,0 @@
-name: CD Rating North America
-
-on:
-  schedule:
-    - cron: '0 5 * * *'
-
-jobs:
-  host:
-    runs-on: ubuntu-latest
-
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Use node
-        uses: actions/setup-node@v4
-        with:
-          node-version: 18
-          cache: 'npm'
-
-      - name: Install Yarn
-        run: npm install --location=global yarn
-
-      - name: Use node_modules cache
-        uses: actions/cache@v3
-        with:
-          path: '**/node_modules'
-          key: ${{ runner.os }}-modules-${{ hashFiles('**/yarn.lock') }}
-
-      - name: Install dependencies
-        run: yarn
-
-      - name: Generate leaderboard
-        run: GH_TOKEN=${{ secrets.GH_TOKEN }} DISCORD_TOKEN=${{ secrets.DISCORD_TOKEN }} DATABASE_URL=${{ secrets.DATABASE_URL }} yarn publish:ratingleaderboard --region=na --target=midnight --production

.github/workflows/ci-build-bot.yml

@@ -1,46 +0,0 @@
-name: CI Build Bot
-
-on: push
-
-concurrency:
-  group: ${{ github.workflow }}-${{ github.ref }}
-  cancel-in-progress: true
-
-jobs:
-  build:
-    name: Build
-    runs-on: ubuntu-latest
-
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Use node
-        uses: actions/setup-node@v4
-        with:
-          node-version: 18
-          cache: 'npm'
-
-      - name: Install Yarn
-        run: npm install --location=global yarn
-
-      - name: Use node_modules cache
-        uses: actions/cache@v3
-        with:
-          path: '**/node_modules'
-          key: ${{ runner.os }}-modules-${{ hashFiles('**/yarn.lock') }}
-
-      - name: Install dependencies
-        run: yarn
-
-      - name: Build Prisma
-        run: yarn prisma generate
-
-      - name: Build
-        run: yarn build:bot --production
-
-      - name: Archive build
-        uses: actions/upload-artifact@v4
-        with:
-          name: bot
-          path: dist/bot

.github/workflows/ci-build-docs.yml

@@ -1,43 +0,0 @@
-name: CI Build Docs
-
-on: push
-
-concurrency:
-  group: ${{ github.workflow }}-${{ github.ref }}
-  cancel-in-progress: true
-
-jobs:
-  build:
-    name: Build
-    runs-on: ubuntu-latest
-
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Use node
-        uses: actions/setup-node@v4
-        with:
-          node-version: 18
-          cache: 'npm'
-
-      - name: Install Yarn
-        run: npm install --location=global yarn
-
-      - name: Use node_modules cache
-        uses: actions/cache@v3
-        with:
-          path: '**/node_modules'
-          key: ${{ runner.os }}-modules-${{ hashFiles('**/yarn.lock') }}
-
-      - name: Install dependencies
-        run: yarn
-
-      - name: Build
-        run: yarn build:docs
-
-      - name: Archive build
-        uses: actions/upload-artifact@v4
-        with:
-          name: docs
-          path: dist/docs

.github/workflows/ci-build-website.yml

@@ -1,43 +0,0 @@
-name: CI Build Website
-
-on: push
-
-concurrency:
-  group: ${{ github.workflow }}-${{ github.ref }}
-  cancel-in-progress: true
-
-jobs:
-  build:
-    name: Build
-    runs-on: ubuntu-latest
-
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Use node
-        uses: actions/setup-node@v4
-        with:
-          node-version: 18
-          cache: 'npm'
-
-      - name: Install Yarn
-        run: npm install --location=global yarn
-
-      - name: Use node_modules cache
-        uses: actions/cache@v3
-        with:
-          path: '**/node_modules'
-          key: ${{ runner.os }}-modules-${{ hashFiles('**/yarn.lock') }}
-
-      - name: Install dependencies
-        run: yarn
-
-      - name: Build
-        run: yarn build:website
-
-      - name: Archive build
-        uses: actions/upload-artifact@v4
-        with:
-          name: website
-          path: dist/website

.github/workflows/discover-ids.yml

@@ -0,0 +1,32 @@
+name: Discover IDs
+
+on:
+  workflow_dispatch:
+  schedule:
+    - cron: '0 0 * * 1'
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+env:
+  DISCORD_TOKEN: ${{ secrets.DISCORD_TOKEN }}
+  GH_TOKEN: ${{ secrets.GH_TOKEN }}
+  DATABASE_URL: ${{ secrets.DATABASE_URL }}
+  PUBLIC_ASSET_BRANCH: ${{ secrets.PUBLIC_ASSET_BRANCH }}
+  PUBLIC_ASSET_REPO: ${{ secrets.PUBLIC_ASSET_REPO }}
+  PUBLIC_WARGAMING_APPLICATION_ID: ${{ secrets.PUBLIC_WARGAMING_APPLICATION_ID }}
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+      - uses: oven-sh/setup-bun@v1
+
+      - name: Install dependencies
+        run: bun install
+
+      - name: Discover IDs
+        run: bun build:ids --production

.github/workflows/host-bot.yml

@@ -0,0 +1,52 @@
+name: Host Bot
+
+on:
+  push:
+    branches: main
+  schedule:
+    - cron: '0 */5 * * *'
+  workflow_dispatch:
+  release:
+    types: [created, published, released, edited]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+env:
+  DISCORD_TOKEN: ${{ secrets.DISCORD_TOKEN }}
+  DISCORD_CLIENT_ID: ${{ secrets.DISCORD_CLIENT_ID }}
+  DATABASE_URL: ${{ secrets.DATABASE_URL }}
+  PUBLIC_ASSET_REPO: ${{ secrets.PUBLIC_ASSET_REPO }}
+  PUBLIC_ASSET_BRANCH: ${{ secrets.PUBLIC_ASSET_BRANCH }}
+  PUBLIC_WARGAMING_APPLICATION_ID: ${{ secrets.PUBLIC_WARGAMING_APPLICATION_ID }}
+  PUBLIC_ASSET_FAST_USER: ${{ secrets.PUBLIC_ASSET_FAST_USER }}
+  PUBLIC_ASSET_FAST_REPO: ${{ secrets.PUBLIC_ASSET_FAST_REPO }}
+
+jobs:
+  host:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: oven-sh/setup-bun@v1
+      #        with:
+      #          bun-version: 1.1.33
+
+      - name: Download release assets
+        run: |
+          DOWNLOAD_URL=$(curl -s https://api.github.com/repos/blitzkit/blitzkit/releases/latest \
+            | grep "browser_download_url.*bot.zip" \
+            | cut -d : -f 2,3 \
+            | tr -d \")
+          curl -L -o bot.zip $DOWNLOAD_URL
+          mkdir -p dist/bot
+          unzip bot.zip -d dist/bot
+
+      - name: Install sharp
+        run: bun init -y && bun add sharp
+
+      - name: Move directories
+        run: mv dist/bot/prisma .
+
+      - name: Run bot
+        run: bun run dist/bot/main.js

.github/workflows/rating-asia.yml

@@ -0,0 +1,41 @@
+name: Rating Asia
+
+on:
+  workflow_dispatch:
+  schedule:
+    - cron: '0 17 * * *'
+
+jobs:
+  host:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+      - uses: oven-sh/setup-bun@v1
+
+      - name: Install dependencies
+        run: bun install
+
+      - name: Generate leaderboard
+        env:
+          PUBLIC_ASSET_BRANCH: main
+          PUBLIC_ASSET_REPO: ${{ secrets.PUBLIC_ASSET_REPO }}
+          DISCORD_CLIENT_ID: ${{ secrets.DISCORD_CLIENT_ID }}
+          GH_TOKEN: ${{ secrets.GH_TOKEN }}
+          DISCORD_TOKEN: ${{ secrets.DISCORD_TOKEN }}
+          DATABASE_URL: ${{ secrets.DATABASE_URL }}
+          PUBLIC_WARGAMING_APPLICATION_ID: ${{ secrets.PUBLIC_WARGAMING_APPLICATION_ID }}
+          PUBLIC_ASSET_FAST_USER: ${{ secrets.PUBLIC_ASSET_FAST_USER }}
+          PUBLIC_ASSET_FAST_REPO: ${{ secrets.PUBLIC_ASSET_FAST_REPO }}
+          PUBLIC_PROMOTE_OPENTEST: ${{ secrets.PUBLIC_PROMOTE_OPENTEST }}
+          ALLOW_ROBOTS: 'true'
+          WOTB_GLOSSARY: ${{ secrets.WOTB_GLOSSARY }}
+          PUBLIC_GOOGLE_TAG_MANAGER_ID: ${{ secrets.PUBLIC_GOOGLE_TAG_MANAGER_ID }}
+          PUBLIC_GOOGLE_ANALYTICS_PROPERTY_ID: ${{ secrets.PUBLIC_GOOGLE_ANALYTICS_PROPERTY_ID }}
+          GOOGLE_APPLICATION_CREDENTIALS: ${{ secrets.GOOGLE_APPLICATION_CREDENTIALS }}
+          WOTB_GLOSSARY_DOMAIN: ${{ secrets.WOTB_GLOSSARY_DOMAIN }}
+          WOTB_GLOSSARY_PATH: ${{ secrets.WOTB_GLOSSARY_PATH }}
+          PUBLIC_DISCORD_SERVER_ID: ${{ secrets.PUBLIC_DISCORD_SERVER_ID }}
+          PUBLIC_ASSET_BASE: ${{ secrets.PUBLIC_ASSET_BASE }}
+          PUBLIC_BRANCH: ${{ secrets.PUBLIC_BRANCH }}
+        run: bun build:ratingleaderboard --region=asia

.github/workflows/rating-eu.yml

@@ -0,0 +1,41 @@
+name: Rating Europe
+
+on:
+  workflow_dispatch:
+  schedule:
+    - cron: '0 23 * * *'
+
+jobs:
+  host:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+      - uses: oven-sh/setup-bun@v1
+
+      - name: Install dependencies
+        run: bun install
+
+      - name: Generate leaderboard
+        env:
+          PUBLIC_ASSET_BRANCH: main
+          PUBLIC_ASSET_REPO: ${{ secrets.PUBLIC_ASSET_REPO }}
+          DISCORD_CLIENT_ID: ${{ secrets.DISCORD_CLIENT_ID }}
+          GH_TOKEN: ${{ secrets.GH_TOKEN }}
+          DISCORD_TOKEN: ${{ secrets.DISCORD_TOKEN }}
+          DATABASE_URL: ${{ secrets.DATABASE_URL }}
+          PUBLIC_WARGAMING_APPLICATION_ID: ${{ secrets.PUBLIC_WARGAMING_APPLICATION_ID }}
+          PUBLIC_ASSET_FAST_USER: ${{ secrets.PUBLIC_ASSET_FAST_USER }}
+          PUBLIC_ASSET_FAST_REPO: ${{ secrets.PUBLIC_ASSET_FAST_REPO }}
+          PUBLIC_PROMOTE_OPENTEST: ${{ secrets.PUBLIC_PROMOTE_OPENTEST }}
+          ALLOW_ROBOTS: 'true'
+          WOTB_GLOSSARY: ${{ secrets.WOTB_GLOSSARY }}
+          PUBLIC_GOOGLE_TAG_MANAGER_ID: ${{ secrets.PUBLIC_GOOGLE_TAG_MANAGER_ID }}
+          PUBLIC_GOOGLE_ANALYTICS_PROPERTY_ID: ${{ secrets.PUBLIC_GOOGLE_ANALYTICS_PROPERTY_ID }}
+          GOOGLE_APPLICATION_CREDENTIALS: ${{ secrets.GOOGLE_APPLICATION_CREDENTIALS }}
+          WOTB_GLOSSARY_DOMAIN: ${{ secrets.WOTB_GLOSSARY_DOMAIN }}
+          WOTB_GLOSSARY_PATH: ${{ secrets.WOTB_GLOSSARY_PATH }}
+          PUBLIC_DISCORD_SERVER_ID: ${{ secrets.PUBLIC_DISCORD_SERVER_ID }}
+          PUBLIC_ASSET_BASE: ${{ secrets.PUBLIC_ASSET_BASE }}
+          PUBLIC_BRANCH: ${{ secrets.PUBLIC_BRANCH }}
+        run: bun build:ratingleaderboard --region=eu

.github/workflows/rating-na.yml

@@ -0,0 +1,41 @@
+name: Rating North America
+
+on:
+  workflow_dispatch:
+  schedule:
+    - cron: '0 5 * * *'
+
+jobs:
+  host:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+      - uses: oven-sh/setup-bun@v1
+
+      - name: Install dependencies
+        run: bun install
+
+      - name: Generate leaderboard
+        env:
+          PUBLIC_ASSET_BRANCH: main
+          PUBLIC_ASSET_REPO: ${{ secrets.PUBLIC_ASSET_REPO }}
+          DISCORD_CLIENT_ID: ${{ secrets.DISCORD_CLIENT_ID }}
+          GH_TOKEN: ${{ secrets.GH_TOKEN }}
+          DISCORD_TOKEN: ${{ secrets.DISCORD_TOKEN }}
+          DATABASE_URL: ${{ secrets.DATABASE_URL }}
+          PUBLIC_WARGAMING_APPLICATION_ID: ${{ secrets.PUBLIC_WARGAMING_APPLICATION_ID }}
+          PUBLIC_ASSET_FAST_USER: ${{ secrets.PUBLIC_ASSET_FAST_USER }}
+          PUBLIC_ASSET_FAST_REPO: ${{ secrets.PUBLIC_ASSET_FAST_REPO }}
+          PUBLIC_PROMOTE_OPENTEST: ${{ secrets.PUBLIC_PROMOTE_OPENTEST }}
+          ALLOW_ROBOTS: 'true'
+          WOTB_GLOSSARY: ${{ secrets.WOTB_GLOSSARY }}
+          PUBLIC_GOOGLE_TAG_MANAGER_ID: ${{ secrets.PUBLIC_GOOGLE_TAG_MANAGER_ID }}
+          PUBLIC_GOOGLE_ANALYTICS_PROPERTY_ID: ${{ secrets.PUBLIC_GOOGLE_ANALYTICS_PROPERTY_ID }}
+          GOOGLE_APPLICATION_CREDENTIALS: ${{ secrets.GOOGLE_APPLICATION_CREDENTIALS }}
+          WOTB_GLOSSARY_DOMAIN: ${{ secrets.WOTB_GLOSSARY_DOMAIN }}
+          WOTB_GLOSSARY_PATH: ${{ secrets.WOTB_GLOSSARY_PATH }}
+          PUBLIC_DISCORD_SERVER_ID: ${{ secrets.PUBLIC_DISCORD_SERVER_ID }}
+          PUBLIC_ASSET_BASE: ${{ secrets.PUBLIC_ASSET_BASE }}
+          PUBLIC_BRANCH: ${{ secrets.PUBLIC_BRANCH }}
+        run: bun build:ratingleaderboard --region=com

.github/workflows/reviews.yml

@@ -0,0 +1,37 @@
+name: Reviews
+
+on:
+  workflow_dispatch:
+  schedule:
+    - cron: 0 0 * * 2
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+env:
+  DISCORD_TOKEN: ${{ secrets.DISCORD_TOKEN }}
+  GH_TOKEN: ${{ secrets.GH_TOKEN }}
+  DATABASE_URL: ${{ secrets.DATABASE_URL }}
+  PUBLIC_ASSET_BRANCH: ${{ secrets.PUBLIC_ASSET_BRANCH }}
+  PUBLIC_ASSET_REPO: ${{ secrets.PUBLIC_ASSET_REPO }}
+  GOOGLE_APPLICATION_CREDENTIALS: ${{ secrets.GOOGLE_APPLICATION_CREDENTIALS }}
+  PUBLIC_WARGAMING_APPLICATION_ID: ${{ secrets.PUBLIC_WARGAMING_APPLICATION_ID }}
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: recursive
+          token: ${{ secrets.GH_TOKEN }}
+
+      - uses: oven-sh/setup-bun@v1
+
+      - name: Install dependencies
+        run: bun install
+
+      - name: Find reviews
+        run: bun packages/scripts/src/reviews.ts

.github/workflows/website.yml

@@ -0,0 +1,71 @@
+name: Website
+
+on:
+  push:
+  workflow_dispatch:
+
+  schedule:
+    - cron: '0 4 * * *'
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: ${{ github.ref == 'refs/heads/main' }}
+
+env:
+  PUBLIC_WARGAMING_APPLICATION_ID: ${{ secrets.PUBLIC_WARGAMING_APPLICATION_ID }}
+  PUBLIC_PROMOTE_OPENTEST: ${{ secrets.PUBLIC_PROMOTE_OPENTEST }}
+  ALLOW_ROBOTS: ${{ secrets.ALLOW_ROBOTS }}
+  WOTB_GLOSSARY: ${{ secrets.WOTB_GLOSSARY }}
+  PUBLIC_GOOGLE_TAG_MANAGER_ID: ${{ secrets.PUBLIC_GOOGLE_TAG_MANAGER_ID }}
+  PUBLIC_GOOGLE_ANALYTICS_PROPERTY_ID: ${{ secrets.PUBLIC_GOOGLE_ANALYTICS_PROPERTY_ID }}
+  GOOGLE_APPLICATION_CREDENTIALS: ${{ secrets.GOOGLE_APPLICATION_CREDENTIALS }}
+  WOTB_GLOSSARY_DOMAIN: ${{ secrets.WOTB_GLOSSARY_DOMAIN }}
+  WOTB_GLOSSARY_PATH: ${{ secrets.WOTB_GLOSSARY_PATH }}
+  PUBLIC_DISCORD_SERVER_ID: ${{ secrets.PUBLIC_DISCORD_SERVER_ID }}
+  PUBLIC_ASSET_BASE: ${{ secrets.PUBLIC_ASSET_BASE }}
+  PUBLIC_BRANCH: ${{ secrets.PUBLIC_BRANCH }}
+  PUBLIC_GUIDE_WEBSITE: ${{ secrets.PUBLIC_GUIDE_WEBSITE }}
+  SERVICING: ${{ secrets.SERVICING }}
+
+jobs:
+  build:
+    name: Build
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: recursive
+          token: ${{ secrets.GH_TOKEN }}
+
+      - uses: oven-sh/setup-bun@v1
+      - uses: actions/configure-pages@v5
+
+      - name: Install dependencies
+        run: bun install
+
+      - name: Build website
+        run: bun run build:website
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: dist/website
+
+  deploy-github-pages:
+    if: ${{ github.ref == 'refs/heads/main' }}
+    name: Deploy to GitHub Pages
+    runs-on: ubuntu-latest
+    needs: build
+    environment:
+      name: Production
+      url: ${{ steps.deployment.outputs.page_url }}
+
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.gitignore

@@ -1,13 +1,14 @@
 node_modules
+_node_modules
 package-lock.json
-.env
+*.env
 /test-results/
 /playwright-report/
 /playwright/.cache/
 dist/
 dist.*
 yarn-error.log
-/test.*
+test.*
 /docs/.vitepress/dist
 /docs/.vitepress/cache
 servers.csv
@@ -19,4 +20,11 @@ temp/
 /.yarn
 depots
 public/sitemap*
-/firebase.json
+/firebase.json
+target
+# packages/core/src/protos/*.ts
+/.vercel
+/.astro
+.vercel
+/src
+/packages/bot/src/prisma

.gitmodules

@@ -1,3 +1,9 @@
 [submodule "submodules/blitzkit-closed"]
 	path = submodules/blitzkit-closed
 	url = https://github.com/tresabhi/blitzkit-closed
+[submodule "submodules/CUE4Parse"]
+	path = submodules/CUE4Parse
+	url = https://github.com/FabianFG/CUE4Parse
+[submodule "submodules/blitzkit-internal"]
+	path = submodules/blitzkit-internal
+	url = https://github.com/blitzkit/internal

.vscode/extensions.json

@@ -0,0 +1,4 @@
+{
+  "recommendations": ["astro-build.astro-vscode"],
+  "unwantedRecommendations": []
+}

.vscode/launch.json

@@ -0,0 +1,11 @@
+{
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "command": "./node_modules/.bin/astro dev",
+      "name": "Development server",
+      "request": "launch",
+      "type": "node-terminal"
+    }
+  ]
+}

.vscode/settings.json

@@ -2,16 +2,22 @@
   "cSpell.words": [
     "AABBOX",
     "Abhi",
+    "absarc",
     "accountinfo",
     "adsense",
     "aeson",
     "alphatest",
+    "analyticsdata",
+    "analyticsreporting",
     "APAC",
     "apcr",
     "applypatches",
     "artefacts",
+    "astrojs",
+    "astrolib",
     "atgm",
-    "Avearges",
+    "Autoloader",
+    "Autoreloader",
     "AYUV",
     "battleresults",
     "bbox",
@@ -19,6 +25,7 @@
     "betakrieg",
     "BINORMAL",
     "Binormals",
+    "bkni",
     "BKRL",
     "BKRTS",
     "BKRTSMANIFEST",
@@ -26,50 +33,64 @@
     "blitzkit",
     "blitzrinth",
     "blitzstars",
+    "cacheable",
+    "Callouts",
     "Camo",
+    "Carro",
+    "CCPAOPTOUT",
     "CDON",
     "classname",
     "cleandist",
     "closedkrieg",
     "cockroackdb",
     "Coef",
+    "Combattimento",
     "cooldown",
+    "corelations",
     "corsproxy",
     "CUBEMAP",
     "CUBETEXCOORD",
     "customperiod",
     "datasource",
+    "Dava",
     "dbid",
     "Ddpf",
     "Ddsd",
+    "deadrail",
     "debugflags",
     "deburr",
     "decalmask",
+    "decompressor",
     "defence",
     "degressive",
     "devkrieg",
     "diacriticless",
+    "DIDS",
     "donotremove",
     "drei",
-    "Droodles",
     "dvpd",
     "dvpl",
     "DVPLCRC",
     "dvpm",
     "dxgi",
+    "echarts",
     "Everytime",
     "FASTNAME",
+    "flexdirection",
     "FOURCC",
+    "frameloop",
     "fsformat",
     "Fullscreen",
     "fullstats",
     "fuzzysort",
-    "gamemode",
+    "gameplay",
     "glsl",
     "GLTF",
+    "gtag",
     "haha",
     "highp",
     "iife",
+    "imgur",
     "immer",
     "Inclusivity",
     "JOINTINDEX",
@@ -80,37 +101,54 @@
     "leaderboards",
     "lerp",
     "LINEARSIZE",
+    "lmao",
     "loadouts",
     "loddist",
     "lods",
     "lossrate",
+    "Maddoxkkm",
+    "malum",
     "mantlets",
+    "mediump",
     "metallicness",
+    "metalness",
     "minitelrose",
     "Minotauro",
     "MIPMAPCOUNT",
     "mišek",
+    "mmnow",
     "modeltransform",
     "MURICA",
+    "nanostores",
     "NEGATIVEX",
     "NEGATIVEY",
     "NEGATIVEZ",
+    "NITROPAY",
+    "nivo",
     "nmatname",
     "noout",
     "normalmap",
+    "oneof",
+    "oopsies",
     "Oopsy",
+    "opentest",
     "OPTML",
     "outdir",
     "outfile",
     "ownedtanks",
+    "padder",
+    "partytown",
     "PIXELFORMAT",
     "playerachievements",
     "playerinfo",
+    "playform",
     "pngjs",
     "POSITIVEX",
     "POSITIVEY",
     "POSITIVEZ",
+    "precompute",
     "Promisable",
+    "proto",
     "protobuf",
     "protos",
     "Pyogenics",
@@ -133,6 +171,7 @@
     "Specularity",
     "SSAO",
     "startcase",
+    "statkit",
     "statsfull",
     "steamapps",
     "Stringifying",
@@ -151,6 +190,7 @@
     "TEXCOORD",
     "tresabhi",
     "tungstentip",
+    "Turretless",
     "TYPELESS",
     "ubjson",
     "Unicum",
@@ -158,12 +198,16 @@
     "UNORM",
     "unpickled",
     "Unregistering",
+    "unrotate",
+    "unwrapper",
+    "vercel",
     "vickers",
     "vitepress",
     "Vovko",
     "wargaming",
     "webp",
     "whitespaces",
+    "WHSS",
     "winrate",
     "wireframe",
     "Woah",
@@ -175,10 +219,15 @@
     "xkdkw",
     "XMLDVPL",
     "YAMLDVPL",
+    "yolo",
+    "youtuber",
     "youtubers",
+    "zoomable",
     "zustand"
   ],
   "deno.enable": false,
   "deno.unstable": false,
-  "cSpell.enableFiletypes": ["glsl"]
+  "cSpell.enableFiletypes": ["glsl", "proto3"],
+  "typescript.tsdk": "node_modules\\typescript\\lib",
+  "liveServer.settings.multiRootWorkspaceName": "blitzkit"
 }

LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2023 TrèsAbhi
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

LICENSE.md

@@ -0,0 +1,50 @@
+# BlitzKit License
+
+Version 1.1, August 5th, 2025. Copyright (c) TrèsAbhi.
+
+Permission is hereby granted to anyone to:
+
+- Fork, clone, and download the contents of this repository.
+- Modify the code locally in private.
+- Use and run the code **only for personal, non-public testing, or educational purposes**.
+
+The following restrictions apply:
+
+- You may **not** deploy, host, or make this project or any derivative publicly accessible.
+- You may **not** share screenshots, recordings, or any form of media from this project unless you intend to merge your changes back into BlitzKit.
+- You may **not** use this project or its contents in any public or commercial product.
+- You may **not** redistribute modified or unmodified versions of this project.
+
+Contributions:
+
+- You are encouraged to propose changes or improvements via pull requests to the original BlitzKit repository.
+- Any such contributions will be considered under the same license terms unless explicitly stated otherwise.
+
+Violations of this license may result in revocation of usage rights and takedown requests.
+
+For questions or licensing inquiries, contact support@blitzkit.app.
+
+## Notes on Existing Forks
+
+All forks fall under these categories:
+
+- If your fork was made from commit `8462901` (Apr 17, 2023) or between commits `2958124` (Jul 3, 2023) and `85e483e` (Jul 13, 2024), your fork falls under the **MIT license**.
+- If your fork was made from commits between `5646093` (Jul 13, 2024) and `e3f131c` (Aug 5, 2025), your fork falls under the **AGPL-3.0 license**.
+- If your fork was made between commit `f7c356d` (Apr 17, 2023) and `2958124` (Jul 3, 2023), your fork falls under **a default exclusive copyright**.
+- If your fork was made from commits between `e3f131c` (Aug 5, 2025) and today, your fork falls under **this license**.
+
+MIT and AGPL-3.0 licensed fork owners:
+
+- You may continue to use your fork of BlitzKit under the corresponding license.
+- You may upgrade your fork up to commit `5cab394` (Aug 4, 2025) and keep the AGPL-3.0 license.
+- You may upgrade to commit `e3f131c` (Aug 5, 2025) or beyond but have to **switch to this license** where all rules apply.
+  - If you upgrade to commit `e3f131c` (Aug 5, 2025) or beyond, you must retract all public deployments of BlitzKit.
+  - Existing screenshots, recordings, or any form of media can remain.
+
+Default exclusive copyright fork owners:
+
+- You may continue to use their forks under the AGPL-3.0 license as no license was applied to BlitzKit at the time of forking.
+
+BlitzKit licensed fork owners:
+
+- You may continue to upgrade to the latest commits only under the conditions of this license.

README.md

@@ -1,23 +1,13 @@
-# BlitzKit
+## BlitzKit
 
-[![built with Codeium](https://codeium.com/badges/main)](https://codeium.com)
+Your premier source for all things Blitz.
 
-Tools for everything World of Tanks Blitz
+### https://blitzkit.app/
+
+![BlitzKit website](https://i.imgur.com/KaxUxmt.png)
 
 ## Invite the bot
 
 Go to [application directory for BlitzKit](https://discord.com/application-directory/1097673957865443370) and click "Add to Server." Voila! You're ready to go.
 
 ![BlitzKit application directory](https://i.imgur.com/YWCtOuJ.png)
-
-## Visit the website
-
-### https://blitzkit.vercel.app/
-
-![BlitzKit website](https://i.imgur.com/bdYMUCL.png)
-
-## Visit the documentation website
-
-### https://tresabhi.github.io/blitzkit/
-
-![BlitzKit documentation website](https://i.imgur.com/hm3KTsF.png)

blitzkit.code-workspace

@@ -0,0 +1,10 @@
+{
+  "folders": [
+    {
+      "path": ".",
+    },
+    {
+      "path": "C:/Program Files/WindowsApps/7458BE2C.WorldofTanksBlitz_11.1.256.0_x64__x4tje2y229k00/Data",
+    },
+  ],
+}

crowdin.yml

@@ -1,3 +1,3 @@
 files:
-  - source: /src/lang/en-US.json
-    translation: /src/lang/%locale%.json
+  - source: /packages/i18n/strings/en.json
+    translation: /%original_path%/%locale%.json

discord.json

@@ -1,14 +0,0 @@
-{
-  "client_id": "1097673957865443370",
-  "client_id_dev": "1099063696015229078",
-
-  "sklld_guild_id": "894784231677513819",
-  "sklld_verify_channel": "909968131873726545",
-  "sklld_verify_role": "909968395154358333",
-  "sklld_peasant_role": "896878529512370228",
-
-  "tres_guild_id": "734786591205359697",
-  "tres_log_channel": "1109262265850544148",
-
-  "test_guild_id": "1124729294829142116"
-}

docs/.vitepress/config.ts

@@ -1,39 +0,0 @@
-import { compareVersions } from 'compare-versions';
-import { readdirSync } from 'fs';
-import { parse } from 'path';
-import { defineConfig } from 'vitepress';
-import { getSidebar } from 'vitepress-plugin-auto-sidebar';
-
-export default defineConfig({
-  title: 'BlitzKit',
-  description: '🎉 All-in-one Discord bot for everything World of Tanks Blitz',
-  base: '/blitzkit/',
-  outDir: '../dist/docs',
-
-  themeConfig: {
-    nav: [
-      { text: 'Home', link: '/' },
-      { text: 'Guide', link: '/guide/introduction' },
-    ],
-
-    sidebar: [
-      ...getSidebar({
-        collapsed: false,
-        contentDirs: ['guide', 'legal'],
-        contentRoot: '/docs/',
-      }),
-
-      {
-        text: 'Changelogs',
-        items: readdirSync('./docs/changelogs')
-          .map((file) => parse(file).name)
-          .sort(compareVersions)
-          .map((name) => ({ text: name, link: `/changelogs/${name}.html` })),
-      },
-    ],
-
-    socialLinks: [
-      { icon: 'github', link: 'https://github.com/tresabhi/blitzkit' },
-    ],
-  },
-});

docs/.vitepress/theme/index.ts

@@ -1,16 +0,0 @@
-// https://vitepress.dev/guide/custom-theme
-import { h } from 'vue';
-import Theme from 'vitepress/theme';
-import './style.css';
-
-export default {
-  extends: Theme,
-  Layout: () => {
-    return h(Theme.Layout, null, {
-      // https://vitepress.dev/guide/extending-default-theme#layout-slots
-    });
-  },
-  enhanceApp({ app, router, siteData }) {
-    // ...
-  },
-};

docs/.vitepress/theme/style.css

@@ -1,90 +0,0 @@
-/**
- * Customize default theme styling by overriding CSS variables:
- * https://github.com/vuejs/vitepress/blob/main/src/client/theme-default/styles/vars.css
- */
-
-/**
- * Colors
- * -------------------------------------------------------------------------- */
-
-:root {
-  --vp-c-brand: #646cff;
-  --vp-c-brand-light: #747bff;
-  --vp-c-brand-lighter: #9499ff;
-  --vp-c-brand-lightest: #bcc0ff;
-  --vp-c-brand-dark: #535bf2;
-  --vp-c-brand-darker: #454ce1;
-  --vp-c-brand-dimm: rgba(100, 108, 255, 0.08);
-}
-
-/**
- * Component: Button
- * -------------------------------------------------------------------------- */
-
-:root {
-  --vp-button-brand-border: var(--vp-c-brand-light);
-  --vp-button-brand-text: var(--vp-c-white);
-  --vp-button-brand-bg: var(--vp-c-brand);
-  --vp-button-brand-hover-border: var(--vp-c-brand-light);
-  --vp-button-brand-hover-text: var(--vp-c-white);
-  --vp-button-brand-hover-bg: var(--vp-c-brand-light);
-  --vp-button-brand-active-border: var(--vp-c-brand-light);
-  --vp-button-brand-active-text: var(--vp-c-white);
-  --vp-button-brand-active-bg: var(--vp-button-brand-bg);
-}
-
-/**
- * Component: Home
- * -------------------------------------------------------------------------- */
-
-:root {
-  --vp-home-hero-name-color: transparent;
-  --vp-home-hero-name-background: -webkit-linear-gradient(
-    120deg,
-    #bd34fe 30%,
-    #41d1ff
-  );
-
-  --vp-home-hero-image-background-image: linear-gradient(
-    -45deg,
-    #bd34fe 50%,
-    #47caff 50%
-  );
-  --vp-home-hero-image-filter: blur(40px);
-}
-
-@media (min-width: 640px) {
-  :root {
-    --vp-home-hero-image-filter: blur(56px);
-  }
-}
-
-@media (min-width: 960px) {
-  :root {
-    --vp-home-hero-image-filter: blur(72px);
-  }
-}
-
-/**
- * Component: Custom Block
- * -------------------------------------------------------------------------- */
-
-:root {
-  --vp-custom-block-tip-border: var(--vp-c-brand);
-  --vp-custom-block-tip-text: var(--vp-c-brand-darker);
-  --vp-custom-block-tip-bg: var(--vp-c-brand-dimm);
-}
-
-.dark {
-  --vp-custom-block-tip-border: var(--vp-c-brand);
-  --vp-custom-block-tip-text: var(--vp-c-brand-lightest);
-  --vp-custom-block-tip-bg: var(--vp-c-brand-dimm);
-}
-
-/**
- * Component: Algolia
- * -------------------------------------------------------------------------- */
-
-.DocSearch {
-  --docsearch-primary-color: var(--vp-c-brand) !important;
-}

docs/about/credits.md

@@ -0,0 +1,19 @@
+# BlitzKit Credits
+
+BlitzKit is a one man band **TrèsAbhi** but I am far from solo.
+
+| Role                           | People                         |
+| ------------------------------ | ------------------------------ |
+| Bot verification               | S0AP                           |
+| General testing | Prince_NA |
+| Bot advertisement platform     | S0AP                           |
+| Bot rendering pipeline         | Vovko                          |
+| Game asset decompression       | Maddox                         |
+| Game 3D model parsing          | Pyogenics                      |
+| Game file layout               | Aeson                          |
+| 3-caliber rule edge cases      | Minitelrose, ChickenMan7777    |
+| Embed UX                       | \_34, HisRoyalFatness, Synx    |
+| Tankopedia pre-release testing | [OPTML], Aeson, \_34, xkdkw |
+| Website advertisement platform | Aeson                |
+| Compare pre-release testing    | [OPTML]              |
+| Redacted                       | GonnaHetzMe                    |

docs/changelogs/1.19.1.md

@@ -6,6 +6,6 @@ A minor-major fix to the armor sandbox. This update only affects the website.
 
 - Guns are now clipped properly allowing some tanks like the 252U and T34's mantlets to be penetrable (usually with premium shells) as they are in-game
 
-| Before                                     | After                                     |
-| ------------------------------------------ | ----------------------------------------- |
-| ![before](https://i.imgur.com/wB0kuk0.png) | ![after](https://i.imgur.com/vxp8wB0.png) |
+| Before                                      | After                                      |
+| ------------------------------------------- | ------------------------------------------ |
+| ![before](https://i.imgur.com/wB0kuk0m.png) | ![after](https://i.imgur.com/vxp8wB0m.png) |

docs/changelogs/1.20.1.md

@@ -0,0 +1,32 @@
+# BlitzKit 1.20.1
+
+The Tankopedia becomes sexier.
+
+## Features
+
+- Switched domain to https://blitzkit.app/
+- Added a hero section with the name of the Tank displayed in a huge font with the model of the tank on the right auto-rotating
+  - The auto-rotation is disabled upon manual disruption of the camera angle
+- Added a historical section for some tanks
+- Full screen is cleaner
+- The rotation inputs have been moved up to the top of the page
+- The shell selector has been moved to the right of the page to mimic the game
+- The antagonist (or the shooter) controls have been moved to the bottom of the sandbox
+  - The "armor" and "model" tabs have been replaced with a single toggle switch labeled as "armor:
+- Tank modules are now rendered similar to how they are in the game as a tree
+  - This is highly experimental; please report issues on [the official Discord server](https://discord.gg/nDt7AjGJQH)
+  - The XP cost is also listed in this section
+  - Top tier modules are highlighted in amber
+- Added a section to show the tech tree progression for tech tree tanks
+  - The credit and XP costs are also listed in this section along with the nationality
+- The shell selector has been simplified
+- Added a "back" button to return to the Tankopedia search page
+  - The "change" button has now been removed
+- The characteristics are now displayed with three columns when possible with the configuration acting as the first row
+- Replaced the loading percentage for tank models with a loading bar
+- The second page turner controls in the tankopedia search is now hidden when there's not a lot of search results
+
+## Fixes
+
+- Tanks without videos no longer display a broken YouTube video
+- Added "alt" texts for all images on the website

docs/changelogs/1.20.2.md

@@ -0,0 +1,48 @@
+# BlitzKit 1.20.2
+
+Taming the homepage.
+
+## Features
+
+- All tools are now displayed directly on the navbar on wide screens
+  - On small screens, the tools are hidden within a hamburger menu displaying a list similar to the old homepage
+- Added tiny hero image banner to the homepage
+- The tools are now displayed in a more readable manner with the most important tool(s) shown twice as large as all others on wider screens
+- The pitch and yaw inputs for tank turrets is now update live as the turret and gun is rotated
+- Consumables are now displayed in a neater box
+- Modules are now displayed in a more compact manner
+- Added a privacy policy and terms of service agreement prompt
+  - The links also point to an on-site page
+- Remade the navbar to include important information
+  - The about section offers credits, a link to Discord, and a link to the GitHub repository
+  - The legal section displays privacy policy, terms of service, and a link to Google's ad settings
+  - On the left side, the name of BlitzKit, version, and motto is displayed
+- The armor sandbox breakdown has been rewritten from scratch to maintain full parity with the visual armor highlighter, especially for HE shells
+  - The tracer has also been made more visible by rendering it on top of the armor
+  - The tracer's penetration locations have also been simplified and no longer show the index
+- The number of tanks per page is now reduced for smaller screen sizes
+- Added a BlitzKit watermark to the tankopedia sandbox when in fullscreen
+- The tool's backgrounds are no longer blurred on their dedicated page
+- Added a plus button to add tanks to the right of the rightmost column in the compare tool
+
+## Fixes
+
+- The navbar blur effect now works on Safari too
+- Switched buttons out for icon buttons for page turners
+- Many hydration issues have been fixed allowing a few pages to load twice as fast
+- The nationality of tanks in the title of the tab are now in adjective forms
+- HEAT shells no longer ricochet
+- Text on page won't be selected on accident when interacting with the tank sandbox
+- The first shell is now equipped by default instead of the last one when switching guns/turrets
+- Quite a few pages have been more responsive for smaller screens
+- Camouflage bonuses are now multiplicative instead of additive
+- Light tanks now have the same camouflage on move as when still
+- The shot display is now discarded when the tank is swapped out
+- Roboto Flex is now properly used instead of the default Radix UI font
+- The website now uses Imgur to load images and scale them appropriately for better performance
+- The compare headers no longer collapse on Firefox
+- Turrets can now be rotated correctly in the Tankopedia on Apple devices
+
+## Technical Changes
+
+- Moved all technical documentations to the `technical` directory within `docs`

docs/changelogs/1.20.3.md

@@ -0,0 +1,14 @@
+# BlitzKit 1.20.3
+
+A bug turns into a rating command feature!
+
+## Features
+
+- The rating command was giving seasonal statistics instead for the current day; this bug has now been made a feature through the new `/rating season` command
+
+## Fixes
+
+- Missing WN8 is now displayed with "--" instead of `NaN`
+- Players who have not participated in the rating gamemode are handled correctly
+- Decreasing position is now positive indicated in `/rating`
+- `/rating` now displays today's statics correctly once again

docs/changelogs/1.20.4.md

@@ -0,0 +1,13 @@
+# BlitzKit 1.20.4
+
+Continuing the revamping UI train, this release tanks the tank search page.
+
+## Changes
+
+- Tanks are now displayed naked, not bounded by a button
+- The filters are now far more compact, responsive, and intuitive
+- The search bar is now faster and shows skeletons when loading
+- The sort feature now displays the values of tanks used to sort underneath the tank's names
+- Nations are now ordered in the way they are in-game
+- When filtering tanks in testing, a work-in-progress warning is shown
+- When there are no results, a proper message is shown

docs/changelogs/1.20.5.md

@@ -0,0 +1,28 @@
+# BlitzKit 1.20.5
+
+Some QOL changes incoming!
+
+## Changes
+
+- The penetration of the shooter is now displayed above the shell switcher
+- The shot display card is now shown below the tank instead of to the side on narrow screens
+- Added a few more stats to Compare and Tankopedia
+  - Max dispersion
+  - Clipping potential for auto-loaders and auto-reloaders
+  - Raw terrain resistance coefficients
+- Renamed the "Fire" section to "Firepower"
+- The shell selector for the protagonist tank has been moved to the Firepower section's title
+- The table layout of Compare has been compacted and indented in places
+- The tank class and type has now displayed in the hero section of the Tankopedia
+- Removed the default tier X filter
+- Added draggable tracks
+- Added the ability to sort by premium shell DPM
+
+## Fixes
+
+- Clicking enter no longer changes the tank you're viewing when selecting the shooter tank
+- The open in new tab button in Compare now opens in a new tab
+- HEAT shells no longer display ricochet angle
+- The gun depression is now properly reported for the Minotauro line
+- Stopped autofocus of the ghost button in the login card
+- Patreon login now handles bad responses

docs/changelogs/1.21.0.md

@@ -0,0 +1,19 @@
+# BlitzKit 1.21.0
+
+Introducing the Tank performance tool! This release only affects the websites.
+
+## Features
+
+- Added the Tank performance tool which lists all tanks in the game and how players are performing in them
+  - This tool features the same tank filters as the Tankopedia search page
+  - The number of players in any given period can be viewed by switching the period from the dropdown
+  - This list updated daily
+- The tankopedia search page now loads much faster
+  - Not all tanks are loaded at once; rather, more tanks are loaded as you scroll down the page (the same as Tank performance)
+  - The tank pages also load lightning fast now
+- Tank compare now feature sticky headers and runs must faster
+- Reduced ads in a few places
+
+## Fixes
+
+- The footer is now better centered

docs/changelogs/1.21.1.md

@@ -0,0 +1,22 @@
+# BlitzKit 1.21.1
+
+One wise man said, experimental is literally in the name of experimental technology.
+
+## Features
+
+- Added a button on the right above the shells to quickly switch antagonist guns
+- Terrain resistance coefficients are now displayed as coefficients
+
+## Fixes
+
+- The shot display card now once again shows up on-screen
+- The shot tracer is also now correctly aligned
+- Tank tracks no longer interfere with camera rotation
+- "NaN" deltas don't show up in the stats section
+- The default provisions algorithm has been improved so most tanks should now have the best provisions by default
+- The tree type icon in the Tankopedia hero section is now colored properly
+- Removed "Battles" from Tank performance as it's simply inaccurate
+  - This feature will come back when player stats are released
+- Tank cell headers are now more consistently sized
+- Armor mode no longer causes Next.js hydration issues (even faster Tankopedia loading!)
+- The antagonist selector for the Tankopedia page now once again works

docs/changelogs/1.21.2.md

@@ -0,0 +1,8 @@
+# BlitzKit 1.21.2
+
+Freshly baked buns, anyone? This update only affects the bot.
+
+## Technical Changes
+
+- Switched from Node to Bun (faster everything!)
+- Removed legacy features like the custom welcome message for the SKLLD Discord server

docs/changelogs/1.21.3.md

@@ -0,0 +1,17 @@
+# BlitzKit 1.21.3
+
+Splashing with HE got splashier! This update only affects the website.
+
+## Features
+
+- Added HE splash radius visualization to the armor sandbox
+- Added a count for the number of tanks in the Tankopedia search page
+
+## Fixes
+
+- The Session tool's player search no longer clips into the footer
+- The shell tracer is no longer bugged when switching between tanks
+
+## Technical Changes
+
+- "BlitzKit" in the navigation bar is now simple text instead of an image

docs/changelogs/1.22.0.md

@@ -0,0 +1,26 @@
+# BlitzKit 1.22.0
+
+Introducing the long awaited Static Armor mode! This update only affects the website.
+
+## Features
+
+- Added static armor mode which display solid colors for each plate of armor
+  - Different type of armors have different scales and can be toggled by clicking the color scales
+  - Checking on "Edit" allows you to change the thicknesses to test hypothetical values
+  - Changes you make are also reflected in the Blitz-styled dynamic armor highlighter
+- Added a segmented controller to switch between Model, Dynamic Armor, and Static Armor modes
+- Track dragging has been disabled in both armor modes
+- Penetration tracer has been disabled for model mode
+- Penetration and thickness cards are now placed to better cooperate with screen real estate
+- "Core" armor has been renamed to "primary" across the website
+
+## Fixes
+
+- Penetration card now displays in fullscreen mode on mobile devices once again
+- Penetration of external modules after ricochets are no longer reported as "successful penetrations"
+- Gun barrels are no longer incorrectly incorporated into the shell tracer
+- Japanese gun depression equipment has been swapped back to the correct values
+
+## Technical Features
+
+- In dev mode, the ID of the selected armor plates is shown in static mode

docs/changelogs/1.22.1.md

@@ -0,0 +1,19 @@
+# BlitzKit 1.22.1
+
+## Features
+
+- Legendary camouflage names are now included in the Tankopedia search (for example, you can search up "Shark" and the T54E2 will show up)
+- Provision and consumable buttons in the Tankopedia and Compare tools are now separate buttons
+
+## Fixes
+
+- The name and icons of tanks in the Tankopedia search page are now properly aligned and trimmed
+- The Tankopedia search is now stricter; thus, filters out nonsensical results
+- The most optimal shell index once again shows the correct index
+- The DPM listing is now in parity with the game which is what "Max DPM" used to be previously
+- The Max DPM value is now also correct since the optimal shell index has been corrected
+- The mastery of crew members who play a secondary role in the tank is now handled properly
+- The turret of tanks cannot be accidentally rotated when dragging over other objects (like the body of the tank)
+- Penetrations are once again calculated after a ricochet
+- Camouflage values are now calculated properly when the Camouflage Net equipment is applied
+- Removed the redundant Configure tab when selecting an antagonist tank

docs/changelogs/1.22.2.md

@@ -0,0 +1,38 @@
+# BlitzKit 1.22.2
+
+This update packs a punch.
+
+## Features
+
+- Added "Game mode abilities" section to the tankopedia pages
+  - Shows the game mode provisions and consumables underneath the corresponding mode's banner
+- Reworked the tech tree section
+  - Now shows the whole line and if multiple paths exist, they are can be selected
+  - The selected tank is now highlighted with the flag of the corresponding country
+  - This section now also shows the total required XP and credits required
+  - Added a battle count which indicates the number of games required to reach the next tank (not including module upgrades) based on average xp earnings of players
+  - XP multipliers can also be applied to get a sense of how many battles you will really have to play
+- Reworked the "Review videos" section
+  - Removed all previews videos; we will be starting from scratch
+  - Added names of content creators under their corresponding videos
+  - Added a way for YouTubers to apply to be a part of the review videos section
+- Reworked the navbar
+  - This are a lot more compact and contrastive
+  - Tool names are now separated with vertical lines now
+  - The hamburger menu now looks more like the homepage cards
+- Added a warning for test tanks
+- Switched to on-demand rendering
+  - This makes it so that the canvas only renders upon interaction and not the continuously synced with the screen's refresh rate
+- Added the meta information section to the tankopedia pages
+  - Lists the full name, nation, tier, class, type, restoration, purchase, and sale prices
+- Added tooltips to a lot of places
+- Reduced ads on the tankopedia pages
+- Added a screenshot button to take screenshots of the tank
+- Added crew training slider to the compare tool
+
+## Fixes
+
+- Invalid Wargaming logins are now handled properly
+- Season currencies are now displayed properly
+- Tank filters are now persistent but will be reset on refresh
+- The search for a tank now populates the search bar when navigating back to the search page

docs/changelogs/1.22.3.md

@@ -0,0 +1,16 @@
+# BlitzKit 1.22.3
+
+This should've been in the last update lol.
+
+## Features
+
+- The "meta information" section has been moved to the hero section on larger screens
+- Added an option to take a screenshot directly to the clipboard
+- Removed the number from the BlitzKit logo
+- The tank playground now stops rendering when it is offscreen, hence fixing a lot of crashes
+
+## Fixes
+
+- The hero section of the Tankopedia is now better sized on smaller screens
+- The shell penetration over distance slider now instantly updates the corresponding input instead after a delay
+- The game mode banner info is now visible on Apple devices

docs/changelogs/1.22.4.md

@@ -0,0 +1,11 @@
+# BlitzKit 1.22.4
+
+This update makes some technical internal changes to allow the website to switch to the opentest version of the game when it is released. The opentest variant of BlitzKit will be available on https://opentest.blitzkit.app/ in the future (currently, it just redirects to https://blitzkit.app).
+
+## Features
+
+- Renamed "Tank performance" to "Performance"
+- Added auto-redirect for old tool names:
+  - "ratings" -> "rating"
+  - "tank-performance" -> "performance"
+- Added a 404 page

docs/changelogs/1.22.5.md

@@ -0,0 +1,27 @@
+# BlitzKit 1.22.5
+
+This update only affects the website.
+
+## Features
+
+- CDN branch names are now outline
+- Added an "unaffiliated to Wargaming" note to the footer
+- Added a warning when viewing deprecated tanks
+- Added partial support for dynamic armor
+  - The armor behaves properly in both dynamic and static armor modes but the visual 3D model doesn't update as of yet
+  - I'm working on it!
+- Reworked the hero and meta information section of the tankopedia pages
+- The grid is now more visible at steeper angles
+- Re-introduced the "swap" tanks button in the tankopedia
+- Added an opentest plug at homepage (you'll see what this is soon™)
+
+## Fixes
+
+- Titles for a few pages are once again static
+- Some links that opened in a new tab even though they were BlitzKit links now once again behave properly
+- Missing page titles for documentation pages now work properly
+- Toggling equipments through the tank canvas now update the render properly
+- The sorting feature in tank search properly updates once again
+- Dragging on the tracks to move them once again renders properly
+- Correct tier I tanks are now shown in tech trees where deprecated tanks previously occupied the slot
+- Reward icons once again display properly for archived rating seasons

docs/changelogs/1.22.6.md

@@ -0,0 +1,21 @@
+# BlitzKit 1.22.6
+
+This update only affects the website.
+
+## Features
+
+- Added a "cool projects" section at the bottom of the homepage
+  - If you have any other cool projects, feel free to let me know
+- Added raw terrain coefficients along side the percentage values
+- The account name is displayed instead of "Wargaming" when logged in
+- Added an opentest button to the Tankopedia pages
+
+## Fixes
+
+- Protobuf files are now loaded more deterministically on both the server and client which resolves one of the issues that caused Error 500
+- Removed a server-side incompatible method which fixes the other issue that caused Error 500
+- Shot penetration is now displayed properly on mobile devices again
+- Center aligned Wargaming login regions buttons on smaller screen sizes
+- The dynamic armor button is no longer inverted
+- BlitzKit opentest is not longer promoted on opentest
+- The settings link in the navbar no longer open in a new tab

docs/changelogs/1.23.0.md

@@ -0,0 +1,17 @@
+# BlitzKit 1.23.0
+
+I rewrote the whole website for performance and lower bandwidth. This update does not affect the bot. If I did my job right, you should not notice a difference.
+
+## Changes
+
+- Removed documentation website, all the docs are now available within https://blitzkit.app/
+- Removed the Rating tool
+- Removed the ability to log in with Patreon
+- Removed all ads
+
+## Technical Changes
+
+- Converted BlitzKit to a monorepo
+- The whole website is now static with no server-side rendering
+  - Gotta go fast ⚡
+- All structural data is now stored in protocol buffers

docs/changelogs/1.23.1.md

@@ -0,0 +1,12 @@
+# BlitzKit 1.23.1
+
+Some critical fixes. This update only affects the website.
+
+## Features
+
+- Added a cool new interactive banner to the homepage
+  - This was primary done to reduce load times due to the high-definition image behind the "BlitzKit" heading
+
+## Fixes
+
+- The Session tool once again works

docs/changelogs/1.23.2.md

@@ -0,0 +1,25 @@
+# BlitzKit 1.23.2
+
+I made some oopsies so it's time to fix them. This update only affects the website.
+
+## Features
+
+- Added an experimental "Charts" tab to the Performance tool feature a single player distribution chart for now
+
+## Fixes
+
+- The player count in the Performance tool is now more accurate
+- The "Total" option in the Performance player count dropdown is now accessible
+- The tier in the meta section of the Tankopedia page is no longer off by 1
+- The HE splash animation no longer stutters
+- Module damage is no longer affected by Reactive Armor, Dynamic Armor, and Spall Liner
+- Lower raw terrain coefficients are now correctly flagged as better in the Compare tool
+- The Vanilla website is now promoted in the OpenTest version of the Tankopedia page
+- Removed the crew mastery slider
+- Removed the annoying tooltips in tank filters which would block the buttons up above
+- The default gun depression transition angle is now 0 instead of 10deg
+- The capitalization of "BlitzKit" in the terms of service is now correct
+- The lighting in static mode is now consistent between PBR and non-PBR tanks
+- On-click penetration testing now correctly applies enhanced armor
+- Crew member count is now longer off by 1
+  - These values may take up to 24 hours to update on your end

docs/changelogs/1.24.0.md

@@ -0,0 +1,20 @@
+# BlitzKit 1.24.0
+
+Introducing a new tool: the Gallery, an exhaustive collection of player avatars. This update only affects the website.
+
+## Features
+
+- Added the Gallery tool with a blazing fast search bar
+  - Click on an avatar to get the full resolution image which you can download using the download button
+- External modules in static mode is now denoted by gray
+- Added a crew count to the Crew Training section
+
+## Fixes
+
+- Crew skill levels are not longer off by 1
+- Crew members with no substitutes are no longer shown with substitutes
+- PBR tanks no longer are blasted with excessive lighting
+
+## Technical Changes
+
+- Added page pre-fetching for faster anchors

docs/changelogs/1.25.0.md

@@ -0,0 +1,9 @@
+# BlitzKit 1.25.0
+
+## Features
+
+- Added embeds
+  - This tool is intended for streamers and content creators but feel free to generate embeds for personal use!
+  - There are tons of options and an infinite amount of possible customizations
+  - BlitzKit only offers 1 embed at the moment but feel free to suggest more
+- Tank models are now 4x smaller (meaning it's 4x faster to load)

docs/changelogs/1.25.1.md

@@ -0,0 +1,14 @@
+# BlitzKit 1.25.1
+
+## Features
+
+- Added shell range and capacity to Tankopedia, Compare, and tank search sort
+  - These values will appear "0" for a few hours as the website slowly syncs with the game
+- Added a skeleton loading screen to Tankopedia
+- Added gun type filters and module damage sorting to tank search
+- Added the camouflage button to Compare
+- Gave camouflage percentages 2 decimals places of precision
+
+## Fixes
+
+- Tankopedia no longer displays "0 battles" under tier X tanks in the tech tree section

docs/changelogs/1.25.2.md

@@ -0,0 +1,13 @@
+# BlitzKit 1.25.2
+
+## Features
+
+- Added custom shells
+  - This shows up as a "fourth" shell below the antagonist's shells
+  - Here, you can customize the shell type, caliber, and penetration
+  - If the shell type is AP or APCR, you can further customize the ricochet and normalization angles
+
+## Fixes
+
+- The Tankopedia now renders more efficiently by not rendering frames when not needed and unnecessarily rebuilding the whole tank model
+- This fix above fixes an issue where the whole tank flashed red when switching shells

docs/changelogs/1.25.3.md

@@ -0,0 +1,26 @@
+# BlitzKit 1.25.3
+
+## Features
+
+- Added a "popular tanks" list under the Tankopedia link on the homepage
+- The render engine has been sped up by about 50% thanks to cheaper lighting
+- Added a caliber discriminator for the antagonist gun selector in the Tankopedia sandbox
+- Added 30+ new stats to the Session tool
+- Added relative stat bars to the Tankopedia tank pages
+  - This compares each stat against other tanks of the same class & tier, tier, or every other tank
+- Added a recently viewed tanks list to the Tankopedia tank pages
+
+## Fixes
+
+- The shot result card is now displayed in the sandbox even on mobile devices now
+- Removed ad settings and referenced from the policies prompt
+- Removed draco compression as it usually only saved about 0.7mb per tank but added an extra 1mb to the decompressor
+- The tank type colors are back in the tank search
+- Frames are once again rendered when posing tanks
+- Removed the "ghost column" in the Session tool
+- The "total" cell is now sticky too much-like the tank name cells
+- The reset button in the tank search now resets the sort as well
+- The provisions list is now centered on smaller screens
+- The navbar can once again be scrolled
+- Provisions and consumables are no longer off by 1
+  - Allow up to 24 hours for this to update as BlitzKit re-syncs with the game

docs/changelogs/1.25.4.md

@@ -0,0 +1,15 @@
+# BlitzKit 1.25.4
+
+## Features
+
+- The popular tanks list on the homepage now uses a better algorithm such that it doesn't exclude low tier
+
+## Fixes
+
+- Clipping potential is once again rounded to the nearest integer
+- Raw hard terrain coefficients are now flagged as "lower the better," hence bringing it to parity with the terrain percentages
+- The renderer now doesn't brighten the tank too much
+- The recently viewed tanks is list no longer displayed in compact mode (in places like the Compare tool)
+- Tank ids once again populate the URL making it easily shareable
+- The number of tanks no longer double each time a file is saved in dev mode
+  - Lol tankopedia once had 662 \* 2 ^ 18 = 173 million tanks loaded on my dying pc

docs/changelogs/1.25.5.md

@@ -0,0 +1,7 @@
+# BlitzKit 1.25.5
+
+## Fixes
+
+- The Compare tool now has a vertically clipping table
+- Custom shells that are not HE no longer have an explosion radius
+- Performance tool table row titles are now fully clickable instead of just the icons

docs/changelogs/1.26.0.md

@@ -0,0 +1,19 @@
+# BlitzKit 1.26.0
+
+## Features
+
+- Added the Tier list tool
+- Migrated the bot to use BlitzKit 1.26.0
+- The hamburger menu has been move to the right of the screen
+- The Gallery tool now has a larger number of loading skeletons
+- Added some extra details when pasting Tankopedia links in Discord
+
+## Fixes
+
+- Rewrote the rating leaderboard archiver and commands making use of protobufs
+- The navbar is once again sticky to the top of the page
+- Added missing page titles to the Compare tool, Tankopedia pages, and the various docs
+
+## Technical Changes
+
+- Commands that accept a player account input now use just the player id instead of including the region

docs/changelogs/1.26.1.md

@@ -0,0 +1,9 @@
+# BlitzKit 1.26.1
+
+The auctions are here!
+
+## Features
+
+- Added the `/auction` command
+  - No need to login or go to the official website, just use `/auction`
+  - Everything built into Discord, one step at a time!

docs/changelogs/1.26.2.md

@@ -0,0 +1,22 @@
+# BlitzKit 1.26.2
+
+Two updates in a day! Why? Well, these two updates were being cooked separately in parallel and happened to have matured on the same day. Merry early Christmas!
+
+## Features
+
+- Highly optimized the component rerenders of the Tank Sandbox
+- Implemented Google Analytics into the homepage to more accurately show the most popular tanks
+- Optimized page load speeds and memory consumption by loading all data in parallel instead of sequentially
+
+## Fixes
+
+- Dynamic armor is now loaded in React Suspense to avoid race conditions
+- Re-ordered cards on the home page so that it makes a little bit more sense
+- The warnings section of the Tankopedia pages are now padded on the sides
+- The calibers in the antagonist gun selector are now rounded correctly
+- Tank class icons are now colored and sized properly again in the header
+
+## Technical Changes
+
+- Removed the extreme JPEG compression for the tank textures
+- Buffers of the same length are now assumed to be identical when diffing lmao I hope this doesn't go wrong

docs/changelogs/1.26.3.md

@@ -0,0 +1,19 @@
+# BlitzKit 1.26.3
+
+## Features
+
+- The bot now notifies you if your username/clan search query is too long or short instead of just showing a generic no results message
+- Reduced the popular tanks list on the home page back to 8 tanks
+- `/owned-tanks` now links to the corresponding Tankopedia pages
+- Added more funky rich presence statuses
+
+## Fixes
+
+- The website no longer crashes when turning on Static Armor mode
+- `/stats` and other commands with tank filter commands now work properly once again
+- The swap button in the Tankopedia pages no longer crashes switching between tech tree and non-tech tree tanks
+- `/owned-tanks` and `/auction` now chunk text better to meet Discord's 2000 character limit
+- Tanks with fixes camouflages like the M60 no longer have the option to disable the camouflage of in the Compare tool
+- The pointer cursor and underscore once again appear now in the tank search in the Compare tool
+- Opaque mode in the Dynamic armor mode once again works instantly
+- The rich presence/status/bio of the bot once again counts all servers instead of just the ones the single shard is responsible for

docs/changelogs/1.26.4.md

@@ -0,0 +1,15 @@
+# BlitzKit 1.26.4
+
+## Features
+
+- `/auction` now warns if a tank stock is at or below 500 and now strikes through the tank name if its out
+- Added advanced armor highlighting mode
+  - Green: penetration
+  - Red: blocked
+  - Pink: ricochet
+  - Cyan: penetration with 3 calibers rule
+- Optimized the armor highlighting for about a 15% increase in frame rate
+
+## Fixes
+
+- Added 5000 doses of adrenaline, incase the BOT DECIDES TO DIE AGAIN FOR NO REASON

docs/changelogs/1.26.5.md

@@ -0,0 +1,19 @@
+# BlitzKit 1.26.5
+
+¡Ahora en 6 idiomas! This version of BlitzKit adds support for 4 new languages totalling up to 6! [Please help translate on Crowdin](https://crowdin.com/project/blitzkrieg).
+
+## Features
+
+- Added Croatian, Russian, Ukrainian, and Chinese
+  - Pre-existing languages: English, Spanish
+- Added better lighting making tanks a little less yellow and a bit more realistic
+- Added custom tank icons (some may be missing when the update drops; just give them an hour or so to update)
+- Increased the maximum recently viewed tanks list size to 14
+- Tweaked the tank name in the hero section of the Tankopedia to allow the tank to be in the center of the page
+- The headers in the Performance tool are now sticky just like the Compare tool
+
+## Fixes
+
+- Removed unnecessary third party script that did absolutely nothing
+- Localizations are now stricter in what they allow, reducing errors in the Discord bot
+- Added 50 gallons of tomato soup to the bot in an attempt to keep it alive

docs/changelogs/1.26.6.md

@@ -0,0 +1,15 @@
+# BlitzKit 1.26.6
+
+This update only affects the website.
+
+## Features
+
+- Added an option to hide the tank model beneath the armor
+
+## Fixes
+
+- 3RC is now only display when it is used to avoid a ricochet in the advanced armor highlighting mode
+- Fixed the excessively sharp lighting in static mode
+- Brightness for non-PBR tanks is a bit better now
+- Decimal places are now properly rounded in BlitzKit link embeds
+- The titles in the Tankopedia pages aren't too massive now

docs/changelogs/1.27.0.md

@@ -0,0 +1,14 @@
+# BlitzKit 1.27.0
+
+PLEASE HELP TRANSLATE BLITZKIT: https://crowdin.com/project/blitzkrieg
+
+This update will be the last major update before the release of World of Tanks Blitz Unreal Engine.
+
+## Features
+
+- Added support for English, Spanish, French, Japanese, Polish, Portuguese, Russian, Ukrainian, and Chinese to the website and bot
+  - You can switch languages through the home page, the footer of any page, or the settings page
+
+## Fixes
+
+- Fixed the units for shell capacity

docs/changelogs/1.27.1.md

@@ -0,0 +1,7 @@
+# BlitzKit 1.27.1
+
+## Fixes
+
+- Fixed a crash that occurs if tanks are deleted in Blitz and were once available in BlitzKit
+- All tank icons are now back
+- The tank search once again returns results

docs/changelogs/1.27.10.md

@@ -0,0 +1,23 @@
+# BlitzKit 1.27.10
+
+This update changes the URLs across the whole website, removing the "tools" prefix and simplifying other aspects too.
+
+## Changes
+
+- Removed "full" tank names
+  - For example, tanks like the "Carro 45t" had full names like "Carro Combattimento 45t" which remained pretty much unused, so they have been removed
+- Reduced the shadow below the navigation bar
+- Removed the "tools" prefix from the URLs; here are the paths:
+  - `/tools/tankopedia` -> `/tanks`
+  - `/tools/tankopedia/12345` -> `/tanks/tank-name`
+  - `/tools/compare` -> `/compare`
+  - `/tools/embed` -> `/embed`
+  - `/tools/embed/embed-name` -> `/embed/embed-name`
+  - `/tools/gallery` -> `/gallery`
+  - `/tools/performance` -> `/performance`
+  - `/tools/session` -> `/session`
+  - `/tools/tier-list` -> `/tier-list`
+
+## Technical Features
+
+- The asset mangler now uses http headers and even more heuristics to minimize re-creating unchanged assets

docs/changelogs/1.27.11.md

@@ -0,0 +1,7 @@
+# BlitzKit 1.27.11
+
+This update affects both the bot and the website.
+
+## Technical Changes
+
+- Added a proper CDN domain to avoid error 429s and any slowdowns

docs/changelogs/1.27.12.md

@@ -0,0 +1,18 @@
+# BlitzKit 1.27.12
+
+This update only affects the website.
+
+## Features
+
+- Added the ability to sort by HE shell penetration
+- The Tankopedia compare bars now account for equipment and selected shells
+- Made the hero section of the Tankopedia a bit shorter to show users that the page is scrollable
+
+## Fixes
+
+- The "Clear filters" button no longer shows up after clearing the search bar
+- Guns for some tanks no longer go transparent when far away from the camera
+- The dynamic armor tab no longer lags and flickers when rotating the turret of a tank
+- Reimplemented the missing tool backgrounds in the navigation bar hamburger menu
+- The navigation bar now properly goes transparent for pages that request like the Tankopedia pages
+- Removed the tank name text outline because it doesn't work on most devices

docs/changelogs/1.27.13.md

@@ -0,0 +1,19 @@
+# BlitzKit 1.27.13
+
+This update adds a feature for a future version of WoTB 👁️👃👁️
+
+## Features
+
+- Added compatibility for the new mechanic for the upcoming Polish Tank Destroyers
+  - This code will remain dormant until the update for WoTB is released
+- Added a progress bar to the hero section of the Tankopedia to show that the model is loading
+- Reordered some Tankopedia statistics to bring important statistics like Damage to the very top
+
+## Fixes
+
+- The second column in the footer is now aligned on mobile devices
+- Fixed an issue that stopped the armor highlighting from working on the Kiwi browser and on older devices
+
+## Technical Changes
+
+- Removed permissions for robots to crawl non-blitzkit.app domains

docs/changelogs/1.27.14.md

@@ -0,0 +1,8 @@
+# BlitzKit 1.27.14
+
+This is the 14th patch for `1.27`, making it the new longest lasting version beating the previous record of `1.15.13`!
+
+## Fixes
+
+- Optimized the rendering of the shells in the Tankopedia search
+- The Assault Shells cursor now works on iOS devices

docs/changelogs/1.27.15.md

@@ -0,0 +1,7 @@
+# BlitzKit 1.27.15
+
+I did not see this coming
+
+## Fixes
+
+- The Assault Shell graph now supports damage factors of above 100% now

docs/changelogs/1.27.16.md

@@ -0,0 +1,25 @@
+# BlitzKit 1.27.16
+
+## Features
+
+- Added links to GuidesBlitz to Tankopedia to aid users understand tanks beyond just numbers and stats
+- Added a gun depression and yaw visualizer
+
+## Changes
+
+- Made the colors of the advanced highlighting mode more subtle
+- Made the Tankopedia stat lines more condensed
+- You can now scroll the page even with your cursor on the Tankopedia sandbox
+
+## Fixes
+
+- Fixed a bug where the range of increased gun depression was incorrectly doubled
+- Removed an unintended space before the "x" in the "Gun damaged" stat
+- Fixed an issue causing the 3D renderer to render frames even when off screen
+- Fixed a differential issue causing excessive rerendering of the stat lines
+- Images no longer exceed the width of the device in the docs
+- Assault shells no longer scale the module damage with distance
+
+## Technical Changes
+
+- Removed all code relating to the canceled "Shooting Range" mode

docs/changelogs/1.27.17.md

@@ -0,0 +1,18 @@
+# BlitzKit 1.27.17
+
+This update was released early for the website. Today, it'll be officially announced and released for the bot
+
+## Features
+
+- Added the shell reload visualizer to aid people in getting a feel for how long shell reloads really are
+- Added lines of stats for the burst shells
+
+## Changes
+
+- Removed the redundant word "Shell" from "Shell reload" and "Shell reloads"
+- Removed the penetration over distance slider
+
+## Fixes
+
+- Fixed the DPM of tanks with burst shells like the ATAC
+  - The DPM will still be different from the game due to a bug in World of Tanks Blitz; I am trying to get Wargaming to fix it; trust BlitzKit!

docs/changelogs/1.27.2.md

@@ -0,0 +1,7 @@
+# BlitzKit 1.27.2
+
+This update only affects the website.
+
+## Fixes
+
+- The new Improved Vertical Stabilizer equipment which only affects the gun depression found on the Type 63 now works

docs/changelogs/1.27.3.md

@@ -0,0 +1,9 @@
+# BlitzKit 1.27.3
+
+This update only affects the bot.
+
+## Fixes
+
+- Added support for 64-bit IDs allowing users with new accounts to link with BlitzKit
+  - This comes at the added cost of resetting the links of all other accounts
+  - Just re-link and you're good to go

docs/changelogs/1.27.4.md

@@ -0,0 +1,3 @@
+# FreakKit 1.27.4
+
+It has come to our attention that tanks are very harsh objects. To even it out, we made the website a pretty pretty princess <3

docs/changelogs/1.27.5.md

@@ -0,0 +1,11 @@
+# BlitzKit 1.27.5
+
+This update only affects the bot.
+
+## Changes
+
+- Removed `/auction`
+
+## Fixes
+
+- Fixed a bug that caused `/rating` to disappear

docs/changelogs/1.27.6.md

@@ -0,0 +1,23 @@
+# BlitzKit 1.27.6
+
+This update only affects the website.
+
+## Features
+
+- Added a promotional card for [the official Discord server](https://discord.gg/nDt7AjGJQH) to the homepage
+- Added a better navbar
+  - The added spaces and padding helps add more room for error when clicking, especially on mobile
+  - The dropdown menu is now a lost smaller, disposing of the need to scroll at all
+- Added shell filters to the tank search
+- Reworked the filter buttons and their positions to allow for more space
+
+## Fixes
+
+- Moved most images from imgur to BlitzKit allowing for users in certain countries to load BlitzKit without getting blocked
+
+## Technical Features
+
+- Added Partytown to offload some workload off the main thread, allowing for a more responsive experience
+- Reworked `robots.txt` to disallow indexing of BlitzKit variants
+- Improved the SEO further for most pages
+- Added a few compressor library to speed up load times

docs/changelogs/1.27.7.md

@@ -0,0 +1,25 @@
+# BlitzKit 1.27.7
+
+![](https://i.imgur.com/qFepOaT.png)
+
+This update only affects the website.
+
+## Features
+
+- Added a new foggy-wireframe transition between tabs to smooth out the jarring jumps
+- Added animations pop-in and out animations on a few elements
+  - The tank name title now shrinks in size as soon as a disturbance is caused
+  - The shell selector, antagonist switcher, and thicknesses range now ease into frame
+- The Tankopedia search page now loads as a skeleton by default before populating with tanks, allowing for the recently viewed tanks to load without cumulative shift
+  - Something similar was done to the Gallery tool
+- Gave the meta section of the website some zest with nation-based backdrops
+- The compare tabs in the Tankopedia are now centered
+
+## Fixes
+
+- The camera no longer snaps to the initial position when switching between tabs
+
+## Technical Changes
+
+- Backported some technologies from BlitzKit Reforged; you will not notice any differences in usage
+- The popular tanks and gallery indexings have been moved to the asynchronous cron job

docs/changelogs/1.27.8.md

@@ -0,0 +1,12 @@
+# BlitzKit 1.27.8
+
+![](https://i.imgur.com/WO5MS94.png)
+
+## Features
+
+- The website now uses Inter as the font
+- Added a cool new non-disturbed state for the Tankopedia because why not
+
+## Changes
+
+- Removed the Discord plug and language changer from the homepage

docs/changelogs/1.27.9.md

@@ -0,0 +1,27 @@
+# BlitzKit 1.27.9
+
+BlitzKit's great, but there's far too many numbers. This update adds a few visualizers to help new players understand how things relate numerically.
+
+![](https://i.imgur.com/OV5ak4T.png)
+
+## Features
+
+- Added the turret and hull traverse speed visualizer
+- Added the shell ricochet and normalization angles visualizer
+- Added the view-range visualizer
+- Added a search bar to the Tankopedia characteristics
+- Bumped the decimal places for vehicle dimensions and volume
+- Made tank ranks softer (the bars beneath the tank characteristics)
+- Gave the navigation bar better distinction from the rest of the page
+- Increased the number of characteristics rows to 3 on select devices
+- Switched to a more contrasting classic style of components across the website (it's subtle, but beautiful)
+
+## Changes
+
+- Removed units
+
+## Fixes
+
+- Clarified a few confusing row labels in the Compare tool
+- Made the Tankopedia hero section dynamically smaller on mobile phones to allow scrolling
+- Tank ranks no longer reach 0 or go above the number of vehicles in the comparison

docs/changelogs/1.3.0.md

@@ -2,7 +2,7 @@
 
 This release of Blitzkrieg focuses mainly on **performance**. Blitzkrieg now uses **Satori** and **resvg** under the hood to render images resulting in a solid **2x to 8x performance boost** depending on the situation.
 
-This only applies to `/today` and /stats` as they're the only commands that render an image currently.
+This only applies to `/today` and `/stats` as they're the only commands that render an image currently.
 
 We're working further on **performance optimizations**. Our goal is to deliver a message within **3 seconds or less**. We're close and we'll get there!
 

docs/guide/cdon.md

@@ -1,99 +0,0 @@
-# Cedilla Object Notation
-
-1. JSON compressed as CDON, written directly to disk (a direct 50% reduction).
-2. CDON further compressed with LZ4 (a clean 90% reduction).
-3. The raw JSON file as fetched from a random data source.
-4. CDON decompressed once again to JSON. Note that this file is a little larger than the original JSON file as it contains a lot more decimal places due to float precision (this shouldn't affect the size in memory).
-
-![an image of file sizes](https://i.imgur.com/AHJiFpq.png)
-
-FS stands for "Fast String".
-
-```cpp
-primary CedillaObjectNotation {
-  utf8"CDON" magic;
-  Header header;
-  primary Body<header.fsFormat> body;
-}
-
-Header {
-  uint16 version; // always 1
-  FSFormat fsFormat;
-  StringTable<fsFormat> stringTable;
-}
-
-FSFormat enum<uint8> {
-  Format8,
-  Format16,
-  Format32,
-}
-
-FSPrimitive<FSFormat fsFormat> match(fsFormat) {
-  Format8: uint8;
-  Format16: uint16;
-  Format32: uint32;
-}
-
-StringTable<FSFormat fsFormat> {
-  FSPrimitive<fsFormat> count;
-  String[count] strings;
-}
-
-Body<FSFormat fsFormat> {
-  primary Value<fsFormat> object;
-}
-
-ValueType enum<uint8> {
-  Null,
-  Boolean,
-  Uint8,
-  Uint16,
-  Uint32,
-  Uint64,
-  Int8,
-  Int16,
-  Int32,
-  Int64,
-  Float32,
-  Float64,
-  String,
-  FS,
-  Array,
-  Object,
-}
-
-String {
-  uint32 length;
-  primary utf8<length> value;
-}
-
-StringValue Value & { (ValueType.String | ValueType.FS) type }
-
-Value<FSFormat fsFormat> {
-  ValueType type;
-  match<type> {
-    Boolean: { uint8 value; }
-    Uint8: { uint8 value; }
-    Uint16: { uint16 value; }
-    Uint32: { uint32 value; }
-    Uint64: { uint64 value; }
-    Int8: { int8 value; }
-    Int16: { int16 value; }
-    Int32: { int32 value; }
-    Int64: { int64 value; }
-    Float32: { float32 value; }
-    Float64: { float64 value; }
-    String: { String value; }
-    FS: { FSPrimitive<fsFormat> index; }
-    Array: {
-      uint32 count;
-      Value[count] values;
-    }
-    Object: {
-      uint32 count;
-      StringValue[count] keys;
-      Value[count] values;
-    }
-  }
-}
-```

docs/guide/credits.md

@@ -1,16 +0,0 @@
-# Team
-
-- TrèsAbhi: creator & programmer
-
-# Contributors
-
-- Prince_NA: general game advisor and tester
-- S0AP: bot verification and initial advertizement platform
-- Vovko: discord bot rendering pipeline
-- Maddox: game file decompression
-- Pyogenics: tank model parsing
-- Aeson: game files layout
-- Minitelrose, ChickenMan7777: 3-caliber rule edge cases
-- \_34, HisRoyalFatness, Synx, xkdkw: embed UX
-- [OPTML], Aeson, \_34, Droodles: beta testing Tankopedia
-- [OPTML], Droodles: beta testing Compare

docs/guide/introduction.md

@@ -15,7 +15,7 @@ BlitzKit is available as a Discord bot and can be [installed very easily](/guide
 
 ## Website
 
-Provides a bunch of very helpful tools; https://blitzkit.vercel.app/
+Provides a bunch of very helpful tools; https://blitzkit.app/
 
 - Session tracker
 - Rating leaderboard

docs/index.md

@@ -1,30 +0,0 @@
----
-# https://vitepress.dev/reference/default-theme-home-page
-layout: home
-
-hero:
-  name: 'BlitzKit'
-  text: Everything Blitz, right in Discord
-  tagline: All-in-one Discord bot for everything World of Tanks Blitz
-  image:
-    src: '/assets/images/hero.png'
-    alt: 'blitzkit'
-  actions:
-    - theme: brand
-      text: Add to Discord Server
-      link: /guide/invite
-    - theme: alt
-      text: Guide
-      link: /guide/introduction
-
-features:
-  - title: Clean and Efficient UI
-    icon: 🚀
-    details: BlitzKit is where concise meets efficient. Get the information you need in the way you want.
-  - title: Endless Possibilities
-    icon: 🛠
-    details: With endless ways to customize the output, it's guaranteed that you'll always get the information you need.
-  - title: Easy to Use
-    icon: 💻
-    details: Leveraging Discord's, Blitz Stars', and Wargaming's powerful APIS, Blitzkit does all the hard work for you.
----

docs/legal/privacy-policy.md

@@ -1,19 +1,208 @@
 # BlitzKit Privacy Policy
 
-BlitzKit collects little to no data. Regardless, here is an exhaustive list of BlitzKit's data collection practices.
+Last updated: May 23, 2024
 
-## Logs
+This Privacy Policy describes Our policies and procedures on the collection, use and disclosure of Your information when You use the Service and tells You about Your privacy rights and how the law protects You.
 
-All BlitzKit logs are available to the public as an effort for open source transparency. A history of all logs [can be found on GitHub](https://github.com/tresabhi/blitzkit/actions/workflows/host.yml). All logs expire automatically and are permanently deleted after 30 days. However, anyone may chose to save a local copy of the logs which is not tracked by GitHub.
+We use Your Personal data to provide and improve the Service. By using the Service, You agree to the collection and use of information in accordance with this Privacy Policy. This Privacy Policy has been created with the help of the [Privacy Policy Generator](https://www.termsfeed.com/privacy-policy-generator/).
 
-## Commands
+## Interpretation and Definitions
 
-Everytime a command a command is used, the command name and parameters provided is logged. Any identifying information like manually provided in-game usernames are also recorded.
+### Interpretation
 
-## Databases
+The words of which the initial letter is capitalized have meanings defined under the following conditions. The following definitions shall have the same meaning regardless of whether they appear in singular or in plural.
 
-No databases are used by BlitzKit meaning that no data is collected outside of what has already been mentioned above. This is no permanent state.
+### Definitions
 
-## 3rd Party
+For the purposes of this Privacy Policy:
 
-The privacy policies of Discord, Wargaming, and Blitz Stars apply too since they are utilized by the bot.
+- **Account** means a unique account created for You to access our Service or parts of our Service.
+- **Affiliate** means an entity that controls, is controlled by or is under common control with a party, where "control" means ownership of 50% or more of the shares, equity interest or other securities entitled to vote for election of directors or other managing authority.
+- **Company** (referred to as either "the Company", "We", "Us" or "Our" in this Agreement) refers to BlitzKit.
+- **Cookies** are small files that are placed on Your computer, mobile device or any other device by a website, containing the details of Your browsing history on that website among its many uses.
+- **Country** refers to: Missouri, United States
+- **Device** means any device that can access the Service such as a computer, a cellphone or a digital tablet.
+- **Personal Data** is any information that relates to an identified or identifiable individual.
+- **Service** refers to the Website.
+- **Service Provider** means any natural or legal person who processes the data on behalf of the Company. It refers to third-party companies or individuals employed by the Company to facilitate the Service, to provide the Service on behalf of the Company, to perform services related to the Service or to assist the Company in analyzing how the Service is used.
+- **Usage Data** refers to data collected automatically, either generated by the use of the Service or from the Service infrastructure itself (for example, the duration of a page visit).
+- **Website** refers to BlitzKit, accessible from [https://blitzkit.app/](https://blitzkit.app/)
+- **You** means the individual accessing or using the Service, or the company, or other legal entity on behalf of which such individual is accessing or using the Service, as applicable.
+
+## Collecting and Using Your Personal Data
+
+### Types of Data Collected
+
+#### Personal Data
+
+While using Our Service, We may ask You to provide Us with certain personally identifiable information that can be used to contact or identify You. Personally identifiable information may include, but is not limited to:
+
+- Usage Data
+
+#### Usage Data
+
+Usage Data is collected automatically when using the Service.
+
+Usage Data may include information such as Your Device's Internet Protocol address (e.g. IP address), browser type, browser version, the pages of our Service that You visit, the time and date of Your visit, the time spent on those pages, unique device identifiers and other diagnostic data.
+
+When You access the Service by or through a mobile device, We may collect certain information automatically, including, but not limited to, the type of mobile device You use, Your mobile device unique ID, the IP address of Your mobile device, Your mobile operating system, the type of mobile Internet browser You use, unique device identifiers and other diagnostic data.
+
+We may also collect information that Your browser sends whenever You visit our Service or when You access the Service by or through a mobile device.
+
+#### Tracking Technologies and Cookies
+
+We use Cookies and similar tracking technologies to track the activity on Our Service and store certain information. Tracking technologies used are beacons, tags, and scripts to collect and track information and to improve and analyze Our Service. The technologies We use may include:
+
+- **Cookies or Browser Cookies.** A cookie is a small file placed on Your Device. You can instruct Your browser to refuse all Cookies or to indicate when a Cookie is being sent. However, if You do not accept Cookies, You may not be able to use some parts of our Service. Unless you have adjusted Your browser setting so that it will refuse Cookies, our Service may use Cookies.
+- **Web Beacons.** Certain sections of our Service and our emails may contain small electronic files known as web beacons (also referred to as clear gifs, pixel tags, and single-pixel gifs) that permit the Company, for example, to count users who have visited those pages or opened an email and for other related website statistics (for example, recording the popularity of a certain section and verifying system and server integrity).
+
+Cookies can be "Persistent" or "Session" Cookies. Persistent Cookies remain on Your personal computer or mobile device when You go offline, while Session Cookies are deleted as soon as You close Your web browser. You can learn more about cookies on [TermsFeed website](https://www.termsfeed.com/blog/cookies/#What_Are_Cookies) article.
+
+We use both Session and Persistent Cookies for the purposes set out below:
+
+- **Necessary / Essential Cookies**
+
+  Type: Session Cookies
+
+  Administered by: Us
+
+  Purpose: These Cookies are essential to provide You with services available through the Website and to enable You to use some of its features. They help to authenticate users and prevent fraudulent use of user accounts. Without these Cookies, the services that You have asked for cannot be provided, and We only use these Cookies to provide You with those services.
+
+- **Cookies Policy / Notice Acceptance Cookies**
+
+  Type: Persistent Cookies
+
+  Administered by: Us
+
+  Purpose: These Cookies identify if users have accepted the use of cookies on the Website.
+
+- **Functionality Cookies**
+
+  Type: Persistent Cookies
+
+  Administered by: Us
+
+  Purpose: These Cookies allow us to remember choices You make when You use the Website, such as remembering your login details or language preference. The purpose of these Cookies is to provide You with a more personal experience and to avoid You having to re-enter your preferences every time You use the Website.
+
+- **Google AdSense Cookies**
+
+  Type: Persistent Cookies
+
+  Administered by: Google AdSense
+
+  Purpose: Third party vendors, including Google, use cookies to serve ads based on a user's prior visits to BlitzKit. Google's use of advertising cookies enables it and its partners to serve ads to your users based on their visit to your sites and/or other sites on the Internet. Users may opt out of personalized advertising by visiting [Ads Settings](https://www.google.com/settings/ads).
+
+For more information about the cookies we use and your choices regarding cookies, please visit our Cookies Policy or the Cookies section of our Privacy Policy.
+
+### Use of Your Personal Data
+
+The Company may use Personal Data for the following purposes:
+
+- **To provide and maintain our Service**, including to monitor the usage of our Service.
+- **To manage Your Account:** to manage Your registration as a user of the Service. The Personal Data You provide can give You access to different functionalities of the Service that are available to You as a registered user.
+- **For the performance of a contract:** the development, compliance and undertaking of the purchase contract for the products, items or services You have purchased or of any other contract with Us through the Service.
+- **To contact You:** To contact You by email, telephone calls, SMS, or other equivalent forms of electronic communication, such as a mobile application's push notifications regarding updates or informative communications related to the functionalities, products or contracted services, including the security updates, when necessary or reasonable for their implementation.
+- **To provide You** with news, special offers and general information about other goods, services and events which we offer that are similar to those that you have already purchased or enquired about unless You have opted not to receive such information.
+- **To manage Your requests:** To attend and manage Your requests to Us.
+- **For business transfers:** We may use Your information to evaluate or conduct a merger, divestiture, restructuring, reorganization, dissolution, or other sale or transfer of some or all of Our assets, whether as a going concern or as part of bankruptcy, liquidation, or similar proceeding, in which Personal Data held by Us about our Service users is among the assets transferred.
+- **For other purposes**: We may use Your information for other purposes, such as data analysis, identifying usage trends, determining the effectiveness of our promotional campaigns and to evaluate and improve our Service, products, services, marketing and your experience.
+
+We may share Your personal information in the following situations:
+
+- **With Service Providers:** We may share Your personal information with Service Providers to monitor and analyze the use of our Service, to contact You.
+- **For business transfers:** We may share or transfer Your personal information in connection with, or during negotiations of, any merger, sale of Company assets, financing, or acquisition of all or a portion of Our business to another company.
+- **With Affiliates:** We may share Your information with Our affiliates, in which case we will require those affiliates to honor this Privacy Policy. Affiliates include Our parent company and any other subsidiaries, joint venture partners or other companies that We control or that are under common control with Us.
+- **With business partners:** We may share Your information with Our business partners to offer You certain products, services or promotions.
+- **With other users:** when You share personal information or otherwise interact in the public areas with other users, such information may be viewed by all users and may be publicly distributed outside.
+- **With Your consent**: We may disclose Your personal information for any other purpose with Your consent.
+
+### Retention of Your Personal Data
+
+The Company will retain Your Personal Data only for as long as is necessary for the purposes set out in this Privacy Policy. We will retain and use Your Personal Data to the extent necessary to comply with our legal obligations (for example, if we are required to retain your data to comply with applicable laws), resolve disputes, and enforce our legal agreements and policies.
+
+The Company will also retain Usage Data for internal analysis purposes. Usage Data is generally retained for a shorter period of time, except when this data is used to strengthen the security or to improve the functionality of Our Service, or We are legally obligated to retain this data for longer time periods.
+
+### Transfer of Your Personal Data
+
+Your information, including Personal Data, is processed at the Company's operating offices and in any other places where the parties involved in the processing are located. It means that this information may be transferred to — and maintained on — computers located outside of Your state, province, country or other governmental jurisdiction where the data protection laws may differ than those from Your jurisdiction.
+
+Your consent to this Privacy Policy followed by Your submission of such information represents Your agreement to that transfer.
+
+The Company will take all steps reasonably necessary to ensure that Your data is treated securely and in accordance with this Privacy Policy and no transfer of Your Personal Data will take place to an organization or a country unless there are adequate controls in place including the security of Your data and other personal information.
+
+### California Consumer Privacy Act (CCPA)
+
+If you are a California resident, you have specific rights regarding your personal information under the California Consumer Privacy Act (CCPA). This section describes your CCPA rights and explains how to exercise those rights.
+
+#### Rights under CCPA
+
+Under CCPA, California residents have the following rights:
+
+1. Right to Know: You have the right to request that we disclose certain information to you about our collection and use of your personal information over the past 12 months.
+2. Right to Delete: You have the right to request that we delete any of your personal information that we collected from you and retained, subject to certain exceptions.
+3. Right to Opt-Out of Sale: You have the right to opt-out of the sale of your personal information. Note that we do not sell personal information as defined by the CCPA.
+4. Right to Non-Discrimination: You have the right not to be discriminated against for exercising any of your CCPA rights.
+
+#### Exercising Your CCPA Rights
+
+To exercise your rights under CCPA and to opt-out of the sale of your personal information, you can click on the "Do not sell my personal information" link in the footer of any page on our website.
+
+### Delete Your Personal Data
+
+You have the right to delete or request that We assist in deleting the Personal Data that We have collected about You.
+
+Our Service may give You the ability to delete certain information about You from within the Service.
+
+You may update, amend, or delete Your information at any time by signing in to Your Account, if you have one, and visiting the account settings section that allows you to manage Your personal information. You may also contact Us to request access to, correct, or delete any personal information that You have provided to Us.
+
+Please note, however, that We may need to retain certain information when we have a legal obligation or lawful basis to do so.
+
+### Disclosure of Your Personal Data
+
+#### Business Transactions
+
+If the Company is involved in a merger, acquisition or asset sale, Your Personal Data may be transferred. We will provide notice before Your Personal Data is transferred and becomes subject to a different Privacy Policy.
+
+#### Law enforcement
+
+Under certain circumstances, the Company may be required to disclose Your Personal Data if required to do so by law or in response to valid requests by public authorities (e.g. a court or a government agency).
+
+#### Other legal requirements
+
+The Company may disclose Your Personal Data in the good faith belief that such action is necessary to:
+
+- Comply with a legal obligation
+- Protect and defend the rights or property of the Company
+- Prevent or investigate possible wrongdoing in connection with the Service
+- Protect the personal safety of Users of the Service or the public
+- Protect against legal liability
+
+### Security of Your Personal Data
+
+The security of Your Personal Data is important to Us, but remember that no method of transmission over the Internet, or method of electronic storage is 100% secure. While We strive to use commercially acceptable means to protect Your Personal Data, We cannot guarantee its absolute security.
+
+## Children's Privacy
+
+Our Service does not address anyone under the age of 13. We do not knowingly collect personally identifiable information from anyone under the age of 13. If You are a parent or guardian and You are aware that Your child has provided Us with Personal Data, please contact Us. If We become aware that We have collected Personal Data from anyone under the age of 13 without verification of parental consent, We take steps to remove that information from Our servers.
+
+If We need to rely on consent as a legal basis for processing Your information and Your country requires consent from a parent, We may require Your parent's consent before We collect and use that information.
+
+## Links to Other Websites
+
+Our Service may contain links to other websites that are not operated by Us. If You click on a third party link, You will be directed to that third party's site. We strongly advise You to review the Privacy Policy of every site You visit.
+
+We have no control over and assume no responsibility for the content, privacy policies or practices of any third party sites or services.
+
+## Changes to this Privacy Policy
+
+We may update Our Privacy Policy from time to time. We will notify You of any changes by posting the new Privacy Policy on this page.
+
+We will let You know via email and/or a prominent notice on Our Service, prior to the change becoming effective and update the "Last updated" date at the top of this Privacy Policy.
+
+You are advised to review this Privacy Policy periodically for any changes. Changes to this Privacy Policy are effective when they are posted on this page.
+
+## Contact Us
+
+If you have any questions about this Privacy Policy, You can contact us:
+
+- By emailing blitzkriegautomation@gmail.com

docs/legal/terms-of-service.md

@@ -1,13 +1,109 @@
-# BlitzKit Terms of Service
+# BlitzKit Terms and Conditions
 
-## About
+Last updated: May 23, 2024
 
-BlitzKit is a multi-function Discord bot that serves users with needs specific to the game World of Tanks Blitz.
+Please read these terms and conditions carefully before using Our Service.
 
-## License
+## Interpretation and Definitions
 
-BlitzKit is licensed under the MIT License.
+### Interpretation
 
-## 3rd Party
+The words of which the initial letter is capitalized have meanings defined under the following conditions. The following definitions shall have the same meaning regardless of whether they appear in singular or in plural.
 
-The terms of services of Discord, Wargaming, and Blitz Stars apply too since they are utilized by the bot.
+### Definitions
+
+For the purposes of these Terms and Conditions:
+
+- **Affiliate** means an entity that controls, is controlled by or is under common control with a party, where "control" means ownership of 50% or more of the shares, equity interest or other securities entitled to vote for election of directors or other managing authority.
+- **Country** refers to: Missouri, United States
+- **Company** (referred to as either "the Company", "We", "Us" or "Our" in this Agreement) refers to BlitzKit.
+- **Device** means any device that can access the Service such as a computer, a cellphone or a digital tablet.
+- **Service** refers to the Website.
+- **Terms and Conditions** (also referred as "Terms") mean these Terms and Conditions that form the entire agreement between You and the Company regarding the use of the Service. This Terms and Conditions agreement has been created with the help of the [Terms and Conditions Generator](https://www.termsfeed.com/terms-conditions-generator/).
+- **Third-party Social Media Service** means any services or content (including data, information, products or services) provided by a third-party that may be displayed, included or made available by the Service.
+- **Website** refers to BlitzKit, accessible from [https://blitzkit.app/](https://blitzkit.app/)
+- **You** means the individual accessing or using the Service, or the company, or other legal entity on behalf of which such individual is accessing or using the Service, as applicable.
+
+## Acknowledgment
+
+These are the Terms and Conditions governing the use of this Service and the agreement that operates between You and the Company. These Terms and Conditions set out the rights and obligations of all users regarding the use of the Service.
+
+Your access to and use of the Service is conditioned on Your acceptance of and compliance with these Terms and Conditions. These Terms and Conditions apply to all visitors, users and others who access or use the Service.
+
+By accessing or using the Service You agree to be bound by these Terms and Conditions. If You disagree with any part of these Terms and Conditions then You may not access the Service.
+
+You represent that you are over the age of 18. The Company does not permit those under 18 to use the Service.
+
+Your access to and use of the Service is also conditioned on Your acceptance of and compliance with the Privacy Policy of the Company. Our Privacy Policy describes Our policies and procedures on the collection, use and disclosure of Your personal information when You use the Application or the Website and tells You about Your privacy rights and how the law protects You. Please read Our Privacy Policy carefully before using Our Service.
+
+## Links to Other Websites
+
+Our Service may contain links to third-party web sites or services that are not owned or controlled by the Company.
+
+The Company has no control over, and assumes no responsibility for, the content, privacy policies, or practices of any third party web sites or services. You further acknowledge and agree that the Company shall not be responsible or liable, directly or indirectly, for any damage or loss caused or alleged to be caused by or in connection with the use of or reliance on any such content, goods or services available on or through any such web sites or services.
+
+We strongly advise You to read the terms and conditions and privacy policies of any third-party web sites or services that You visit.
+
+## Termination
+
+We may terminate or suspend Your access immediately, without prior notice or liability, for any reason whatsoever, including without limitation if You breach these Terms and Conditions.
+
+Upon termination, Your right to use the Service will cease immediately.
+
+## Limitation of Liability
+
+Notwithstanding any damages that You might incur, the entire liability of the Company and any of its suppliers under any provision of this Terms and Your exclusive remedy for all of the foregoing shall be limited to the amount actually paid by You through the Service or 100 USD if You haven't purchased anything through the Service.
+
+To the maximum extent permitted by applicable law, in no event shall the Company or its suppliers be liable for any special, incidental, indirect, or consequential damages whatsoever (including, but not limited to, damages for loss of profits, loss of data or other information, for business interruption, for personal injury, loss of privacy arising out of or in any way related to the use of or inability to use the Service, third-party software and/or third-party hardware used with the Service, or otherwise in connection with any provision of this Terms), even if the Company or any supplier has been advised of the possibility of such damages and even if the remedy fails of its essential purpose.
+
+Some states do not allow the exclusion of implied warranties or limitation of liability for incidental or consequential damages, which means that some of the above limitations may not apply. In these states, each party's liability will be limited to the greatest extent permitted by law.
+
+## "AS IS" and "AS AVAILABLE" Disclaimer
+
+The Service is provided to You "AS IS" and "AS AVAILABLE" and with all faults and defects without warranty of any kind. To the maximum extent permitted under applicable law, the Company, on its own behalf and on behalf of its Affiliates and its and their respective licensors and service providers, expressly disclaims all warranties, whether express, implied, statutory or otherwise, with respect to the Service, including all implied warranties of merchantability, fitness for a particular purpose, title and non-infringement, and warranties that may arise out of course of dealing, course of performance, usage or trade practice. Without limitation to the foregoing, the Company provides no warranty or undertaking, and makes no representation of any kind that the Service will meet Your requirements, achieve any intended results, be compatible or work with any other software, applications, systems or services, operate without interruption, meet any performance or reliability standards or be error free or that any errors or defects can or will be corrected.
+
+Without limiting the foregoing, neither the Company nor any of the company's provider makes any representation or warranty of any kind, express or implied: (i) as to the operation or availability of the Service, or the information, content, and materials or products included thereon; (ii) that the Service will be uninterrupted or error-free; (iii) as to the accuracy, reliability, or currency of any information or content provided through the Service; or (iv) that the Service, its servers, the content, or e-mails sent from or on behalf of the Company are free of viruses, scripts, trojan horses, worms, malware, timebombs or other harmful components.
+
+Some jurisdictions do not allow the exclusion of certain types of warranties or limitations on applicable statutory rights of a consumer, so some or all of the above exclusions and limitations may not apply to You. But in such a case the exclusions and limitations set forth in this section shall be applied to the greatest extent enforceable under applicable law.
+
+## Governing Law
+
+The laws of the Country, excluding its conflicts of law rules, shall govern this Terms and Your use of the Service. Your use of the Application may also be subject to other local, state, national, or international laws.
+
+## Disputes Resolution
+
+If You have any concern or dispute about the Service, You agree to first try to resolve the dispute informally by contacting the Company.
+
+## For European Union (EU) Users
+
+If You are a European Union consumer, you will benefit from any mandatory provisions of the law of the country in which You are resident.
+
+## United States Legal Compliance
+
+You represent and warrant that (i) You are not located in a country that is subject to the United States government embargo, or that has been designated by the United States government as a "terrorist supporting" country, and (ii) You are not listed on any United States government list of prohibited or restricted parties.
+
+## Severability and Waiver
+
+### Severability
+
+If any provision of these Terms is held to be unenforceable or invalid, such provision will be changed and interpreted to accomplish the objectives of such provision to the greatest extent possible under applicable law and the remaining provisions will continue in full force and effect.
+
+### Waiver
+
+Except as provided herein, the failure to exercise a right or to require performance of an obligation under these Terms shall not affect a party's ability to exercise such right or require such performance at any time thereafter nor shall the waiver of a breach constitute a waiver of any subsequent breach.
+
+## Translation Interpretation
+
+These Terms and Conditions may have been translated if We have made them available to You on our Service. You agree that the original English text shall prevail in the case of a dispute.
+
+## Changes to These Terms and Conditions
+
+We reserve the right, at Our sole discretion, to modify or replace these Terms at any time. If a revision is material We will make reasonable efforts to provide at least 30 days' notice prior to any new terms taking effect. What constitutes a material change will be determined at Our sole discretion.
+
+By continuing to access or use Our Service after those revisions become effective, You agree to be bound by the revised terms. If You do not agree to the new terms, in whole or in part, please stop using the website and the Service.
+
+## Contact Us
+
+If you have any questions about these Terms and Conditions, You can contact us:
+
+- By visiting this page on our website: [https://discord.gg/nDt7AjGJQH](https://discord.gg/nDt7AjGJQH)

docs/technical/dids.md

@@ -0,0 +1,18 @@
+# Discovered Ids
+
+```c
+primary DiscoveredIds {
+  utf8"DIDS" magic;
+  Header header;
+  primary Body body;
+}
+
+Header {
+  uint16 version; // always 1
+}
+
+Body {
+  uint32 count;
+  uint32[count] ids;
+}
+```

docs/technical/kitscore.md

@@ -0,0 +1,172 @@
+# KitScore
+
+## Memo
+
+KitScore is a performance metric that makes sense. This metric can be applied to any game, virtual or real. Specific pieces of information relating directly to World of Tanks Blitz will be provided within parentheses and with a "WoTB:" prefix.
+
+## Consumption of Observations
+
+KitScore is driven solely by the behavior of other players and finding meaning of a new observation within a pool of condensed data based on previously observed data. Generally, we will be provided with a number of statistics (the $x_i$ of an observation) per player (WoTB: $x_\text{frags}$, $x_\text{xp}$, $x_\text{spots}$, etc.) including a target statistic (the $x_j$ of an observation) that all other statistics try to maximize (WoTB: "winrate" which we will defined later as $x_j$).
+
+If the statistics are cumulative, they will have to be normalized (WoTB: statistics fetched from Wargaming are indeed cumulative even for a single player; $x_\text{frags}=\frac{\Sigma x_\text{frags}}{\Sigma x_\text{battles}}$, $x_\text{spots}=\frac{\Sigma x_\text{spots}}{\Sigma x_\text{battles}}$, $x_j=\frac{\Sigma x_\text{wins}}{\Sigma x_\text{battles}}$, etc.). Each player will have such average statistics, giving us many points of data to work with. If the statistics are not cumulative, then you will be dealing with multiple observations per player which will only help improve accuracy.
+
+## It's Impossible to "Find What Makes the Metric Tick"
+
+WN8, a widely adopted metric in the World of Tanks and World of Tanks Blitz communities is plagued with problems. One of them being that people often find and exploit "what makes the metric tick." In other words, people easily exploit the rudimentary nature of WN8 to score undeservedly high.
+
+In WN8, the gains of some rewarding categories overshadow the losses of others though that may not necessarily be in the best interest in maximizing winrate. KitScore makes this nearly impossible as it punishes a player for scoring well solely high in a certain category. You will never exploit KitScore. Period.
+
+## Generating Reasonable Values
+
+TODO: there's like no runaway cases
+
+## Symbol Interpretation
+
+| Symbol           | Interpretation                                                                                                                                         |
+| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| $A_\text{human}$ | The human readable version of the raw score $A$.                                                                                                       |
+| $A$              | The raw KitScore.                                                                                                                                      |
+| $C$              | An arbitrary coefficient.                                                                                                                              |
+| $I$              | The number of statistics including the target statistic. This means that there are $I-1$ entries for $x_i$ and $1$ entry for $y$ for each observation. |
+| $i$              | The statistic index of where there are $I$ entries.                                                                                                    |
+| $j$              | A discriminator for the target statistic. There may never be more than $1$ entries for $j$.                                                            |
+| $m$              | The degree of the polynomial regression.                                                                                                               |
+| $n$              | The number of observations.                                                                                                                            |
+| $a$              | An "atomic" score which is a function of the $i$th statistic.                                                                                          |
+| $w$              | The weight of the $i$th atomic statistic.                                                                                                              |
+
+## Computing the Score
+
+The final metric $A_\text{human}$ is an arbitrarily scaled value of the raw score $A$ where $C$ is any coefficient of your liking. BlitzKit uses $C=10^3$.
+
+$$
+A_\text{human}=CA
+$$
+
+The final metric $A$ is the weighted average of individual scores $a$ which are functions of the $i$th statistic excluding the target statistic $j$ itself.
+
+$$
+A=\frac{\sum_{i \neq j} w_{i}a_{i}}{\sum_{i \neq j} w_{i}}
+$$
+
+The "atomic" score $a$ is the difference between the predicted target statistic $P_{i \leftrightarrow j}(x_i)$ acquired using a polynomial regression of degree $m$ and the actual newly observed $x_j$.
+
+$$
+a_i=x_j-P_{i \leftrightarrow j}(x_i)
+$$
+
+The polynomial regression of $m$th degree can be written as follows:
+
+$$
+P(x)=\beta_0x^0+\beta_1x^1+\beta_2x^2+\dots+\beta_mx^m
+$$
+
+Polynomial regression coefficients $\beta$ can be acquired through basic linear algebra where an $m \times m$ of constants is multiplied with $m \times 1$ of unknowns which equals another $m \times 1$ of constants.
+
+```math
+\begin{bmatrix}
+\sum_{k=1}^n x_i^0 & \sum_{k=1}^n x_i^1 & \sum_{k=1}^n x_i^2 & \dots & \sum_{k=1}^n x_i^m \\
+\sum_{k=1}^n x_i^1 & \sum_{k=1}^n x_i^2 & \sum_{k=1}^n x_i^3 & \dots & \sum_{k=1}^n x_i^{m+1} \\
+\sum_{k=1}^n x_i^2 & \sum_{k=1}^n x_i^3 & \sum_{k=1}^n x_i^4 & \dots & \sum_{k=1}^n x_i^{m+2} \\
+\vdots & \vdots & \vdots & \ddots & \vdots \\
+\sum_{k=1}^n x_i^m & \sum_{k=1}^n x_i^{m+1} & \sum_{k=1}^n x_i^{m+1} & \dots & \sum_{k=1}^n x_i^{2m} \\
+\end{bmatrix}
+
+\begin{bmatrix}
+\beta_0 \\
+\beta_1 \\
+\beta_2 \\
+\vdots \\
+\beta_m
+\end{bmatrix}
+
+=
+
+\begin{bmatrix}
+\sum_{k=1}^n x_jx_i^0 \\
+\sum_{k=1}^n x_jx_i^1 \\
+\sum_{k=1}^n x_jx_i^2 \\
+\vdots \\
+\sum_{k=1}^n x_jx_i^m
+\end{bmatrix}
+```
+
+The weight $w$ is a slice of the Pearson corelation matrix. The numerator is the corelation between the $i$th statistic and the target statistic $j$ while the denominator the sum of the corelations between the $i$th statistic and all statistics but the target statistic $j$.
+
+$$
+w_{i}=\frac{r_{i\leftrightarrow j}^2}{\sum_{i_{k}\neq j}r_{i\leftrightarrow i_{k}}^2}
+$$
+
+## Understanding the Corelation Matrix
+
+Forming the corelation matrix will create an $I \times I$ matrix where. This matrix is best represented as a table. The example below illustrates a matrix/table for $I=4$ which includes $3$ entries for $i$ statistics and $1$ entry for the $j$ target statistic.
+
+|       | $x_1$                       | $x_2$                       | $x_3$                       | $x_j$                       |
+| ----- | --------------------------- | --------------------------- | --------------------------- | --------------------------- |
+| $x_1$ | $1$                         | $r_{1 \leftrightarrow 2}^2$ | $r_{1 \leftrightarrow 3}^2$ | $r_{1 \leftrightarrow j}^2$ |
+| $x_2$ | $r_{1 \leftrightarrow 2}^2$ | $1$                         | $r_{2 \leftrightarrow 3}^2$ | $r_{2 \leftrightarrow j}^2$ |
+| $x_3$ | $r_{1 \leftrightarrow 3}^2$ | $r_{2 \leftrightarrow 3}^2$ | $1$                         | $r_{3 \leftrightarrow j}^2$ |
+| $x_j$ | $r_{1 \leftrightarrow j}^2$ | $r_{2 \leftrightarrow j}^2$ | $r_{3 \leftrightarrow j}^2$ | $1$                         |
+
+It should not be a surprise to find $r_{i \leftrightarrow i}^2=1$ which forms a neat diagonal across the table. Note that there are many duplicates within the $I^2$ entries. The "bottom-right triangle" can be eliminated to remove redundancies leaving us with only $\frac{I(I+1)}{2}$ fields occupied.
+
+|       | $x_1$ | $x_2$                       | $x_3$                       | $x_j$                       |
+| ----- | ----- | --------------------------- | --------------------------- | --------------------------- |
+| $x_1$ | $1$   | $r_{1 \leftrightarrow 2}^2$ | $r_{1 \leftrightarrow 3}^2$ | $r_{1 \leftrightarrow j}^2$ |
+| $x_2$ |       | $1$                         | $r_{2 \leftrightarrow 3}^2$ | $r_{2 \leftrightarrow j}^2$ |
+| $x_3$ |       |                             | $1$                         | $r_{3 \leftrightarrow j}^2$ |
+| $x_j$ |       |                             |                             | $1$                         |
+
+When programming this matrix into an array, $r_{i \leftrightarrow i}^2=1$ will be redundant. I recommend condensing the matrix into an array of size $\frac{I(I+1)}{2}+I=\frac{I(I-1)}{2}$ to avoid all redundant entries. For $I=4$, the array will look something like the one illustrated below (here, $j=4$).
+
+$$
+[r_{1 \leftrightarrow 2}^2, r_{1 \leftrightarrow 3}^2, r_{1 \leftrightarrow 4}^2, r_{2 \leftrightarrow 3}^2, r_{2 \leftrightarrow 4}^2, r_{3 \leftrightarrow 4}^2]
+$$
+
+## Understanding the Weights
+
+Some may find the weight equation arbitrary; it evidently isn't. The goal of $w$ is to eliminate over-rewarding the same behavior represented in multiple statistics. It makes all atomic statistics concurrent by leveraging the Pearson corelation matrix.
+
+A simplified example will clarify the idea. First, we compute a Pearson corelation matrix for $I=3$ statistics. We have $x_1$ and $x_2$, the statistics that are trying to maximize $x_j$. Reminder: a Pearson corelation matrix finds the $r$ value not only between $x_i$ and $x_j$ but also between all combinations of $x_i$ and themselves. Here, $r^2$ is calculated using polynomial regression corelation analysis to the $m$th degree.
+
+|       | $x_1$ | $x_2$       | $x_3$ | $x_j$ |
+| ----- | ----- | ----------- | ----- | ----- |
+| $x_1$ | $1$   | $\boxed{0}$ | $0$   | $1$   |
+| $x_2$ |       | $1$         | $0$   | $1$   |
+| $x_3$ |       |             | $1$   | $1$   |
+| $x_j$ |       |             |       | $1$   |
+
+In the case above, $r^2_{1 \leftrightarrow 2}=0$ meaning that both statistics have absolutely nothing to do with each other. Hence, the player will be awarded for optimizing both individually. And since $r^2_{1 \leftrightarrow j}=r^2_{2 \leftrightarrow j}$, they should both be rewarded equally; in other words, they should have equal weights.
+
+$$
+w_{1}=\frac{1}{1 + 0 + 0}=1
+$$
+
+$$
+w_{2}=\frac{1}{0 + 1 + 0}=1
+$$
+
+$$
+w_{3}=\frac{1}{0 + 0 + 1}=1
+$$
+
+Now consider a case where $x_1$ and $x_2$ are fully correlated. It would be a bad idea to reward them equally; hence, their weights suffer.
+
+|       | $x_1$ | $x_2$       | $x_3$ | $x_j$ |
+| ----- | ----- | ----------- | ----- | ----- |
+| $x_1$ | $1$   | $\boxed{1}$ | $0$   | $1$   |
+| $x_2$ |       | $1$         | $0$   | $1$   |
+| $x_3$ |       |             | $1$   | $1$   |
+| $x_j$ |       |             |       | $1$   |
+
+$$
+w_{1}=\frac{1}{1 + 1 + 0}=0.5
+$$
+
+$$
+w_{2}=\frac{1}{1 + 1 + 0}=0.5
+$$
+
+$$
+w_{3}=\frac{1}{0 + 0 + 1}=1
+$$