SharpGraph

Что хранит граф

SharpGraph задаёт игровую логику блоками и генерирует C#, который собирается вместе с проектом. Документ графа имеет расширение .rsg. Поток выполнения, значения и ссылки на объекты — разные соединения; совпадение цвета провода не заменяет проверку типа.

Графы могут использовать переменные, функции, события, сигналы, условия, циклы и асинхронные операции. Часть поведения удобно оставить в обычном C#: оба варианта работают с API Reckfell.

Откройте рабочий пример

В комплекте исходных примеров движка есть проект SharpGraphQuickStart. Если в вашей поставке он отсутствует, это не ссылка на доступный пакет Asset Store: магазин пока не запущен.

1. Откройте project.reckfell примера через менеджер проектов.
2. Откройте Kits/GettingStarted/Example.rscene.
3. Выберите корень FirstSteps и откройте ресурс поведения SharpGraph в Inspector.
4. Найдите цепочку Начало → Задать текст интерфейса → Подождать → Задать текст интерфейса.
5. Измените параметр Delay или текст поведения, сохраните и запустите сцену.

Результат: первая надпись сменяется второй после задержки. Если надпись не меняется, проверьте, запущена ли нужная сцена и назначено ли ей поведение.

Создание поведения

Выберите объект, выполните Подключить SharpGraph, если проект ещё не настроен, затем Создать граф…. Сохраните .rsg внутри проекта. Из выхода выполнения можно открыть поиск совместимой операции и продолжить цепочку.

У нового графа на Control остаётся известная проблема: файл может сохраниться без первого автоматического подключения хоста поведения. После создания проверьте Inspector. Если поведение не назначено, не считайте создание завершённым; для знакомства используйте уже подключённый пример. Исправление этого сценария пока не подтверждено.

Для значения выбирайте блок с подходящим типом. Для ветвления подключайте отдельные выходы выполнения. У ожидания продолжение должно идти после завершения операции; отдельный блок ожидания не задерживает несвязанную цепочку.

Перейдите к редактируемому C#

1. Режим Граф + C# показывает генерируемый код рядом с блоками.
2. Команда Преобразовать в C# создаёт отдельные файлы в Scripts/Behaviors, собирает проект и открывает результат в IDE.
3. Команда Использовать C#-поведение переносит параметры и ссылки на C#-компонент. Сохраните сцену после замены.
4. Запустите её отдельно и сравните поведение с исходным графом.

Исходный граф сохраняется, замену можно отменить через Undo. Повторное преобразование создаёт новую копию и сохраняет предыдущий результат. Дальнейшие ручные изменения C# не следует считать синхронными изменениями .rsg. Обратное преобразование произвольного C# в граф не поддерживается как готовый рабочий процесс.

Отладка и организация

Используйте точки остановки и пошаговое выполнение, чтобы увидеть реальный путь выполнения и значения. Отсутствие остановки может означать, что запущен C#-вариант после замены либо другая сцена. Подробную Debug-трассу нельзя ожидать от Release-сборки.

Выделяйте повторяющиеся операции в функции, подписывайте смысловые участки и сохраняйте понятные имена параметров. Библиотеки графов и ресурсы проекта отличаются от будущего магазина ассетов.

Продолжение: встроенная IDE, компоненты C#, Entity и иерархия.