# Hyperscape

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

## Docs

- [Constants Reference](https://hyperscape-ai.mintlify.app/api-reference/constants.md): Centralized game constants and configuration values
- [Context Menu API](https://hyperscape-ai.mintlify.app/api-reference/context-menus.md): OSRS-style context menus with colored entity names and action dispatching
- [Data Providers](https://hyperscape-ai.mintlify.app/api-reference/data-providers.md): Runtime data access for manifests and recipes
- [Food Consumption API](https://hyperscape-ai.mintlify.app/api-reference/food-consumption.md): Server-authoritative food consumption with eat delay and combat integration
- [Mining System API](https://hyperscape-ai.mintlify.app/api-reference/mining-system.md): OSRS-accurate mining mechanics with success rates and pickaxe bonuses
- [API Reference](https://hyperscape-ai.mintlify.app/api-reference/overview.md): Hyperscape game server API endpoints and WebSocket events
- [ProcessingDataProvider](https://hyperscape-ai.mintlify.app/api-reference/processing-data-provider.md): Runtime data provider for cooking, firemaking, smelting, and smithing
- [Game Systems API](https://hyperscape-ai.mintlify.app/api-reference/systems.md): API reference for core game systems
- [TierDataProvider](https://hyperscape-ai.mintlify.app/api-reference/tier-data-provider.md): OSRS-accurate tier-based level requirements for equipment and tools
- [2025 - Project Foundation](https://hyperscape-ai.mintlify.app/changelog/2025.md): August - December 2025 - Initial development and core systems
- [January 2026](https://hyperscape-ai.mintlify.app/changelog/2026-01.md): Duel Arena, Prayer, Collision, Smithing, Website, and UI Improvements
- [Changelog](https://hyperscape-ai.mintlify.app/changelog/index.md): Latest updates and releases from Hyperscape
- [Combat System](https://hyperscape-ai.mintlify.app/concepts/combat.md): Tick-based combat mechanics inspired by RuneScape
- [Economy](https://hyperscape-ai.mintlify.app/concepts/economy.md): Banking, shops, currency, and item management
- [Entity Component System](https://hyperscape-ai.mintlify.app/concepts/ecs.md): Understanding Hyperscape's ECS architecture
- [Entities](https://hyperscape-ai.mintlify.app/concepts/entities.md): Game objects with 3D representation, networking, and components
- [Manifest-Driven Design](https://hyperscape-ai.mintlify.app/concepts/manifests.md): Data-driven content through TypeScript manifest files
- [Multiplayer Architecture](https://hyperscape-ai.mintlify.app/concepts/multiplayer.md): WebSocket networking, entity sync, and persistence
- [Skills System](https://hyperscape-ai.mintlify.app/concepts/skills.md): Skill progression, XP formulas, and resource gathering
- [CDN Architecture](https://hyperscape-ai.mintlify.app/devops/cdn.md): Asset delivery with manifest validation and production fallback
- [Configuration](https://hyperscape-ai.mintlify.app/devops/configuration.md): Environment variables and port allocation
- [Database Management](https://hyperscape-ai.mintlify.app/devops/database.md): Drizzle ORM, migrations, and schema management
- [Docker Setup](https://hyperscape-ai.mintlify.app/devops/docker.md): CDN, PostgreSQL, and container management
- [Railway Deployment](https://hyperscape-ai.mintlify.app/devops/railway.md): Deploy Hyperscape server to Railway with automated CI/CD
- [Troubleshooting](https://hyperscape-ai.mintlify.app/devops/troubleshooting.md): Common issues and solutions
- [Architecture](https://hyperscape-ai.mintlify.app/getting-started/architecture.md): Monorepo structure and package overview
- [Quickstart](https://hyperscape-ai.mintlify.app/getting-started/quickstart.md): Get Hyperscape running locally in minutes
- [Adding Content](https://hyperscape-ai.mintlify.app/guides/adding-content.md): Create NPCs, items, and world areas using JSON manifests
- [AI Agents](https://hyperscape-ai.mintlify.app/guides/ai-agents.md): ElizaOS integration for autonomous gameplay
- [Deployment](https://hyperscape-ai.mintlify.app/guides/deployment.md): Deploy Hyperscape to production environments
- [Railway Deployment](https://hyperscape-ai.mintlify.app/guides/deployment-railway.md): Deploy Hyperscape server to Railway with automated CI/CD
- [Development Setup](https://hyperscape-ai.mintlify.app/guides/development.md): Local development workflow, hot reload, and debugging
- [Manifest-Driven Architecture](https://hyperscape-ai.mintlify.app/guides/manifest-architecture.md): Understanding the data-driven content system
- [MCP Server](https://hyperscape-ai.mintlify.app/guides/mcp-server.md): Connect Hyperscape documentation to AI tools with Model Context Protocol
- [Mobile Development](https://hyperscape-ai.mintlify.app/guides/mobile.md): Build Hyperscape for iOS and Android with Capacitor
- [Playing the Game](https://hyperscape-ai.mintlify.app/guides/playing.md): Character creation, controls, and gameplay basics
- [Railway Deployment Guide](https://hyperscape-ai.mintlify.app/guides/railway-deployment.md): Deploy Hyperscape server to Railway with automated CI/CD
- [Hyperscape](https://hyperscape-ai.mintlify.app/index.md): The first AI-native MMORPG where autonomous agents play alongside humans
- [asset-forge](https://hyperscape-ai.mintlify.app/packages/asset-forge.md): AI-powered 3D asset generation
- [client](https://hyperscape-ai.mintlify.app/packages/client.md): Web client with Vite, React, and 3D rendering
- [SKILL GUIDE PANEL](https://hyperscape-ai.mintlify.app/packages/client/SKILL-GUIDE-PANEL.md)
- [Package Overview](https://hyperscape-ai.mintlify.app/packages/overview.md): Overview of all packages in the Hyperscape monorepo
- [plugin-hyperscape](https://hyperscape-ai.mintlify.app/packages/plugin-hyperscape.md): ElizaOS integration for autonomous AI agents
- [server](https://hyperscape-ai.mintlify.app/packages/server.md): Game server with Fastify, WebSockets, and database
- [shared](https://hyperscape-ai.mintlify.app/packages/shared.md): Core 3D engine with ECS, Three.js, PhysX, and networking
- [website](https://hyperscape-ai.mintlify.app/packages/website.md): Marketing website with Next.js and Three.js
- [Agent Actions Reference](https://hyperscape-ai.mintlify.app/wiki/ai-agents/actions.md): Complete reference for ElizaOS agent actions
- [AI Agents Overview](https://hyperscape-ai.mintlify.app/wiki/ai-agents/overview.md): ElizaOS integration for autonomous AI gameplay
- [Agent Providers Reference](https://hyperscape-ai.mintlify.app/wiki/ai-agents/providers.md): Context providers for ElizaOS agent decision-making
- [Client Application](https://hyperscape-ai.mintlify.app/wiki/client/overview.md): React UI, 3D rendering, VRM avatars, and client architecture
- [UI Improvements](https://hyperscape-ai.mintlify.app/wiki/client/ui-improvements.md): Action bars, mobile enhancements, and edit mode features
- [UI System](https://hyperscape-ai.mintlify.app/wiki/client/ui-system.md): Anchor-based positioning, drag-and-drop, and responsive scaling
- [UI Systems](https://hyperscape-ai.mintlify.app/wiki/client/ui-systems.md): Client-side interface systems including action bars, chat, and edit mode
- [Item Data Structure](https://hyperscape-ai.mintlify.app/wiki/data/items.md): How items, equipment, and consumables are defined
- [NPC Data Structure](https://hyperscape-ai.mintlify.app/wiki/data/npcs.md): How NPCs and mobs are defined in Hyperscape
- [Data Manifests Overview](https://hyperscape-ai.mintlify.app/wiki/data/overview.md): Manifest-driven content system for NPCs, items, and world areas
- [Database Schema](https://hyperscape-ai.mintlify.app/wiki/engine/database.md): PostgreSQL persistence with Drizzle ORM
- [Entity Component System](https://hyperscape-ai.mintlify.app/wiki/engine/ecs.md): Deep dive into Hyperscape's ECS architecture
- [Event System](https://hyperscape-ai.mintlify.app/wiki/engine/events.md): Type-safe event-driven architecture with 500+ events
- [Networking Architecture](https://hyperscape-ai.mintlify.app/wiki/engine/networking.md): WebSocket protocol, packet format, and client-server sync
- [Engine Overview](https://hyperscape-ai.mintlify.app/wiki/engine/overview.md): Hyperscape 3D engine architecture and core concepts
- [Rendering & Graphics](https://hyperscape-ai.mintlify.app/wiki/engine/rendering.md): WebGPU rendering with WebGL fallback, auto exposure, and visual effects
- [Bank System](https://hyperscape-ai.mintlify.app/wiki/game-systems/bank.md): Per-town bank storage with tabs and placeholders
- [Collision System](https://hyperscape-ai.mintlify.app/wiki/game-systems/collision.md): OSRS-accurate tile-based collision with zone storage
- [Combat System](https://hyperscape-ai.mintlify.app/wiki/game-systems/combat.md): OSRS-accurate tick-based combat mechanics
- [Context Menus](https://hyperscape-ai.mintlify.app/wiki/game-systems/context-menus.md): OSRS-style right-click menus with colored entity names and manifest-driven actions
- [Crafting System](https://hyperscape-ai.mintlify.app/wiki/game-systems/crafting.md): OSRS-accurate crafting with leather, dragonhide, jewelry, and gem cutting
- [Death & Respawn System](https://hyperscape-ai.mintlify.app/wiki/game-systems/death.md): Player death handling, crash recovery, gravestones, and item recovery
- [Debugging & Performance](https://hyperscape-ai.mintlify.app/wiki/game-systems/debugging.md): Debug tools, performance monitoring, and FPS panel
- [Duel Arena](https://hyperscape-ai.mintlify.app/wiki/game-systems/duel-arena.md): Player-vs-player dueling system with rules, stakes, and arenas
- [Eating & Healing](https://hyperscape-ai.mintlify.app/wiki/game-systems/eating.md): OSRS-accurate food consumption with eat delays and combat integration
- [Equipment Visual System](https://hyperscape-ai.mintlify.app/wiki/game-systems/equipment-visuals.md): VRM avatar equipment rendering, V2 fitting format, and gathering tool display
- [Fletching](https://hyperscape-ai.mintlify.app/wiki/game-systems/fletching.md): Create bows and arrows from logs and materials
- [Inventory System](https://hyperscape-ai.mintlify.app/wiki/game-systems/inventory.md): Player inventory management, item stacking, context menus, and persistence
- [Lighting & Day/Night Cycle](https://hyperscape-ai.mintlify.app/wiki/game-systems/lighting.md): Dynamic lighting, auto exposure, and atmospheric day/night transitions
- [Ground Items & Loot](https://hyperscape-ai.mintlify.app/wiki/game-systems/loot.md): OSRS-style ground item piling, despawn timers, and loot protection
- [Mining System](https://hyperscape-ai.mintlify.app/wiki/game-systems/mining.md): OSRS-accurate mining with pickaxe tiers, success rates, and rock depletion
- [Mob AI & Behavior](https://hyperscape-ai.mintlify.app/wiki/game-systems/mob-ai.md): State machine AI for hostile mobs, aggression mechanics, and leashing
- [Tile Movement System](https://hyperscape-ai.mintlify.app/wiki/game-systems/movement.md): OSRS-accurate tile-based movement and pathfinding
- [Game Systems Overview](https://hyperscape-ai.mintlify.app/wiki/game-systems/overview.md): How Hyperscape game systems work
- [Prayer System](https://hyperscape-ai.mintlify.app/wiki/game-systems/prayer.md): OSRS-style prayer system with drain mechanics and combat bonuses
- [Quest System](https://hyperscape-ai.mintlify.app/wiki/game-systems/quests.md): OSRS-style quest system with progress tracking and rewards
- [Skills & Progression](https://hyperscape-ai.mintlify.app/wiki/game-systems/skills.md): RuneScape-style skill system with XP curves and leveling
- [Smithing System](https://hyperscape-ai.mintlify.app/wiki/game-systems/smithing.md): OSRS-accurate smelting and smithing with anvils, furnaces, and manifest-driven recipes
- [Social Features](https://hyperscape-ai.mintlify.app/wiki/game-systems/social.md): Friend system, private messaging, and ignore list
- [Terrain System](https://hyperscape-ai.mintlify.app/wiki/game-systems/terrain.md): Procedural terrain generation with flat zones for stations
- [Trading System](https://hyperscape-ai.mintlify.app/wiki/game-systems/trading.md): Player-to-player item trading with OSRS-style two-screen confirmation
- [Wiki](https://hyperscape-ai.mintlify.app/wiki/index.md): In-depth technical documentation for Hyperscape
- [Constants Reference](https://hyperscape-ai.mintlify.app/wiki/reference/constants.md): All game constants for combat, movement, and timing
- [Keyboard Controls](https://hyperscape-ai.mintlify.app/wiki/reference/keybinds.md): Complete keyboard shortcuts and keybinds reference
- [MCP Server](https://hyperscape-ai.mintlify.app/wiki/reference/mcp-server.md): Connect AI tools to Hyperscape documentation via Model Context Protocol
- [Recent Updates - January 2026](https://hyperscape-ai.mintlify.app/wiki/technical-notes/recent-updates-jan-2026.md): Technical summary of prayer system, death system overhaul, and equipment sync improvements

## OpenAPI Specs

- [openapi](https://hyperscape-ai.mintlify.app/openapi.json)