View Categories

Progress and Missions (3.4+)

Est. read time: 4 min read

Missions and quests form a key part of a game’s metagame design. They provide structured, rewarding goals that encourage players to return, progress, and engage with your game’s core systems. Properly designed missions drive retention by offering incremental achievements and tangible rewards that reinforce player investment over time.

This guide refers to version of Namazu Elements 3.4 and above.

📝Notes on Missions and Progress

Namazu Elements missions serve a similar purpose to PlayFab’s Quests or Event-based Tasks. Both systems define multi-step objectives that track player progress and grant rewards upon completion. This section explains how to manage missions in Namazu Elements using the admin console.

This guide explains how to create, update and delete missions using the Namazu Elements CMS. A mission is a set of steps that players can complete to earn rewards. Each step has a completion threshold and grants rewards when finished. Missions are defined in the admin console and copied to each user’s profile when they begin the mission, so modifying a mission after users have started it does not affect their existing progress.

Creating a Multi-Step Mission #

  1. From the navigation menu, choose Progress → Missions. The missions list appears with an Add Mission button.
  2. Click Add Mission. A blank mission editor opens. Fill in the mission-level fields: Field Description and guidance Display Name Human-readable title shown in the UI. Name Unique identifier used in APIs and scripts. Description Summary of what the mission requires. Tags Comma-separated labels for organisation or filtering (optional). Metadata Key–value pairs for additional data, such as image paths or categories.
  3. In the Steps section, click Add Step to create the first mission step. For each step, provide: Field Purpose Display Name Name of the step visible to players. Description Brief description of the objective. Count Number of times the player must perform an action to complete the step. For example, 5 means the action must be performed five times. Rewards Add rewards by selecting an existing item (e.g. sample_reward) and specifying the quantity. Use the + button to add multiple reward items. Metadata Optional key–value pairs for step-specific data.
  4. Repeat step 3 for additional steps. Increase the count threshold and reward quantity for each successive step to encourage continued engagement. Example: Step Count Reward Item Quantity Description 1 5 sample_reward 10 Collect 5 stars 2 10 sample_reward 20 Collect 10 stars 3 15 sample_reward 30 Collect 15 stars
  5. (Optional) Check Final Repeat Step on the last step if it should repeat indefinitely.
  6. Click Save or Create. The mission definition is stored and appears in the missions list.

Updating a Mission #

  1. In the missions list, locate the mission you created. Use the search bar or filter tags as needed.
  2. Click the Edit button next to the mission name. The mission editor opens with current values.
  3. Update mission-level fields (display name, description, tags, metadata) or modify existing steps:
  • Change a step’s Count to alter the completion threshold.
  • Adjust reward quantities or add another reward item.
  • Use the drag handle to reorder steps.
  • Click Add Step to insert new steps or Delete Step to remove one.
  1. After making changes, click Save. The mission definition updates; however, remember that changes do not affect users who already started the mission.

Deleting a Mission #

  1. In the missions list, find the mission you wish to delete.
  2. Click the Delete button (trash-can icon) next to the mission.
  3. Confirm the deletion when prompted. The mission definition is removed from the database.
  4. Deleting a mission prevents new users from starting it, but it does not remove progress data from users who already started the mission.

Best Practices #

  • Plan your mission structure. Because mission definitions are copied to user profiles when a mission starts, editing a mission later will not retroactively update existing players’ progress. Make sure the steps, rewards, and metadata are correct before activating the mission.
  • Use meaningful names and descriptions so administrators and players can easily identify missions and steps.
  • Scale rewards thoughtfully. Increasing reward quantities for later steps motivates players, but avoid making rewards so large that they destabilise the game economy.
  • Organise with tags and metadata. Tags help you filter missions in the console, and metadata allows you to attach custom data like images or categories.

Integrating Missions with Analytics and Retention #

Mission completion data is an effective tool for measuring player engagement and progression. By tracking which missions are started, completed, or abandoned, developers can identify trends in player bahaior and adjust content accordingly. Integrating mission data into your analytics pipeline allows you to measure retention, tune difficulty pacing, and optimize rewards. Over time, this feedback loop helps improve the overall player experience and supports long-term engagement strategies.

What are your Feelings