Warmind Destiny Autoroles

April 20, 2019


What Are Warmind Destiny Autoroles?

The Warmind keeps track of many different leaderboards based on guardian's in-game performance. A full list can be found at https://warmind.io/s and each leaderboard can also be displayed in Discord with the !rank commands. These leaderboards can be used to assign Discord roles to users to acknowledge accomplishments as well as provide incentives to complete objectives. Roles can be used to provide special Discord permissions or access to exclusive channels on your server, and allows users to see your selected roles by looking at their Discord user summary.

If you are looking to assign roles based on registration with Charlemagne or clan membership, please see the Destiny System Autorole guide.

How Do I Assign Roles Based on Destiny Accomplishments?

In order to assign roles based on the numerous leaderboards available by Charlemagne, first make sure the following requirements are met:

  • Charlemagne has the manage roles permission

  • The guardian must be registered with Charlemagne in order to be assigned a role

  • All managed roles must be beneath Charlemagne's role in Discord’s role hierarchy

Steps for creating Warmind Destiny Autoroles

  1. Create the desired roles

  2. Go to https://warmind.io/s and decide which leaderboard stats you want to use

  3. Click on the desired leaderboard. The stat command with the shortcut is displayed. You will need to know the SHORTCUT command for assigning roles (ex: For Overall PvP K/D, command is !rank kd, shortcut is just kd, so respond with kd)

  4. Type the following command: !server autorole

  5. Respond with the stat shortcut kd from the step above

    • If you want to remove an autorole rule, enter remove before the leaderboard shortcut (e.g. remove kd)

  6. Respond with the requirement value - ONLY the numerical value

  7. Select the greater than/equal to or less than/equal to reaction to finish setting up the role.

Any stat that has a leaderboard is possible to add as a requirement. There are no limitations to how many requirements you may set up. Combine away! (Do keep in mind that Discord limits servers to 250 roles/server.)

When Does Charlemagne Assign Destiny Autoroles?

Autoroles are assigned when:

  • When a registered guardian joins your server

  • When a guardian registers with Charlemagne for the first time

  • The moment Bungie recognizes a related activity as complete

If you use the !last <activity> commands, you can verify that the activity is available.

Note: Warmind AutoRoles are not retroactive; they occur in real time. If a new role is added, it will be assigned to a guardian the next time they play the required activity. For example, as soon as someone completes a raid, reaches that elusive kd or hits their weekly clan xp, the respective roles will be assigned.

What Stats Can I Use With Destiny Autoroles?

Charlemagne has over 250 stats on her leaderboards. You can use any combination of these stats to create your roles.

  • Go to https://warmind.io/s

  • Then click on the link for the leaderboard/rank you want to use. The command will be at the top of the leaderboard (ie. !rank kd) The shortcut command for creating the role is the rank command minus the word: rank. So, in the example above: kd

Will Charlemagne Automagically Remove Roles When A Guardian No Longer Meets The Criteria?

If you want a role hierarchy, the roles need to be "linked" so that lower linked roles will be removed once the higher role requirements are met.

To link a role:

  • Create the roles first, then run: !server autorole link

  • Select the higher role first

  • Select the lower role second

To unlink a role:

  • Run !server autorole unlink

  • Select the higher role first

  • Select the lower role second

Example using Destiny Autorole

Bypassing Roles

To bypass a server role (meaning Charlemagne will not apply certain AutoRoles to server members with that role) use:

!server autorole bypass

Then select the AutoRole in question, followed by the role you want her to bypass when she's assigning AutoRoles.

For example, let's say I create an AutoRole called "Scrubs" that Charlemagne is to assign to anyone with under 100 hours of D2 gametime. Let's also say that my administrators are called "Mods." If I don't want Charlemagne to assign the AutoRole of "Scrubs" to my "Mods" role, I'd run the !server autorole bypass command, chose the "Scrubs" AutoRole and then chose the "Mods" role as the role that I want her to bypass.

Example using Autorole Bypass

Can I Limit Roles To Only Clan Members?

This is not available at this time. If you assign a "Non-Clan" role to those users, you can use the bypass feature in the previous section. See System Autoroles for other types of roles that can be assigned.

Step By Step Sample Configs

As an example of setting up the autorole, here are the commands necessary to setup autorole assignment for users based on Last Wish completions. Check out the full list of leaderboards at https://warmind.io/s to customize for your needs.

Single Criteria With Multiple Levels

This example will create multiple roles based on one leaderboard. As a user moves up the ranks, roles will be linked so lower roles will be removed as higher roles are added.

Creating The Roles

The first step is to create the roles you want in your Discord server's settings. In this example, we have created four roles.

  • 1-4 Last Wish

  • 5-9 Last Wish

  • 10-19 Last Wish

  • 20+ Last Wish

Assigning The Rules

