⚔️ Королевства Этерии

Текстовая ролевая игра для VK Mini Apps с AI-повествованием и PvP боями

🎯 Особенности игры

⚔️

11 Уникальных Классов

Воин, Маг, Жрец, Паладин, Некромант, Варвар, Охотник, Друид, Вор, Оборотень, Призыватель

🤖

AI-Повествование

Генерация сюжета с помощью Groq API (Llama 3) для уникального игрового опыта

🎲

Система Боя d20

Классическая система бросков кубиков с модификаторами характеристик и преимуществами

👥

PvP Сражения

Сражайтесь с другими игроками в пошаговых боях с системой матчмейкинга

Система Выносливости

Управляйте ресурсами персонажа с регенерацией, штрафами усталости и отдыхом

🎒

Инвентарь и Экипировка

Собирайте предметы, экипируйте оружие и броню с бонусами к характеристикам

🛠 Технологии

Backend

Python 3.10 + FastAPI

Frontend

React 18 + TypeScript

База Данных

PostgreSQL / SQLite

Кэш

Redis

ORM

SQLAlchemy 2.0 (async)

Миграции

Alembic

AI

Groq API (Llama 3)

Интеграция

VK Bridge

Контейнеры

Docker & Docker Compose

CI/CD

GitHub Actions

162

Файлов проекта

40,138

Строк кода

11

Классов персонажей

2.0

Версия проекта

🚀 Быстрый старт

# 1. Клонирование репозитория
git clone https://chichekin-tech.ru/aetheria-rpg.git
cd aetheria-rpg

# 2. Настройка Backend
cd backend
cp .env.example .env
pip install -r requirements.txt
alembic upgrade head
uvicorn app.main:app --reload

# 3. Настройка Frontend
cd ../frontend
cp .env.example .env
npm install
npm start

# 4. Или используйте Docker
cd ../docker
docker-compose up -d

📚 Документация

📖

README.md

Основная документация проекта с инструкциями по установке и использованию

Открыть
🔌

API Документация

Полное описание всех endpoints backend с примерами запросов

Открыть
📝

CHANGELOG.md

История изменений проекта по версиям

Открыть