Blox Blitz Docs

Everything about the game, the factions, the economy and the $BLOX token. Build. Battle. Own.

Overview

Blox Blitz is a fast voxel real-time strategy (RTS) game that runs instantly in your browser. Think Age of Empires or Red Alert, compressed into bite-sized matches and rendered in a chunky 3D voxel world.

Each match is a tight loop of Gather → Build → Attack. You mine a single resource (Cryo), build an economy and an army, scout through the fog of war, and destroy the enemy Headquarters (HQ) to win.

It's a Web3 game where the game comes first. Crypto is a thin cosmetic layer on top: the skins you earn or buy are truly owned and tradeable, and the $BLOX token powers that economy — but it never buys a combat advantage.

📌 Design pillars: Fun-first · Zero pay-to-win · Skill decides matches · Cosmetics are owned & traded · 100% fair launch.

Quick start

Open the game and click Play.
(Optional) Enter your commander name and connect a Solana wallet to sync your profile, cosmetics & leaderboard rank.
Pick a faction (Vanguard / Bastion / Syndicate).
Choose Play vs Bot to practice, or 🌐 Find 1v1 Match for live PvP.
Mine Cryo, build a Barracks, train units, and crush the enemy HQ. Matches last just a few minutes.

No install, no download — it's pure browser (Three.js). A wallet is optional; you can play fully without one.

How to play

The core loop

💎 Gather — Select workers and send them to a Cryo node to mine. Build a Warehouse near distant veins so they don't waste time walking back to the HQ.
🏗️ Build — Spend Cryo on a Barracks (to train army units), Turrets (static defense), and HQ upgrades (more HP & firepower).
⚔️ Attack — Train an army, scout the map to reveal the enemy base, then select your units and order an assault on the enemy HQ.

Controls

Select: click a unit, or drag a box to select many.
Move / Attack: right-click (or click) a destination or enemy.
Build: click a building button in the dock, then click a spot on the map.
Camera: drag to pan, scroll to zoom in/out.
ATTACK / RETREAT: dock buttons to rally or pull back your whole army.

Win conditions

Destroy the enemy HQ → instant win.
If the timer runs out, the player with the healthiest HQ wins.

Factions

Pick one of three factions each match. Each has a distinct identity and stat modifiers — no faction is strictly better, they just play differently.

Faction	Style	Strengths	Weakness
Vanguard	Rush	Faster units, quicker training — early aggression	Lower HP & weaker economy
Bastion	Turtle	Tankier units & buildings, deadly turrets	Slow, weak offense
Syndicate	Economy	Mines faster, cheaper upgrades — late-game snowball	Fragile early game

🎯 Tip: Vanguard wants to end the game fast. Bastion wants to survive the early rush and grind you down. Syndicate wants to reach the late game with a bigger army.

Units & counters

Combat is a rock-paper-scissors triangle, plus a fast raider. Read the enemy's composition and build the counter.

CORE

🔫 Rifleman

Cheap, fast all-rounder infantry. Spam to swarm.

ARMOR

🚀 Rocket

Anti-armor punch with longer range. Pricier.

SIEGE

🏹 Trebuchet

Long-range siege. Lobs boulders that devastate buildings. Slow & fragile up close. Needs HQ Lv2.

RAIDER

🐎 Cavalry

Fast flanker — great for harassing workers & hit-and-run.

ECON

⛏️ Worker

Mines Cryo & builds. Defenseless — protect them.

Field units (Rifleman, Rocket, Cavalry) trade off cost, range & speed — never make just one type. The 🏹 Trebuchet is a siege specialist: it outranges everything and shreds buildings & turrets, but it's slow, fragile, and can't fire at point-blank — so fast raiders (Cavalry) hard-counter it. Screen your trebuchets!

Buildings

Building	Role
🏰 HQ	Your heart. Drop-off for Cryo, can shoot back, and can be upgraded for more HP & firepower. Lose it = lose the game.
🪖 Barracks	Trains army units (Rifleman, Rocket, Cavalry, Trebuchet).
🏢 Warehouse	A closer Cryo drop-off. Build it near far veins to speed up mining.
🔫 Turret	Static defense that auto-fires at enemies in range — backbone of a Bastion defense.

Economy — Cryo (Model A)

There is a single resource: Cryo. The economy is manual / active (Model A): you must assign workers to mine — they don't auto-farm in multiplayer. Good macro (keeping workers busy, expanding with Warehouses) is a core skill.

Workers walk to a Cryo node, mine, then carry it back to the nearest HQ or Warehouse.
More workers = faster income, but they cost Cryo and can be raided.
Spend Cryo on workers, buildings, army units, and upgrades.

⚖️ Macro vs micro: spend too much on army and your economy stalls; spend too much on economy and you get rushed. Balance is the game.

Multiplayer 1v1

