AI Dungeon Master — D&D 5e Solo

Веб-приложение для соло-игры в D&D 5e с AI-мастером. Нейросеть ведёт кампанию, бросает кубики, помнит персонажей и события, ищет правила в интернете через DuckDuckGo.

Возможности

• AI Dungeon Master — нейросеть ведёт кампанию, описывает сцены, играет за NPC
• 12 AI-инструментов (function calling): roll_dice, calculate, search_web, fetch_page, create_character, update_character, get_character, list_characters, save_memory, recall_memories, log_event, get_recent_events
• Трёхслойная память: краткосрочная (контекст), долгосрочная (факты), состояние персонажей
• Управление кампаниями: создание с 11 параметрами (сеттинг, тон, сложность, стиль мастера, строгость правил, и т.д.), активация, удаление
• Кнопки кубиков d4-d100 + кнопка "Вспомни" для триггера памяти
• Сайдбар: персонажи / память / журнал событий
• Markdown-рендеринг в чате
• Тест API-ключа прямо в настройках

Технологии

• Next.js 16 (App Router) + TypeScript 5
• Tailwind CSS 4 + shadcn/ui
• Prisma ORM (SQLite)
• Vercel AI SDK 7.x (ai, @ai-sdk/openai, @ai-sdk/react)
• OpenAI-compatible API (claudehub.fun, OpenAI, любой совместимый)

---

🪟 УСТАНОВКА НА WINDOWS 11

Шаг 1. Установить Node.js 20+

1. Скачай Node.js LTS с https://nodejs.org/ (версия 20.x или новее)
2. Запусти установщик, нажимай "Next" до конца
3. Проверь установку — открой PowerShell и выполни:

   node --version
   npm --version
   

   Должны появиться версии (например v20.11.0 и 10.2.4)

Шаг 2. Установить Bun (рекомендуется, но не обязательно)

Bun работает быстрее npm. Установка через PowerShell:

powershell -c "irm bun.sh/install.ps1 | iex"

После установки перезапусти PowerShell и проверь:

bun --version

Если не получилось — не страшно, можно использовать npm вместо bun во всех командах ниже.

Шаг 3. Распаковать проект

1. Распакуй zip-архив ai-dnd-master.zip в папку, например C:\Projects\ai-dnd-master
2. В PowerShell перейди в эту папку:

   cd C:\Projects\ai-dnd-master
   

Шаг 4. Установить зависимости

Если установлен Bun:

bun install

Если только npm:

npm install

Это займёт 2-5 минут (много пакетов).

Шаг 5. Инициализировать базу данных

bun run db:push

или

npm run db:push

Команда создаст SQLite-файл db/custom.db со всеми таблицами.

Шаг 6. Настроить .env

Файл .env уже создан в корне проекта. Открой его в блокноте и проверь:

DATABASE_URL=file:./db/custom.db?connection_limit=1&journal_mode=DELETE

AI_BASE_URL=https://api.claudehub.fun/v1
AI_API_KEY=your-claudehub-api-key-here
AI_MODEL=gpt-4o-mini

ВАЖНО: На Windows лучше использовать относительный путь для БД: file:./db/custom.db вместо абсолютного.

Шаг 7. Исправить скрипты под Windows (ВАЖНО!)

По умолчанию в package.json скрипты используют Linux-команду tee. На Windows это не работает. Открой package.json в блокноте и замени блок "scripts":

"scripts": {
  "dev": "next dev -p 3000",
  "build": "next build",
  "start": "next start -p 3000",
  "lint": "eslint .",
  "db:push": "prisma db push --accept-data-loss",
  "db:generate": "prisma generate",
  "db:migrate": "prisma migrate dev",
  "db:reset": "prisma migrate reset"
}

Шаг 8. Запустить dev-сервер

bun run dev

или

npm run dev

В консоли появится:

▲ Next.js 16.1.3 (Turbopack)
- Local: http://localhost:3000
✓ Ready in 2.3s

Шаг 9. Открыть в браузере

Открой http://localhost:3000 в Chrome/Firefox/Edge.

---

🎲 НАСТРОЙКА API-КЛЮЧА

Получение ключа

1. Зарегистрируйся на https://app.claudehub.fun
2. В личном кабинете создай API-ключ
3. ВАЖНО: ключ имеет формат sk-hub-xxxxxxxxxxxx (начинается с sk-hub-, а НЕ с sk- как у OpenAI!)

Ввод ключа в приложении

1. Нажми "Настройки" (кнопка справа сверху)
2. Вставь ключ в поле "API Key" — должен начинаться с sk-hub-
3. Список моделей загрузится автоматически — выбери из выпадающего списка
4. Рекомендуемые модели:
   • claude-haiku-4.5 — самая быстрая и дешёвая (рекомендуется для старта)
   • claude-sonnet-4.6 / claude-sonnet-5 — баланс скорости и качества
   • claude-opus-4.8 / claude-opus-5 — самое качественное ведение
   • gpt-5.4 / gpt-5.5 — GPT-модели
5. Нажми "Проверить ключ и модель" — должно показать зелёное ✅

Если пишет "Неверный API ключ (401)"

1. Проверь формат ключа — должен начинаться с sk-hub- (не sk-)
2. Проверь, что ключ скопирован полностью — без обрезки
3. Попробуй другой режим авторизации в настройках:
   • Bearer (стандартный) — по умолчанию, должен работать
   • x-api-key — Anthropic-стиль
   • Raw — ключ как есть, без префикса
4. Проверь баланс в личном кабинете claudehub.fun — если 0, ключ не работает

Если пишет "Модель не найдена (404)"

• Список моделей загружается автоматически с провайдера
• Если список не загрузился — нажми кнопку "Обновить" рядом с полем модели
• Модели claudehub.fun: claude-haiku-4.5, claude-sonnet-4.6, claude-sonnet-5, claude-opus-4.6/4.7/4.8/5, gpt-5.4, gpt-5.5
• НЕ используй gpt-4o-mini, gpt-4o, claude-3-5-sonnet — их нет на claudehub.fun!

---

🎮 ИСПОЛЬЗОВАНИЕ

Создание кампании

1. На welcome screen нажми "Создать новую кампанию"
2. Заполни форму:
   • Название — любое имя
   • Сеттинг — Forgotten Realms / Eberron / Ravenloft / свой
   • Тон — Heroic / Dark / Gritty / Humorous / Epic
   • Сложность — Easy / Normal / Hard / Brutal
   • Стиль мастера — Balanced / Narrative / Tactical / Roleplay
   • Строгость правил — Loose / Standard / Strict
   • Стартовый уровень — слайдер 1-20
   • Частота отдыха — Frequent / Standard / Rare (Gritty Realism)
   • Язык — Русский / English
   • Описание мира — кастомное описание (опционально)
   • Заметки для мастера — пожелания к стилю (опционально)

This is the beginning of the README. Read the rest at the original. Read the full README ↗