Ordered Player List

Configuration

{
  // Interval for checking and updating order in ticks
  "updateRate": 5,
  // Display prefix metadata above the player
  "displayPrefix": true,
  // Display suffix metadata above the player
  "displaySuffix": true,
  // List of comparison criteria applied from top to bottom
  // In this example, rank weight is checked first, then players with same weight are sorted by playtime...
  "order": [
    {
      "key": "weight",
      "reversed": true,
      "mode": "integer",
      "type": "metadata"
    },
    {
      "placeholder": "player:statistic",
      "argument": "play_time",
      "reversed": true,
      "mode": "integer",
      "type": "placeholder"
    },
    {
      "placeholder": "player:pos_y",
      "reversed": false,
      "mode": "double",
      "type": "placeholder"
    },
    {
      "placeholder": "player:statistic",
      "argument": "deaths",
      "reversed": false,
      "mode": "integer",
      "type": "placeholder"
    },
    {
      "placeholder": "player:name",
      "reversed": false,
      "mode": "string",
      "type": "placeholder"
    }
  ]
}

(Parameters displayPrefix and displaySuffix have been removed in all versions for Minecraft 1.21.2 and higher.)

Comparison System

Comparison criteria allow determining how players should be ordered in the list. They are applied sequentially from top to bottom. This means that if a comparison yields the same result for two players, the next criterion will be used to determine the order.

Sometimes it's useful to interpret data as integers or floating-point numbers instead of string comparisons. Parsing modes tell the mod how to process the string to apply the correct comparison method. Available parsing modes are: integer, string, double, long, and boolean!

Currently, two types of comparisons are available:

Metadata

Useful for comparing players based on metadata from mods like LuckPerms

{
  // Metadata key to check
  "key": "<key>",
  // Whether to reverse the comparison
  "reversed": false,
  // Parsing mode
  "mode": "<mode>",
  "type": "metadata"
}

Placeholders

Allows comparing players using placeholders

{
  // Placeholder identifier (without %)
  "placeholder": "<placeholder>",
  // Optional argument for placeholders
  "argument": "<argument>",
  // Whether to reverse the comparison
  "reversed": false,
  // Parsing mode
  "mode": "<mode>",
  "type": "placeholder"
}