Achievements

Managing Achievements

Achievements are user goals that reward users when they complete specific tasks or collect specific game objects. Achievements are organized in three layers:
Achievement Groups → Achievements → Levels.
Users see achievements as cards with progress and rewards.

⚠️ Draft or inactive achievements and levels are not shown to users.

Steps

1. Open the platform and login as a SuperAdmin.
2. Go to “Gamification” and select “Achievements”.
3. Create an Achievement Group (category):
   1. Click “ADD”.
   2. Fill in captions in all available languages.
   3. Fill in descriptions in all available languages (what users will read).
   4. Upload an “Icon” (optional).
   5. Click “Submit”.
4. Open an Achievement Group:
   1. In the groups list, click next to the required group.
   2. Open the group achievements list.
5. Create an Achievement inside the group:
   1. Click “ADD”.
   2. Fill in captions in all available languages.
   3. Set “Object” as the internal achievement identifier used by gamification logic.
   4. Fill in descriptions in all available languages (what users will read).
   5. Upload an “Icon” (optional).
   6. Set “Status” to “Active” to make it available to users.
   7. Click “Submit”.
6. Open Levels for an Achievement:
   1. In the achievements list, click next to the required achievement.
   2. Select “Achievements Levels”.
7. Create a Level (a milestone inside the achievement):
   1. Click “ADD”.
   2. Fill in captions in all available languages (level name shown to users).
   3. Set “Object” as the internal level identifier.
   4. Configure “Need” (the condition to complete the level):
   1. Enter the required quantity.
   2. Enter the “Object Name” that must be present in the user inventory (for example a progress flag).
   5. Configure “Withdraw” (optional):
   1. Enter the quantity.
   2. Enter the “Object Name” that will be removed when the level is completed.
   6. Configure “Rewards” (optional):
   1. Enter the quantity.
   2. Enter the “Object Name” that will be added when the level is completed (for example points or the next level object).
   7. Fill in descriptions in all available languages (simple explanation of what the user must do).
   8. Upload an “Icon” (optional).
   9. Link “Tasks” (optional but recommended):
   1. Select tasks that describe the user actions needed to reach this level.
   2. Make sure the selected tasks match the progress logic for the “Need” condition.
   10. Click “Submit”.
8. Edit or remove an existing group, achievement, or level:
   1. Find the required item in the list.
   2. Click .
   3. Select “Edit” or “Remove”.
   4. If editing, update fields and click “Submit”.
9. Verify the result as a user:
   1. Open the user interface and go to “Achievements”.
   2. Confirm the achievement appears as a card with its title, description, reward preview, and progress.
   3. Open the achievement to confirm the level details and the linked tasks are displayed and progress is tracked.