Utilisation détaillée

Subsystem

ADS Quest Subsystem est le point d'entrée principal. Il centralise la gestion des quêtes au runtime : états, suivi, progression des objectifs, récompenses et verrous.

Accéder au Subsystem

Dans un Blueprint, utilisez Get ADS Quest Subsystem.

Fonction Get ADS Quest Subsystem

Fonctions

Fonction	Description
`SetCurrentDT`	Définit une DataTable à utiliser. Par défaut, le Subsystem utilise `DT_Quests` : si cette table convient, il est inutile d'appeler cette fonction.
`GetCurrentDT`	Retourne la DataTable active.
`ResetCurrentDTToDefault`	Restaure `DT_Quests`.
`DoesQuestExist`	Vérifie qu'une quête existe.
`GetAllQuestRows`	Retourne les identifiants des quêtes.
`GetQuest`	Retourne les données d'une quête.
`GetState`	Retourne l'état runtime d'une quête.
`SetState`	Modifie l'état d'une quête.
`IsObtainable`	Indique si une quête peut être obtenue.
`IsQuestReadyToComplete`	Indique si tous les objectifs sont atteints.
`GetQuestsToComplete`	Retourne les quêtes à valider manuellement.
`ResolveCompletionConflict`	Résout un conflit de terminaison.
`Track`	Ajoute une quête au suivi.
`Untrack`	Retire une quête du suivi.
`ClearTracked`	Vide le suivi.
`GetTracked`	Retourne les quêtes suivies.
`GetActiveObjectiveInTrack`	Retourne les objectifs actifs pour l'interface.
`Lock`	Verrouille des quêtes.
`Unlock`	Déverrouille des quêtes.
`IsLocked`	Indique si une quête est verrouillée.
`GetLockedQuests`	Retourne les quêtes verrouillées.
`GetCurrentObjectiveViews`	Retourne les objectifs actifs des quêtes en cours.
`GetTrackedObjectiveViews`	Retourne les objectifs actifs des quêtes suivies.
`NotifyObjectiveReached`	Signale manuellement un objectif atteint.
`GetRewards`	Retourne les récompenses définies.
`GetAvailableRewards`	Retourne les récompenses disponibles.
`IsRewardReady`	Indique si les récompenses sont prêtes.
`ClearRewardReady`	Retire les récompenses prêtes.
`GetStateRegistry`	Retourne les états à sauvegarder.
`SetStateRegistry`	Restaure les états sauvegardés.
`ClearStateRegistry`	Efface les états sauvegardés.
`GetReachedObjectiveStepsRegistry`	Retourne les paliers atteints.
`SetReachedObjectiveStepsRegistry`	Restaure les paliers atteints.
`ClearReachedObjectiveStepsRegistry`	Efface les paliers atteints.
`GetReachedObjectiveElementsRegistry`	Retourne les objectifs atteints.
`SetReachedObjectiveElementsRegistry`	Restaure les objectifs atteints.
`ClearReachedObjectiveElementsRegistry`	Efface les objectifs atteints.
`GetRewardReadyRegistry`	Retourne les récompenses prêtes.
`SetRewardReadyRegistry`	Restaure les récompenses prêtes.
`ClearRewardReadyRegistry`	Efface les récompenses prêtes.
`GetRewardGrantCountRegistry`	Retourne les compteurs de récompenses.
`SetRewardGrantCountRegistry`	Restaure les compteurs de récompenses.
`ClearRewardGrantCountRegistry`	Efface les compteurs de récompenses.

Dispatchers

Dispatcher	Appelé lorsque
`OnStateChanged`	L'état d'une quête change.
`OnTracked`	Une quête est ajoutée au suivi.
`OnUntracked`	Une quête est retirée du suivi.
`OnTrackedClear`	Le suivi est vidé.
`OnObjectiveUpdated`	La progression d'un objectif est mise à jour.
`OnObjectiveStepReached`	Un palier est atteint.
`OnAllObjectivesReached`	Tous les paliers sont atteints.
`OnQuestsCompleted`	Une ou plusieurs quêtes sont terminées.
`OnLocked`	Des quêtes sont verrouillées.
`OnUnlocked`	Des quêtes sont déverrouillées.
`OnCompletionConflict`	Un conflit de terminaison doit être résolu.

Actor Component

Ajoutez ADS Quest Participant Component sur l'actor qui donne une quête ou représente un objectif. Un même actor peut remplir les deux rôles.

Paramètres

Paramètres du ADS Quest Participant Component

Paramètre	Description
`TargetIDs`	Identifiants logiques auxquels l'owner correspond en tant qu'objectif de quête.
`TargetType`	Type d'objectif de quête représenté par l'owner.
`QuestsToGive`	Quêtes que l'owner peut proposer.

Fonctions

Fonction	Description
`GetQuestsToGive`	Retourne les quêtes réellement disponibles.
`GetInObjectiveQuests`	Retourne les quêtes dont l'owner est l'objectif actif.
`DoesMatchObjective`	Vérifie si l'owner correspond à un objectif.
`UpdateMarker`	Réévalue l'indicateur.
`GetMarkerWidgetComponent`	Retourne le composant de widget.
`GetMarkerWidget`	Retourne le widget de marqueur.

Les paramètres de marqueur règlent son décalage, son espace, sa taille, son orientation et sa distance maximale de visibilité.

Logique

Créez un Blueprint enfant de ADS Quest Logic Base lorsque le système doit interroger ou modifier des données propres à votre projet.

Fonction ou événement	Description
`GetObjectiveProgress`	Retourne la progression réelle d'un objectif.
`ConsumeObjectiveRequirements`	Consomme les ressources requises à la fin d'une quête.
`OnStateChanged`	Réagit à un changement d'état.
`OnObjectiveUpdated`	Réagit à une mise à jour de progression.
`OnObjectiveStepReached`	Réagit lorsqu'un palier est atteint.
`OnAllObjectivesReached`	Réagit lorsque tous les paliers sont atteints.
`OnQuestsCompleted`	Réagit à la terminaison de quêtes.
`OnTracked`	Réagit à l'ajout au suivi.
`OnUntracked`	Réagit au retrait du suivi.
`OnLocked`	Réagit au verrouillage.
`OnUnlocked`	Réagit au déverrouillage.
`OnCompletionConflict`	Réagit à un conflit de terminaison.

Définition des quêtes

Data Table

La DataTable utilise la structure S_Quest. Chaque ligne représente une quête et son RowName est son identifiant technique. Elle contient notamment le texte affiché, le type, la catégorie, les conditions de déblocage, les paliers d'objectifs, les récompenses et les automatisations.

Manager

Le Quest Manager est l'outil recommandé pour créer, consulter et modifier les quêtes. Dans Unreal Engine, ouvrez le menu Window, puis ADS Framework > Open ADS Quest Manager. Vous pouvez aussi faire un clic droit dans le Content Browser, puis choisir Open ADS Quest Manager dans la section ADS Framework ; la capture ci-dessous illustre cette méthode.

Le manager permet de choisir la DataTable à éditer, de créer ou dupliquer une quête, de filtrer les quêtes et de configurer les informations générales, les paliers d'objectifs, les récompenses et les automatisations.