Skip to main content

task boost

Command Title​

/task boost

Description​

This command allows you to set up a boost record-breaking reward task that motivates members to boost your Discord server. Members will be rewarded with points every time their 7-day server boost count surpasses their historical maximum. This task encourages continuous server boosting and recognizes members who contribute to achieving new boost milestones.

Usage​

/task boost <break_reward> <max_breaks> [title] [description]

Parameters​

Required Parameters:​

  • <break_reward>: The reward points given each time a new 7-day server boost record is achieved. The value must be a positive integer or 0. Setting 0 disables the reward.
  • <max_breaks>: The maximum number of times a user can receive the record-breaking reward. Set to -1 for unlimited breaks.

Optional Parameters:​

  • [title]: The title of the task. This will be visible to users in task lists and details. If omitted, a default title will be used.
  • [description]: A detailed description of the task, explaining how users can participate and earn rewards. This will be shown in the task details. If omitted, a default description will be used.

Examples​

  • Example 1: Set up a boost record-breaking task that rewards users with 50 points each time they break their 7-day boost record, with no limit on the number of breaks, and using default title and description:

    /task boost break_reward:50

  • Example 2: Set up a boost record-breaking task with a custom title and description, rewarding 100 points per record break, and limiting the reward to a maximum of 3 breaks per user:

    /task boost break_reward:100 max_breaks:3 title:"Boost Record Breaker" description:"Smash your personal best 7-day boost record and earn 100 points! Rewards are capped at 3 breaks per user."

  • Example 3: Set up a boost record-breaking task with only a custom title, keeping other parameters default:

    /task boost break_reward:25 title:"Server Boost Milestone Challenge"

Notes​

  • This task focuses on rewarding users for consistently boosting the server and achieving new 7-day boost records.
  • The 7-day boost record is calculated based on the number of server boosts within a rolling 7-day window.
  • Rewards are given each time a user's 7-day boost count exceeds their personal historical maximum for the first time.
  • The system automatically tracks each user's 7-day boost record and awards points upon each break.
  • If max_breaks is set, users will stop receiving rewards after exceeding the specified number of record breaks, even if they continue to break their record further.

FAQs​

  • Q: How is the 7-day boost record calculated?

    A: The 7-day boost record is determined by counting the total number of server boosts a user has contributed within a continuous 7-day period. This record is tracked individually for each user.

  • Q: What happens if I set max_breaks to -1?

    A: Setting max_breaks to -1 means users will not be limited in the number of times they can receive the record-breaking reward. The reward will be given every time they break their 7-day boost record, without a maximum limit.

  • Q: What if a user's 7-day boost count ties their previous record, not exceeds it?

    A: Rewards are only given when the 7-day boost count strictly exceeds the user's previous historical maximum. Tying the record will not trigger a reward. The boost count must be greater than the previous record to count as a break.