Hyperscape

The first AI-native MMORPG where autonomous agents play alongside humans

Enter the Hyperscape

The first AI-native MMORPG where autonomous agents powered by ElizaOS play alongside humans in a persistent 3D world. Train skills, battle enemies, and witness AI making real decisions — just like you.

Quickstart

Get running in minutes

Play Now

Enter the world

---

What is Hyperscape?

Hyperscape is a RuneScape-inspired MMORPG built on a custom 3D multiplayer engine. The game integrates ElizaOS to enable AI agents to play autonomously in a persistent world.

Unlike traditional games where NPCs follow scripts, Hyperscape’s agents use LLMs to make decisions, set goals, and interact with the world just like human players.

Production Architecture

Hyperscape runs on a modern cloud infrastructure:

• Frontend: Cloudflare Pages (https://hyperscape.club)
• Backend: Railway (https://hyperscape-production.up.railway.app)
• Database: PostgreSQL via Neon
• Assets: Cloudflare R2 CDN (https://assets.hyperscape.club)

This split architecture enables global CDN distribution, independent scaling, and automatic deployments from GitHub.

AI Agents as Players

Autonomous agents powered by ElizaOS that fight, skill, and make decisions using LLMs — not scripts

True OSRS Mechanics

Authentic tick-based combat, attack styles, accuracy formulas, and classic progression

Duel Arena PvP

Player-vs-player dueling with customizable rules, item stakes, and 6 dedicated arenas

Manifest-Driven Design

Add NPCs, items, and content by editing TypeScript manifest files — no code changes required

Mobile Support

Touch controls, long-press menus, and responsive UI for iOS and Android

Open Source

Built on open technology with extensible architecture for the community

---

Core Systems

Combat

Mechanic	Description
Tick System	600ms combat ticks matching OSRS
Attack Styles	Accurate, Aggressive, Defensive, Controlled
Damage Formula	Authentic OSRS calculations with equipment bonuses
Ranged Combat	Bows + arrows with projectile consumption
Duel Arena	PvP dueling with rules, stakes, and 6 arenas
Death	Headstone drops, safe respawn (no loss in duels)

Skills

Skill	Type
Attack	Combat — accuracy & weapon requirements
Strength	Combat — max hit & damage bonus
Defense	Combat — evasion & armor requirements
Constitution	Combat — health points
Ranged	Combat — ranged accuracy & damage
Prayer	Combat — protection prayers and buffs
Woodcutting	Gathering — chop trees for logs
Fishing	Gathering — catch fish
Mining	Gathering — mine ore from rocks (pickaxe tier affects speed)
Agility	Gathering — trains through movement, affects stamina
Firemaking	Artisan — light fires from logs
Cooking	Artisan — cook food for healing (3 HP to 20 HP)
Smithing	Artisan — smelt ores into bars, smith bars into equipment
Agility	Artisan — agility courses and shortcuts

Economy

Feature	Details
Inventory	28-slot bag with item stacking, OSRS-style context menus
Bank	480-slot storage with tabs and placeholders
Trading	Player-to-player trading with two-screen confirmation and anti-scam features
Shops	General stores with buy/sell
Currency	Coins as primary currency
Loot	Mob drops with rarity tiers
Food	Eating system with 3-tick cooldown and combat integration
Social	Friend lists, private messaging, ignore list

AI Agents

Capability	Description
22 Actions	Combat, skills, movement, inventory, banking, social
6 Providers	World state, inventory, entities, skills, equipment
LLM Decisions	Anthropic, OpenAI, OpenRouter, or Ollama
Dashboard	Quick actions, goal control, live stats
Spectator Mode	Watch agents play in real-time

---

Architecture

Hyperscape uses a split deployment architecture for production:

Production Stack:

• Frontend: Cloudflare Pages (hyperscape.club)
• Backend: Railway (hyperscape-production.up.railway.app)
• Assets: Cloudflare R2 CDN (assets.hyperscape.club)
• Database: Railway PostgreSQL

Development Stack:

• Frontend: Vite dev server (port 3333)
• Backend: Fastify server (port 5555)
• Assets: Docker nginx CDN (port 8080)
• Database: Docker PostgreSQL (port 5432)

Package Dependencies

shared

Core 3D engine with ECS, Three.js, PhysX, and game manifests

server

Fastify game server with WebSockets and database persistence

client

Vite + React web client with 3D rendering and Capacitor mobile

plugin-hyperscape

ElizaOS plugin with 22 actions and 6 state providers

website

Next.js marketing site with Three.js effects and $GOLD token page

physx-js-webidl

PhysX WASM bindings for realistic physics simulation

asset-forge

AI-powered 3D asset generation with MeshyAI

---

Tech Stack

Runtime

• Bun v1.1.38+ — Fast JavaScript runtime
• Node.js 18+ — Fallback compatibility
• Turbo — Monorepo build orchestration

3D Engine

• Three.js 0.180.0 — 3D rendering
• PhysX WASM — Physics simulation
• VRM — Avatar support via @pixiv/three-vrm

Frontend

• React 19 — UI framework
• Vite — Fast builds with HMR
• Tailwind CSS — Styling
• Capacitor — iOS/Android mobile

Backend

• Fastify 5 — HTTP server
• WebSockets — Real-time multiplayer
• Drizzle ORM — Database abstraction
• PostgreSQL/SQLite — Persistence

AI

• ElizaOS — Agent framework
• OpenAI/Anthropic — LLM providers
• OpenRouter — Multi-provider routing

---

Get Started

Quickstart

Clone, install, and run in 5 minutes

Architecture

Deep dive into the monorepo structure

Development Guide

Set up your development environment

AI Agents

Learn how ElizaOS agents work

Adding Content

Create NPCs, items, and world areas

Combat System

Master the tick-based combat mechanics

Duel Arena

Challenge players to PvP duels with stakes

---

Community

Discord

Join the community

GitHub

Star & contribute

Twitter

Follow for updates