SkyRift Server - backend-сервер для multiplayer RPG/online game-проекта SkyRift.

Здесь собраны авторизация, GraphQL API, realtime-взаимодействие по WebSocket, игровая симуляция мира, боевая система, перемещение, NPC, квесты, инвентарь и вспомогательная инфраструктура.

В сервер уже заложены основные игровые подсистемы:

• 🔐 регистрация, логин, refresh/logout и работа с токенами
• 👤 пользователи и игровые персонажи
• 🧙 классы персонажей, навыки и эффекты
• 🎒 инвентарь, экипировка и предметы
• 🗺 локации, спавны, тайловые карты и телепорты
• 👾 мобы и NPC
• ⚔️ realtime-бой, урон, AOE, снаряды и восстановление
• 🧭 перемещение, pathfinding и spatial grid
• 📜 квесты и прогресс игрока
• 💬 чат и игровые realtime-события
• 📡 presence и сессии игроков через Redis
• 🌱 сидинг мира и стартовых игровых данных

• Обзор
• Технологический стек
• Функциональность
• Архитектура
• Структура проекта
• API и realtime
• Quick Start
• Docker
• Скрипты

SkyRift Server построен как модульный backend на NestJS и разделен на два больших слоя:

• modules - persistent-домен и бизнес-сущности, которые живут в PostgreSQL
• realtime - игровая runtime-логика, которая обслуживает живой мир, сокеты, симуляцию и боевые тики

При запуске сервер:

• поднимает GraphQL API
• подключает PostgreSQL и Redis
• инициализирует realtime-подсистемы
• загружает ассеты карт
• выполняет bootstrap игрового мира

То есть backend не просто отдает данные, а держит активное состояние мира и обрабатывает игровые действия в реальном времени.

• TypeScript
• Node.js
• NestJS
• CQRS

• GraphQL
• Apollo Server
• cookie-based auth

• WebSocket
• Socket.IO
• Redis

• PostgreSQL
• TypeORM

• EasyStar.js для pathfinding
• in-memory runtime repositories
• tick-based simulation

• Docker
• Docker Compose

Проект организован модульно и сочетает DDD, CQRS и ports & adapters.

Общий поток выглядит так:

Client
  │
  ├── GraphQL API
  │     └── use-cases / facades / repositories
  │
  └── WebSocket Gateway
        └── realtime use-cases / runtime services / in-memory state
                    │
                    ├── PostgreSQL
                    ├── Redis
                    └── Game world simulation

Что важно в текущей структуре:

• persistent-модули отвечают за сущности и данные, которые должны храниться между сессиями
• realtime-модули отвечают за живое состояние мира и реакцию на игровые события
• CQRS используется для разделения команд, query-объектов, фасадов и use-case логики
• часть runtime-данных хранится в памяти для быстрой обработки тиков и боевых событий

src
├─ app.module.ts
├─ main.ts
├─ schema.gql
├─ assets
│  ├─ maps
│  └─ tilesets
├─ common
├─ infrastructure
│  ├─ database
│  ├─ graphql
│  ├─ redis
│  ├─ seed
│  └─ ws
├─ modules
│  ├─ auth
│  ├─ bag
│  ├─ character
│  ├─ character-class
│  ├─ effect
│  ├─ equipment
│  ├─ faction
│  ├─ item
│  ├─ location
│  ├─ mob
│  ├─ npc
│  ├─ owned-skill
│  ├─ quest
│  ├─ skill
│  ├─ spawn
│  └─ user
├─ realtime
│  ├─ chat
│  ├─ combat
│  ├─ connection-stats
│  ├─ container
│  ├─ contracts
│  ├─ effect
│  ├─ entity-registry
│  ├─ faction
│  ├─ flow
│  ├─ gateway
│  ├─ interaction
│  ├─ location
│  ├─ mob-session
│  ├─ movement
│  ├─ npc-session
│  ├─ path-finding
│  ├─ player-session
│  ├─ presence
│  ├─ quest
│  ├─ recovery
│  ├─ shared
│  ├─ simulation
│  ├─ skill-session
│  └─ spatial-grid

Сервер поднимает GraphQL endpoint и автоматически собирает схему в файл:

• src/schema.gql

В проекте уже есть операции для:

• signUp
• signIn
• refreshTokens
• logout
• getCurrentUser
• findUserCharacters

GraphQL playground включается в dev-режиме.

Realtime-взаимодействие работает через Socket.IO namespace:

• /game

Сокет-слой обрабатывает игровые события, например:

• вход в мир
• перемещение персонажа
• атаку и отмену атаки
• использование навыков
• использование предметов
• экипировку / снятие экипировки
• разговор с NPC
• использование телепортов
• игровой чат
• ping/pong и connection stats

npm install

Создайте .env и заполните основные переменные:

PORT=3001
FRONTEND_URL=http://localhost:5173

DB_HOST=localhost
DB_PORT=5432
DB_USER=postgres
DB_PASSWORD=postgres
DB_NAME=skyrift

REDIS_HOST=localhost
REDIS_PORT=6379
REDIS_USER=default
REDIS_PASSWORD=redis

ACCESS_SECRET=your_access_secret
REFRESH_SECRET=your_refresh_secret

docker compose up -d

npm run seed

npm run start:dev

После запуска приложение будет доступно по адресу:

• API: http://localhost:3001/graphql
• Assets: http://localhost:3001/assets/...
• WebSocket namespace: ws://localhost:3001/game

Через docker-compose.yaml поднимаются:

• PostgreSQL
• Redis

Команда запуска:

docker compose up -d

Если нужно остановить контейнеры:

docker compose down

Основные npm-скрипты проекта:

npm run start
npm run start:dev
npm run start:prod

npm run build
npm run lint

npm run seed

• при старте вызывается bootstrap игрового мира, поэтому часть runtime-состояния инициализируется автоматически
• карты и тайлсеты лежат прямо в репозитории в src/assets
• backend рассчитан на связку с отдельным frontend-клиентом игры

Проект находится в стадии активной разработки и представляет собой серверную основу для realtime RPG-игры SkyRift.