Blox Blitz is a snappy, browser-native voxel RTS where matches last minutes instead of an hour. You gather one resource, command six unit types in a clean rock-paper-scissors meta, and race to crush the enemy HQ through the fog of war. Skill decides every match. The cosmetics you earn are owned, tradeable assets settled in $BLOX — never stat boosts.

It is a real game first. The token rides on top of a product that already exists and plays.

Why it is different:

• 🧠 Strategy depth, condensed — one resource, six units, three factions. Easy to learn, hard to master.
• 🚫 Zero pay-to-win — every cosmetic is visual only. A free player has the exact same combat power.
• 💎 Cosmetics you truly own — a CS:GO-style economy of trails, auras, emblems and banners you can trade for $BLOX.
• 🌐 Web-native & instant — no install, plays in the browser, short matches built for shareable clips.
• 🏆 A live ladder & market — season points and a player-priced marketplace drive real demand.
• ✅ Shipped, not promised — a working 3D voxel RTS plus a full-stack backend already run today.

   ┌────────────┐     ┌────────────┐     ┌────────────┐     ┌────────────┐
   │ 1. FACTION │ ──▶ │ 2. GATHER  │ ──▶ │ 3. BUILD   │ ──▶ │ 4. TRAIN   │
   │ HQ+workers │     │ mine Cryo  │     │ barracks / │     │ RPS army + │
   │ + Cryo     │     │ build Depot│     │ turret /HQ │     │ cavalry    │
   └────────────┘     └────────────┘     └────────────┘     └─────┬──────┘
                                                                  │
        ┌─────────────────────────────────────────────────────────┘
        ▼
   ┌────────────┐     ┌────────────┐     ┌──────────────────────────────┐
   │ 5. SCOUT   │ ──▶ │ 6. ATTACK  │ ──▶ │  WIN → season points + $BLOX │
   │ pierce fog │     │ push enemy │     │  → own & trade cosmetics →   │
   │ find base  │     │ HQ to win  │     │  climb the ladder, run it back│
   └────────────┘     └────────────┘     └──────────────────────────────┘

One Node process serves both the Three.js client and the API. No separate frontend server.

# 1. Clone
git clone https://github.com/bloxblitzfun/blox-blitz.git
cd blox-blitz/prototype/server

# 2. Configure DB credentials
cp .env.example .env        # fill PGHOST / PGUSER / PGPASSWORD ...

# 3. Install & run (Node 20.6+ for native --env-file)
npm install
node --env-file=.env server.js

Open http://localhost:8787 — connect a wallet (or play as guest), pick a faction, and blitz.

The server verifies its Postgres connection on boot and exits if it cannot reach the database. Make sure your .env points at a reachable Postgres instance before starting.

Principle: $BLOX trades looks, never power. The game is free and fair for everyone; the token layers an owned economy on top.

Blox Blitz launches only through its official channels. Protect yourself:

• The only official links are listed at the top of this README (bloxblitz.fun, @bloxblitz_, t.me/blox_blitz).
• There is no presale, no private allocation, and no airdrop DM. $BLOX is a 100% fair launch on PumpFun.
• Anyone DMing you a "team contract", "presale spot", or "early access" link is a scammer. The team will never DM you first.
• Always verify the contract address (CA) against the pinned post on the official X and Telegram before trading.

When in doubt, assume anything from a stranger is a scam.