Troubleshooting
Common problems, quick solutions.
"My streak reset but I checked in yesterday"
MainQuest uses a 3 AM day boundary instead of midnight. If you checked in before 3 AM, that check-in counted for the previous day, not the new one.
To maintain your streak, make sure you check in at least once between 3 AM today and 3 AM tomorrow. The 3 AM boundary is designed to accommodate late-night routines — if you are active past midnight, your activity still counts for the current day.
"I’m not earning XP anymore"
You have likely hit the daily XP cap of 100. MainQuest limits XP earned per day to encourage consistent daily effort rather than marathon sessions.
The cap resets at 3 AM. You can still complete quests and check in on habits after hitting the cap — the completions are recorded, but no additional XP is awarded until the reset. A Whetstone buff can raise the cap temporarily, and Achievement XP is exempt from the cap entirely.
"My data isn’t syncing"
The fix depends on where you're playing — mobile and web handle this differently.
On mobile:
- Check that your device has an active internet connection.
- Open Settings and tap Sync Data to manually re-sync everything with the server.
- Close and reopen the app to restart the background sync.
- If the issue persists, confirm you're signed in to the same account everywhere you play.
On web: most actions need a live connection, but habit check-ins, quest completions, and focus-session logs queue automatically for up to 24 hours and retry on their own once you're back online or the tab regains focus. There's no manual sync button — if something seems stuck, reloading the page triggers a fresh retry attempt.
"My character died"
Your HP reached 0, triggering death. While dead, all gameplay is blocked — you cannot complete quests, check in on habits, or earn XP. This is a real, full-screen event on both mobile and web.
To revive, use a Second Chance Scroll — either spend one of your own (self-revive, no friend needed) or have a friend send you one. Either way, revival restores your HP to 50. If you don't have friends on MainQuest yet, use the Friends & Revival guide to learn how to add them.
"Quest abandoned accidentally"
The -10 HP penalty cannot be undone, but the quest itself survives — abandoning a focus session doesn't delete the quest, so you can simply start it again. The penalty only fires when you quit mid-session, after the timer has started; pausing for a break is free.
If you are unsure about a quest, just leave it active — there is no penalty for having incomplete quests in your list, even committed ones. (Challenges use a separate, steeper -20 HP penalty for walking away mid-attempt — don't confuse the two.)
"How do I undo a habit check-in?"
It's possible, but only on the same day you checked in — once the day rolls past 3 AM, the check-in is locked in for good.
On mobile, open the habit's menu and choose "Undo Today." On web, just tap the habit again. Either way you'll get a confirmation prompt first, and your streak drops by 1 once you confirm.
"Dawn Scroll didn’t activate Clarity Buff"
The Clarity Buff (1.2x XP for 4 hours, on quests and habits alike) requires your Dawn Scroll entry to meet a 30-word minimum (100 words if you've turned on Monk Mode). If your entry was shorter than that, the buff won't activate.
Write a full journal entry — reflect on your goals, plan your day, or free-write. This works identically on mobile and web. See the Dawn Scrolls guide for details.
"I don’t see Story Mode anywhere"
You're not missing a menu. Story Mode — 3 factions, weekly chapters — is real and fully built on the backend, but it's currently hidden from navigation on both platforms while it's finished. See the Story Mode guide for what it will look like once it ships.
"I can’t create a second Class"
Free accounts get 1 class slot. Pro unlocks up to 3, so you can hold a Main class and a Secondary or two at once. See the Classes & Attributes guide for how Main/Secondary and switching between classes works.
"Differences between mobile and web"
MainQuest's mobile and web apps share the same core gameplay, and most systems — death, push notifications, Surge Mode, the Clarity Buff — now have full parity. A few genuine differences remain: mobile handles offline sync as a local-first queue, while web is server-authoritative with a narrower offline queue; the vanishing-ink writing effect on Dawn Scrolls is mobile-only; and a pet's mood only mirrors onto a home-screen widget on mobile.
For the complete, current breakdown, see the Platform Differences guide.
Still Stuck?
If your issue is not listed above, these guides may help:
- FAQ — Answers to frequently asked questions
- Platform Differences — Check if the feature you expect is available on your platform
- Getting Started — Revisit the basics if something feels off