Skip to content

Scenarios.md

Latest commit

 

History

History
131 lines (84 loc) · 9.15 KB

Scenarios.md

File metadata and controls

131 lines (84 loc) · 9.15 KB

Сценарии в инспекторе

Что это: пошаговые сценарии настройки квестов в инспекторе: QuestManager, QuestNoCodeAction, NeoCondition. Какие объекты создавать, куда вешать компоненты, что подключать в UnityEvent.

Как использовать: убедиться, что в сцене есть QuestManager и Known Quests; при Start Conditions назначить Condition Context. Выбрать сценарий ниже и выполнить шаги; проверять кнопками в инспекторе или в игре.

--- Какие объекты создавать, куда вешать компоненты, что подключать в UnityEvent.

Как с этим работать:

  1. Убедиться, что в сцене есть QuestManager, в Known Quests добавлены нужные QuestConfig, в Condition Context назначен объект (если в квесте есть Start Conditions).
  2. Выбрать сценарий ниже и выполнить шаги по порядку.
  3. Проверять через кнопки в инспекторе (QuestNoCodeAction.Execute, кнопки в блоке Editor у QuestManager) или в игре.

Сценарий 1: Принять квест по кнопке

Цель: по нажатию UI-кнопки принять выбранный квест.

  1. Выбрать объект с компонентом Button (или панель, на которой висит кнопка).
  2. Add Component → Neoxider → Quest → Quest NoCode Action.
  3. В поле Action Type выбрать Accept, в поле Quest перетащить QuestConfig.
  4. У Button в On Click () добавить вызов: Object = этот же объект, Function = QuestNoCodeAction → Execute().

Проверка: нажать [Execute Action] в инспекторе у QuestNoCodeAction или нажать кнопку в игре. Если квест не принимается: конфиг в Known Quests, Id не пустой, квест не принят ранее, все Start Conditions при Evaluate(Condition Context) дают true.

Сценарий 2: Зачесть цель при выполнении условия (NeoCondition)

Цель: когда условие (здоровье, счётчик, флаг) становится true — засчитать одну цель квеста.

  1. Выбрать или создать GameObject.
  2. Add Component → Neoxider → Condition → NeoCondition. Настроить Conditions (объект, компонент, свойство, оператор, порог) по NeoCondition.
  3. На тот же объект Add Component → Neoxider → Quest → Quest NoCode Action.
  4. В компоненте: Action Type = CompleteObjective, Quest = ваш QuestConfig, Objective Index = индекс цели (0, 1, 2, …).
  5. В NeoCondition в Events → On True добавить вызов: Object = этот объект, Function = QuestNoCodeAction → Execute().

При первом срабатывании NeoCondition.On True менеджер засчитает указанную цель. Проверка: кнопка [Execute Action] у QuestNoCodeAction.

Сценарий 3: Показать UI при завершении квеста

Цель: при завершении любого квеста (все цели выполнены) показать панель или воспроизвести анимацию.

  1. Выбрать QuestManager в сцене.
  2. В инспекторе найти On Any Quest Completed (UnityEvent без аргументов).
  3. Добавить вызов: перетащить UI-объект (панель, попап), выбрать функцию показа/анимации. Параметры не передаются.

Если нужна разная реакция по questId: использовать On Quest Completed (UnityEvent<string>) и подключить метод своего скрипта с одним параметром string (questId).

Сценарий 4: Реакция на принятие квеста (звук, подсказка)

  1. У QuestManager найти On Any Quest Accepted (без аргументов).
  2. Добавить вызов: звук, анимация, показ подсказки. Срабатывает при любом принятии квеста.

Сценарий 5: Обновить UI при выполнении одной цели

Цель: когда выполнена одна цель (например «собрать ключ») — сразу поставить галочку в списке целей.

  1. У QuestManager найти On Objective Completed (UnityEvent<string, int>: questId, objectiveIndex).
  2. Подключить метод своего скрипта с двумя параметрами (string, int). В методе по questId и objectiveIndex обновить нужный элемент UI.

Сценарий 6: Реакция на провал квеста

  1. У QuestManager найти On Quest Failed (UnityEvent<string>).
  2. Подключить вызов: сообщение «Квест провален», скрытие квеста в журнале, звук и т.д. Событие вызывается только при явном вызове FailQuest (из кода или другого компонента).

Сценарий 7: Перезапуск проваленного/завершённого квеста

  1. В UI добавить кнопку "Restart".
  2. В обработчик кнопки вызвать QuestManager.RestartQuest(quest) или RestartQuest(questId).
  3. Менеджер сбросит старое состояние квеста и снова попробует принять квест с проверкой Start Conditions.

Сценарий 8: Сброс всех квестов (новая игра)

  1. В меню/настройках добавить кнопку "Reset All Quests".
  2. В обработчик кнопки вызвать QuestManager.ResetAllQuests().
  3. После этого UI перечитывает список состояний через GetState/AllQuests и показывает квесты как NotStarted.

Сценарий 9: Линейные и независимые квесты

  1. Создать QuestFlowConfig и добавить квесты в Chains (для линейных) и Standalone Quests (для независимых).
  2. Для линейной цепочки включить Strict Order.
  3. Перед AcceptQuest в UI проверять доступность через QuestFlowConfig.CanAcceptQuest(...).
  4. В журнале помечать заблокированные квесты как Locked (пока не завершён предыдущий).

Сценарий 10: Полное управление квестами без кода (через QuestNoCodeAction)

  1. На UI-кнопку добавить компонент QuestNoCodeAction.
  2. Выбрать Action Type:
    • Accept — принять квест,
    • CompleteObjective — зачесть цель,
    • Fail — провалить,
    • Restart — перезапустить,
    • Reset — сбросить один,
    • ResetAll — сбросить всё.
  3. Назначить Quest (и Objective Index, если нужно).
  4. Опционально назначить Flow Config для проверки последовательности при Accept.
  5. В Button.OnClick вызвать QuestNoCodeAction.Execute().
  6. Подключить On Success / On Failed / On Result Message к UI (лог, попапы, индикаторы).

Кнопки в инспекторе

  • QuestManager, блок Editor: Editor Quest Id, Editor Objective Index, кнопки Accept Quest (Editor Id) и Complete Objective (Editor) — тест приёма и зачёта цели без игровых действий.
  • QuestNoCodeAction: [Execute Action] для выбранного Action Type.

Ограничения

  • Разная реакция на завершение разных квестов (по questId) — нужен метод в своём скрипте с параметром string, подключённый к On Quest Completed.
  • Проверка «доступен ли квест» для отображения в UI — в модуле нет метода «проверить без принятия»; реализовывать в коде (оценка условий или свои флаги).
  • Сложная выдача наград или ветвление по диалогу — удобнее в коде по событиям QuestCompleted / ObjectiveProgress.