🛠️ Troubleshooting Guide

✅ Quick Fix (Works 95% of the time)

1. Refresh the page — Press the refresh button or swipe down on iPad
2. Re-enter the code — Make sure it's typed exactly as shown (e.g., STAR-01)
3. Check with your teacher — Verify the code is still active

🔧 If That Doesn't Work

1. Clear Safari data (iPad):
   • Settings → Safari → Clear History and Website Data
   • Return to game page and try again
2. Check internet connection:
   • Make sure WiFi is connected
   • Try loading another website to verify
3. Try Private Browsing:
   • Open a new Private tab in Safari
   • Navigate to the game page
   • Enter student code

✅ iPad Requirements

• iOS/iPadOS 14 or newer — Update in Settings → General → Software Update
• Safari browser — Chrome and Firefox may have issues on iPad
• Active internet connection — Game requires online access

🔧 iPad-Specific Fixes

1. Enable JavaScript:
   • Settings → Safari → Advanced
   • Turn ON "JavaScript"
2. Disable Content Blockers:
   • Settings → Safari → Content Blockers
   • Temporarily disable for vibeverseedu.com
3. Allow Cross-Site Tracking (for game session):
   • Settings → Safari
   • Turn OFF "Prevent Cross-Site Tracking" temporarily
   • Re-enable after playing

✅ Common Login Issues

Forgot Password?

• Click "Forgot Password" on the login page
• Check your email (including spam folder)
• Follow the reset link

"Invalid email or password"

1. Double-check your email address (no typos)
2. Make sure Caps Lock is OFF
3. Try copying and pasting your password
4. Reset password if needed

"No game account found"

• You need to register first with your activation code from TpT
• Go to the game page and click "Register"
• Enter your activation code from your PDF download

✅ Quick Fixes

1. Hard refresh the page:
   • Desktop: Ctrl+Shift+R (Windows) or Cmd+Shift+R (Mac)
   • iPad: Hold refresh button → "Reload Without Content Blockers"
2. Check browser console (for teachers):
   • Press F12 to open Developer Tools
   • Look for red error messages
   • Screenshot and send to support if needed
3. Try a different browser:
   • Chrome, Firefox, or Safari (desktop)
   • Safari only (iPad)

🔧 Advanced Troubleshooting

1. Clear browser cache:
   • Chrome: Settings → Privacy → Clear browsing data
   • Safari: Settings → Safari → Clear History and Website Data
2. Disable browser extensions:
   • Ad blockers can interfere with game loading
   • Try in Incognito/Private mode
3. Check firewall settings (school networks):
   • vibeverseedu.com must be whitelisted
   • Firebase domains must be allowed
   • Contact IT if blocked

✅ Code Generation Problems

Can't generate student codes?

1. Make sure you're logged in with your teacher account
2. Verify you have a paid account (activation code redeemed)
3. Try refreshing the dashboard page
4. Check that you haven't exceeded any limits (50 codes per batch)

Generated codes don't work?

1. Check that codes are marked "active" in your dashboard
2. Make sure students are entering the code exactly as shown
3. Verify your internet connection is stable
4. Try deactivating and regenerating codes

🔧 Dashboard Access Issues

• "You need a paid account" — Register with your activation code first
• Dashboard won't load — Clear cache and refresh
• Codes disappeared — They're still there, try refreshing

✅ Finding Your Activation Code

1. Open your TpT download bundle (ZIP file)
2. Look for the PDF labeled "Digital Game Access" or similar
3. The code is printed on a card-style graphic
4. Format: Usually 8-12 characters (letters and numbers)

"Invalid activation code"

• Double-check for typos (O vs 0, I vs 1)
• Make sure you're using the activation code, not a student code
• Verify you purchased from the official TpT store
• Contact support if code is definitely correct

"Code already used"

• Each activation code can only be used once
• If you already registered, just log in instead
• If someone else used your code, contact support immediately

✅ Performance Optimization

1. Close other tabs and apps — Free up device memory
2. Check internet speed — Game needs stable connection
3. Restart your device — Clears temporary issues
4. Update your browser — Older versions may be slower

🔧 Device-Specific Tips

iPad:

• Close background apps (swipe up from bottom)
• Restart iPad if it's been on for days
• Check available storage (Settings → General → iPad Storage)

Chromebook:

• Close unnecessary tabs
• Disable extensions temporarily
• Check for Chrome OS updates