How does it work?

The Playfull Mission system works by leveraging game events to track player progress and determine the completion of configured missions. Here's an overview of how it typically operates:

Note:

• All mission configurations are managed by the Playfull team. There is currently no API available for developers to directly update or modify mission settings.
• As a developer, your main responsibility is to integrate with the Playfull Events API and send the required game events and player identifiers. These are used by Playfull to track progress and determine mission completion.

Defining Missions: Game developers define a set of missions within the game. Missions can vary in complexity, objectives, and requirements. Each mission is configured with specific conditions that need to be met for completion.

Defining Game Events: Game developers determine what events are needed to track the progress and completion of the defined set of missions. The game sends these events to the Playfull Events API based on player actions, interactions, or achievements. These events can include actions like completing a level, defeating an enemy, earning points, collecting items, reaching a milestone, or any other significant in-game activity.

Defining Account Identifiers: To map the game specific user ids, to the Playfull user accounts, there needs to be at least one account identifier sent to the API. These identifiers include email address, wallet address, Discord id, etc., and it is good practice to send these on user signup and signin. Once that is done, the Game Events can refer to the internal user id.

Mission Scheduling: The defined Missions are configured and scheduled on the Playfull platform. We recommend to schedule daily missions that rotate between a set of defined missions.

Event Evaluation: The captured game events are evaluated against the conditions set for each mission. While the player is active on the Playfull platform, the Mission system tries to sync the state of the mission, to see if the received game events for the player, align with the requirements specified for each mission. For example, if a mission requires the player to defeat 10 enemies, the system might check if the player has triggered the event for defeating an enemy 10 times.

Mission Completion: Once the player's actions fulfill the conditions of a mission, the Mission system marks the mission as completed.

Reward Distribution: Upon mission completion, the player will receive a prompt to claim their rewards. The Mission system manages the distribution of these rewards, providing a sense of accomplishment and incentivizing players to continue engaging with the game.

Progress Tracking: The Mission system only updates the player's ongoing progress toward each mission, when it receives a sync request. This typically happens when a player visits the Playfull platform. But even if the sync does not happen until after the mission timer has expired, it will still evaluate the game events that were sent during the mission duration and correctly mark the Mission as either completed or failed.

Mission Updates and Refresh: Game developers can periodically update or refresh the available missions to offer new objectives and keep the experience engaging for players. This may involve adding new missions, modifying existing ones, or introducing time-limited or seasonal missions.

By utilizing game events to track player actions and progress, the Mission system creates a dynamic and interactive gameplay experience. It motivates players to engage with specific objectives, offers a sense of accomplishment upon mission completion, and provides ongoing goals to pursue, enhancing player retention and enjoyment in the game.