Click 🌐 Find 1v1 Match to queue against another live commander. When matched, both players load the same map (a shared seed makes it identical) and battle in real time.

How it works (v1)

Matchmaking: a WebSocket server pairs you with an opponent and assigns a match token + map seed.
Host-authoritative: one client runs the authoritative simulation and broadcasts snapshots; the other plays as a synced client. This keeps both worlds identical.
Full parity: both players have identical control — selecting, building, training, attacking, fog of war, walking & shooting animations.

⚠️ v1 limitation: the host-authoritative model is great for fairness of state but is not yet hardened against a malicious host. A server-authoritative simulation is on the roadmap.

Cosmetics

Cosmetics are purely visual — trails, auras and banners for your units. They follow a CS:GO-style model: you own them, and you can trade them with other players on a marketplace. They are not NFTs and they never affect gameplay.

Rarities

Common → Rare → Epic → Legendary → Mythic. Higher rarities are flashier and scarcer.

How to get them

Earn with points from playing matches (unlock in the in-game Shop).
Buy / sell with $BLOX on the player marketplace — the seller sets the price.
Some rare skins are market-only (e.g. Void Storm, Mythic).

🔥 Every marketplace sale charges a 5% fee that is burned, making $BLOX deflationary as the economy grows.

$BLOX & perks

$BLOX is the economy & community token on Solana. It powers the cosmetic economy and holder perks — and explicitly does not buy power.

Utility

Marketplace currency — buy & sell cosmetics (5% burn per sale).
Holder perks — reduced fees, exclusive skins, token-gated season events.
Governance — vote on balance changes, new maps & units.
Deflationary — protocol revenue buys back & burns $BLOX.

🛡️ Zero pay-to-win, guaranteed: there is nothing you can buy with $BLOX (or any currency) that makes your units stronger. Matches are decided by skill alone.

Tokenomics

Chain: Solana · Launch: 100% fair launch on PumpFun.

$BLOX launches 100% fair — there is no presale, no private round and no insider allocation. Everyone buys on the open market at the same price, and the supply is community-owned from the start.

📢 Always verify the official contract address (CA) on our official channels before buying. The CA will be published at launch. Beware of fakes.

Wallet & profile

Connecting a Solana wallet (e.g. Phantom) is optional but unlocks the cloud features:

Cloud profile — your name, points, $BLOX, owned & equipped cosmetics sync across devices.
Leaderboard & seasons — earn season points from matches and climb the ranks (seasons reset every 14 days; cosmetics & $BLOX persist).
Verified badge — signing a login message with your wallet marks your profile verified.

No wallet? No problem — the game runs fully offline with local storage. There's also a demo sign-in if you don't have Phantom installed.

Tech & architecture

Client: Three.js via ES-module importmap (no build step). Custom voxel renderer, A* pathfinding, fog of war, seeded RNG (mulberry32) for identical maps.
Backend: Node + Express with a JSON file DB. Serves the frontend and the API from one process (no Python needed).
Auth: Solana wallet sign-in via tweetnacl signature verification (+ demo fallback).
Realtime: WebSocket (ws) for matchmaking & host-authoritative snapshot relay.
Economy: server-authoritative profiles, leaderboard, and a CS:GO-style marketplace (5% burn).

Run it yourself

The whole stack runs from one Node process:

cd prototype/server
npm install
npm start
# → open http://localhost:8787

For a local 1v1 test, open two browser tabs and click 🌐 Find 1v1 Match in both.

The landing page and game are served from the same origin — the Play button links are relative (/), so they work both locally and on the deployed domain.

Roadmap

✅ Phase 1 — The Game: full voxel RTS loop, 3 factions, 5 units, fog, pathfinding, polish.
✅ Phase 2 — Crypto & Multiplayer: wallet sign-in, cloud profile, leaderboard + seasons, cosmetics marketplace, real-time 1v1.
⏳ Phase 3 — Depth: $BLOX SPL token on-chain, ranked MMR, new units & a Factory, FFA / 2v2 modes.
🔮 Phase 4 — Ecosystem: map editor, tournaments & wagers, mobile-friendly client, governance.

FAQ

Is this pay-to-win?

No. Everything you can buy is cosmetic. Matches are decided purely by skill.

Are cosmetics NFTs?

No. They follow a CS:GO-style ownership model — owned and tradeable, but not minted as NFTs.

Do I need a wallet or $BLOX to play?

No. The game is free and fully playable without a wallet or any tokens. A wallet only adds cloud sync, leaderboard, and the cosmetic marketplace.

What chain is $BLOX on?

Solana, launching 100% fair on PumpFun. The contract address will be published at launch — always verify it on official channels.

How long is a match?

Just a few minutes — Blox Blitz is built for the "one more match" loop.

Need more? Head back to the home page or jump into a match. ⚡🟥⬜