An always-on, on-chain medieval strategy game where your realm keeps producing, marching and fighting 24/7 โ even while you sleep. Raise armies, raid other real players, climb the ranks, and earn a daily share of a real SOL reward pool just for holding the token.
CA: qYc4gQ9xVq48XmeBBUh7GMfTYycoLS1m3VTT9tapump
- What is Realm Rumble?
- The Gameplay
- Play-to-Earn: Token Rewards
- Sign in your way
- Tech Stack
- Architecture
- Local Development
- Deployment
- Roadmap
- Links
- License
Realm Rumble is a persistent, browser-based real-time strategy game played on one shared world map. Think classic base-building and conquest โ gather resources, raise a settlement, train armies and crush your rivals โ but with two twists that make it different:
- The world never stops. Your economy produces and your armies march around the clock. Log off and your realm keeps growing; come back to find rivals have made their move. There is no "match" โ just one continuous world.
- It pays out real Solana. Hold the game token and a slice of a fixed daily 1 SOL pool accrues to your wallet, claimable as real SOL. The bigger your holdings, the bigger your multiplier. No token? Play the entire game for free in demo mode.
One settlement. Four ages. A living world of rivals โ and real SOL on the line.
It runs entirely in the browser, renders the world in a custom isometric engine, and streams the living world to every player over WebSockets in real time.
The core loop is simple to learn and deep to master:
Gather โ Build & Fortify โ Advance Ages โ Train Armies โ Raid Rivals โ Climb the Ranks
Every ruler shares one map. Your settlement sits on it permanently. Buildings produce resources every second, armies travel in real time, and rival empires (other real players and AI) act on their own โ whether you're watching or not. Walk your hero around your base in the isometric view, harvest resource nodes, fend off wandering brigands and wolves, and place new buildings wherever you like.
Four resources drive everything. Economy buildings produce them passively, second by second:
| Resource | Used for |
|---|---|
| ๐ชต Wood | The construction backbone โ almost every building needs it. |
| ๐พ Food | Feeds your population and trains most units. |
| ๐ช Gold | Funds advanced units, research and trade. |
| ๐ชจ Stone | Walls, keeps, and advancing through the later ages. |
Spend resources to raise and upgrade your settlement. Buildings fall into three roles:
- Economy โ lumber camps, farms, mines and quarries that generate wood, food, gold and stone over time. Upgrade them to produce faster.
- Military โ barracks and ranges that train your soldiers, plus the Keep for stronger defense.
- Defensive โ walls, towers and gates to barricade your territory, and prestige structures like the Temple and Wonder.
Every building you place and level up raises your empire's power โ the score that drives your rank and your standing on the leaderboard.
Research your way through history. Each age unlocks stronger buildings, better units and greater storage:
| Age | What it brings |
|---|---|
| ๐ Dark Age | Your humble beginning โ villagers and the basics. |
| ๐ก๏ธ Feudal Age | Barracks, spearmen and your first real army. |
| ๐ฐ Castle Age | Archers, stronger walls and serious fortifications. |
| ๐ Imperial Age | Knights, wonders and the mightiest structures in the realm. |
Train troops to defend your land and raid your enemies. Each unit has a role:
| Unit | Role |
|---|---|
| ๐งโ๐พ Villager | Workers โ gather and build. The backbone of your economy. |
| ๐ก๏ธ Spearman | Cheap, sturdy infantry โ your front line. |
| ๐น Archer | Ranged damage from the back rank. |
| ๐ Knight | Heavy cavalry โ expensive, devastating, the hammer of your army. |
Gear them up in the shop with weapons and armour to push their stats even higher.
When you march on a rival, the battle isn't decided on paper โ you spectate it live in the isometric world. Watch your warriors swing their swords, your knights charge, and the enemy's buildings get razed in real time. Winners take loot up to their army's carry capacity; the losing army takes heavy casualties. Raze enough of a foe's buildings and you cripple their economy and power.
Raids cut both ways โ rivals will come for you. Keep a standing garrison and barricade your territory with walls, towers and gates. Defenders fight with their defense power, boosted by your fortifications and a home-ground advantage, so a well-walled base can turn back a much larger army. Fortify before you over-extend.
You don't just command โ you have an avatar on the field. Customise your hero, buy a helmet and armour (extra HP) and a weapon in the shop โ and your gear shows on the character on-screen. Learn traits for lasting perks: some are free (Hardy, Keen Eye, Brawler), others cost coins and boost your HP, harvest yield or damage.
Your power places you on the renown ladder. Each rank grants a permanent harvest bonus, so winning and building pays off forever:
| Rank | Power required | Harvest bonus |
|---|---|---|
| Peasant | 0 | 1.00ร |
| Footman | 120 | 1.10ร |
| Squire | 300 | 1.20ร |
| Knight | 700 | 1.35ร |
| Baron | 1,500 | 1.50ร |
| Warlord | 3,000 | 1.70ร |
| Conqueror | 6,000 | 2.00ร |
| ๐ Emperor | 12,000 | 2.50ร |
As your empire grows you complete quests automatically โ building your first lumber camp, fielding an army, reaching a new age and more. Claim each for coins and resources. Coins are precious: spend them to rush any construction, training or research to finish it instantly, or to buy hero gear and traits.
A live directory of every empire on the map โ rulers and AI alike. Search and filter them, then click any empire to:
- Scout their power, rank, army size, buildings and raids won.
- Spectate their actual settlement, rendered with the real isometric engine.
- Invade them โ march straight from the browser with the target pre-selected.
The world is seeded with AI empires across difficulty tiers, so there's always something to fight โ from defenceless hamlets to fearsome conquerors. Weaker empires are far more common, so you always have someone to farm for loot and power, while the top tiers offer a real challenge.
| Tier | Name | Strength |
|---|---|---|
| 0 | Hamlet | defenceless pushovers |
| 1 | Rookie | up to 280 power |
| 2 | Squire | up to 700 |
| 3 | Knight | up to 1,600 |
| 4 | Warlord | up to 3,600 |
| 5 | Conqueror | unlimited |
A single pool of 1 SOL per day is shared among all token holders. Your slice is pro-rata to your share of supply, then boosted by your holder tier:
your daily SOL = (your tokens รท total supply) ร 1 SOL ร tier multiplier
๐ Hard-capped. The treasury emits at most 1 SOL per day total across everyone. The tier multiplier only sets how fast you accrue (your claim priority) โ never extra SOL on top of the pool. When the day's pool is used up, claims resume tomorrow.
The more you hold, the higher your tier and the bigger your multiplier (up to 3ร):
| Tier | Supply share | Multiplier |
|---|---|---|
| ๐ฅ Bronze | any holder | 1.00ร |
| ๐ฅ Silver | โฅ 0.1% | 1.25ร |
| ๐ฅ Gold | โฅ 0.5% | 1.50ร |
| ๐ท Sapphire | โฅ 2% | 2.00ร |
| ๐ Diamond | โฅ 5% | 3.00ร |
- On-chain holdings. Your SPL-token balance is read live on-chain against the circulating supply โ no manual registration.
- Continuous accrual. Rewards build up from the moment you're first seen holding. You don't need to be online.
- Claim cadence. Your first claim is available any time, then once every 6 hours (4ร a day). A live countdown shows when your next claim unlocks.
- Real SOL, mainnet. Claims send real SOL on Solana mainnet, straight from the treasury to your wallet.
- Your dashboard shows your tier, multiplier, claimable amount, total earned, and the day's remaining shared pool.
No token? Play the entire game for free in demo mode with worthless in-game coins. Everything works โ you just don't earn real SOL until you hold and connect a wallet.
No passwords. The same identity always returns to the same empire:
| Method | What you get |
|---|---|
| ๐ Solana wallet (Phantom & friends) | Empire tied to your address; holdings unlock real SOL rewards. |
| โ๏ธ Email | A full empire now; connect a wallet later from the dashboard to start earning. |
| ๐ฎ Demo mode | One click, no wallet, worthless coins โ perfect for learning the ropes. |
Auth is handled by Privy, with wallet ownership verified by signature.
| Layer | Tech |
|---|---|
| Frontend | React 18 ยท TypeScript ยท Vite ยท Tailwind CSS ยท Zustand ยท React Router ยท HTML5 Canvas (custom isometric renderer) |
| Realtime | Socket.IO โ live world snapshots & player actions stream over WebSockets |
| Backend | Node.js ยท Express ยท tsx (runtime TypeScript) ยท JSON persistence |
| Web3 | Solana Web3.js ยท SPL-Token ยท Privy (wallet + email auth) |
| Tooling | npm workspaces monorepo ยท a shared types/data package consumed by both client & server |
Realm Rumble is a TypeScript monorepo with three npm workspaces. The server owns the authoritative game state, runs the simulation on a tick, streams snapshots to clients over Socket.IO, and (in production) serves the built client from the same origin.
realm-rumble/
โโโ client/ # React + Vite front-end
โ โโโ src/
โ โ โโโ world/ # isometric engine, renderer, character sprites & tiles
โ โ โโโ game/ # in-game panels: hero, army, shop, rewards, spectateโฆ
โ โ โโโ pages/ # landing, play, empires, dashboard, docs, guide, auth
โ โ โโโ components/# navbar, footer, splash screen, toastsโฆ
โ โ โโโ lib/ # Zustand store, api client, web3, Privy bridge
โ โโโ public/ # sprites, tiles, logo, splash art
โ
โโโ server/ # Node + Express + Socket.IO game server
โ โโโ src/ # world engine, bot AI, combat, auth, Solana rewards/payouts
โ
โโโ shared/ # types + game data (units, buildings, ages, ranks, tiers)
# imported by BOTH client & server โ one source of truth
Prerequisites: Node.js 18+
# install all workspaces
npm install
# run the client (5173) and server (4000) together
npm run devThen open http://localhost:5173. The game runs fully in demo mode out of the box โ no configuration needed.
Realm Rumble deploys as a single service โ the server builds and serves the client from the same origin (no CORS, one URL).
- Build:
npm install --include=dev && npm run build - Start:
npm run start - Listens on
process.env.PORT; servesclient/dist+ the API + Socket.IO. - Mount a persistent volume at
server/dataso the world survives redeploys.
- Live token launch & on-chain rewards switched on
- Player-vs-player loot of a rival's accrued SOL on a winning raid
- Alliances & clans
- Seasonal leaderboards & rewards
- Mobile-optimised controls
- More unit types, buildings and map biomes
- In-game marketplace for trading resources
ยฉ 2026 Realm Rumble. All rights reserved.
Built for strategists. โ๏ธ