Challenges are community events in which players compete and earn prizes by completing a group of related tasks. This page is dedicated to more advanced challenge mechanics. Challenge creators are also invited to join the Guild Leaders & Challenge Creators guild to ask any questions and share challenge ideas.

The Challenge Data Tool is very effective for managing challenges. Challenge creators are likely to find it particularly useful for long-term and large challenges or for declaring a winner.

Challenge Creation Tips[edit | edit source]

Please read the Running a Challenge page before beginning.

Tag and Labels[edit | edit source]

The left column can be used to sort challenges by type and keyword.

Once you have determined the name, the guild the challenge belongs to, and the number of gems awarded, you will need to select appropriate categories for your challenge.

Because users may participate in many challenges at once, it's suggested to use a short but very descriptive title and description. The title will help users find your challenge if searching by keyword. If it will be a recurring challenge, consider adding a date or sequence number to the tag to differentiate it from past or future recurrences of the same challenge. For example, a challenge to help you stop smoking may have the tag "StopSmoking0516" for May, 2016 and "StopSmoking0617" for June, 2017.

You can use emojis within the title. This can help add a theme or identifier to your challenge. An emoji identifier can also be helpful for chat responses if the challenge requires participants to respond in the guild chat.

Description[edit | edit source]

Your challenge description should at minimum describe the purpose of the challenge and any instructions for the participants. However, there are other things that you should consider placing in the description:

  • How you will choose a winner (e.g., using a random number generator for those that have completed a specific task or simply those that participated in the challenge, the participant with the highest score on a required Daily, etc.)
  • Past winners (For prestige, and to possibly avoid giving it to the same person twice)
  • Gamification - Creating a story line about the challenge.

Tasks[edit | edit source]

Be aware that the tasks created will appear in a random order when the participant joins the challenge. If there is a specific order you wish the tasks to be completed, prefix the title with words like 'Task 1' or something similar. See below for examples. Participants in the challenge can rearrange the task list once they join the challenge.

Task 1: Prepare a List of Items to Buy

Task 2: Go Shopping

Task 3: Wrap Gifts

Checklists[edit | edit source]

When creating or editing a challenge, you can't add checklists to challenge tasks. As a workaround, if you want the challenge participants to work with checklists, you can ask them to add checklists themselves. (Note, however, that the challenge creator will not be able to see the participants' checklists.) You can describe in the challenge description or in the notes of a challenge task (best in both) which checklist items the participants should add.

Please keep in mind that only the 30 most recently completed To Do's are shown in each participant's list of done To Do's! That means if participants check off a To Do, they may not be able to look at it later, and cannot look up or edit anything they wrote in that To Do (for example, checklists or notes). Notes can still be read by going to the challenge itself, clicking on the participant's name under "How's Everyone Doing?", and then hovering over the task. Checklists, however, cannot. The only way for the participant to retrieve them is by searching through a data export of their User Data. So please design your challenge in such a way that a To Do with a checklist is only checked off when the participant no longer needs to look at that checklist (The checklist items themselves can be checked off at any time though).

(Example: If a participant has to count the days on which they did a certain task, and report the number at the end of a challenge that runs for a month, there should either be one To Do with a long checklist for each day of the challenge, or there should be a reminder to note down the number for each week in a task that stays active. If there are only To Do's for each week, each with checklist items for each day, and no reminder to take notes, then some of those weekly To Do's will probably be gone at the end of the challenge, so the participant can't sum up the days from them.)

Advanced Challenge Mechanics[edit | edit source]

There are some ways that you can design your challenge to ensure that it is being used for its intended purpose.

  • Habits in challenges are hard to enforce because they do not need to be checked off to prevent damage from occurring. If you have a Habit that should be checked off once a day (i.e., +/- Stayed on task at work), then you can have a Daily that reminds participants to check that Habit (i.e., Mark productivity Habit). It is likely more appropriate to create a Daily.

    A challenge note can a) instruct a participant to edit it (top) and b) be edited by a participant to show compliance with the challenge (bottom).

  • Often, challenge creators will require participants to write a response in the Notes section of a task. A challenge creator can see the Notes section of every participant (both through the CSV file, described below, or through the challenge page). Requiring Notes can ensure that the task is being performed properly and not just being checked off to gain the points.
  • If a challenge requires participants to post responses in the chat of a larger guild, emojis or keywords may be helpful for locating challenge-related posts. Requiring participants to put an emoji before their challenge response makes it easier for challenge creators to identify and keep track of challenge chat participation.
  • Some challenge creators may create a challenge-specific guild. In this case, participants can always post responses and updates in the chat. This is particularly useful for challenge about sensitive topics because guilds can be private. These guilds are often temporary, and the creator may delete them after the challenge is completed (thus deleting the chat history as well, for added privacy).

Long-Term Challenges[edit | edit source]

If you plan to run a challenge for a long time (longer than a month), or the stakes are raised (e.g. a large reward, a duel), you should include additional details. Consider adding information about:

  • What will happen if someone is temporarily absent from Habitica or unable to do the tasks? Can they make up for the lost time before or after their absence or illness?
  • What will happen if a participant leaves Habitica or can't be contacted? (Example: "If a participant doesn't answer to PMs for two weeks, they lose automatically. If they have stated before that they are on vacation until an expected return date, the two weeks count from the expected return date onwards.")