To assign the criteria to each role, we would run the following set of action for EACH of the roles:

  1. !server autorole This will give you a prompt to select which role

  2. Use the reaction buttons. Scroll through the pages to select the role you want to use

  3. You will next be prompted to select the leaderboard to use. In the case of this example for Last Wish completions, we will enter lw

  4. Next is specifying the number of completions for the role, followed by if we want the rule to be Greater than (>=) or Less Than (<=) the number we entered.

  5. Repeat these steps for each of the roles.

For this example, the following values were selected:

  • 1-4 Completions - Greater than 1

  • 5-9 Completions - Greater than 5

  • 10-19 Completions - Greater than 10

  • 20+ Completions - Greater than 20

Once created, !server autorole summary returns the following results, confirming the proper linking of roles to all lower roles:

Linking The Roles

By default, each of the roles applies independently. That means that someone with 11 completions would receive all of these roles. That isn't necessary and by linking the roles, the lower roles will be removed as users progress up.

Higher level roles will need to link to all lower roles. That means that the 20+ needs to be linked to the 10+, 5+ and 1+ roles, The 10-19 role needs to be linked to the 5+ and 1+ roles. The 5-9 role needs to be linked to 1+

  1. !server autorole link - This will give you a list of roles that have rules assigned to them. Start by selecting the highest role, in this case 20+.

  2. You will then be prompted to select a lower role to link, choose 10-19.

  3. Select Yes to link another role, and respond Yes and select 5-9.

  4. Select Yes to link another role, and respond Yes and select 1-4

  5. Repeat the above steps for 10-19 Completions and its lower roles, 5-9 Completions and its lower role. 1-4 Completions does not have any lower roles.

Multiple Criteria

In this example, we will create a role that is based off multiple, different leaderboards. Since this role will not need to replace another role, it does not need to be linked.

Creating The Role

The first step is to create the role you want in your Discord server's settings. In this example, we have created one role.

  • Master Raider

Assigning The Rules

To assign the criteria to each role, we would run the following set of actions for EACH of the roles:

  1. !server autorole - This will give you a prompt to select which role

  2. Use the reaction buttons. Scroll through the pages to select the role you want to use

  3. You will next be prompted to select the leaderboard to use. In the case of this example we will use each of the raid completion leaderboards.

  4. Next is specifying the leaderboard value for the role, followed by if we want the rule to be Greater Than (>=) or Less Than (<=) the number we entered, and finally a choice to add additional criteria to the role.

  5. Repeat these steps for each of the leaderboards.

For this example, the following leaderboards and values were selected:

  • D2 Leviathan Total Completions leaderboard with shortcut lev - Greater than 20

  • D2 Lev: Eater of Worlds Total Completions leaderboard with shortcut eow - Greater than 20

  • D2 Lev: Spire of Stars Total Completions leaderboard with shortcut sos - Greater than 20

  • D2 Total Last Wish Completions leaderboard with shortcut lw - Greater than 20

  • D2 Scourge of the Past Total Completions leaderboard with shortcut sotp - Greater than 20

Once these rules are created, a !server autorole summary should give following response:

Possible Role Scenarios

  • Weekly Clan XP

    • Recognize your most dedicated clan contributors with a custom Discord role each week using the Weekly Clan XP Contribution leaderboard with shortcut clanxpweekly

  • Raid Completions

    • Recognize your server's most hardcore raiders

    • Help identify players that have multiple completions as possible sherpas

  • PvP K/D

    • Create multiple, linked roles to easily see someone's current K/D just by looking at their Discord user summary

    • Use the D2 Overall PvP K/D leaderboard with shortcut kd or D2 Overall PvP Efficiency leaderboard with shortcut eff

  • Glory Ranking

    • Reward the comp grind with special Discord permissions via Autoroles

    • Pair Destiny Autoroles with exclusive channels so folks can easily find others with similar Glory to team up with based on the D2 Current Season Glory Rank leaderboard with shortcut glory

  • Gambit Prime Roles

    • Auto-assign Gambit Prime roles based on in-game performance. Set performance thresholds for server members to reach in order to receive the roles

      • Collector: Use the D2 Gambit Prime MPM: Motes Deposited / Match leaderboard with shortcut gpmpm

      • Invader: Use the D2 Gambit Prime Avg KPI: Kills / Invasion leaderboard with shortcut gpkpi

      • Reaper: Use the D2 Gambit Prime PvE Kills / Round leaderboard with shortcut gpkpr

      • Sentry: Use the D2 Gambit Prime Invaders Killed leaderboard with shortcut gpikilled

  • Total Active Time

    • Reward your most active server members with roles at specific total active time milestones

  • Maximum Reported Power

    • Pair Destiny Autoroles with exclusive channels so discussions about end-game content are only visible to people with the proper power level to access said content

~TheFishBoxer, KramRM, & LoraTheXplorer