Help

Levels#

Ranking

Ranks are split into 4 categories, daily, weekly, monthly, and all time. When you send a message, you gain 5 XP. This is limited to at least one minute between each message to prevent spamming. Your ranking is calculated by ROW_NUMBER() over each category in which users have sent messages in.

Example: If there has been 30 people who sent a message today, and you have the most XP gained today, you will be 1 / 30 for daily ranking.

Ranking is counted on each unique ordinal, iso_week, month, and all time. More specifically, the intervals are day of the year (1 - 365/366), ISO 8601 week-numbering week of the year (1- 52/53, starting Monday), and month within the year (1 - 12). Ranks reset in it's respective category when these values change. All times are in UTC.

Levels

Levels are calculated with the function XP required = 50 * level.pow(2) - (50 * level). Using the levels command displays the top users in each category. The all time category shows each users's rank while the other periodic categories display the rank change within each timeframe.

Activity

Similar to ranking, your activity is updated at a maximum of once per minute. When you send a message, a counter is incremented for the respective hour. The number displayed on the side of the graph designates the maximum "active minutes" within the 24 hour period. These values are never reset and consist of all time activity since the bot joined the server. Please allow the bot some time to produce a more accurate result.

Example: If you have sent messages across a total of 200 minutes between 2:00-3:00, your graph will display 200 at that point in time.

Roles#

Self role assignments can be configured with the following format. You can use JSONLint to check if your configuration is correct. Sushii should also respond with errors if your configuration is incorrect.

{
  "categoryName": {
    "limit": 1,
    "roles": {
      "roleName": {
        "primary": 1234,
        "secondary": 1235,
        "searches": [
          "word / name to search"
        ]
      }
    }
  }
}

An example is given below. The following configuration allows for 2 different categories. Bias will allow for a maximum of 3 roles from the category and the first role chosen will be the primary ID while following ones will be secondary IDs. You can use primary / secondary roles to allow for multiple role assignment while keeping a primary one in front of others depending on role hierarchy. The extras category has no limit on assignments along with no secondary roles IDs.

{
  "bias": {
    "limit": 3,
    "roles": {
      "Jennie": {
        "primary": 187473364187611140,
        "secondary": 219942256474325000,
        "searches": [
          "jennie",
          "jendeukie"
        ]
      },
      "Jisoo": {
        "primary": 192458011665498100,
        "secondary": 219942349508182000,
        "searches": [
          "jisoo",
          "chichu"
        ]
      },
      "Lisa": {
        "primary": 189915363373219840,
        "secondary": 219942309687590900,
        "searches": [
          "lisa"
        ]
      },
      "OT4": {
        "primary": 202178656066338800,
        "secondary": 0,
        "searches": [
          "ot4",
          "all"
        ]
      },
      "Rosé": {
        "primary": 195032853493448700,
        "secondary": 220679982622441470,
        "searches": [
          "rose",
          "rosé"
        ]
      }
    }
  },
  "extras": {
    "limit": 0,
    "roles": {
      "BLINK": {
        "primary": 320656786631950340,
        "secondary": 0,
        "searches": [
          "blink"
        ]
      },
      "vlive": {
        "primary": 442928635075100700,
        "secondary": 0,
        "searches": [
          "vlive"
        ]
      }
    }
  }
}

If you need additional help with the configuration, you can join the sushii support Discord server. As role configuration isn't the easiest as of now, it may be changed to be more ergonomic later.