If a long-term challenge has many Dailies and Habits and several participants, it also has a higher risk of becoming a "large challenge", i.e., one which takes up lots of data storage. This is because the history for each Dailiy and Habit is recorded for each participant, and the longer the duration, the more data required.

Large Challenges[edit | edit source]

Rarely, trying to edit or join a large challenge with many members will result in an "Entity too large" error. This error makes the challenge difficult to join, leave, edit, or close. Cloning and closing the challenge annually (or more frequently if it has a large number of participants) prevents this error.

Examples to Follow[edit | edit source]

For examples on running long, large challenges with explicit rules, see the guild: The Duelling Grounds.

To discuss your ideas for a challenge, see the guild: Guild Leaders & Challenge Creators.

Challenge Editing[edit | edit source]

When you edit a challenge, the challenge is affected for both current and future participants.

For example, if midway through the challenge, the challenge creator adds a task, that task will then appear on the tasks page for each participant. Any user that joins the challenge after that point will also see the new task. Adding tasks in sequence is a way to prevent cheating. But beware: Adding a new Daily to an already existing challenge may result in damage to your participants if they don't see it before their Cron. A feature to delay damage from newly added Dailies for one Cron has already been requested.

If a task is deleted from the challenge, a broken megaphone icon will appear in the task. Clicking for more information about the task will inform the user that the task has been removed from the challenge; the participant will then be prompted to keep or remove that task.

Challenge Completion[edit | edit source]

At any time during a challenge, the challenge creator can check a participant's progress by selecting their name from the pull-down section of the challenge labelled, "View Progress Of".

Use "View Progress Of" to view the progress of one individual in your challenge.

Information about all of the challenge participants is available by downloading the spreadsheet, or CSV file. The challenge creator will find this option from the challenge edit menu and the button labelled, "Export Challenge".

The edit challenge menu. 'Export challenge' will produce a spreadsheet of participant progress.

The CSV file lists the User ID (UID) and username of each participant and the following for each of their challenge tasks: the task type and task name separated by two colons (e.g., "daily::Brush your teeth" or "to-do::Clean your room"), the task value, and any text in the notes box.

Task value changes at Cron depending on the task type.

  • For Habits, the challenge creator can easily determine if the participant is doing well on that Habit by high positive values.
  • The task value for Dailies may appear positive if the participant is regularly checking them off. Values may appear negative if the Dailies have been going unchecked.
  • The task value for To Do's reaches a maximum value of +1 if the participant checks it off on the day they join the challenge, and will become more negative in subsequent days depending on the difficulty level of the task. If the value for the To Do is 0, then this means that either a) the participant joined the challenge the day you downloaded the file and has not completed that task yet, or b) the participant has been in Resting in the Inn, preventing the task value of the To Do from decreasing. The CSV file does not express whether a participant has successfully checked off a To Do or not.
  • Note: Skills that affect tasks values, such as Brutal Smash and Searing Brightness, do NOT effect the task values of challenges. This is to make comparing the task values between challenge participants easier.
  • In addition, the CSV file makes it easy to scroll through to see any notes that participants may have edited per challenge guidelines. For example, a challenge Habit may state "Pick a bad habit, and write the habit in the notes." The participant may write "Forgetting to floss" in the notes section of the Habit, and then presses the "+" button every time they remember to floss and the "-" every time they forget to floss. The CSV file will show "Forgetting to floss" in the notes column for the task of that user.

The CSV file can make it easier to identify participants who have "cheated" in a challenge. For example, if your challenge has a To Do that states "Go to bed on time for 14 days" and the participant has a task value of +1 for that task, they may have checked off that To Do immediately upon joining the challenge, rather than after 14 days of adhering to the challenge's principles. Optionally, the challenge creator can remove any participants with a large negative score on any Dailies or Habits that hints that the participant was not as successful within the challenge.

If the challenge requires the participants to actively participate in the guild chat, the owner may wish to double check that participants who have checked off tasks requiring chat participation have actually done so. This can be made easier with the use of emojis, as mentioned above.

Thus, if a challenge creator decides that the winner of the challenge will be randomly selected from all users who complete all challenge To Do's, a common method for determining the winner of a challenge may be as follows:

  • Download the CSV file.
  • Remove any users who have obviously cheated by immediately checking off To Do's that require time before checking off (optional).
  • Remove any users who have strong negative values for any Dailies or To Do's (optional).
  • Remove any users who have not complied with adding notes into tasks that require editing.
  • Look at the "How's Everyone Doing?" section on the challenge page to determine which users have completed To Do's. Remove any users who have not completed all To Do's (Note: this method can be tedious if your challenge has many participants; there is currently a feature request for obtaining this information easier).
  • Verify any completed To Do's that require guild or party chat participation and remove any participants who have checked those To Do's off but not participated.
  • Use a random number generator from the remaining number of participant's to choose a winner.
Community content is available under CC-BY-SA unless otherwise noted.