Action types
Complete
A promise is only worth the day it is kept. Complete is how the Ledger marks that day.
What it is
Complete is the turn-in. It checks that the player has what a quest or achievement asks for, uses those things up, pays the rewards and marks the quest as done. If the quest has a next stage, that stage is given to the player.
What the player sees
The Complete button sits with the player's other action buttons. If the requirements are not met, the button is grey. A tap shows "Requirements Not Met" and nothing starts. If they are met, the tap completes it in the same moment, and the rewards arriving are the feedback. The button then disappears, because the quest is no longer active.
An achievement usually completes by itself the moment the player has what it asks for. A quest does not, unless you turn Auto Complete on: the player hands it in.
Which components can have it
A Quest or an Achievement. See Quest and Achievement.
Requirements & effects it uses
| Requirement / effect | What it does here |
|---|---|
| Needs | The things the player hands in, such as 10 wood. Each one is used up unless you untick Used up. |
| Gives | The rewards, such as 100 gold. |
| Skills needed | The player must have a skill. A higher level also counts. |
| Research needed | The player must have finished a piece of research. |
Other requirements and effects are possible. They are listed under the hood.
Setting it up
With a new quest. The Quest form in Create Component writes the Complete for you. Fill in To complete it, the player needs and Rewards. At least one reward is required. See Quest or the guide Create a quest.
On an older quest. If a quest has no Complete:
- Select the quest and open its property window.
- Click Add action ▾ and choose Add how this completes.
Settings in the window: duration, cooldown, Auto Award, Quick action, Volume and Remove this action. A new Complete from Edit Mode takes no time at all.
In Vespera: turning in First Light Play it
In Vespera, the player opens the Guild of Smiths & Growers from the Quest Board and completes its first stage, First Light. The Complete uses up 3 Wheat Sheaf and 6 Iron Nails. It pays 10 Vesper Marks, 1 Hope and 20 XP. Then the story The Hearth Wakes plays, followed by the choice of a calling. The quest moves to its second stage, Tools for the Fields.
Wheat Sheaf and Iron Nails are Materials. Where they land when they are made is explained on the Harvest page: they go into the place, not the player's bag. So before turning in, the player picks them up. In the Unplaced Items tray, tap the item, press Pickup, set the quantity (it starts at 1), and press Pickup again.
Good to know
- Turn-in takes from the bag. Edit Mode writes requirements and rewards for the player, so what is handed in must be in the bag, not lying in the place.
- Auto Complete needs something to wait for. It fires only when something the quest asks for is received. With nothing to ask for, the window says it never completes by itself.
- "At most" cannot be edited here. A requirement of the kind "fewer than" or "at most" is kept as it is. Edit it in the admin editor.
- Offer a quest once. Have the character who offers it require that the player does not already hold it.
Under the hood
- A Complete can also be started by the game itself when a quest is handed to the player, if it has a trigger stored. The Edit Mode window does not show that setting.
- Besides Needs and Gives, a Complete can also need a character attribute, a skill, a piece of research or a tool, and can change the player's attributes or skills. The window edits skills, research and outcome groups; other rows stay as they are.
- Quests keep their progress as a status on the player's copy of the quest: active, then completed.