Skip to main content

Query

The query system is the same as the one used in Topper, with the addition that the <holder> is the name of the Holder specified in the configuration file of TimedTopper.

Refer to the Topper Query page for more information.

Types​

The name of the holder (e.g. money, exp)

The position in the leaderboard (must be >= 1)

top_name

  • Format:
    • <holder>;top_name;<position>
  • Description: The name of the player at the specified position.
  • Argument:
    • <holder>: The name of the Holder
  • Example:
    • money;top_name;1
      • Retrieve the name of the player at position 1 in the Holder named money

top_key

  • Format:
    • <holder>;top_key;<position>
  • Description: The UUID of the player at the specified position.
  • Argument:
    • <holder>: The name of the Holder
  • Example:
    • money;top_key;1
      • Retrieve the UUID of the player at position 1 in the Holder named money

top_value

  • Format:
    • <holder>;top_value;<position>
    • <holder>;top_value;<position>;<format>
  • Description: The value of the player at the specified position.
  • Argument:
    • <holder>: The name of the Holder
  • Example:
    • money;top_value;1
      • Retrieve the value of the player at position 1 in the Holder named money
    • money;top_value;1;#,###
      • Retrieve the formatted value of the player at position 1 in the Holder named money, in the format of #,###

top_value_raw

  • Format:
    • <holder>;top_value_raw;<position>
  • Description: The raw value of the player at the specified position.
  • Argument:
    • <holder>: The name of the Holder
  • Example:
    • money;top_value_raw;1
      • Retrieve the raw value of the player at position 1 in the Holder named money

top_rank

  • Format:
    • <holder>;top_rank
    • <holder>;top_rank;<format>
  • Description: The player's rank (position number) in the specified Holder.
  • Argument:
    • <holder>: The name of the Holder
  • Example:
    • money;top_rank
      • Retrieve the rank of the player in the Holder named money
    • money;top_rank;#,###
      • Retrieve the formatted rank of the player in the Holder named money

top_size

  • Format:
    • <holder>;top_size
  • Description: The amount of entries in the Holder.
  • Argument:
    • <holder>: The name of the Holder
  • Example:
    • money;top_size
      • Retrieve the amount of entries in the Holder named money

value

  • Format:
    • <holder>;value
    • <holder>;value;<format>
  • Description: The value of the player.
  • Argument:
    • <holder>: The name of the Holder
  • Example:
    • money;value
      • Retrieve the value of the player in the Holder named money
    • money;value;#,###
      • Retrieve the formatted value of the player in the Holder named money

value_raw

  • Format:
    • <holder>;value_raw
  • Description: The raw value of the player.
  • Argument:
    • <holder>: The name of the Holder
  • Example:
    • money;value_raw
      • Retrieve the raw value of the player in the Holder named money

remain_time

  • Format:
    • <holder>;remain_time
    • <holder>;remain_time;<format>
  • Description: The remaining time until the next reset.
  • Argument:
    • <holder>: The name of the Holder
    • <format>: A time format pattern (e.g., HH:mm:ss for hours:minutes:seconds)
  • Example:
    • money;remain_time
      • Retrieve the remaining time in millis until the next reset of the Holder named money
    • money;remain_time;HH:mm:ss
      • Retrieve the remaining time until the next reset of the Holder named money

end_time

  • Format:
    • <holder>;end_time
    • <holder>;end_time;<format>
  • Description: The time of the next reset.
  • Argument:
    • <holder>: The name of the Holder
    • <format>: A time format pattern (e.g., yyyy-MM-dd HH:mm:ss)
  • Example:
    • money;end_time
      • Retrieve the next reset time in millis of the Holder named money
    • money;end_time;yyyy-MM-dd HH:mm:ss
      • Retrieve the next reset time of the Holder named money