heyheythere

Quickstart: a quest in your own map

Fifteen minutes from an installed plugin to a quest you can play: Mira has lost her ring by the well, she asks you to find it, and thanks you when you have. No Blueprint graph or C++ is needed.

The steps use a project made from the Third Person template with the plugin enabled (Install). Any project whose player uses Enhanced Input works the same.

1. Add a gameplay tag

Quests hear about what happens in your game through gameplay tags. Finding the ring will report one.

  1. Open Edit > Project Settings and pick GameplayTags under Project on the left.
  2. Click Manage Gameplay Tags… beside Gameplay Tag List. The Gameplay Tag Manager opens.

    The Project - GameplayTags settings page, its Gameplay Tags rows down to Gameplay Tag List, which has the Manage Gameplay Tags button.
    The GameplayTags page; the button is on the Gameplay Tag List row.
  3. Click + at the manager’s top left, type Quest.Ring.Found as the Name, and click Add New Tag. The tag shows in the list, under Quest and Ring.

2. Make the quest

  1. In the Content Browser, right-click an empty spot and pick Gameplay > Quest. Name the new asset Ring and double-click it to open it.
  2. Fill in Title with Mira's Ring and Description with Mira lost her ring by the old well.
  3. Click + beside Stages to add a stage, and open it with the arrow beside Index [0]. Set its Text to Search the well.
  4. Click + beside the stage’s Objectives and open the new objective. Fill in:

    Field Value
    Id Find
    Text Find the ring
    Event Tag Quest.Ring.Found
    The Ring quest asset open: Title Mira's Ring, the description, one stage with the text Search the well, and its objective with Id Find, Text Find the ring, Event Tag Quest.Ring.Found and Count 1.
    The quest with its stage and objective opened.
  5. Click Save. If anything is missing, such as an objective with no Event Tag, the Message Log says so as you save.

3. Write the dialogue

Dialogue is a text file in the script format. Mira’s checks the quest first, so she says the right thing before, during and after it:

speaker Mira: Mira
if Ring is completed -> thanks
if Ring is active -> waiting
Mira: I lost my ring by the old well. Would you look for it?
* I'll find it. -> yes
* Not now.
Mira: Another time, then.
end

== yes
do start Ring
Mira: Thank you! It's silver, you can't miss it.
end

== waiting
Mira: Any luck by the well?
end

== thanks
Mira: You found it! Thank you.

The first line names who speaks: lines starting Mira: show under the name “Mira”. The if lines jump to a label (== thanks) when they hold, * lines are choices, and end ends the talk.

  1. Save the text above as Mira.qds, from any text editor.
  2. Drag Mira.qds from its folder into the Content Browser. It becomes the dialogue asset Mira, beside the quest.

    The Content Browser showing the dialogue asset Mira, selected, beside the quest asset Ring.
    The script imported as the dialogue asset Mira.

If the script has a mistake, the import names its line in the Message Log. After editing the file, right-click the asset and pick Reimport.

4. Place Mira

Anyone the player can talk to carries a Speaker Component: a character, a statue, a sign.

  1. From Characters/Mannequins/Meshes in the Content Browser, drag SKM_Quinn_Simple into the map near the player start.
  2. With it selected, click + Add in the Details panel, search for Speaker, and pick Speaker Component.
  3. Set the component’s Dialogue to Mira.

    The Details panel of SKM_Quinn_Simple with its Speaker Component, listed as QDSpeaker, selected and Dialogue set to Mira.
    Mira’s Speaker Component, its Dialogue set.

5. Place the ring

A Quest Trigger reports its tag when the player walks into its box.

  1. Open Window > Place Actors, search for Quest Trigger, and drag it into the map some way from Mira.

    The Place Actors panel searched for Quest Trigger, with the Quest Trigger actor listed.
    The Quest Trigger in Place Actors.
  2. In its Details, set Event Tag to Quest.Ring.Found.

    The Details panel of the Quest Trigger with Event Tag Quest.Ring.Found, Count 1 and no Quest to Start.
    The trigger reports Quest.Ring.Found once, completing the objective.

Scale the trigger to fit the spot. Its box catches any pawn a player controls.

6. Play

Press Play.

  1. Walk up to Mira and press E. She asks for help. Pick I’ll find it. with the mouse or 1, then press Enter past her thanks. The quest shows at the top right.

    The dialogue box: Mira asks the player to look for her ring by the old well, with the choices I'll find it and Not now.
    Mira’s first line and its two choices.
    The tracker at the top right of the screen: Mira's Ring, with the objective Find the ring under it.
    The tracker, once the quest has started.
  2. Press J. The quest log lists Mira’s Ring with its stage and objective. Press J again, or Esc, to close it.

    The quest log open over the game, listing Mira's Ring as active with its stage text and objective.
    The quest log.
  3. Walk into the trigger. The quest completes and leaves the tracker.
  4. Walk back to Mira and press E. She thanks you.

    The dialogue box with Mira's line: You found it! Thank you.
    Mira, once the quest is completed.

To watch the quest while you play, press ' (apostrophe) for the Gameplay Debugger: its Quests category lists the player’s quests, objectives and tags as they change. Or type Quest.List in the console (`).

The Gameplay Debugger's Quests category: the player's quests, with Ring completed at stage 1 of 1, and an empty Tags line.
The Gameplay Debugger’s Quests category.

If something doesn’t happen as written, Troubleshooting has each step’s usual cause.

Next