Skip to content

Приложение для создания и хранения персонажей

License

Notifications You must be signed in to change notification settings

MaxGog/CharacterBook

Repository files navigation

🎭 CharacterBook

Flutter Dart Platforms License

Кроссплатформенное приложение для создания и управления персонажами RPG

📖 Документация🎮 Возможности📥 Установка👨‍💻 Руководство

✨ О проекте

CharacterBook – это мощное кроссплатформенное приложение, созданное для игроков и мастеров ролевых игр. Создавайте, организуйте и экспортируйте персонажей для любых RPG систем с невероятной легкостью!

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

Категория Возможности
👥 Управление персонажами Создание, редактирование, шаблоны, расширенные поля
🗂️ Организация Папки, теги, поиск, фильтрация, сортировка
🎨 Шаблоны и расы D&D 5e, Для писателей, кастомные шаблоны, база рас
💾 Работа с данными PDF экспорт, резервные копии, локальное хранение
🌍 Кроссплатформенность Android, Windows, macOS, iOS/Linux/Web (в планах)

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

📥 Установка для пользователей

Google Play RuStore Microsoft Store GitHub Releases

🛠️ Для разработчиков

# 1. Клонируйте репозиторий
git clone https://github.com/maxgog/characterbook.git
cd characterbook

# 2. Установите зависимости
flutter pub get

# 3. Запустите приложение
flutter run

# 4. Сборка для production
flutter build apk --release    # Android
flutter build windows --release # Windows
flutter build web --release    # Web

📸 Галерея приложения

Главный экран Создание персонажа Управление расами
Главный экран Создание Расы

Доступный и интуитивный интерфейс для всех платформ

🏗️ Технологический стек

🔧 Основные технологии

Компонент Технология Назначение
🖼️ Фреймворк Flutter 3.13+ Кроссплатформенный UI
💙 Язык Dart 3.7+ Бизнес-логика и производительность
💾 Хранилище Hive 2.2.3 Быстрая NoSQL база данных
🎮 State Management Provider + Flutter Bloc Управление состоянием
📄 Экспорт PDF, Printing Генерация документов

📦 Ключевые зависимости

dependencies:
  # State Management
  provider: ^6.0.5
  flutter_bloc: ^8.1.3
  
  # Local Storage
  hive: ^2.2.3
  shared_preferences: ^2.5.3
  
  # File Operations
  pdf: ^3.10.0
  file_selector: ^1.0.3
  
  # Platform Integration
  window_manager: ^0.5.1
  msix: ^3.16.10

🎯 Для кого это приложение?

🎮 Для игроков

  • Полная кастомизация персонажей под любую систему
  • Оффлайн доступ - играйте где угодно без интернета
  • Бесплатность - все функции доступны без подписок
  • Визуализация - добавляйте изображения и галереи

🎲 Для мастеров

  • Единая база всех NPC и персонажей кампании
  • Быстрый экспорт материалов для сессий
  • Гибкая организация под вашу кампанию
  • Шаблоны для быстрого создания контента

💻 Для разработчиков

  • Открытый код - возможность модификации
  • Современный стек - актуальные технологии
  • Активное развитие - регулярные обновления

📊 Статус разработки

Компонент Статус Примечания
Android ✅ Разработано Google Play
Windows ✅ Разработано Microsoft Store
Web 🔧 В разработке Скоро будет доступно
iOS 📅 В планах Требуется Mac для сборки
Облачная синхронизация ✅ Разработано Google Drive интеграция

🤝 Участие в разработке

Мы приветствуем вклад в развитие CharacterBook!

🐛 Сообщение об ошибках

Нашли баг? Создайте issue с подробным описанием.

💡 Предложения функций

Есть идея для улучшения? Обсудим в issues!

🔧 Pull Requests

  1. Форкните репозиторий
  2. Создайте feature branch (git checkout -b feature/amazing-feature)
  3. Закоммитьте изменения (git commit -m 'Add amazing feature')
  4. Запушьте branch (git push origin feature/amazing-feature)
  5. Откройте Pull Request

📄 Лицензия

Этот проект распространяется под лицензией GPL-3.0. Подробнее см. в файле LICENSE.

💖 Поддержка проекта

Если вам нравится CharacterBook, рассмотрите возможность поддержать разработчика:

Boosty


📞 Контакты

👨‍💻 Автор: MaxGog
📧 Почта: max.gog2005@outlook.com
🐙 GitHub: maxgog
💬 Поддержка: Создать issue

CharacterBook вдохновлен классическими бумажными листами персонажей и создан для современной эпохи цифровых RPG!

⭐ Не забудьте поставить звезду репозиторию, если проект вам понравился!