Commands

This Discord bot helps track and compete on daily step counts in your server. Below are the available commands and their usage.

/steps

Add your steps for today (or a specific date). The steps submitted will always overwrite any previous submissions.

Usage:

/steps steps:<number> [date:YYYY-MM-DD]

• steps: The number of steps you want to record.
• date: (optional) Date for which to record steps (defaults to today).

Example:

/steps steps:10000
/steps steps:8500 date:2025-06-15

/leaderboard

Show the step leaderboard for your server.

Usage:

/leaderboard [mode:week|month] [when:YYYY-MM-DD]

• mode: (optional) Time period to show the leaderboard for. Defaults to week.
• when: (optional) Date to use as the "reference" when calculating the week or month for the leaderboard. Defaults to today.

/report

Show your own step stats.

Usage:

/stats [range:week|month]

• range: (optional) Time period to show stats for.
• when: (optional) Date to use as the "reference" when calculating the week or month for the report. Defaults to today.

/export

Export your step data to a CSV file that can be imported into many spreadsheet programs.

Usage:

/export [period:week|month|year|all] [format:csv]

• period: (optional) Time period to export data for.
• format: (optional) File format of the export. CSV is the only option (for now!).

Admin-only commands

/config

Configure step tracking settings for your server.

Usage:

/config weekday:<Monday|Tuesday|...|Sunday> week_mode:<standard|month7>

• weekday: The day your server’s step week starts on (e.g. Monday).
• week_mode:
  • standard: Weeks are counted in standard 7-day blocks, starting on the weekday configured.
  • month7: Weeks start on the first day of the month and reset every 7 days.