Quests

Overview

The Quest Module allows administrators to create and manage challenges tied to Bonus Hunts and Tournaments. When quests are completed, active chatters with connected accounts will automatically receive reward points.

Quest Management

Creating a Quest

1. Navigate to Admin Panel > Modules > Quests

2. Click the New Quest button

3. Fill in the quest details:

   • Name: A descriptive name for the quest

   • Type: Choose from Bonus Hunt, Tournament, or Custom

   • Description: Optional details about the quest

   • Active: Toggle to enable/disable the quest

4. Click Create Quest to save

Quest Types

• Bonus Hunt: Tasks related to bonus hunt streams

• Tournament: Tasks related to slot tournament streams

• Custom: Special quests that don't fit into the above categories

Managing Existing Quests

• View: Click on a quest to see its details and associated tasks

• Edit: Modify quest details using the Edit button

• Toggle Status: Activate or deactivate a quest without deleting it

• Delete: Permanently remove a quest and all its associated tasks

Task Management

Each quest consists of one or more tasks. Tasks are the specific conditions that need to be met for the quest to be completed.

Creating Tasks

1. Navigate to the quest detail page

2. Click Add Task

3. Fill in the task details:

   • Name: A descriptive name for the task

   • Description: Optional details about what needs to be done

   • Points: The number of points awarded when this task is completed

   • Type: The specific condition type (varies based on quest type)

   • Additional Fields: Based on the selected task type

Task Types for Bonus Hunts

• Bonus Hunt Profit: Completed when the bonus hunt ends with a profit

  • Requires selecting a specific Bonus Hunt

• Bonus Hunt Slots Over Multiplier: Completed when a specified number of slots achieve a certain multiplier

  • Requires: Bonus Hunt, Number of Slots, Multiplier threshold

• Bonus Hunt Slot Over Multiplier: Completed when a specific slot achieves a certain multiplier

  • Requires: Bonus Hunt, Slot Name, Multiplier threshold

• Bonus Hunt Slot Under Multiplier: Completed when a specific slot performs below a certain multiplier

  • Requires: Bonus Hunt, Slot Name, Multiplier threshold

Task Types for Tournaments

• Tournament Slot Winner: Completed when a specific slot wins the tournament

  • Requires: Tournament, Slot Name

• Tournament Slots Over Multiplier: Completed when a specified number of slots achieve a certain multiplier

  • Requires: Tournament, Number of Slots, Multiplier threshold

• Tournament Slots Under Multiplier: Completed when a specified number of slots perform below a certain multiplier

  • Requires: Tournament, Number of Slots, Multiplier threshold

Managing Tasks

• Edit: Modify task details

• Complete Manually: Mark a task as completed manually (in case automatic detection fails)

• Reset: Return a completed task to its uncompleted state

• Delete: Remove a task from the quest

Automatic Task Completion

The system automatically checks for task completion when:

1. A new bonus hunt game result is added

2. A bonus hunt game result is updated

3. A bonus hunt is completed (end balance is set)

4. A tournament match result is added

5. A tournament match result is updated

6. A tournament is completed

No manual intervention is required for task completion under normal circumstances.

Reward Distribution

When a task is completed:

1. The system automatically marks the task as completed

2. Active chatters with connected accounts receive the specified points

3. The completion is logged in the system for reference

Linking Bonus Hunts and Tournaments

For tasks that require selecting a Bonus Hunt or Tournament:

1. Only active Bonus Hunts/Tournaments will be available in the dropdown

2. When selecting a specific slot for a task, the system will display all slots from the selected Bonus Hunt/Tournament

3. The task will be associated with the specific Bonus Hunt/Tournament, not just any Bonus Hunt/Tournament