⚙️ bloxblitz-foundry

The engine room of Blox Blitz — game logic, economy, and the fair-launch toolchain.

A fast voxel RTS on Solana where skill wins and cosmetics are truly owned.

Play · X · Telegram

---

What is bloxblitz-foundry

The foundry holds the parts of Blox Blitz that decide outcomes: the gather-build-train-attack loop, the rock-paper-scissors combat resolver, faction modifiers, the server-authoritative economy, and the scripts that run the $BLOX fair launch. The browser client renders the war. The foundry rules it.

One Node process serves the Three.js client and the API. Rewards, cosmetic unlocks, and the marketplace resolve server-side so ownership and the ladder stay cheat-resistant.

---

Core Mechanics

System	Rule
💎 Cryo economy	One resource. Workers mine it; a Depot near far veins cuts travel time.
⚔️ RPS combat	Rifleman › Rocket › Tank › Rifleman. Cavalry raids workers and flanks.
🛡️ Factions	Vanguard (rush), Bastion (turtle), Syndicate (economy) apply stat modifiers.
🌫️ Fog of war	Enemy base spawns at a random tile each match; vision reveals, memory dims.
🏅 Two currencies	Points are earned and free. $BLOX settles the marketplace.
🏆 Seasons	Server-authoritative rewards; the ladder resets every 14 days.

Holder Tiers — $BLOX

Tier	Hold	Unlocks
Recruit	0%	Full game, standard fees, ranked play
Sergeant	0.1%	−25% marketplace fee, a cosmetic drop
Captain	0.5%	−50% fee, token-gated season events, exclusive skins
General	1%+	−75% fee, governance vote, early access

---

How It Works

   GATHER ─────────▶ BUILD ──────────▶ TRAIN ───────────▶ ATTACK
   workers mine      barracks /         RPS army +         scout fog,
   Cryo, drop a      turret /           cavalry            push enemy HQ
   Depot             upgrade HQ              │                  │
      ▲                                      ▼                  ▼
      │                          ┌───────────────────────────────────┐
      └──────────  WIN  ◀────────┤ season points + $BLOX → own & trade │
                                 │ cosmetics → climb the ladder        │
                                 └───────────────────────────────────┘

Architecture

┌──────────────────────────────────────────────────────────────┐
│  ONE NODE PROCESS                                             │
│                                                              │
│  ┌────────────────┐   serves    ┌──────────────────────────┐ │
│  │  GAME CLIENT   │ ◀────────── │  EXPRESS APP              │ │
│  │  (Three.js)    │  static     │  · /api auth, profile     │ │
│  │  · voxel RTS   │             │  · match → reward + ladder │ │
│  │  · A* path     │   /api      │  · marketplace (5% burn)   │ │
│  │  · fog / mmap  │ ◀─────────▶ │  · /ws realtime (V2)       │ │
│  └────────────────┘   JSON      └────────────┬─────────────┘ │
└───────────────────────────────────────────────┼─────────────┘
              wallet sign-in │                   │ SQL
                             ▼                   ▼
                   ┌──────────────┐   ┌────────────────────┐
                   │   SOLANA     │   │  CLOUD POSTGRES     │
                   │  $BLOX · sig │   │  schema: bloxblitz  │
                   └──────────────┘   └────────────────────┘

Full container model: SYSTEM_DESIGN.md.

---

Tech Stack

Layer	Technology
Renderer	Three.js (isometric ortho cam, InstancedMesh voxel terrain)
Game logic	A* pathfinding, per-block movement, fog of war, RPS resolver
Server	Node.js 20+, Express, native WebSocket (ws)
Auth	Solana wallet sign-in (nonce + tweetnacl verify)
Data	Cloud Postgres (ACID, isolated bloxblitz schema)
Launch	PumpFun 100% fair launch · fair-launch scripts in scripts/

---

Fair-Launch Toolchain

The blueprint is a 100% fair launch with no custom on-chain program. The foundry ships scripts instead of contracts:

Script	Purpose
scripts/tokenomics_calc.ts	Model supply, burn schedule, and tier thresholds for $BLOX.
scripts/pump_integrator.ts	Read PumpFun curve state and surface launch metrics.

npm install
npx tsx scripts/tokenomics_calc.ts --supply 1000000000 --burn 0.05

---

Roadmap

Phase	Window	Highlights
1 — Launch-Ready	Now → 2 weeks	Voxel RTS loop, factions, cosmetics, ladder, $BLOX fair launch
2 — Multiplayer	1–2 months	Real-time PvP (server-authoritative sim), on-chain marketplace
3 — Depth	3–5 months	New units, tech tree, FFA & 2v2, wagered matches
4 — Ecosystem	6–12 months	Map editor, tournaments, governance

---

Reference Links

Resource	Link
Play	https://bloxblitz.fun
Docs / Codex	../bloxblitz-codex
API Gateway	../bloxblitz-gateway
Game Client	../bloxblitz-arena
X	https://x.com/bloxblitz_
Telegram	https://t.me/blox_blitz

License

MIT

---

Blox Blitz — build a blocky base, command a voxel army, win in minutes. Provided for informational purposes only. $BLOX is a utility token for cosmetics and access, not an investment. Verify the official contract address on official channels before trading.