Skip to main content

Role Reward Tasks

Engagerly's role reward tasks provide a powerful way to incentivize and reward your community members based on their roles within your server. This guide will walk you through setting up and managing role reward tasks, helping you cultivate a more engaging and rewarding community experience.

Why Use Role Rewards?​

Role rewards are particularly effective for:

  • Tiered Membership: Offer increasingly valuable perks to higher-level roles, encouraging members to strive for more.
  • Recognizing Contributions: Reward specific roles that are essential to your community (e.g., moderators, event organizers, content creators).
  • Automating Perks: Instead of manually granting benefits, role rewards make it automatic once a member has the required role.

Key Points to Remember:

  • You can run multiple role reward tasks simultaneously (e.g., have daily, weekly, and monthly rewards for different roles).
  • If a member has multiple roles that qualify for rewards, they can claim each role's reward separately.

Setting Up Role Reward Tasks​

Setting up role reward tasks is a straightforward process that allows you to create customized rewards for specific roles in your community, encouraging active participation and recognition.

Role Reward Task Options​

Engagerly supports daily, weekly, and monthly role rewards. Use the following commands to set them up:

  • Daily role rewards:

    /task claim_role period:daily reward:10 role:@RoleName

  • Weekly role rewards:

    /task claim_role period:weekly reward:50 role:@RoleName

  • Monthly role rewards:

    /task claim_role period:monthly reward:200 role:@RoleName

Notes:

  • Replace @RoleName with the actual role that can claim the reward.
  • Adjust the reward value to your liking (this represents the number of points awarded).

Setup Steps​

  1. Open Discord: Admins should open any text channel that supports slash commands in the Discord server.
  2. Enter and Send Command: Input the above commands and send them. The Engagerly Bot will then create the task.
  3. Task Display: Once created, the task will automatically appear in the #🎯│task-center channel, and creation logs will be sent to the 🤖│engagerly-logs channel.

Managing Role Reward Tasks​

As the community grows and evolves, admins may need to adjust role reward tasks.

Modifying Existing Role Rewards​

Use the /task claim_role command again to modify existing role rewards. For example, to change the @VIP role's reward from 10 points daily to 50 points weekly:

/task claim_role reward:50 period:weekly role:@VIP

Note:

  • If the specified role doesn't have an existing reward task, this command will create a new task with the given parameters.
  • Changes to existing tasks only apply to future claims. Any rewards already claimed will not be affected.

Removing Role Rewards​

To remove a role reward task entirely, use the same command structure but set the reward value to 0. For example, to remove the weekly reward for the @VIP role:

/task claim_role reward:0 period:weekly role:@VIP

Note:

  • If the specified period and role do not match an existing task, the command will not remove any task.
  • Always double-check the period and role before executing the removal command to ensure you're targeting the correct task.

How Members Claim​

Members can claim their role rewards easily using simple commands in any channel that supports slash commands:

  1. Daily Rewards: /reward role_daily
  2. Weekly Rewards: /reward role_weekly
  3. Monthly Rewards: /reward role_monthly

Engagerly will automatically detect the member's roles and distribute any eligible rewards.

Note

  • Members can only claim each role reward once per claim period (day, week, or month).
  • If members have multiple roles with rewards, they will receive all eligible rewards by using the command just once.

FAQs​

Q: Can I set up multiple role rewards with different values?
A: Yes. You can create as many role reward tasks as you need, each with its own unique reward value, frequency, and role assignment.

Q: What happens if a member has multiple roles with rewards?
A: Members with multiple eligible roles can claim all their rewards by using the appropriate claim command (/reward role_daily, /reward role_weekly, or /reward role_monthly) just once. They'll receive all the rewards they're eligible for. This streamlined process saves time and improves user experience.

Q: Can members claim rewards for roles they don't have?
A: No. The system automatically checks a member's roles and only distributes rewards for roles they currently hold.

Q: How can I check which role rewards are currently active?
A: You can view all active tasks, including role reward tasks, in the designated #🎯│task-center channel on your Discord server.

Q: Does removing a role from a member affect their ability to claim past rewards?
A: If a member already claimed a reward for a role, they will keep that reward even if the role is later removed. However, once a role is removed, they are no longer eligible for future rewards associated with that role.