Live on Solana Mainnet

The Blockchain
is a Living City

SOLANApolis visualizes the entire Solana blockchain as a real-time 3D city. Every wallet becomes a building. Fly planes. Drive cars. Sail boats. Battle 1,000 players. NPCs remember you across sessions. Explore the globe.

Play Now npx solanapolis GitHub
1,000
City Slots
100
Planes
250
Cars
12
AI NPCs

What You Can Do

A Complete Blockchain City

Every feature is live on mainnet. No testnet, no mockups — real wallets, real buildings, real multiplayer.

🏙️

3D Solana City

Every wallet with swap history generates a unique building. Height and detail scale with trading volume. Five skyscraper types with procedural window shaders, day/night cycle with atmospheric dome, and instanced rendering for 60fps with thousands of buildings.

✈️

Fly Planes

First 100 wallets get a personal plane circling their building. Enter plane mode for WASD flight with pointer-lock mouse look, chase camera, and full combat. Fire projectiles and dogfight other players in real time.

🚗

Drive Cars

First 250 wallets get a resident car. Enter car mode for third-person driving with bicycle-model physics, AABB collision detection, and combat. AI swap cars drive the streets carrying live trade metadata.

Sail Boats

Drive to the harbor for a cinematic departure sequence — car transfer through downtown, dock handoff animation, then open-water sailing. Full water physics with wave bob, hull pitch, and wake effects.

🌍

Explore the Globe

Zoom out to an interactive 3D Earth powered by CesiumJS. Millions of real-world buildings via OSM 3D Tiles. Fly to 9 world cities, enter a full Cesium flight simulator, or open Google Street View with Shift+click.

💥

1000-Player PvP Combat

InstancedMesh rendering supports 1000 remote players. Spatial-hash hit detection, player HP system, damage networking, camera shake, crash animations with debris physics, and 30-second respawn.

🧠

NPCs That Remember You

12 AI NPCs powered by Grok + Honcho persistent memory. Each NPC builds a unique understanding of each player across sessions. Nova remembers your city questions, Cipher tracks your security knowledge, Drift recalls your trades.

🤖

AI Town Simulation

Full tick-based game engine running on Convex with A* pathfinding. NPCs walk city roads, start conversations, form memories, and react to player interactions. Click any NPC to start a real simulation conversation.

🦞

Bikini Bottom

Underwater district east of the city with lobster NPCs, pineapple house, coral reef, animated kelp, tiki buildings, glass dome, and caustic lighting. Token-gated via $MAWD on Helius DAS API.

🌅

Dynamic Sky System

8-keyframe day/night cycle with separate horizon, zenith, and sun-glow colors per phase. Custom GLSL atmosphere dome with 3-layer solar halo, moon glow, and smooth dawn-to-night transitions.

💬

City Chat & Companions

Real-time in-game chat with AI streaming responses. Create custom companion agents with unique personalities. Persistent conversation threads saved per wallet across sessions.

🗺️

CLI Dashboard

Run npx solanapolis for an interactive terminal dashboard with live city stats, Solana network data, wallet lookup, and ASCII city map. Or --serve for the full 3D game locally.


Limited Economy

City Slots

First come, first served. The earliest wallets get the best perks.

✈️

Planes

100

Personal plane circling above your building at a unique altitude, speed, and color

🚗

Cars

250

Resident car driving city streets near your block with a distinct color from a 20-color palette

🏢

Buildings

1,000

Unique building sized by your on-chain activity — height, width, and detail scale with volume


Persistent AI Residents

Meet the Citizens

12 AI NPCs live in Solanapolis. Each has a unique personality, remembers you across sessions via Honcho persistent memory, and participates in the AI Town simulation.

Nova

Unofficial mayor. Knows every wallet, every building. Welcomes newcomers with city lore and tips about pump.fun launches turning into neighborhoods.

Cipher

Security researcher. Patrols streets watching for MEV, sandwich attacks, and wallet drainers. Paranoid but brilliant.

Drift

Surfer-trader. Talks about waves and token charts with equal enthusiasm. Drops alpha disguised as beach talk.

Spark

Builder and hackathon champion. Always working on the next dApp. Types faster than she talks.

Phantom

Quiet, enigmatic. Speaks rarely but with deep insight about validator economics. Rumored to run several validators.

Echo

Community manager. Knows everyone. Hosts Twitter Spaces and organizes meetups. Strong opinions on which projects are legit.

Blaze

Retired DeFi degen. Made and lost fortunes. Shares war stories about yield farming and the time he burned 10,000 SOL.

Nexus

AI researcher studying blockchain consciousness. Treats the NPCs as research subjects. Sometimes breaks the fourth wall.

Vex

Competitive gamer obsessed with the combat leaderboard. Trash-talks with love, respects skilled opponents.

Flux

Street artist. Sees every building as art shaped by on-chain history. Dreamy, creative, lost in sunsets.

Prism

Data analyst. Sees the city in numbers — TPS, epoch progress, fee averages. Precise, methodical, slightly obsessive.

Sable

Night owl. Runs a virtual jazz club. Mysterious and eloquent. Claims the city looks best when the procedural windows glow.


Under the Hood

Tech Stack

Built on bleeding-edge infrastructure for real-time 3D, AI agents, and blockchain data.

Framework
Next.js 16 (App Router)
3D Engine
React Three Fiber + Three.js
Globe & Flight
CesiumJS + Cesium Ion
Shaders
Custom GLSL (PBR + GPU Particles)
Backend
Convex (reactive, real-time)
AI Engine
Grok 4.20 Multi-Agent (OpenRouter)
NPC Memory
Honcho (persistent memory)
AI Town
Tick-based sim (A* pathfinding)
Token Gate
Helius DAS API ($MAWD)
Wallet
Phantom Connect SDK
Multiplayer
Supabase Realtime Broadcast
Blockchain
Helius API (Solana mainnet)
Mini-Map
Mapbox GL v3
Styling
Tailwind CSS
Deploy
Netlify + Fly.io + Vercel
UE5 (Optional)
Unreal Engine 5.7 + Pixel Streaming

How to Play

Game Controls

City View

Click + Drag Pan / Orbit
Scroll Zoom
Click building Select wallet
Click NPC Open conversation

Plane Mode

W / S Throttle up / down
A / D Bank left / right
Q / Space Climb
E Descend
F / Click Fire projectile
Esc Exit plane mode

Car Mode

W / S Accelerate / Brake
A / D Steer
Space Brake
F / Click Fire projectile
Esc Exit car mode

Boat Mode

W / S Throttle
A / D Steering
Space Cut engine
F / Click Fire projectile
Esc Exit boat mode

Globe View

Drag Rotate globe
Double-click Fly to location
Shift+click Street View
B Toggle buildings
L Toggle locations
Esc Return to city

Cesium Flight

W / S Throttle
A / D Bank
Space Climb
C Toggle camera
Esc Exit simulator

Get Started

Quick Start

# Interactive terminal dashboard (no browser needed)
$ npx solanapolis

# Full 3D game running locally
$ npx solanapolis --serve

# Custom port
$ npx solanapolis --serve --port 8080

# Or play live right now
$ open https://solanapolis.com

The CLI automatically installs dependencies, generates .env.local with preconfigured API tokens, starts the Next.js dev server, and opens your browser. No setup, no config files.