Skip to content

KellerHalm/StoryGopher

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🐿️ StoryGopher Engine

StoryGopher — это современный кроссплатформенный движок для создания и воспроизведения текстовых RPG квестов.

Главная особенность движка — Hybrid Rendering Architecture. Один и тот же код сценария и логики работает одновременно в двух режимах:

  1. GUI (Desktop): Красивое оконное приложение с поддержкой мыши, инвентаря и звуков (на базе Wails/React).
  2. TUI (Terminal): Олдскульный консольный интерфейс для игры через терминал или SSH (на базе Bubbletea).

🔥 Ключевые возможности

  • Hot Reload (Горячая перезагрузка): Изменяйте файл сюжета story.yaml во время игры, и изменения мгновенно применятся без перезапуска.
  • Гибкий DSL: Сценарии пишутся на простом YAML с поддержкой Markdown (жирный текст, курсив).
  • Скриптовый движок: Поддержка математики (health - 10), условий (gold > 50) и мутаций состояния.
  • Система инвентаря: Полноценная работа с предметами (добавление, удаление, проверка наличия).
  • Аудио: Воспроизведение звуковых эффектов при событиях.
  • Сохранения: Система Save/Load (JSON сериализация).

🛠 Технический стек

  • Core: Go 1.25.1+
  • Logic: expr-lang/expr (Expression evaluation)
  • GUI: Wails v2 + React + Vite
  • TUI: Bubbletea + Lipgloss
  • Data: YAML

🚀 Запуск проекта

Предварительные требования

  • Go 1.18+
  • Node.js 16+
  • Wails CLI: go install github.com/wailsapp/wails/v2/cmd/wails@latest

1. Запуск GUI версии

Этот режим поддерживает Hot Reload и инструменты разработчика.

wails dev

2. Запуск TUI версии (Терминал)

go run cmd/tui/main.go

3. Сборка релиза (.exe)

Создаст оптимизированный файл в папке build/bin.

wails build

Не забудьте положить файл story.yaml рядом с созданным .exe!

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published