Skip to 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

Click me to edit the example values

top_name

  • Format:
    • <holder>;top_name;<position>
  • Description: The name of the player at the specified position.
  • Argument:
    • <holder>: The name of the Holder
    • <position>: The position of the player in 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
    • <position>: The position of the player in 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
    • <position>: The position of the player in the Holder
    • <format>: A number format pattern, see Value Display for more details on how to apply a format
  • 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
    • <position>: The position of the player in 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
    • <format>: A number format pattern, see Value Display for more details on how to apply a format
  • 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
    • <format>: A number format pattern, see Value Display for more details on how to apply a format
  • 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 date-time format pattern (e.g., yyyy-MM-dd HH:mm:ss for year-month-day hours:minutes:seconds)
  • Example:
    • money;end_time
      • Retrieve the time of the next reset in epoch millis of the Holder named money
    • money;end_time;yyyy-MM-dd HH:mm:ss
      • Retrieve the time of the next reset of the Holder named money