Экосистема проекта

Stalker PDA — это не один репозиторий, а несколько связанных частей. Знать про них полезно даже сюжетописателю: понятно будет, «где что искать» и к кому идти с вопросом.

Карта репозиториев

Репозиторий	Что это	Зачем сюжетописателю
artux-net/pda	Android-игра (клиент) на libGDX/Kotlin	Здесь «живёт» движок: он исполняет историю, рисует карту, считает отношения фракций и бои
artux-net/pdanetwork	Backend на Spring Boot (Kotlin/Java)	Хранит истории, инвентарь игроков, синхронизирует прогресс, обслуживает редактор сюжетов
artux-net/pda-assets	Ресурсы игры: карты (.tmx), текстуры, звуки, шрифты, локализация интерфейса	Здесь лежат сами файлы локаций и базовые настройки фракций
artux-net/pda-quests	Готовые истории/квесты в JSON	Примеры и черновики контента — хорошая шпаргалка «как это делают другие»
pda-quest-editor-web (репозиторий zethange/pda-quest-editor-web)	Веб-редактор историй	Основной инструмент сюжетописателя — см. раздел «Редактор сюжетов»

Как это работает вместе

Сюжетописатель
     │  пишет историю визуально
     ▼
Редактор сюжетов (story.artux.net)
     │  сохраняет/публикует JSON истории
     ▼
Backend pdanetwork  ──────────────┐
     │  отдаёт истории и синк      │  хранит: прогресс игрока,
     │  инвентаря/опыта/денег      │  инвентарь, отношения к фракциям,
     ▼                             │  каталог предметов
Игра pda (Android, клиент)  ◄──────┘
     │  исполняет стадии/условия/действия,
     │  рисует карту (.tmx из pda-assets),
     │  считает бои и отношения между NPC
     ▼
Игрок видит: диалоги, точки на карте, награды, уведомления

Ключевая идея: история — это данные, а не код. Сюжетописатель в редакторе собирает JSON-структуру (главы → стадии → условия → действия), а игра на устройстве уже умеет её исполнять. Новый контент почти никогда не требует правок в Kotlin/Java-коде игры — только данные (историю в pda-quests/через редактор, карту в pda-assets).

Роли доступа

И backend, и редактор используют единую систему ролей: USER < TESTER < MODERATOR < ADMIN. У каждой истории есть поле access — минимальная роль, начиная с которой игрок видит историю (например, чтобы протестировать непубликуемый пока квест силами TESTER, не показывая его всем). Подробнее — в разделе «Публикация и доступ».

Что дальше

• Написание историй — модель данных истории.
• Карта и мир — из чего состоит игровая карта.
• Фракции и отношения — кто с кем воюет и дружит.
• Редактор сюжетов — как собрать историю на практике.