██████╗ ███████╗███████╗██╗████████╗ ██████╗ ██████╗ ████████╗
██╔══██╗██╔════╝██╔════╝██║╚══██╔══╝ ██╔══██╗██╔═══██╗╚══██╔══╝
██████╔╝█████╗ █████╗ ██║ ██║█████╗██████╔╝██║ ██║ ██║
██╔══██╗██╔══╝ ██╔══╝ ██║ ██║╚════╝██╔══██╗██║ ██║ ██║
██████╔╝███████╗██║ ██║ ██║ ██████╔╝╚██████╔╝ ██║
╚═════╝ ╚══════╝╚═╝ ╚═╝ ╚═╝ ╚═════╝ ╚═════╝ ╚═╝
This cool bot can help you with improving your fitness. It can track your progress, motivate you, manage your goals and compare your progress to others.
Achievements
With this command you can view all of your earned and locked achievements. It can also display the completion percentage of the entire community.
Format:
/achievements
Example:
View all exercises
With this command you van view all available exercises. The extended data will also show how many people are participating and who is in first place.
Format:
/exercises view all
Example:
View the exercises you are participating in
With this command you can view all the exercises you are participating in. The extended data will show the amount of logs you've made, the goal if you have added any, your personal record and your place in the leaderboard.
Format:
/exercises view my
Example:
View extended data of a single exercise
With this command you can view extended data on a single exercise. It can show global information and statistics, your personal statistics and also a larger leaderboard.
Format:
/exercises view one {exercise}
Example:
Create a new exercise type
With this command you can create new exercises so that you can track your progress on all of your favorite exercises. Go to measurement-types and goal-direction to see the available options.
Format:
/exercises create {name} {measurement-type} {goal-direction}
Example:
Renaming an exercise type
With this command you can rename an exercise.
Format:
/exercises rename {exercise} {new-name}
Create a new goal for yourself
With this command you can set a goal for a specific exercise to work towards. See goal-status for all possible statuses.
Format:
/goals add {exercise} {amount}
Example:
Cancel an existing goal
With this command you can cancel a goal. This will update the goal's status to
CANCELLED. See goal-status for all possible statuses.Format:
/goals cancel {goal}
Example:
View your goals
With this command you can view all of your active goals. See goal-status for all possible statuses.
Format:
/goals view
Example:
Add a new habit
Use this command to add a new habit. See habit time-ranges for all the possible options.
Format:
/habits add {name} {time-range}
Example:
Check off a habit
This action will ask you what habit you have completed in the past time-range. The daily habits will be asked every day, the weekly habits will be asked each sunday and the monthly habits will be asked on the last day of the month.
Note: this is not really a command, instead it is automatically being sent to you via a private channel.
Example:
View all your habits
Use this command to view all your habits, optionally you can filter on a specific time-range. See habit time-ranges for all the possible options.
Format:
/habits view all ?{time-range}
Example:
View one of your habits
Use this command to get a detailed view of one of your habits.
Format:
/habits view one {habit}
Example:
View your progress on a habit
Use this command to generate a chart of your logged habits.
Format:
/habits progress {time-range}
Example:
Remove one of your habits
Use this command to remove one of your habits.
Format:
/habits remove {habit}
Help
Use this command to get an overview of the most common and useful commands. You also get some information of the bot. Optionally you can also get more information on a specific command.
Format:
/help ?{command}
Example:
Leaderboard
With this command you can view the global leaderboard. This leaderboard is based on the users total xp.
Format:
/leaderboard
Example:
Log history
With this command you can see your entire log history or filter it by an exercise.
Format:
/history {exercise}
Example:
Log an exercise
With this command you can create a log of an exercise. In the response you can see multiple personal statistics of the exercise, get congratulations on your reached result, see your reached achievements, view the received amount of experience and finally get some motivation. This is perhaps the most important, used and complex command of the bot.
Format:
/log {exercise} {amount}
Example:
Retrieve a random motivational quote
With this command you can receive a random motivational quote.
Format:
/motivation
Example:
Create session
With this command you can create a session. With a session you can group subsequent logs and get an overview of your entire workout. A session will get automatically finished when there is no log created for at least an hour. See session-status for the possible states that a session can be in.
Format:
/sessions create {name}
Example:
View sessions
With this command you can see all of your created sessions. See session-status for the possible states that a session can be in.
Format:
/sessions view all
Example:
View last session
With this command you can view more expanded data on your last session. See session-status for the possible states that a session can be in.
Format:
/sessions view last
Example:
View one session
With this command you can view more expanded data on a specific session. See session-status for the possible states that a session can be in.
Format:
/sessions view one {session}
Example:
Stop session
With this command you can manually stop a session. This will update the session's status to
STOPPED. See session-status for the possible states that a session can be in.Format:
/sessions stop {session}
Example:
Rate session
When a session is manually or automatically stopped, then the user is sent a message to rate their session.
Note: this is not really a command, instead it is automatically being sent to you via the channel you originally created the session.
Example:
User stats
With this command you can see your own stats or optionally see the stats of one of your friends.
Format:
/stats ?{user-id}
Example:
These commands are only available from the configured management server. It is advisable to create a separate server as a management server so that these management commands will only be visible to the maintainer. Besides this the bot needs some free space for the custom emoji's that are used for the achievement icons, and to not fill your personal server with these visuals, it is advisable to create this separate server.
Restart server
With this command you can as a maintainer restart the server on demand.
Format:
/management restart
Refresh guild commands
With this command you can as a maintainer register the discord commands. This is useful if some commands are not working properly or are missing on a server.
Format:
/management refresh
Add scheduled job
With this command you can as a maintainer add a scheduled job. These jobs are scheduled on a cron-expression basis. Optionally you can give a
timezone-id, defaults to UTC. See job-types to view all the available types of jobs.Format:
/management jobs add {channel-id} {job-type} {cron-expression} ?{timezone-id}
Remove scheduled job
With this command you can as a maintainer remove a scheduled job.
Format:
/management jobs remove {scheduled-job}
- Increasing
- Decreasing
- Active
- Cancelled (manually)
- Overwritten (when a goal with the same exercise is created)
- Completed
- Daily
- Weekly
- Monthly
- Gym reminder (sends a reminder to go to the gym)
- Motivational message (sends a motivational message)
- Kilograms
- Grams
- Kilometers
- Meters
- Centimeters
- Kilometers per hour
- Times
- Hours
- Minutes
- Seconds
- Calories
- Beats per minute
- Percentage
- Active
- Overwritten (when a new session is started if one is still active)
- Stopped (manually)
- Finished (automatically)
There are 20 achievements for you to complete. Each increasing in difficulty. Are you the one to complete them all?
Achievements
Icon Title Description Difficulty Heart monitor Log an exercise which uses bpm as a measurement. EASY Let's get healthy Create your first log. EASY Reach your potential Complete a goal. EASY Cardio enthusiast Do any exercise for 30 minutes. MEDIUM Done for today Create 10 logs on a single day. MEDIUM Full workout Within 24h, log an exercise for the following categories: weight, time and distance. MEDIUM Keep on stacking Have 5 concurrent logs of a single exercise that keep increasing. MEDIUM Love to lift Lift something weighing more than 50kg for 3 days in a row. MEDIUM On a roll Log an exercise 4 days in a row. MEDIUM On the bench Add 5 logs to a single session. MEDIUM The right mindset Set 5 goals and complete these within a month. MEDIUM Think about your health Log an exercise that burns 200 calories. MEDIUM Feels like home Log an exercise 10 days in a row. HARD Let's go places Reach a distance of 20km. HARD Show off Reach the first place on an exercise leaderboard that has at least 6 participants. HARD The goat Create a total of 100 logs. HARD The hulk Lift something weighing more than 100kg. HARD Bodybuilder Add 10 logs to a single session. IMPOSSIBLE Like a marathon Reach a distance of 42km. IMPOSSIBLE Serious dedication Create at least one log each day for an entire month. IMPOSSIBLE
Follow the instructions as mentioned in the how-to.
See the domain model to view all the entities and their relationships.