Skip to content

playRealmRumble/Realm-Rumble

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

13 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Realm Rumble

Build an empire. Raid real rivals. Earn real Solana.

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.


Play Now Follow on X

CA: qYc4gQ9xVq48XmeBBUh7GMfTYycoLS1m3VTT9tapump


TypeScript React Vite Tailwind CSS Node.js Socket.IO Solana Privy


๐Ÿ“œ Table of Contents


๐Ÿฐ What is Realm Rumble?

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:

  1. 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.
  2. 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 Gameplay

The core loop is simple to learn and deep to master:

Gather  โ†’  Build & Fortify  โ†’  Advance Ages  โ†’  Train Armies  โ†’  Raid Rivals  โ†’  Climb the Ranks

A living, always-on world

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.

๐Ÿชต Resources & Economy

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.

๐Ÿ—๏ธ Buildings

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.

๐Ÿ›๏ธ The Four Ages

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.

โš”๏ธ Armies & Units

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.

๐Ÿ”ฅ Combat & Live Raids

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.

๐Ÿ›ก๏ธ Defending Your Realm

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.

๐ŸŽ–๏ธ Your Hero

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.

โšœ๏ธ Renown Ranks

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ร—

๐Ÿ“œ Quests & Progression

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.

๐ŸŒ The Empires Browser

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.

๐Ÿค– Enemy Difficulty Tiers

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

๐Ÿ’ฐ Play-to-Earn: Token Rewards

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.

Holder tiers

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ร—

How payouts work

  • 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.

Demo mode

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.


๐Ÿ” Sign in your way

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.


๐Ÿ› ๏ธ Tech Stack

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

๐Ÿ—๏ธ Architecture

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

๐Ÿš€ Local Development

Prerequisites: Node.js 18+

# install all workspaces
npm install

# run the client (5173) and server (4000) together
npm run dev

Then open http://localhost:5173. The game runs fully in demo mode out of the box โ€” no configuration needed.


โ˜๏ธ Deployment

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; serves client/dist + the API + Socket.IO.
  • Mount a persistent volume at server/data so the world survives redeploys.

๐Ÿ—บ๏ธ Roadmap

  • 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

๐Ÿ”— Links

Website X


๐Ÿ“œ License

ยฉ 2026 Realm Rumble. All rights reserved.


Built for strategists. โš”๏ธ

About

Build. Conquer. Earn Solana. An always-on strategy game on Solana where real rulers clash 24/7. Your throne is waiting.

Resources

Stars

Watchers

Forks

Contributors