Documentation Index
Fetch the complete documentation index at: https://hyperscape-ai.mintlify.app/llms.txt
Use this file to discover all available pages before exploring further.
The Hyperscape project began development in August 2025. This documents the foundational systems built during the initial development phase.
Timeline
| Date | Milestone |
|---|---|
| August 5, 2025 | Initial commit |
| August 2025 | Refactored RPG into core engine |
| September 2025 | Terrain snapping, player controller |
| October 2025 | Skill system, asset-forge integration |
| October 27, 2025 | First pre-release deployment |
Core Engine
Entity-Component-System (ECS)
- Custom ECS architecture for game entities
- Components: Position, Health, Inventory, Skills, Combat
- Systems: Movement, Combat, Gathering, Processing
3D Rendering
- Three.js for WebGL rendering
- Custom terrain system with tile-based world
- Entity rendering with animations and emotes
Physics
- PhysX WASM bindings for collision detection
- Terrain snapping for entities
- Raycast-based interaction system
Multiplayer Architecture
Server
- Fastify HTTP server
- WebSocket real-time communication
- Server-authoritative game state
- PostgreSQL database with Drizzle ORM
Networking
- Tick-based synchronization (600ms ticks)
- Entity interpolation for smooth movement
- Event-driven packet handling
Client
- React 19 with Vite
- Zustand state management
- Responsive UI panels
Skill Systems
Combat
- Attack, Strength, Defense, Constitution, Ranged, Prayer
- OSRS-style damage calculation
- Auto-retaliate and combat stances
Gathering
- Woodcutting, Fishing, Mining
- Resource nodes with depletion
- Tool requirements and bonuses
Artisan
- Firemaking, Cooking
- Processing stations (ranges, fires)
Economy
- Inventory: 28 slots, stackable items, manifest definitions
- Banking: Tabs, placeholders, deposit/withdraw, note conversion
- Shops: NPC shops with stock and pricing
Monorepo Structure
| Package | Purpose |
|---|---|
@hyperscape/shared | Core engine (ECS, physics, rendering) |
@hyperscape/server | Game server (Fastify, WebSockets) |
@hyperscape/client | Web client (Vite, React) |
@hyperscape/plugin-hyperscape | ElizaOS AI agent plugin |
@hyperscape/physx-js-webidl | PhysX WASM bindings |
3d-asset-forge | AI asset generation tools |
AI Integration
- ElizaOS plugin with agent actions
- State providers for world awareness
- Natural language processing for commands
View repository on GitHub