跳到主要内容

leaderboard points - 积分排行榜命令

命令名称​

/leaderboard points

描述​

此命令允许您查看服务器的积分排行榜。您可以根据不同时间段筛选排行榜、设置自定义日期范围，并指定要显示的成员数量。

用法​

/leaderboard points [period] [date_range] [limit]

参数​

可选参数：​

  • [period]：指定排行榜的时间范围。

    • All：显示用户自加入以来累积的总积分，减去任何扣除或兑换。这是默认值。
    • Today：显示从今天 00:00（服务器时区）到现在的积分。
    • This Week：（高级版）显示从本周一 00:00（服务器时区）到现在的积分。
    • This Month：（高级版）显示从本月 1 日 00:00（服务器时区）到现在的积分。
    • 7-Day：（高级版）显示从当前时间起过去 7 个滚动日内的积分。
    • 30-Day：（高级版）显示从当前时间起过去 30 个滚动日内的积分。
    • Custom：（旗舰版）允许您使用 date_range 参数指定自定义日期范围。
    重要提示：
    • 当 period 设置为 All 时，排行榜显示每位成员的当前积分余额，包括他们获得的所有积分减去已花费的任何积分。
    • 对于所有其他时间段（例如，Today、This Week、Custom），排行榜显示每位成员在该特定时间段内获得的总积分，无论其当前余额如何。

  • [date_range]：此参数仅在 period 设置为 Custom 时使用。它允许您指定排行榜的单个日期或日期范围。

    • 单日：对于特定日期，使用 YYYY-MM-DD,YYYY-MM-DD 格式（例如，2025-07-07,2025-07-07 表示 2025 年 7 月 7 日）。
    • 日期范围：使用 YYYY-MM-DD,YYYY-MM-DD 格式指定一个范围，包括开始和结束日期（例如，2025-07-01,2025-07-07）。
    • 开始日期至今：使用 YYYY-MM-DD 格式（例如，2025-07-01）显示从指定开始日期到当前时间的积分。

  • [limit]：指定要在排行榜上显示的前几名成员数量。支持的最大值为 100。默认值为 10。

示例​

  • 示例 1：查看显示前 10 名成员的整体积分排行榜。

    /leaderboard points

  • 示例 2：查看今天积分排行榜，显示前 10 名成员。

    /leaderboard points period:Today

  • 示例 3：查看本周积分排行榜，显示前 20 名成员。

    /leaderboard points period:"This Week" limit:20

  • 示例 4：查看本月积分排行榜，显示前 30 名成员。

    /leaderboard points period:"This Month" limit:30

  • 示例 5：查看过去 7 天的排行榜，显示前 15 名成员。

    /leaderboard points period:"7-Day" limit:15

  • 示例 6：仅查看 2025 年 7 月 1 日的排行榜。

    /leaderboard points period:Custom date_range:2025-07-01,2025-07-01

  • 示例 7：查看 2025 年 7 月第一周的积分排行榜，显示前 50 名成员。

    /leaderboard points period:Custom date_range:2025-07-01,2025-07-07 limit:50

  • 示例 8：查看从 2025 年 7 月 1 日至今的积分排行榜。

    /leaderboard points period:Custom date_range:2025-07-01

注意事项​

  • 只有管理员权限的成员才能执行 /leaderboard points 命令。
  • 排行榜上的“刷新”按钮对所有成员可见且可点击，但两次点击之间有 5 分钟的冷却时间。
  • “我的排名”按钮所有成员均可点击，但只会显示他们自己的排名。
  • 某些 period 选项（This Week、This Month、7-Day、30-Day）需要高级版。
  • Custom 时间段选项需要旗舰版。
  • date_range 参数仅适用于 period 设置为 Custom 时。

常见问题​

  • 问：普通成员可以看到排行榜吗？

    答：虽然只有管理员才能使用 /leaderboard points 命令生成排行榜，但现有排行榜显示上的"刷新"和"我的排名"按钮对所有成员可见且可点击。

  • 问：我可以在排行榜上显示的最大成员数量是多少？

    答：您可以使用 limit 参数在排行榜上显示最多 100 名成员。

  • 问：我是否需要特殊订阅才能查看"本周"或"自定义"等特定时间段的排行榜？

    答：是的，"本周"、"本月"、"7 天"和"30 天"时间段需要高级版。"自定义"时间段需要旗舰版。