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

Holder Name

The name of the Holder used in examples

Position

The position used in examples

top_name

• Format:
  • money;top_name;1
• 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