Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Приложение для генерации интерактивных RPG-историй с визуализацией сюжетного графа с использованием ИИ (Yandex GPT).

License

Notifications You must be signed in to change notification settings

ValterGames-Coder/GameStoryGenerator

Repository files navigation

Game Story Generator

Game Story Generator Приложение для генерации интерактивных RPG-историй с визуализацией сюжетного графа с использованием ИИ (Yandex GPT).

Возможности

  • Генерация RPG-квестов на основе пользовательских параметров
  • Визуализация сюжета в виде интерактивного графа
  • Подробный просмотр сцен и переходов
  • Экспорт истории в JSON формат
  • Интуитивный графический интерфейс

Установка

1. Клонирование репозитория

git clone https://github.com/ValterGames-Coder/GameStoryGenerator
cd GameStoryGenerator

2. Создание виртуального окружения

python -m venv venv
# Windows
venv\Scripts\activate
# Linux/macOS
source venv/bin/activate

3. Установка зависимостей

pip install -r requirements.txt

4. Настройка API ключей

Создайте файл .env в корневой папке проекта:

YANDEX_ID_KEY=ваш_id_ключ_yandex
YANDEX_API_KEY=ваш_api_ключ_yandex

Как получить ключи Yandex GPT:

  1. Зарегистрируйтесь в Yandex Cloud
  2. Создайте платежный аккаунт
  3. Получите YANDEX_ID_KEY (Folder ID) в консоли Yandex Cloud
  4. Создайте API-ключ для сервиса YandexGPT в разделе "Сервисные аккаунты"

Запуск

python main.py

Использование

Основной интерфейс

Приложение состоит из двух панелей:

Левая панель - Параметры истории:

  1. Описание истории - детальное описание сюжета, сеттинга и основных событий
  2. Жанр - по умолчанию "RPG", можно изменить на любой другой
  3. Персонажи - список главных героев через точку с запятой (например: "Эльф-маг; Человек-воин; Гном-кузнец")
  4. Настроение - выбор из предустановленных вариантов (нейтральное, мрачное, эпичное и др.)

Правая панель - Визуализация:

  • Отображает сгенерированную историю в виде графа
  • Каждая нода представляет сцену
  • Стрелки показывают возможные переходы между сценами

Генерация истории

  1. Заполните все поля в левой панели
  2. Нажмите кнопку "Сгенерировать историю"
  3. Дождитесь завершения генерации (может занять 30-60 секунд)
  4. Изучите полученный граф истории

Управление графом

Навигация по нодам:

  • Одинарный клик по ноде - выделение сцены
  • Двойной клик по ноде - открытие окна с полным описанием сцены

Информация о переходах:

  • Наведение курсора на стрелку - появляется всплывающая подсказка с описанием действия/выбора

Типы нод:

  • 🟢 Зеленая нода - начальная сцена
  • 🔵 Синие ноды - обычные сцены с выборами
  • 🔴 Красные ноды - финальные сцены (концовки)

Экспорт

После генерации истории становится доступна кнопка "Экспорт в JSON":

  1. Нажмите кнопку экспорта
  2. Выберите место сохранения файла
  3. История будет сохранена в структурированном JSON формате

Статистика

В правом нижнем углу отображается информация:

  • Количество сцен
  • Количество концовок
  • Количество переходов

Формат экспортируемого JSON

{
  "title": "Краткое название истории...",
  "description": "Полное описание истории",
  "start_scene": "1",
  "scenes": [
    {
      "scene_id": "1",
      "text": "Описание сцены...",
      "choices": [
        {
          "text": "Описание выбора",
          "next_scene": "2"
        }
      ],
      "is_ending": false
    }
  ]
}

Системные требования

  • Python 3.11+
  • PyQt5
  • Интернет-соединение для работы с Yandex GPT API

LICENSE

About

Приложение для генерации интерактивных RPG-историй с визуализацией сюжетного графа с использованием ИИ (Yandex GPT).

Resources

License

Stars

Watchers

Forks

Contributors 2

  •  
  •  

Languages