跳至主要内容

leaderboard points - 積分排行榜

指令名稱​

/leaderboard points

描述​

此指令允許您查看伺服器的積分排行榜。您可以依據不同時間段篩選排行榜、設定自訂日期範圍，並指定要顯示的成員數量。

用法​

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

參數​

可選參數：​

  • [period]：指定排行榜的時間範圍。

    [!NOTE] ⚠️ 重要事項：

    • 當 period 設定為 All 時，排行榜會顯示每位成員的目前積分餘額，包括他們所賺取的所有積分減去他們花費的任何積分。
    • 對於所有其他時間段（例如，Today、This Week、Custom），排行榜會顯示每位成員在該特定時間段內賺取的總積分數，而不論其當前餘額如何。
    • All：顯示使用者自加入以來累積的總積分，減去任何扣除或兌換的積分。這是預設值。
    • Today：顯示從今天 00:00（伺服器時區）到現在所賺取的積分。
    • This Week：（進階版）顯示從本週一 00:00（伺服器時區）到現在所賺取的積分。
    • This Month：（進階版）顯示從本月 1 日 00:00（伺服器時區）到現在所賺取的積分。
    • 7-Day：（進階版）顯示過去 7 天滾動時間內所賺取的積分。
    • 30-Day：（進階版）顯示過去 30 天滾動時間內所賺取的積分。
    • Custom：（旗艦版）允許您使用 date_range 參數指定自訂日期範圍。

  • [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 天」時間段需要 Premium 方案。「自訂」時間段需要旗艦版。