Core concepts#
The building blocks#
- Quest
- A container that holds one or more tasks.
- Task
- A concrete action a player must complete — reach chapter 5, kill 10 scorpions, find the level 2 easter egg.
- Verification
- How Gamearly decides a task is done.
How verification happens#
There are two ways verification happens:
- Manual verification
- The player clicks Verify on Gamearly, and Gamearly calls your webhook to ask whether the task is complete.
- Automatic verification (recommended)
- Your project proactively reports completion to Gamearly via
/quests/complete_task, or the task validates itself from in-game events you already send.
Prefer automatic verification
It is a smoother experience for the player — no waiting on a round trip to your servers while they stare at a spinner — and it removes the need to host and operate a verification endpoint at all.