02 — Інтеграція без налаштування¶

🇬🇧 English | 🇺🇦 Українська

Щоб користуватися QuestSystem, не потрібен кастомний клас PlayerState, GameState чи GameMode. Цей розділ пояснює, що робить усю проводку за вас і як налаштувати її під себе, коли це знадобиться.

UQuestWorldSubsystem¶

UQuestWorldSubsystem — це UWorldSubsystem, він існує автоматично в кожному ігровому світі, жодного налаштування не потрібно. На сервері (одиночна standalone-сесія теж вважається сервером) він:

створює UQuestManagerComponent на GameState (party-менеджер);
створює UQuestManagerComponent на кожному PlayerState у міру його спавну — це покриває вхід у гру, пізнє підключення, seamless travel і PIE;
зараховує нових підключених гравців до активних party-квестів із увімкненим bAutoEnrollNewParticipants (див. 06 — Мультиплеєр);
опційно валідує весь граф залежностей квестів під час старту й пише результат у лог (лише в dev-збірках).

Якщо у PlayerState чи GameState вже є UQuestManagerComponent — бо ви розмістили його вручну в кастомному класі чи Blueprint, — сабсистема його не чіпає. Ручне налаштування й налаштування без коду можуть співіснувати.

// Отримати сабсистему напряму, якщо потрібно:
UQuestWorldSubsystem* Subsystem = UQuestWorldSubsystem::Get(this);
UQuestManagerComponent* PartyManager = Subsystem->GetPartyQuestManager();
UQuestManagerComponent* MyManager = UQuestWorldSubsystem::GetPlayerQuestManager(MyPlayerState);

У більшості випадків замість цього ви користуватиметеся UQuestBlueprintLibrary (див. 08) — вона огортає ті самі пошуки зрозумілішими іменами (GetQuestManager, GetPartyQuestManager).

UQuestSystemSettings¶

Project Settings → Game → Quest System (зберігається в DefaultGame.ini під [/Script/QuestSystem.QuestSystemSettings]):

Властивість	За замовчуванням	Значення
`bAutoCreatePlayerQuestManagers`	`true`	Створювати менеджер на кожному `PlayerState`.
`bAutoCreatePartyQuestManager`	`true`	Створювати менеджер на `GameState`. Обов'язковий для Shared/Individual квестів.
`QuestManagerClass`	`UQuestManagerComponent`	Клас, який створює сабсистема. Вкажіть тут свій сабклас — див. нижче.
`bValidateQuestsOnStartup`	`true`	Запускати валідацію залежностей під час старту світу (лише не-shipping збірки).

Пороги попередження таймера задаються для кожного ассету квесту/цілі окремо (TimerWarningThreshold, 0 = без попередження), а не одним спільним проєктним значенням — див. 03 — Створення квестів.

; Приклад: DefaultGame.ini
[/Script/QuestSystem.QuestSystemSettings]
bAutoCreatePartyQuestManager=false

Перевизначення логіки нагород¶

GiveQuestRewards() — це BlueprintNativeEvent на UQuestManagerComponent, природне місце для видачі досвіду, золота чи предметів. Оскільки менеджер створює сабсистема, для доступу до нього не потрібно успадковуватися від PlayerState — натомість успадковуйтеся від самого компонента й вкажіть QuestManagerClass на свій сабклас. Підійде як сабклас на C++, так і на Blueprint — обирайте, що зручніше вашій команді.

Варіант на C++¶

// MyQuestManagerComponent.h
UCLASS()
class UMyQuestManagerComponent : public UQuestManagerComponent
{
    GENERATED_BODY()
protected:
    virtual void GiveQuestRewards_Implementation(UQuestData* QuestData) override;
};

// MyQuestManagerComponent.cpp
void UMyQuestManagerComponent::GiveQuestRewards_Implementation(UQuestData* QuestData)
{
    if (APlayerState* PS = GetOwningPlayerState())
    {
        if (AMyPlayerState* MyPS = Cast<AMyPlayerState>(PS))
        {
            // RewardAmounts - це звичайний TMap<FName, int32>: плагін не має
            // вбудованого поняття "золото" чи "досвід", тож маршрутизуйте
            // потрібні ключі зі своїх даних квесту туди, де вони щось означають у вашій грі.
            if (const int32* XP = QuestData->Rewards.RewardAmounts.Find(TEXT("ExperiencePoints")))
            {
                MyPS->AddExperience(*XP);
            }
            if (const int32* Gold = QuestData->Rewards.RewardAmounts.Find(TEXT("Gold")))
            {
                MyPS->AddGold(*Gold);
            }
        }
    }
    // Викликається і на менеджері PlayerState (Personal/Individual), і на
    // менеджері GameState (Shared) - GetOwningPlayerState() на party-менеджері
    // поверне nullptr, тож для нагородження всіх учасників Shared-квесту
    // розгалужуйтеся за IsPartyQuestManager().
}

Потім укажіть QuestManagerClass = MyQuestManagerComponent у Project Settings. Більше нічого міняти не потрібно — це працює незалежно від того, чи опиниться компонент на ванільному PlayerState, чи на кастомному.

Варіант на Blueprint (без C++)¶

Те, що GiveQuestRewards — це BlueprintNativeEvent, означає, що Blueprint-клас може перевизначити його точно так само, як і сабклас на C++ — жодної особливої обробки з боку рушія не потрібно:

Content Browser → Add → Blueprint Class. У діалозі вибору батька увімкніть All Classes і знайдіть Quest Manager Component — оберіть його як батька.
Назвіть, наприклад, BP_MyQuestManagerComponent, і відкрийте.
В Event Graph правою кнопкою → Add Event → знайдіть Give Quest Rewards. З'явиться нода Event Give Quest Rewards з вихідним піном Quest Data.
Проведіть логіку нагород звідти: Break структури Rewards піна Quest Data, щоб отримати Item Rewards / Reward Amounts, зробіть Find за ключем у Reward Amounts (наприклад "ExperiencePoints", "Gold" або як ваш проєкт називає свої ресурси), щоб дістати суму, потім викличте потрібні функції вашої системи характеристик чи інвентарю (наприклад, Get Player State → каст до свого PlayerState → Add Experience).
Project Settings → Game → Quest System → вкажіть Quest Manager Class = BP_MyQuestManagerComponent.

Реалізація за замовчуванням на C++ (лише логування) не виконається, доки ви явно не додасте Call to Parent Function на ноді події — пропустити його нормально, ви не втрачаєте нічого, крім рядка в лозі.

Ручне розміщення (відмова від автоматики)¶

Якщо хочете повний контроль, вимкніть відповідне налаштування bAutoCreate* і створіть компонент самі — точно так само, як до появи сабсистеми:

AMyPlayerState::AMyPlayerState()
{
    QuestManagerComponent = CreateDefaultSubobject<UQuestManagerComponent>(TEXT("QuestManagerComponent"));
    QuestManagerComponent->SetIsReplicated(true);
}

Обидва підходи дають ідентичний, повністю робочий компонент — інтеграція без налаштування просто рекомендується за замовчуванням.